以下内容是从handsome主题使用文档搬来的


BQH6AU9VH4ZTUIE8.png

相册

创建相册
新建分类:分类的缩略名称为image(这个是固定的,标识该分类是相册)。分类描述会输出到相册列表页面
创建属于该分类的一篇文章,即创建了一个新的相册。文章的标题即相册的标题。
在文章的自定义字段中添加字段名album,值为你的相册描述
上传相片
在属于相册分类新建一篇文章,在编辑器中添加图片即可。

添加图片:允许以下的几种方式:

使用自带的附件功能,上传并插入编辑器中
使用markdown的图片语法,支持外站链接
使用html语法,支持外站链接

举例:

![相片描述](图片地址)
<img src="图片地址" alt="图片描述">

![奔跑的日子](http://localhost/build/usr/uploads/2018/05/1374653827.png)
<img src="http://localhost/build/usr/uploads/2018/05/1374653827.png" alt="奔跑的日子">

主题代码会自动解析代码,并显示为相片格式,编辑器内多余的文字将不会显示


灯箱插件

文章中如果某个图片不想显示灯箱效果,可以给图片标签中加入nogallery属性:

<img nogallery src="">
如果某张图片高度很大,想折叠展示,可以给图片标签加入max属性:

<img max src="">


文章目录树

文章中的目录树已经内置代码,仅当文章有h2 h3 h4标题 才会生成目录树,并且手机端不显示目录树。

注意:如果文章中没有h2标题,只有h3 h4标题是不会生成目录树的。


自定义摘要字数

大版式头图默认摘要字数200字,小版式头图默认摘要字数80字。你可以在后台外观设置->自定义大版式头图摘要/自定义小版式头图摘要来改变这两个默认值。

你还可以使用摘要分隔符进行自主截断内容输出,但是自主生成的摘要不会超过默认摘要字数。

举例:你的默认摘要字数设置为200字,使用摘要分隔符截断的摘要为230字,则摘要只会显示200字。

<!--more-->


添加自定义图标

主题已经内置的图标列表,详见图标列表

如果不能满足你的图标需求,可以使用以下方法扩充主题图标:


方法一:傻瓜式扩充fontawesome图标

直接引入全套的fontawesome图标:

在主题外观设置——开发者设置——自定义输出head 头部的HTML代码,填入:

<link href="https://cdn.bootcss.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet">

上面的fontawesome 的css文件来自bootcdn.css 公共cdn提供,你可以替换成自己的文件。


方法二:自定义添加iconfont图标列表

主题内置fontello图标来自网站http://fontello.com/

你可以在该网站中导入主题目录下的assets/fonts/fontello的config.json,然后重新生成字体文件。

覆盖到assets/fonts/fontello下,并且需要修改assets/css/handsome.css中形如.fontello-*:before,替换为下载的新的标签。

(难度较大,不推荐……)


文章中插入按钮

handsome支持以下类型的按钮:

矩形文字按钮
椭圆形文字按钮
矩形图标文字按钮

[button]矩形按钮文字[/button]
[button color="succees"]矩形按钮文字[/button]
[button type="round" color="success"]椭圆形按钮文字[/button]
[button color="succees" icon="glyphicon glyphicon-eur"]图标按钮文字[/button]
  • type:选填,不填默认为矩形按钮。可选值:
  • round:椭圆形按钮
  • color: 选填,不填默认为success(绿色),可选值:
  • light:白色
  • info:蓝色
  • dark:深色
  • success:绿色
  • black:黑色
  • warning:黄色
  • primary:紫色
  • danger:红色
  • icon:选填,不填默认为文字按钮,可用按钮见图标列表

文章内插入音乐

点击编辑器的插入音乐图标可以在文章内可以插入音乐歌曲地址,支持云解析和本地MP3地址两种方式:

时光机的音乐插入按钮也是同样的操作

云解析歌曲:暂时支持解析单曲,不支持歌单,支持以下媒体:

示例:直接在输入框中输入.mp3结尾的地址,并填写歌曲名和歌手的名称。

[hplayer title="歌曲名" author="歌手" url="http:\/\/xxx.com\/xxx.mp3" size="large" /]

文章页面插入播放器size默认为large时光机插入播放器size默认为small
你也可以手动改动这个标签的内容以选择不同的播放器样式:)


文章内插入视频

点击编辑器的插入音乐图标可以插入视频,只支持本地的视频地址的播放

时光机的视频插入按钮也是同样的操作

直接在输入框中输入视频的地址即可,一般以.mp4结尾的资源地址。

示例:

[vplayer url="http://xxx.com/xxx.mp4" pic="http://xxx.com/xxx.png"]
url:视频地址
pic:视频背景图片

文章内调用其他文章

点击编辑器的调用文章的按钮可以调用其他文章并显示。

post cid="1" /
post cid="1" cover="http://localhost/build/usr/themes/handsome/usr/img/sj/6.jpg"/

cid:必填,是文章的唯一编号,在后台的编辑文章的地址可以看到,比如http://localhost/build/admin/write-post.php?cid=23,值为23
cover:可选项,调用文章显示的封面,如果不填则默认显示随机缩略图。


文章中使用mathJax公式

需要在后台外观设置——主题增强功能中启用公式(MathJax)选项。

  • 语法格式:
//块级公式:
$$ 公式内容 $$
$$    x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a} $$

// 行内公式:
$ 行内公式内容 $ 
\\( 行内公式内容 \\)

$\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$

\\( x = \dfrac{-b \pm \sqrt{b^2 - 4ac}}{2a}  \\)

文章内部分隐藏回复可见

在文章使用使用

`
此处内容需要评论回复后(审核通过)方可阅读。
[/hide]`

标签包裹住你想要隐藏的内容,游客必须先回复后才能查看隐藏内容。


文章内部分内容登录可见

为什么增加这样的功能呢?因为有时候一篇文章并不想完全的加密,部分内容由于隐私问题需要加密。该部分内容仅登录用户(如果是个人博客就是仅博主)可见。

在文章中使用

`
该部分仅登录用户可见
该部分仅登录用户可见
`

文章中插入短代码高亮文本


这是黄色的短代码框,常用来做提示,引起读者注意。
这是红色的短代码框,用于严重警告什么的。
这是浅蓝色的短代码框,用于显示一些信息。
这是绿色的短代码框,显示一些推荐信息。

文章中插入收缩框

示例代码:

标题

一些文字内容

标题

一些文字内容

其中statusfalse 表示默认不显示文字内容,为true表示默认显示内容。

不写status 属性,默认是展开内容的。

如果觉得我的文章对你有用,请随意赞赏