master
hewro 7 years ago
parent a82d64519d
commit eea8aa75a0
  1. 7
      _coverpage.md
  2. 8
      _sidebar.md
  3. 6
      changelog.md
  4. 37
      common-problem.md
  5. 6
      customEdit.md
  6. 169
      functions.md
  7. 2
      page.md
  8. 32
      setting.md

@ -1,8 +1,9 @@
# Handsome Theme <small>4.0 Pro</small>
# Handsome Theme <small>4.1 Pro</small>
这一次,更加优雅
都崭新,都暗淡,都独立,都有明天。
[联系作者](https://www.ihewro.com/)
[开始使用](/start)
[开始使用](/start)

@ -7,15 +7,17 @@
- [独立页面](/page)
- [评论系统](/comment)
- [增强功能](/functions)
- [评论表情](/emotion)
- [图标列表](/icons)
- [多语言设置](/i18n)
- [自定义栏目](/customize)
- [主题增强包](/enhancedPackage)
- [评论表情](/emotion)
- [后台更多设置](/setting)
- [图标列表](/icons)
- [个性化修改](/customEdit)
- [typecho相关](/typecho)
- 其他说明
- [开发日志](/changelog)
- [问题反馈](/feedback)
- [版权声明](/copyright)

@ -1,3 +1,7 @@
> #### 2017-12-02 更新至4.1.0
1.
> #### 2017-10-14 更新至4.0.0
1. **增加全局右侧设置菜单(含浏览器缓存功能)**
@ -226,3 +230,5 @@
2. 更新了404页面
3. 后台增加了instantclick的预加载方式选择
4. 管理员登陆后前台有可编辑的按钮,方便进入后台编辑当前文章

@ -3,34 +3,49 @@
* 依次检查主题文件夹名称是否为`handsome`
* 是否已经安装并且启用主题必要的插件
?> **2. 全局音乐播放器一直在加载无法播放**
?> **2. 使用EditorMD前台文章首次不加载,刷新一次才能加载**
* PHP必须满足 PHP>=5.4
* 某些国外服务器无法云解析,请使用手动添加歌曲功能
* QQ音乐歌单最近出现问题,分享给他人,他人打开显示404,请更换解析源(比如网易云)
如果仍有问题,请联系我。
?> **3. 使用EditorMD前台文章首次不加载,刷新一次才能加载**
* 主题pjax与EditorMD的前台解析js有冲突,在该插件的设置界面,将`接管前台Markdown解析并启用ToC、TeX科学公式、流程图 Flowchart、时序图 Sequence Diagram 等扩展`
选择否即可。
?> **3. typecho1.1版本编辑器无法解析HTML代码**
?> **4. typecho1.1版本编辑器无法解析HTML代码**
* typecho 1.0原生markdown解析器非常弱,无法解析表格。
* typecho 1.1原生markdown解析器非常坑,无法直接解析HTML代码。
* 你可以一劳永逸使用该插件:
* typecho 1.1原生markdown解析器必须使用特权模式才可以解析HTML代码,示例如下:
```html
!!!
// 你的HTML代码
!!!
```
* 你可以使用该插件替换掉typecho的markdown的解析引擎:
[kokororin / typecho-plugin-Parsedown](https://github.com/kokororin/typecho-plugin-Parsedown)
* 启用该插件后,无需任何设置,自动替换前台文章解析,没有任何问题了。
* 启用该插件后,无需任何设置,自动替换前台文章解析,支持解析表格和HTML代码。
?> **4. 点击首页头像,显示404页面**
?> **5. 点击首页头像,显示404页面**
* 需要新建“时光机”独立页面,具体方法见[独立页面](/page)
?> **5. 评论区不能斗图不能显示图片/说说不能显示图片**
?> **6. 评论区不能斗图不能显示图片/说说不能显示图片**
* 后台 `设置——评论——允许使用的HTML标签和属性` 里面添加html标签
```html
<img src="">
```
?> **6. 评论区无法使用markdown语法**
?> **7. 评论区无法使用markdown语法**
* 后台 `设置——评论——在评论中使用Markdown语法(选中)`
后台 `设置——评论——允许使用的HTML标签和属性` 里面添加html标签
@ -39,8 +54,7 @@
```
?> **7. links插件无法启用,显示500错误**
?> **8. links插件无法启用,显示500错误**
* 一般是由于你的`usr/plugin`没有足够的权限导致的。
@ -50,4 +64,5 @@
sudo chmod -R 777 plugin
```
如果仍有问题,请联系我
如果仍有问题,请联系我

@ -0,0 +1,6 @@
以下模块由勤劳的使用者提供的关于handsome主题的自定义修改内容,你可以应用到自己的主题中来。
!> 待补充

@ -1,4 +1,4 @@
### 博文头图
### 1. 博文头图
![headerpic](https://ihewrocdn.b0.upaiyun.com/img/headerpic.png)
@ -42,33 +42,29 @@
每篇文章的编辑页面底部的自定义字段中,字段名为`thumb`,当值为`no`的时候,会不显示当前文章的头图(首页头图和文章头图)(仅对当前文章有效),这里的设置同样会无视上面的设置。
### 文章目录树
### 2. 文章目录树
文章中的目录树已经内置代码,**仅当文章有h2 h3 h4标题** 才会生成目录树,并且手机端不显示目录树。
**注意**:如果文章中没有`h2`标题,只有`h3 h4`标题是不会生成目录树的。
### 短代码高亮文本
### 3. 短代码高亮文本
** \* 2.1.0及以上版本新增功能**
```html
<div class="share">这是灰色的短代码框,常用来引用资料什么的,调用代码为 <strong>&lt;div class="share"&gt;输入文字&lt;/div&gt;</strong><br><br></div>
<div class="yellow">这是黄色的短代码框,常用来做提示,引起读者注意。调用代码为 <strong>&lt;div class="yellow"&gt;输入文字&lt;/div&gt;</strong><br><br></div>
<div class="red">这是红色的短代码框,用于严重警告什么的。调用代码为 <strong>&lt;div class="red"&gt;输入文字&lt;/div&gt;</strong><br><br></div>
<div class="lblue">这是浅蓝色的短代码框,用于显示一些信息。调用代码为 <strong>&lt;div class="lblue"&gt;输入文字&lt;/div&gt;</strong><br><br></div>
<div class="green">这是绿色的短代码框,显示一些推荐信息。调用代码为 <strong>&lt;div class="green"&gt;输入文字&lt;/div&gt;</strong><br><br></div>
```markdown
[scode type="share"]这是灰色的短代码框,常用来引用资料什么的[/scode]
[scode type="yellow"]这是黄色的短代码框,常用来做提示,引起读者注意。[/scode]
[scode type="red"]这是红色的短代码框,用于严重警告什么的。[/scode]
[scode type="lblue"]这是浅蓝色的短代码框,用于显示一些信息。[/scode]
[scode type="green"]这是绿色的短代码框,显示一些推荐信息。[/scode]
```
<img src="https://ihewrocdn.b0.upaiyun.com/img/shortcode.png" />
### 博客友好时间格式化
### 4. 博客时间友好格式化
> **使用效果**
@ -87,9 +83,10 @@
在这里同样可以修改博客的时间格式为你需要的时间格式,值为标准的php格式。
### 灯箱插件
### 5. 灯箱插件
文章中如果某个图片不想显示灯箱效果,可以给图片标签中加入`nogallery`属性:
```html
<img nogallery src="">
```
@ -100,10 +97,146 @@
<img max src="">
```
### 文章内部分隐藏回复可见
### 6. 文章内部分隐藏回复可见
在文章使用使用
```html
[hide][/hide]
```
标签包裹住你想要隐藏的内容,游客必须先回复后才能查看隐藏内容。
### 7. 文章中插入按钮
handsome支持以下类型的按钮:
* 矩形文字按钮
* 椭圆形文字按钮
* 矩形图标文字按钮
```html
[button]矩形按钮文字[/button]
[button color="succees"]矩形按钮文字[/button]
[button type="round" color="succees"]椭圆形按钮文字[/button]
[button color="succees" icon="glyphicon glyphicon-eur"]图标按钮文字[/button]
```
* `type`:选填,不填默认为矩形按钮。可选值:
* `round`:椭圆形按钮
* `color`: 选填,不填默认为success(绿色),可选值:
* `light`:白色
* `info`:蓝色
* `dark`:深色
* `success`:绿色
* `black`:黑色
* `warning`:黄色
* `primary`:紫色
* `danger`:红色
* `icon`:选填,不填默认为文字按钮,可用按钮见[图标列表](./icons)
### 8. 文章内插入音乐
**点击编辑器的插入音乐图标**可以在文章内可以插入音乐歌曲地址,支持云解析和本地MP3地址两种方式:
**时光机的音乐插入按钮也是同样的操作**
> **云解析歌曲**:暂时支持解析单曲,不支持歌单,支持以下媒体:
* 网易云音乐:http://music.163.com/#/song?id=40147556
* QQ音乐:https://y.qq.com/n/yqq/song/000jDQWP4JiB3y.html
* 虾米音乐:http://www.xiami.com/song/bf08DNT3035f
* 酷狗音乐:http://www.kugou.com/song/#hash=09E8DE70A24C97B92A29F6A19F3528A2
* 百度音乐:http://music.baidu.com/song/268275324
> 本地mp3地址播放:
* 示例:直接在输入框中输入`.mp3`结尾的地址,并填写`歌曲名`和`歌手`的名称。
```html
[hplayer title="歌曲名" author="歌手" url="http://xxx.com/xxx.mp3" /]
```
### 9. 文章内插入视频
**点击编辑器的插入音乐图标**可以插入视频,只支持本地的视频地址的播放
**时光机的视频插入按钮也是同样的操作**
直接在输入框中输入视频的地址即可,一般以`.mp4`结尾的资源地址。
示例:
```html
<video src="http://xxx.com/xxx.mp4"></video>
```
### 10. 文章中使用mathJax公式
* 需要在`后台外观设置——主题增强功能`中启用`公式(MathJax)`选项。
* 语法格式:
```markdown
//块级公式:
$$ 公式内容 $$
$$ 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} \\)
```
### 11. 将本地静态资源上传到你的cdn上
* 需要在`后台外观设置——将本地静态资源上传到你的cdn上`中配置:
* 使用该项设置前,你必须有自己搭建的cdn服务器(不是指当前服务器)
* 主题目录下的/assets/目录下有 css、js、fonts、img四个静态资源文件夹。
* 你需要把asset目录上传到你的cdn服务器上,比如CDN服务器的 handsome目录里,地址即为 `https://cdn.ihewro.com/handsome/assets/`
* 在当前框中就填入该地址,主题就会引用你搭建的cdn上面的资源,而不再引用当前服务器上的资源
### 12. 图片附件加速
![qiniu](https://ihewrocdn.b0.upaiyun.com/img/qiniui.png)
在该项配置填写的是你的博客附件的镜像空间地址(地址以`/`结尾)。
在一般情况下,七牛镜像空间的访问文件速度要比你服务器访问文件速度要快,所以你可以建立七牛镜像空间(或者其他的镜像控件)加速你博客中的**附件访问速度**。
注意:你的七牛空间必须在`镜像存储的设置项`中填写你的**博客的附件存放的地址**(例如:https://www.ihewro.com/usr/uploads/ ),这样才能达到加速的效果。
### 13. DNS预解析
DNS prefetching通过指定具体的URL来告知客户端未来会用到相关的资源,告诉客户端可以尽早的解析DNS。
更多详细信息,[请戳这个](https://www.linpx.com/p/small-practice-of-prefetching-dns.html)
### 14. 侧边栏的标签云
需要在新建文章的页面右侧填写标签,才会在首页侧边栏输出的。(回车添加当前标签)
![tagcloud](https://ihewrocdn.b0.upaiyun.com/img/tag.png)
### 15. 自定义摘要字数
默认显示文章的前200字作为摘要,你还可以使用`摘要分隔符`进行自主截断内容输出
```markdown
<!--more-->
```

@ -48,3 +48,5 @@
[1]: https://www.ihewro.com/usr/uploads/2017/03/3674342886.jpg
[2]: https://www.ihewro.com/usr/uploads/2017/03/2880093812.jpg

@ -1,34 +1,2 @@
后台外观的所有设置都已经有说明文字,这里还是补充几点。
### 将本地静态资源上传到你的cdn上
博客采用
### 图片附件加速
![qiniu](https://ihewrocdn.b0.upaiyun.com/img/qiniui.png)
在该项配置填写的是你的博客附件的镜像空间地址(地址以`/`结尾)。
在一般情况下,七牛镜像空间的访问文件速度要比你服务器访问文件速度要快,所以你可以建立七牛镜像空间(或者其他的镜像控件)加速你博客中的**附件访问速度**。
注意:你的七牛空间必须在`镜像存储的设置项`中填写你的**博客的附件存放的地址**(例如:https://www.ihewro.com/usr/uploads/ ),这样才能达到加速的效果。
### DNS预解析
DNS prefetching通过指定具体的URL来告知客户端未来会用到相关的资源,告诉客户端可以尽早的解析DNS。
更多详细信息,[请戳这个](https://www.linpx.com/p/small-practice-of-prefetching-dns.html)
### 首页文章摘要
默认显示文章的前200字作为摘要,你还可以使用`摘要分隔符`进行自主截断内容输出
```markdown
<!--more-->
```
### 侧边栏的标签云
需要在新建文章的页面右侧填写标签,才会在首页侧边栏输出的。(回车添加当前标签)
![tagcloud](https://ihewrocdn.b0.upaiyun.com/img/tag.png)

Loading…
Cancel
Save