iotcat
/
digital-clock
mirror of https://github.com/IoTcat/digital-clock.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

del

Browse Source
master
IoTcat 5 years ago
parent 4baaf7d882
commit cebdd5edbf
23 changed files with 0 additions and 1980 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Split View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 30
      docs/album.md
  2. 530
      docs/changelog.md
  3. 27
      docs/comment.md
  4. 144
      docs/common-problem.md
  5. 15
      docs/copyright.md
  6. 17
      docs/customEdit.md
  7. 129
      docs/customize.md
  8. 50
      docs/emotion.md
  9. 61
      docs/enhancedPackage.md
  10. 5
      docs/feedback.md
  11. 371
      docs/functions.md
  12. 15
      docs/home.md
  13. 124
      docs/i18n.md
  14. 59
      docs/icons.md
  15. 85
      docs/page.md
  16. 4
      docs/pjaxanimate.md
  17. 23
      docs/plugin.md
  18. 49
      docs/rss.md
  19. 2
      docs/setting.md
  20. 66
      docs/speed.md
  21. 42
      docs/start.md
  22. 30
      docs/typecho.md
  23. 102
      docs/wechat.md

30
docs/album.md
Unescape View File

@ -1,30 +0,0 @@
### 创建相册
* 新建分类：分类的缩略名称为`image`（这个是固定的，标识该分类是相册）。分类描述会输出到相册列表页面
* 创建属于该分类的一篇文章，即创建了一个新的相册。文章的标题即相册的标题。
* 在文章的自定义字段中添加字段名`album`，值为你的相册描述
### 上传相片
* 在属于`相册`分类新建一篇文章，在编辑器中**添加图片**即可。
* `添加图片`：允许以下的几种方式：
* 使用自带的附件功能，上传并插入编辑器中
* 使用markdown的图片语法，支持外站链接
* 使用html语法，支持外站链接
举例：
```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="奔跑的日子">
```
* 主题代码会自动解析代码，并显示为相片格式，编辑器内多余的文字将不会显示
*[相关问题：编辑器无法解析HTML代码](https://handsome.ihewro.com/#/common-problem?id=typecho11%E7%89%88%E6%9C%AC%E7%BC%96%E8%BE%91%E5%99%A8%E6%97%A0%E6%B3%95%E8%A7%A3%E6%9E%90html%E4%BB%A3%E7%A0%81)*

530
docs/changelog.md
Unescape View File

@ -1,530 +0,0 @@
> #### 2019-4-3 更新至5.1.0
1. **增加了文章内图集的功能[使用方法见：使用文档——增强功能——文章中插入图集]**
2. **更新links插件，请务必更新插件！**
3. 优化小头图在小屏幕的问题
4. 过滤feed页面的私密评论的内容
5. 增加分类过滤功能(**使用新版handsome配套插件**，文章置顶功能也移动到插件中设置)
6. 现在默认编辑器有了更强的功能！(感谢[sun个性](http://blog.acef.tk)的无私劳动)
7. 增加底部菜单关闭开关(外观设置——外观设置开关)
8. **增加CDN本地化的功能(速度优化——选择公共CDN——选择本地)**
9. 重写友情链接的独立页面模板的样式
10. **公众号支持链接类型，支持多条信息混合发送，优化了发送地点位置消息的输出**
11. 增加评论框的提示文字(设置项在外观设置——评论设置——评论框提示文字)
12. 现在项目库有了更酷的展示，重写了项目库的独立页面模板
13. **增加文章无头图时候的个性化徽标**(文章编辑页面可以选择)
14. 增加文章过时提醒(在文章的编辑页面有选项)
15. 增加文章的手动指定摘要功能(在文章的编辑页面有选项)
16. **文章编辑页面的头图设置更加灵活自由(在文章的编辑页面有选项)**
17. **现在，手机版也支持目录树了，让阅读更轻松**
18. **时光机发送多张图片自动生成图集显示**
19. 时光机网页版增加"私密说说"按钮
20. **时光机支持多条消息发送，支持混合类型发送**
21. 时光机支持发送隐私评论(消息开头加上`#`即可)
22. **时光机增加"那年今日"(默认关闭，需要在外观设置——时光机——那年今日开启功能)**
23. 增加分类默认展开设置(外观设置——主题增强功能里有)
24. 增加文章页面打赏按钮下方文字自定义选项(外观设置——初级设置——文章页面打赏默认提示文字)
25. 增加手机模式下单独设置背景图片
26. 增加评论框背景图片隐藏动画
27. 优化搜索，增加搜索等待动画
28. 时光机其他的RSS订阅也可以使用灯箱效果了
29. 优化文章内的markdown样式(包括标题和代码块的显示(不会自动换行))
30. 优化了文章页面动画的效果(外观设置——主题增强功能——开启文章页面动画)
31. 优化了手机版本相册的显示，一排显示2个
32. 优化未读提醒
33. 更新了meting.php 修复腾讯QQ音乐403错误
34. 删除了旧版本遗漏的多余css代码，优化性能
35. 修复伪静态带来的问题的地址问题
36. 修复搜索地址栏不变的问题
37. 修复时光机某些RSS订阅源时间错误问题
38. **修复豆瓣页面，提供更精确的错误信息**
39. 修复字体大小调整无效的问题
40. 修复mathJax 链接写死的问题，现在已经同步后台的CDN公共库的设置
> #### 2018-12-31 更新至5.0.0
1. 增加了时光机 未读提醒（针对游客）
3. **增加时光机RSS 订阅功能[简单来说，就是支持微博等等社交媒体的动态显示](./rss)**
4. 增加了左侧边栏的底部footer显示（Safari浏览器不会显示）
5. **增加了搜索提示功能（搜索框输入文字即可看到效果）**
6. 重写了搜索结果页面
7. **增加了代码行号的功能**
8. 增加了字体调整功能（后台外观设置——外观设置——文章内容字体大小）
9. **增加了网页版时光机的图片上传功能**
10. 增加了时光机的微信公众号的位置类型的消息
11. **增加了大小头图分离的设置项（在文章编辑页面可以看到）**
1. 优化小头图，现在小头图在手机等各设备都同样显示
2. 优化了右侧边栏的文章列表的样式
3. 优化了折叠框，点击整个标题就是可以折叠
4. 优化了父分类点击，点击会不仅为展开子分类，还会打开父分类
5. 重写了豆瓣页面的样式，完善了错误提示
6. 现在，完美适配 Dplayer（视频播放器） 与 Meting（就是typecho的Aplayer） ，安装好插件无需任何适配[修复官方Dplayer-Typecho插件不能连接弹幕API后端的方法](https://www.moerats.com/archives/856/)
7. 优化了后台外观设置的更新接口，现在更快，而且界面也有些许调整
8. 优化了首页闲言细语空白的情况
9. 优化了黑色风格下的样式细节
8. 给备份数据之类功能，增加了提示框
1. 修复了开启独立页面打赏功能，在某种情况下不生效的问题
2. 修复了备份数据在已有备份数据的前提下，不能覆盖
3. 修复了MySQL5.7的留言板问题
4. 修复时光机微信公众号发送不更新评论数目的问题
5. 修复首页不显示头图，相册也不显示头图的bug
6. 修复浏览器后退的时候，延迟加载的问题
7. 修复延迟加载关了，导致评论表情不加载的问题
> #### 2018-09-17 更新至4.5.1
1. links页面透明模式的bug
2. 引用样式在透明模式的bug
3. 启用白色圆圈有错误提示
4. 修复头像的自定义地址有问题在没开启伪静态下面不生效
5. 摘要颜色变淡
6. 修复了第8中配色中时间进度条的背景问题
> #### 2018-09-12 更新至4.5.0
1. **现在，使用微信公众号可以同步发送到博客啦，支持文字和图片两种类型** [文档教程](/wechat)
2. 私密评论记录cookie，作者同样可以给对方回复私密评论，甚至多人进行相互私密评论也是可以的
3. 重写了留言板的排行榜样式
4. 重写了友情链接的样式
5. 增加时光机页面的点赞功能，还不快来点赞
6. 增加了时光机页面的发送来源
7. 增加了文章字体变大的功能（在标题的右侧）
8. 增加了pjax动画`素雅圆圈`，以及支持自定义pjax动画的设置 [文档教程](http://handsome.ihewro.com/#/pjaxanimate)
9. 增加全站加锁的功能（后台外观设置——高级设置——加密访问）
10. **增加了呼声很高的`后台外观数据备份以及备份管理`（在外观设置的顶栏有）**
11. 增加`头图样式交错模式`（即大头图和小头图根据奇偶以次显示）（后台外观设置——外观设置——头图样式选择）
12. 增加侧边栏分类中有子分类情况下父分类是否显示（外观设置——主题增强功能）
1. 摘要中排除login加密文字
2. 回复可见必须是评论审核后
3. 优化了最后一点风格，深红色变成了淡红色
4. 优化了黑色风格，更加的深邃迷人
5. 优化了引用块的样式
6. 优化了侧边栏的样式
7. 优化了手机端的顶栏样式
8. 升级meting至1.5.4
9. 优化了handsome的debug模式
10. 之前播放器自动播放的提示不小心删掉了，现在补上
11. 调整了首页文章标题的字体大小
12. 优化了lazyLoad的加载
1. 时光机的联系方式以新窗口打开链接
> #### 2018-07-19 更新至4.4.1
1. 修复qq头像解析问题
2. 修复分类页面和搜索结果显示错误
3. 修复外观设置一处文字描述错误
> #### 2018-07-18 更新至4.4.0
1. 现在支持二级目录，在左侧边栏显示，并且分类会显示文章数目信息
2. 右侧边栏去除原来的目录，显示博客信息
3. 现在，加密文章增加了密码提示功能。（自定义字段为lock，值即为你想提示的内容）
4. 时光机页面地址支持自定义了（外观设置——初级设置——首页左侧边栏头像的链接地址）
5. button 按钮增加了url字段 举例：`[button url='http:\/\/baidu.com']矩形按钮文字[/button]`
6. 热门文章排序支持两种方式，支持按照浏览数排序，因为有的博主反应网安不允许评论（主题增强功能——热门文章的排序规则）
7. 新增简单的元素的控制显示功能（外观设置——页面元素显示设置）
8. 顶部音乐播放器增加了错误播放的异常捕捉
9. 增加了文章部分内容仅登录用户可见`[login]登录用户可见[/login]`
10. 登录后顶部的菜单功能变化，增加新建文章和评论管理的入口
11. 增加文章字数统计功能
12. 增加了ins 和paypal 图标
13. 增加了评论框处显示邮箱的头像的功能
14. 相册页面增加了滑动滚动加载
15. 增加独立页面增加navbar 自定义字段可以在左侧边栏隐藏显示 （navbar : hide）
16. 增加了代码高亮的样式选择（外观设置——增加代码块颜色选择的开关）
1. 去除新浪云公共CDN（新浪云的bootstrap 版本太低，没有3.3.4版本的会导致样式错误）
2. 修复了页面动画与lazyload懒加载图片的冲突
3. 修复了生成封面图的问题
4. 修复了视频有黑边的问题
5. 修复未来发布的文章在上一篇中暴露的问题
6. 修复右侧边栏由于评论为图片而出现的错位情况
7. 修复 safari 浏览器下，左侧边栏有一点小的样式问题
8. 修复顶部闲言碎语没有过滤 vplayer 和 hplayer的标签
9. 修复七牛云镜像存储的bug，图片处理的分隔符有误
10. 修复折叠框生成的ID可能重复导致的问题
1. 美化了置顶的按钮，以及优化了标题大小
2. 优化了表情的懒加载
3. 现在随机缩略图不需要再去后台配置数目了，会自动统计文件夹的数目，而且这个统计数目的过程所需的时间在5ms左右，基本可以忽略不计
4. 替换了老版本的侧边栏缩略图图标
5. 优化了首页文章panel的弧度
6. 优化了文章播放器和时光机的播放器的样式（更好看啦！）
7. 手机端点击头像会自动收起侧边栏
8. 优化了文章代码块和引用的样式
9. 赞赏按钮变成了圆弧形
> #### 2018-05-28 更新至4.3.2
1. 修复了手机端透明模式的文章页面背景为纯白色的bug
2. 图片灯箱增加了下载的按钮
3. 文章页面的截图分享增加了二维码自动生成
4. 修复了由于相册文章导致了首页文章数目变少的bug
5. 优化了透明模式的代码块以及其他的文章页面的css
> #### 2018-05-23 更新至4.3.1
1. 手机端透明模式很诡异，原因是安卓大部分浏览器（非Chrome内核）不支持16进制的8位码的颜色格式，比如#ffffff00，就无法识别这个颜色
2. 手机端透明模式下，点击左侧边栏，顶部的footer会调到顶部，重叠
3. 修复没有开启图片延迟加载会导致文章页面php报错
4. 摘要不受后台控制了。这个原因应该让typecho来背，typecho的生成摘要函数，如果摘要字数限制为0,1,2，就会不受这个字数限制，而膨胀
5. 修复友链页面左侧边栏消失了
6. 修复透明模式下小版式头图的样式问题
7. 修复相册图片显示没有相片，这个原因是正则表达式多了一个空格
8. 默认给透明模式加了一个遮罩，这样就不会太过于透明，同样也可以在后台外观设置的透明模式背景颜色修改
> #### 2018-05-22 更新至4.3.0
1. 这可能是typecho唯一的有相册的主题了，使用相册方法[相册](./album)
2. 全新透明炫酷模式，typecho下最炫酷的透明主题之一（后台外观设置——外观设置——开启透明炫酷模式，并按照下面的介绍填写内容）
3. 私密评论，我的评论只有作者能看见
5. 增加文章页面生产分享图片的功能（后台外观设置——主题增强功能——启用文章页面截图）
6. 增加图片延迟加载功能（主题增强功能——延迟加载图片）
7. 增加填写品牌logo的设置（初级设置——博客logo）
8. 增加自定义首页标题左侧的图标
9. 增加镜像空间的高级用法（4.3.0更新了镜像功能的用法，必须重新配置，速度优化——本地图片云存储(镜像)加速）
10. 增加了collapse收缩框的组件
10. 支持自动转换webp和图片缩放的图片处理方案（需要配置镜像空间地址）
10. 修复表情解析（使用code标签包裹住就是不会执行解析了，其他播放器也是一样，如果不想解析的话使用标签包裹住就好了）
11. 文章内插入文章不填写cover的情况下可以直接显示封面图片
12. 修复pjax切换页面返回的时候顶部的加载条不会消失
13. 优化后台外观设置的界面的cdn的css也跟随后台的设置
14. 修复自定义歌曲解析的情况下无法自动播放
15. 优化了摘要，过滤掉[hide]标签
16. 修复了表情当图片栏目为第一栏的时候，第一次点击不加载图片的问题
17. 修复了主题内置的图标名称，有fa-改为fontello- 方面用户直接增加fontawsome图标，而不会出现css冲突
> #### 2018-02-26 更新至4.2.1
1. 修复主题升级由于某些配置初始为空带来了问题
2. 修复pace进度条多次加载
3. 增加css编码格式，防止某些情况下乱码
4. 修复了php7.2 下对count()函数必须接收数组或者实现countable接口的参数带来的问题
5. 优化了目录树太长的情况下可以滚动
6. 修复了文档助手在某些markdown引擎下的解析问题
7. 优化修复了摘要显示markdown语法和其他语法问题
> #### 2018-02-14 更新至4.2.0
1. 新的后台，给你新的体验
2. 增加了更多的pjax动画管理，包括动画样式、遮罩、返回顶部的速度（后台外观设置——PJAX）
3. 手机端增加了音乐播放器显示（为了精简不显示音乐播放列表）
4. 增加全局音乐播放器可以自动播放的开关（主题增强功能——全局播放器设置）
5. 增加了文档助手的markdown扩展
6. 增加了右侧边栏不显示缩略图的开关
7. 增加了页面显示动画（主题增强功能——增强功能开关——启用文章页面/非文章页面显示动画）
8. 增加了个人github独立页面的模板
9. 现在可以展示更多豆瓣个人信息（由原来的豆瓣书单改为豆瓣清单可以显示豆瓣电影列表）
10. 现在全新的表情包，以及表情包解析、添加方式
11. 评论表情改为懒加载，不点击前不会加载图片，减少流量负担
12. 增加了自定义摘要的功能（后台外观设置——高级设置）
13. 增加了评论框的选择位置（评论设置——评论框位置）
14. 增加了拼音注解的功能（主题增强功能——markdown扩展）
1. 优化了视频的鼠标指针样式
2. 全局播放器未点击播放不会加载音乐信息，减少流量负担
3. 优化了表格的css问题
4. 取消了文章内的音乐播放器显示时长
5. 文章中音乐播放器未点击播放不会加载音乐信息，减少流量负担
6. 搜索框增加了点击反馈
7. 短代码样式优化
8. 优化了消息通知的样式和体积大小，使用更精简的库
9. 优化了手机端左侧边栏的打开动画
10. 优化了电脑端登录框打开动画
11. 优化了左侧边栏电脑端在折叠下的hover悬浮效果
12. 优化了顶部的闲言碎语在手机端由于内容过多导致显示不全的问题
13. 更多细节优化等你发现
1. 修复了某些情况下登录出错
2. 修复文章中的h4标签和目录树冲突的bug
3. 修复首页输出列表的作者为登录名称
4. 修复自定义歌单解析bug
5. 修复文章中插入非网易云音乐源出错的问题
6. 修复归档栏底部错误的问题
7. 修复了书单页面的css问题
8. 修复了typecho1.0下的404页面问题
> #### 2017-12-02 更新至4.1.0
1. 增加了评论区的默认头像设置
2. 增加了评论框的背景设置和小彩蛋
3. **全局播放器支持手动添加自定义音乐内容**
4. 增加了文章、独立页面、侧边栏三个地方的广告位
5. **现在时光机、文章都可以直接云解析歌曲了**
6. **编辑器支持插入表情**
7. 增加了公式功能（后台外观设置——主题增强功能）
8. 增加了一言功能（后台外观设置——主题增强功能）
9. 支持取消右侧的全局的主题设置按钮（后台外观设置——主题增强功能）
10. 文章中支持插入各种各样的好看的按钮了，使用方法很简单（详见使用文档—进阶设定—增强功能—向文章中插入按钮）
11. **现在，简单使用方法即可支持文章内调用另一篇文章了（详见使用文档—进阶设定—增强功能—文章内调用其他文章）**
1. 删除了后台外观设置的emoji字符，避免乱码
2. 优化了后台外观设置
3. 首页顶部导航栏的闲言碎语排除音频、视频、图片等HTML代码
4. 优化了评论区的图片太大问题
5. **优化了全局播放器云解析歌单的方式（直接填写歌单地址即可）**
6. **头图和侧边栏缩略图不会再重复**
7. 重新设计了初始的头图
8. **优化了短代码高亮文本的使用方式（详见使用文档—进阶设定—增强功能）**
9. 优化了小版式缩略图的摘要字数
10. **初步优化了handsome主题在2K屏幕和4K屏幕的显示（后续会进一步优化）**
11. 更新了fancybox灯箱插件
12. **优化了markdown的排版**
13. 其他更多细节优化
1. 修复了选择第8个主题风格出现的颜色闪动问题
2. 修复了小版式头图在手机端的显示样式不统一问题
3. **修复了全局播放器首次会自动加载音频的严重问题**
4. 修复了书单页面黑色界面的问题
5. 修复了主题内某些服务器产生的乱码问题
6. **修复了使用非原生评论的时光机无法发送成功**
7. 修复了某些服务器的前台登录失败问题
8. 修复了在后台配置中 隐藏默认的 闲言碎语按钮失败问题
9. **修复了获取网易云歌单无法播放问题**
10. 修复了时光机页面因为音频播放失败导致的时光机其他按钮无法点击的问题
11. 修复了插入表情、插入视频的光标定位问题
12. 修复了评论未审核的判断错误
13. **修复了头图选择小图开关无效**
12. **修复文章页面快读刷新闪动问题**
> #### 2017-10-14 更新至4.0.0
1. **增加全局右侧设置菜单（含浏览器缓存功能）**
2. **重写音乐播放器，支持网易云、百度、虾米、QQ音乐歌单解析**（后台外观设置——主题增强功能）
3. 增加了后台设置的目录树开关
4. 增加了ctrl+Enter评论的快捷键功能
5. 可以在文章页面直接选择当前文章的头图样式
6. 更换了主题内置灯箱的项目，更简洁与现代化
7. **增加了后台选择静态资源公共CDN的选项**
8. 支持上传主题静态资源到自己的CDN服务器上（后台外观设置——速度优化）
9. 时光机支持插入视频、插入音乐，并内置好audio、vedio的样式
10. 增加了返回顶部按钮
11. 后台设置项目可以根据标题折叠
12. 评论框中添加了默认文字
13. 增加了编辑器中插入音乐、插入视频的按钮
14. 增加取消主题内置的代码高亮选项
1. **重构主题**，不再使用bug多多的instantclick.js，使用pjax项目重写主题，重构绝大数代码
2. 顶部导航栏右侧头像根据登录用户的邮箱获取gravator头像
3. 优化了打开文章分享的窗口大小
4. 优化了小版式头图样式
5. 优化了网页中选择文字的颜色
6. 不再使用庞大体积的fontawesome网页字体文件，更快！
7. 使用畅言评论系统，自动取消显示主题中的评论数信息。
1. 修复了浏览器后退时仍然显示动画
2. 修复了留言板一周评论排行榜的时间错误
3. 修复了部分服务器的搜索地址错误
4. 修复了links插件的越权问题
5. 修复了后台自定义gravator头像服务器的错误问题
> #### 2017-9-4 更新至3.3.1
1. 修复滚动条丢失问题
2. 修复某些情况下出现views字段无法创建问题
3. **修复某些服务器的时间问题，时光机和评论的时间不正确**
4. 修复某些情况下出现warning和notice提示问题
5. **修复头图逻辑问题**
6. video样式一开始必须去掉控制条
7. 删掉了多余了`test.js`
8. 默认关闭了ajax评论
9. 修复评论在某些情况下出现的错误
10. **侧边栏不显示隐藏文章和加密文章**
11. 修复某个风格的左侧边栏有竖线（css问题）
12. 修复后台的镜像加速问题
> #### 2017-8-24 更新至3.3.0
1. **搜索添加pjax**
2. 登录退出添加pjax
3. 加密文章输入密码提交添加pjax
4. **添加了HTML5 video标签的样式**
5. 添加了时光机插入视频的功能
6. **增加了文章作者在评论中的标识**
7. 留言板排名增加了一周评论排行榜
8. 增加了回复隐藏的功能`[hide]隐藏内容[/hide]`
9. **增加了后台选择是否裁剪头图的开关**
10. 增加了畅言和其他第三方评论的支持，后台填写两个参数即可使用畅言
11. 后台增加了是否暴露登录注册地址的开关
12. 增加了QQ邮箱显示QQ头像的功能（后台外观设置中有开关）
13. typecho分页时候标题显示`第X页`，优化SEO
14. **支持sqlite、Pgsql 数据库**
15. 对于高度很大的图片可以使用max属性，折叠图片
16. 缩小版头图优化样式
17. 加密文章样式优化
18. 全面多语言化主题中的中文，包括所有的提示语句
19. 改进了提示信息泡的样式和动画效果
20. 重写延迟加载部分代码
21. 将部分由js控制样式改为直接由css控制，加载速度更快
22. 重构了主题部分代码，优化细节部分
23. **修正点击首页说说链接未兼容伪静态**
24. **修复了侧边栏在固定+折叠时候无法展开的bug**（这个陈年老bug终于修好了！）
25. 修复了侧边栏的最新评论中如果评论为空导致的样式错误
26. 修复了时光机中没有说说的时候首页输出网址的bug
27. 修复了分类页面标题和首页文章标题统一，只显示一行
28. **修复开启平滑滚动出现的页面错乱问题**
> #### 2017-7-26 更新至3.2.0
1. **增加小版图的缩略图显示方式（在后台`外观设置—>外观设置开关 `开启）**
2. **增加了原来的缩略图显示方式自动固定大小的功能**
3. **增加了ajax评论的更好的体验（实验性功能，需要手动在`后台外观设置—>增强功能开关` 开启）**
4. 增加了增加平滑滚动功能（后续会优化此体验）
5. 增加了左侧和顶部自定义栏目可选择是否新窗口打开（target字段，具体见使用文档更新）
6. 增加使用文档可以全局搜索的功能（ctrl+F5 获取最新版本）
7. 增加音乐解析功能（获取网易云永久链接）
8. 优化了评论区域的超链接样式以及增加评论区域图片的灯箱效果
9. 优化评论区关闭时候的样式
10. 优化了小板式缩略图显示样式
11. 优化了缩略图显示方式
12. 优化手机端标题显示
13. 优化了首页名称太长导致的换行问题
14. 优化了首页文章标题换行问题
15. ajax评论兼容反垃圾插件
16. ajax评论的@回复优化
17. 优化了其他细节
18. 修复了部分语言未翻译
19. 修复了打赏图标的错误
20. **修复了首页名称的显示规则（顶部导航栏显示【首页名称】，头像名称下面显示【博主名称】，右侧名称显示为【博客标题】）**
21. 修复了手机端文章顶部信息样式错误问题
22. 修复了音乐播放器未点击播放加载第一首歌曲资源
23. 修复了部分服务器中 文章时间显示时差问题
24. 修复了缩略图显示bug（当关闭显示头图开关，thumb填写图片地址，不能够显示头图的问题）
25. 修复非伪静态站点搜索框出现404错误
26. 修复分享到QQ空间地址错误问题
> #### 2017-5-30 更新至3.1.0
1. 增加打赏按钮
2. 修改404页面图标问题和注册链接错误问题
3. 修正由于网易云删除api导致歌单解析错误的问题
4. 修正主题增强包问题
5. 调整点击链接后的返回顶部的动画
6. 修改表格样式自适应样式
7. 修改某处翻译
8. 修改thumb逻辑,增加了显示顺序：thumb自定义字段——随机图片
9. 增加了时间格式为xx天前（开启方法）
10. 增加页脚文章tag 和著作权所有的文字
11. 修改了后缀显示的方式（不填写则不显示后缀）
12. 优化顶部首页一行文字介绍的字体
13. 可以选择是否加载字体
14. 可以选择是否启用pjax
15. 公告信息添加了小图标
16. 修改一天24小时的温馨提醒
17. 时光机的联系方式和社会化图标可以自定义
18. 灯箱添加了黑名单机制(添加nogallery属性)
19. 点击链接时优化上下滚动的动画
20. 修复灯箱下的a链接的黑色下划线
> #### 2017-5-20 更新至3.0.0
1. 优化了播放器显示界面，增加显示歌名与作者
2. 优化了pjax加载的动画，删除了原来枯燥的进度条
3. 重新定义了主题的web图标，可以使用的图标资源大大增加
4. 左侧侧边栏可以简单自定义项目了
5. 顶部导航栏可以简单自定义图标了
6. 增加提供主题增强包：网易云音乐歌单页面和画廊
7. 重构主题部分代码
8. 优化主题细节部分，更快更快更快
9. 给静态资源增加版本号，防止缓存带来的问题
> #### 2017-5-11 更新至2.2.1
1. 彻底更新了多语言支持功能。默认根据浏览器语言设置自动切换，也可以在后台手动切换。用户可以自定义自己的语言包，原则上，模板的每一处文字，都可以简单通过语言包自定义
2. 增加网易云音乐解析，后台一键解析音乐链接，再也不用烦恼用什么链接了！
3. 增加后台在线检查更新功能。主题有更新，打开后台就能快速看到，再也不用担心错误更新了~
4. 增加公告栏目 ，重要的事情通知访客，就这么简单
5. 增加主题透明度选项。背景是图片？后台设置一个数字，即可完成透明度更高
6. 增加分享文章功能。文章想分享给好朋友一起看？没问题！
7. 增加dns预解析功能，你的网站加载更快！
8. 重写了大部分的主题代码。主题第一次发布的日期是16年的12月份，那时候对代码规范性意识很弱。这次，重构了很多代码，当然还有其他部分代码重构会在下次更新完成。
9. fix #46 fix #47 修复时光机页面显示时间过长导致样式错乱
> #### 2017-3-23 更新至2.1.2
1. 增加了效果非常好看的灯箱效果
2. 增加了短代码的功能，加强文章文字效果
3. 后台集成支持七牛云镜像加速功能
4. 增加了豆瓣书单的自定义模板，用户在创建该独立页面的时候，自定义字段名称为：doubanID，值为你的豆瓣ID
5. 增加了后台自定义添加js和css的位置
6. 增加了tooltip.js 功能，在一些链接上悬浮会有小提示泡的样式。
7. 适配了为开启伪静态导致的404问题
8. 修复了含www和不含www域名下的跨域问题导致页面资源调用失败问题。
9. 不再使用TePostViews插件！！！只使用links插件，links插件有修改！！！请务必更新插件
10. 调整了js顺序，加快网页的渲染，尤其针对Firefox滚动做了优化 fix #35
11. 优化一系列细节部分，修复一些bug fix #24
12. 重写了部分函数，优化逻辑
13. 删除了节日祝贺的后台功能和一些不必要的代码
> #### 2017-1-24 更新至2.0.0
1. 增加了文章目录树（仅在电脑端显示）
2. 增加了lang属性,优化SEO
3. 修复由于预加载导致的MathJax失效问题
4. 优化了文章页面内的链接样式
5. 优化了文章内的图片样式
6. 添加 I18n 支持（支持三种语言：中文简体、繁体与英语）
7. 添加了评论框处了[表情]功能
8. 增加图片延迟加载效果
9. 增加了节日祝贺的功能
10. 增加 已经评论过的游客的效果
11. 增加了返回顶部功能
12. 修复一系列bug
13. 后台功能完善
> #### 2016-12-27 更新至 1.6.0
老用户更新时，请查看插件文件夹，不再使BufannaoCms插件，换成更加轻巧的针对handsome主题优化的TePostViews插件（7kb）！
1. 增加了播放器！！试试吧！
2. 评论实现了无限嵌套哦！而且修复了锚点链接的定位偏差
3. 登录的按钮也有登录中的效果了！
4. 对于iconfont图标重新选择，更加美观了！
5. 还有一些小的细节变动，自己发现吧~~
6. 一些bug修复~
> #### 2016-12-20 更新至 1.5.0
1. 文章页面的自定义字段thumb值为no，则不输出当前文章头图（新功能！）
2. 修复了几个样式错误
3. 增加后台设置 安卓chrome浏览器地址栏颜色
4. 增加 左侧边栏的点击名称后的选项卡的内容
> #### 2016-12-19 更新至 1.4.0
1. 评论提交按钮点击更好看的效果啦~（我超喜欢这个效果）
2. 新的友情链接页面写出来啦~这个是不是好看一点了呢？
3. 博文头图的显示方式后台有三种方式了哦！
4. 后台还加了一些小的设置，更方面大家个性化修改了：比如填写备案号、更改加载条的颜色、填写instantclick回调函数和时光机页面的头图
5. 修复了一些bug
6. 优化了一些样式
> #### 2016-12-10 更新至 1.3.0
1. 后台增加“折叠头像”功能
2. 后台增加“自定义gravatar CDN地址”功能
3. 后台增加“自定义缩略图个数”个数
4. “时光机”页面增加了“添加图片”小功能
> #### 2016-12-07 更新至 1.2.0
1. 修复若干instantclick带来的bug
2. 更新了404页面
3. 后台增加了instantclick的预加载方式选择
4. 管理员登陆后前台有可编辑的按钮，方便进入后台编辑当前文章

27
docs/comment.md
Unescape View File

@ -1,27 +0,0 @@
主题内置typecho原生评论系统，同样支持任何第三方评论服务（如：多说，disqus，畅言等）。
## 使用原生评论系统
你可以通过后台外观设置中这些开关来加强原生评论系统：
* 评论系统——原生评论框的背景图片 设置评论框的背景图片
* 评论系统——默认评论者头像 设置默认的gravatar头像
* 主题增强功能——启用ajax评论 获取无刷新评论体验
Q：如何更好的防止垃圾评论？</br>
A：推荐[SmartSpam](/typecho)
</p>
## 使用畅言
在后台外观设置——评论设置 选择 `畅言`，填写畅言appid和填写畅言conf参数。
## 使用其他第三方评论系统
在后台外观设置——评论设置 选择 `其他第三方评论系统`。
找到主题目录下的`usr/third_party_comments.php`，增加第三方评论系统的代码。（不推荐，第三方评论不仅不稳定，而且不一定与主题的pjax兼容，如果不兼容，请在后台外观设置中关闭pjax！）

144
docs/common-problem.md
Unescape View File

@ -1,144 +0,0 @@
#### 安装完主题后，页面中间部分空白/安装后首页报错
* 依次检查主题文件夹名称是否为`handsome`
* **是否已经安装并且启用主题必要的插件links**
* **php版本5.4+，必须安装mbstring 扩展**，否则无法使用（正确检查方式是在你的服务器新建一个`test.php`，然后复制粘贴该代码`<?php phpinfo(); ?>`，最后在浏览器访问该文件可以查看服务器的php信息）
* 初次使用主题必须保证博客有一篇文章，如果一篇文章都没有的话会导致向数据库中添加view（浏览次数字段）失败
* PostgreSql 数据库安装links插件时，需要手动新建`typechos_links`表。（会在下一个版本修复）
#### 点击首页头像，显示404页面
* 需要新建“时光机”独立页面，具体方法见[独立页面](/page?id=时光机)
#### 主题内的博客头像怎么设置
* 主题头像需要设置两处：
* 主题外观设置——初级设置——头像设置：现在在首页的左侧边栏中
* gravatar（全球通用头像），打开后台——控制台——个人设置，点击左侧的头像，去该网站使用**你在个人设置里填写的电子邮箱地址**注册账号，并上传头像，typecho的头像会自动更新：会显示在`时光机`、`评论`、`右上角顶部`的头像处。
#### links插件无法启用，显示500错误
* 更新主题包中最新版本的links插件`1.1.2`
* 一般是由于你的`usr/plugin`没有足够的权限导致的。
如果是Linux服务器尝试，在typecho的usr目录下输入此命令：
```bash
sudo chmod -R 777 plugin
```
如果仍有问题，请联系我
#### 友链设置后前台不输出内容（使用无效）
* links插件需要填写`链接分类`来判断输出的位置，请详细阅读[友链设置文档](./plugin)
#### 无法评论，提示输入内容不符合规则
请依次检查以下内容：
* cdn缓存静态缓存了HTML页面，导致评论功能失败（cdn缓存建议只缓存静态资源文件，如css js image）
* 使用了服务器缓存功能
* 使用了数据库缓存插件
* 使用了页面代码压缩的插件
* 当你作为游客身份评论时，你的邮箱地址不能和后台已有用户的邮箱地址重复
如仍有问题，请联系我。
#### typecho1.1版本编辑器无法解析HTML代码
* typecho 1.0正式版本原生markdown解析器非常弱，可以解析HTML，但是无法解析表格。可以配合以下插件使用[typecho-plugin-Parsedown](https://github.com/kokororin/typecho-plugin-Parsedown) 或者 [typecho-markdown](https://github.com/mrgeneralgoo/typecho-markdown)(包含更多markdown语法)
!> 插件安装后请注意文件夹命名要求。安装插件后，无需任何设置，自动替换前台文章解析，支持解析表格和HTML代码。
* typecho 1.1正式版本原生markdown解析器不支持解析HTML代码，必须使用特权模式才可以解析HTML代码，示例如下：
```html
!!!
// 你的HTML代码
!!!
```
* 使用typecho开发版本（比1.1正式版本更高的版本）[下载开发版本](http://typecho.org/download)
#### 全局音乐播放器一直在加载无法播放
* PHP必须满足 PHP>=5.4
* 某些国外服务器无法云解析，请使用手动添加歌曲功能
* 服务器需要安装curl 扩展，请勿禁用`curl_exec`函数，并且curl扩展需要支持https
* 网易云会时常封禁cookie，导致解析失败，请打开主题目录下面的`libs/Get.php` 根据注释要求修改`$netease_cookie`变量。（一般有问题的话，我会在群内通知的）或者换用QQ音乐或者其他平台
* QQ音乐歌单请勿设置为私密歌单，否则无法解析
如果仍有问题，请联系我。
#### 评论区不能斗图不能显示图片 | 说说不能显示图片/音乐播放器/视频播放器
* 后台 `设置——评论——允许使用的HTML标签和属性` 里面添加html标签
```html
<img src="">
<audio class="" src="" preload>
<video src=""></video>
```
#### 评论区无法使用markdown语法
* 后台 `设置——评论——在评论中使用Markdown语法(选中)`
后台 `设置——评论——允许使用的HTML标签和属性` 里面添加markdown语法对应的html标签
```html
<blockquote><pre><code><strong><em><h5><h6><a href title><table><thead><tr><th><tbody><td>
```
#### 使用EditorMD前台文章首次不加载，刷新一次才能加载
* 主题pjax与EditorMD的前台解析js有冲突，在该插件的设置界面，将`接管前台Markdown解析并启用ToC、TeX科学公式、流程图 Flowchart、时序图 Sequence Diagram 等扩展`
选择否即可。
#### 启用插件总是显示500错误
有些插件必须修改插件的文件夹为指定的名称才能正常使用，一般插件的说明都会有提到修改插件的文件夹名称，请留意。
#### Aplayer 无法正常使用
主题内置支持云解析的文章播放器，详见[文章内插入音乐](https://handsome.ihewro.com/#/functions?id=%E6%96%87%E7%AB%A0%E5%86%85%E6%8F%92%E5%85%A5%E9%9F%B3%E4%B9%90)
如果你仍然喜欢Aplayer插件，你可以使用`MoePlayer` 作者开发的[APlayer-Typecho](https://github.com/MoePlayer/APlayer-Typecho)版本的插件，
然后在`主题的外观设置`——`pjax`——`回调函数`中填写即可：
```JavaScript
if (typeof aplayers !== 'undefined'){
for (var i = 0; i < aplayers.length; i++) {
try {aplayers[i].destroy()} catch(e){}
}
}
loadMeting();
```
#### 文章首页分页数目怎么修改？/我想修改每页显示6篇文章？
在typecho的`后台——设置——阅读——每页文章数目`，修改该值即可。如果你使用头图随机缩略图的话，请保证你的主题文件夹下的`usr/sj/`随机图片数目大于每页文章数目。
#### 主题出现了问题，样式错误？无法点击？
* 配置出现了问题，切换到别的主题，然后再切换回来，这一过程会清空之前的所有配置，请提前备份。
* 修改了源代码导致了问题。删除以前的旧主题文件，然后上传新的主题文件夹
* qq上给我留言
#### 搜索框搜索提示有内容，但是最终的页面没有显示结果？
* typecho bug，详见[issue#705](https://github.com/typecho/typecho/issues/705)
* 打开 typecho 目录下面的 `var/Widget/Archive.php`文件
* 搜索`$keywords = $this->request->filter('url', 'search')->keywords;`
替换成`$keywords = $this->request->keywords;`
#### Dplayer-Typecho不能显示弹幕
* [修复官方Dplayer-Typecho插件不能连接弹幕API后端的方法](https://www.moerats.com/archives/856/#comments)

15
docs/copyright.md
Unescape View File

@ -1,15 +0,0 @@
1. 主题后台界面风格来自material主题
2. 主题function.php部分代码来自 qqdie设计的主题
3. 感谢 links插件作者 寒泥
4. 主题cross自定义模板代码来自 breeze主题by闪闪的星
5. 主题内置的播放器代码修改自youduBGM
6. 短代码css样式来自DNSHH主题
7. 主题基于 [Flatkit](https://themeforest.net/item/flatkit-app-ui-kit/13231484?s_rank=4) 框架 和[Angulr](https://themeforest.net/item/angulr-bootstrap-admin-web-app-with-angularjs/8437259?s_rank=7) 后台框架制作而成。
8. 主题多语言包功能核心代码来着hran的[mirages](https://hran.me/archives/mirages-intro.html)主题
9. 网易云音乐歌单展示页面由biji.io提供
10. 评论表情功能引用项目[owo](https://github.com/DIYgod/OwO)
感谢所有提出建设性建议的小伙伴们！
感谢本项目引用的项目作者的贡献！
如果遗漏申明或者版权问题，请及时联系作者，感谢！

17
docs/customEdit.md
Unescape View File

@ -1,17 +0,0 @@
以下模块由勤劳的使用者提供的关于handsome主题的自定义修改内容，你可以应用到自己的主题中来。
!> 欢迎投稿，感谢！
* [本博客基于Handsome主题的一些小修改教程](https://www.moerats.com/archives/628/)
* [这篇文章主要是typecho下的彩色标签云实现方式](https://ixiyu.me/archives/typecho-colorful-tag.html)
* [一个追番列表独立页模板](https://imalan.cn/archives/88/)
* [把可爱的 Pio 捉到博客上吧！](https://imalan.cn/archives/95/)
* [[Typecho] 在主题与 EditorMD 前台解析冲突的情况下使用其样式](https://lolico.moe/modification/typecho-editormd-solution.html)
* [ColorHighlight插件实现Mac风格代码高亮](https://www.xcnte.com/archives/377/)

129
docs/customize.md
Unescape View File

@ -1,129 +0,0 @@
主题外观设置中提供了非常简单的自定义设置，无需修改主题源码即可配置以下自定义栏目。
配置中可以实现两个功能，一种是 **添加自定义栏目/按钮**，另一种是**隐藏主题默认栏目/按钮**。
```
1. 左侧导航栏目
2. 顶部导航按钮
3. 时光机的社会化图标
4. 时光机的联系方式内容
```
![customize](https://ihewrocdn.b0.upaiyun.com/img/customise.png)
<p class="warn">下面配置中所有的可用网页图标列表，参考[图标列表](/icons)</p>
## 左侧边栏导航
**添加自定义栏目：**
* `name`：代表显示栏目/按钮的名称
* `class`：表示栏目/按钮的网页图标的样式
* `link`：代表栏目/按钮的链接
* `target`（可选）: 代表定在何处打开链接文档，如`_blank`:浏览器总在一个新打开、未命名的窗口中载入目标文档。`_self`:代表在当前窗口打开。不填则为：`_blank`。[更多介绍](http://www.w3school.com.cn/tags/att_a_target.asp)
```json
{"name":"音乐","class":"glyphicon glyphicon-music","link":"xxx.com"},
{"name":"笔记","class":"glyphicon glyphicon-book","link":"xxx.com"},
{"name":"相册","class":"fontello fontello-picture","link":"xxx.com","target":"_self"}
```
!> **每两项之间，用英文逗号(,)隔开，最后一项请勿加上逗号。**
!> 检查配置语法是否正确的方法：将配置内容复制到[json校验](https://www.json.cn/) 网站中，可以检查你的填写配置语法是否正确。
!> 不显示图标，原因可能是**语法错误**或者**图标根本就不在[图标列表](/icons)中**，只能使用[图标列表](/icons)中的图标。
!> 如果想要链接ajax（无刷新）的点击效果，确保你的链接是绝对地址（浏览器地址栏什么样的就是怎么填）而且是本站地址，并且`target`属性为`_self`。
**隐藏默认栏目：**
左侧边栏目默认加载**首页**按钮。隐藏方法：
```json
{"name":"home","status":"hide"}
```
## 顶部导航栏目
**添加自定义栏目：**
与`左侧边栏导航`配置的书写规则完全相同：
```json
{"name":"音乐","class":"fa fa-music","link":"xxx.com"},
{"name":"相册","class":"fontello fontello-picture","link":"xxx.com","target":"_self"}
```
!> **每两项之间，用英文逗号(,)隔开，最后一项请勿加上逗号。**
!> 检查配置语法是否正确的方法：将配置内容复制到[json校验](https://www.json.cn/) 网站中，可以检查你的填写配置语法是否正确。
!> 不显示图标，原因可能是**语法错误**或者**图标根本就不在[图标列表](/icons)中**，只能使用[图标列表](/icons)中的图标。
!> 如果想要链接ajax（无刷新）的点击效果，确保你的链接是绝对地址（浏览器地址栏什么样的就是怎么填）而且是本站地址，并且`target`属性为`_self`。
**隐藏默认栏目：**
顶部导航按钮默认加载**闲言碎语**按钮。隐藏方法：
```json
{"name":"talk","status":"hide"}
```
## 时光机社会化图标
默认已经填入了配置，书写规则和上面基本类似：
* `name`：代表显示按钮的名称
* `class`：表示按钮的网页图标的样式
* `link`：代表按钮的链接
* `status`：当`status`值为`single`时，特指页面中的**绿色文字按钮**，此时无需填写`class`项。
```json
{"name":"twitter","class":"fa fa-twitter","link":"#"},
{"name":"facebook","class":"fa fa-facebook","link":"#"},
{"name":"googlepluse","class":"fa fa-google-plus","link":"#"},
{"name":"github","status":"single","link":"#"}
```
!> 简单配置，只需要修改"value"和"link"的值（修改`#` 那个位置的值，不要修改错位置！！）。高级配置，模仿上面的写法，增加或者删除相应的项目即可。
!> 每两项之间，用英文逗号(,)隔开，**最后一项请勿加上逗号！！**
## 时光机联系方式
默认已经填写email、QQ、微博以及网易云音乐的配置：
* `name`：代表显示栏目的名称
* `img`：表示该联系方式的图标（图片格式）
* `link`：代表联系方式的地址
```json
{"name":"email","img":"https://ww4.sinaimg.cn/large/a15b4afegy1fg2pmtjbaej201s01s0aw","value":"ihewro@163.com","link":"#"},
{"name":"QQ","img":"https://ww4.sinaimg.cn/large/a15b4afegy1fg2pnirhr2j201s01va9u","value":"535425690","link":"#"},
{"name":"微博","img":"https://ww4.sinaimg.cn/large/a15b4afegy1fg2pofbz5fj201s01swe9","value":"@i超级男孩","link":"http://weibo.com/hewro"},
{"name":"网易云音乐","img":"https://ww4.sinaimg.cn/large/a15b4afegy1fg2pouholzj201s01s0ja","value":"@许多年以后我依然是我","link":"http://music.163.com/#/user/home?id=83271175"}
```
!> 简单配置，只需要修改"value"和"link"的值（**修改`#` 那个位置的值，不要修改错位置！！**）。高级配置，模仿上面的写法，增加或者删除相应的项目即可。
!> 每两项之间，用英文逗号(,)隔开，最后一项请勿加上逗号！！

50
docs/emotion.md
Unescape View File

@ -1,50 +0,0 @@
只需要修改主题目录下面的`usr/OwO.json`文件
### 修改表情
主题内置三个栏目`颜文字`和`阿鲁`和`推特`
直接在原有的代码上面做一些修改即可，比如图片替换，文字替换等。（具体代码含义见下面 ）
### 增加新的表情栏目
```json
"新的表情栏目名称": {
"name": "表情包文件夹名称",//只有图片表情类型才需要加这一项
"type": "emoticon/emoji/image",
"container": [
{
"icon": "OωO",
"text": "Author: DIYgod"
},
{
"icon": "OωO",
"text": "Author: DIYgod"
},
]
}
```
**评论表情图片存储在主题目录下的`usr/img/emotion`**
表情名称`name`：
* 该项只有当表情类型为图片表情时候才需要添加
* **name的值对应了emotion文件夹下的表情包文件夹名称。如值为`aru`，文件夹名称对应为`aru`。**
* 建议填写英文
表情类别`type`有三种:
* emoticon: 颜文字
* emoji: emoji表情（比如😊😜😒这些图标，typecho的数据库类型默认不支持emoji编码）
* image: 图片表情，只支持.png 后缀的图片
`container`下存储的是表情的具体内容：
* `icon`：表示的表情具体内容：
* `颜文字`就填具体的颜文字
* `emoji表情`就填具体的emoji图标
* `图片表情`填写对应图片的文件名，如`angry.png`，填`angry`
* `text`:指的是鼠标悬停在表情上面显示的提示文字，一般为中文提示

61
docs/enhancedPackage.md
Unescape View File

@ -1,61 +0,0 @@
其他主题增强包文件在主题文件包中。
主题增强包与主题完全独立，可以不使用。增强包的文件可以上传至服务器的任意位置。
!> v4.2.1 以后的用户不再提供主题增强包，也不再维护以前的主题增强包。v4.3.0 已经内置[相册](/album)功能
### 网易云音乐歌单展示
![netease](https://ihewrocdn.b0.upaiyun.com/img/netease.png)
> 如何修改歌单数据？
打开`player.json`文件，里面填写你的歌单id,可填写多个，播放时会随机选取歌单播放。
```json
[
"93931893",
"722185666"
]
```
直接将整个`music`文件夹上传到你的服务器/主机上面
访问地址即：`./music` （不要加上`index.php`否则访问错误）
!> 最后一个歌单id后不用加上英文逗号（,）
!> 请保证目录下的`play/cache` 缓存目录可写，否则会发生错误
### 画廊相册
![photos](https://ihewrocdn.b0.upaiyun.com/img/photos.png)
> 如何修改照片数据？
图片存储在`user`文件夹下
打开`data.json`文件，模仿下面的格式，添加新的一行即可。
```json
[
{
"link": "./user/1.jpg",
"h2": "大鱼海棠",
"pTag": "大鱼海棠宣传图片"
},
{
"link": "./user/2.jpg",
"h2": "童年时光",
"pTag": "童年时光"
}
]
```
访问地址即`./album/index.php`
【注意】：最后一个图片信息块后不用加上英文逗号（,）

5
docs/feedback.md
Unescape View File

@ -1,5 +0,0 @@
你可以通过以下方式反馈问题：
* [邮件交流：ihewro#163.com](mailto:ihewro@163.com)
* [QQ:535425690](http://wpa.qq.com/msgrd?v=3&uin=535425690&site=qq&menu=yes)
* [购买主题，加入主题收费群](https://www.ihewro.com/archives/489/#主题售价)

371
docs/functions.md
Unescape View File

@ -1,371 +0,0 @@
#### 博文头图
![headerpic](https://ihewrocdn.b0.upaiyun.com/img/headerpic.png)
分为两种：
* 首页头图：首页每篇文章顶部的图片
* 文章头图：每篇文章详情页面顶部的图片
具体见上图指示。
在后台的外观设置中可以对这两部分进行个性化设置：
> **个性化首页头图样式：**
* 大版式头图
* 小版式头图
在后台`外观设置——外观设置开关`中选择。缩小版头图显示即所有文章默认显示小版式头图。
每篇文章的编辑页面都可以选择首页头图样式，这里的设置会无视掉上面设置中的效果（仅对该篇文章有效），这样就实现大版式和小版式头图交叉的效果。
> **个性化头图来源：**
在后台`主题增强功能——博客头图来源设置`中选择。提供四种方式：
* 只显示随机图片
* 显示顺序：thumb自定义字段——文章第一个附件——文章第一张图片
* 显示顺序：thumb自定义字段——文章第一个附件——文章第一张图片——随机图片(推荐)
* 显示顺序：thumb自定义字段——随机图片
以第三种为例，当thumb字段为空的时候，会寻找文章的第一个附件，附件不是图片，会继续寻找文章中第一张图片，文章中如果没有图片的话再去加载随机图片。
其他选项亦是同理。
!> 文章的随机头图的图片存放位置为： 主题目录下的`usr/img/sj`</br>
左侧边栏的随机图片的存放位置为：`usr/img/sj2`
> **个性化头图显示：**
* 不显示文章页面头图
* 不显示首页头图
在后台`外观设置——外观设置开关`选择文章页面不显示头图或首页不显示头图，将会默认不显示文章页面或者首页文章顶部的头图。
每篇文章的编辑页面底部的自定义字段中，字段名为`thumb`,当值为`no`的时候，会不显示当前文章的头图（首页头图和文章头图）（仅对当前文章有效）,这里的设置同样会无视上面的设置。
#### 灯箱插件
文章中如果某个图片不想显示灯箱效果，可以给图片标签中加入`nogallery`属性：
```html
<img nogallery src="">
```
**如果某张图片高度很大，想折叠展示，可以给图片标签加入`max`属性：**
```html
<img max src="">
```
![](https://ws4.sinaimg.cn/large/006tNc79ly1g01rzaa2cmj310k0jygoz.jpg)
#### DNS预解析
!> 这个功能即将被删除
DNS prefetching通过指定具体的URL来告知客户端未来会用到相关的资源，告诉客户端可以尽早的解析DNS。
更多详细信息，[请戳这个](https://www.linpx.com/p/small-practice-of-prefetching-dns.html)
#### 文章目录树
文章中的目录树已经内置代码，**仅当文章有h2 h3 h4标题** 才会生成目录树，并且手机端不显示目录树。
**注意**：如果文章中没有`h2`标题，只有`h3 h4`标题是不会生成目录树的。
#### 侧边栏的标签云
需要在新建文章的页面右侧填写标签，才会在首页侧边栏输出的。(回车添加当前标签)
![tagcloud](https://ihewrocdn.b0.upaiyun.com/img/tag.png)
#### 自定义摘要字数
大版式头图默认摘要字数200字，小版式头图默认摘要字数80字。你可以在`后台外观设置->自定义大版式头图摘要/自定义小版式头图摘要`来改变这两个默认值。
你还可以使用`摘要分隔符`进行自主截断内容输出，**但是自主生成的摘要不会超过默认摘要字数**。
举例：你的默认摘要字数设置为200字，使用`摘要分隔符`截断的摘要为230字，则摘要只会显示200字。
```markdown
<!--more-->
```
#### 添加自定义图标
主题已经内置的图标列表，详见[图标列表](https://handsome.ihewro.com/#/icons)
如果不能满足你的图标需求，可以使用以下方法扩充主题图标：
##### 方法一：傻瓜式扩充fontawesome图标
直接引入全套的fontawesome图标：
在主题外观设置——开发者设置——自定义输出head 头部的HTML代码，填入：
```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支持以下类型的按钮：
* 矩形文字按钮
* 椭圆形文字按钮
* 矩形图标文字按钮
```html
[button]矩形按钮文字[/button]
[button color="succees"]矩形按钮文字[/button]
[button type="round" color="success"]椭圆形按钮文字[/button]
[button color="success" icon="glyphicon glyphicon-eur"]图标按钮文字[/button]
```
* `type`：选填，不填默认为矩形按钮。可选值：
* `round`：椭圆形按钮
* `color`： 选填，不填默认为success（绿色），可选值：
* `light`：白色
* `info`：蓝色
* `dark`：深色
* `success`：绿色
* `black`：黑色
* `warning`：黄色
* `primary`：紫色
* `danger`：红色
* `icon`：选填，不填默认为文字按钮，可用按钮见[图标列表](./icons)
* `url`:选填，填写点击的链接。举例：如果你的链接是`http://www.baidu.com`，请手动将`/`前面加一个反斜杆`\`，即`http:\/\/www.baidu.com`
举例：
```html
[button color="danger" icon="fontello fontello-gratipay" url="http:\/\/wpa.qq.com\/msgrd?v=3&uin=535425690&site=qq&menu=yes"]点击QQ咨询购买（√推荐）[/button]
[button color="success" icon="glyphicon glyphicon-send" url="mailto:ihewro@163.com"]ihewro#163.com[/button]
```
#### 文章内插入音乐
**点击编辑器的插入音乐图标**可以在文章内可以插入音乐歌曲地址，支持云解析和本地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" size="large" /]
```
?> 文章页面插入播放器`size`默认为`large`时光机插入播放器`size`默认为`small`</br>你也可以手动改动这个标签的内容以选择不同的播放器样式:)
#### 文章内插入视频
**点击编辑器的插入音乐图标**可以插入视频，只支持本地的视频地址的播放
**时光机的视频插入按钮也是同样的操作**
直接在输入框中输入视频的地址即可，一般以`.mp4`结尾的资源地址。
示例：
```html
[vplayer url="http://xxx.com/xxx.mp4" pic="http://xxx.com/xxx.png"]
```
* `url`：视频地址
* `pic`：视频背景图片
#### 文章内调用其他文章
**点击编辑器的调用文章的按钮**可以调用其他文章并显示。
![](https://ws2.sinaimg.cn/large/006tNc79ly1g01rxlwb8aj30ze0l8q3z.jpg)
```markdown
[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`：可选项，调用文章显示的封面，如果不填则默认显示随机缩略图。
#### 文章内调用外链网站
!> v5.0及其以上版本支持调用外链
![](https://ws2.sinaimg.cn/large/006tNc79ly1g01ry4640lj30vi0a2jrq.jpg)
```
[post url="https:\/\/www.ihewro.com" title="友人C" intro="一个个人博客" cover="http://www.ihewro.com/img/xxx.jpg" /]
```
* `title`：必填，外链的名称/标题
* `url`：必填，外链的地址（请填写绝对地址，就是浏览器地址栏什么样的就填什么样的）
* `intro`：（可选）外链网站的简介/介绍
* `cover`：（选填）外链网站的介绍图片地址
#### 文章内插入相册
!> v5.1 版本及其以上支持
![](https://ws2.sinaimg.cn/large/006tNc79ly1g01rx4vn36j30pe0dmdgm.jpg)
**使用方法：**
```
[album](插入图片，支持图片的HTML格式或者是markdown语法都可以，支持外链或者附件上传均可)[/album]
```
**举例：**
```
//方式1（markdown语法）
[album]
![图片描述1][1]
![图片描述2][2]
[/album]
[1]: http://xxx.com/xxx1.jpg
[2]: http://xxx.com/xxx2.jpg
//方式2（markdown语法）
[album]
![图片描述1](http://xxx.com/xxx1.jpg)
![图片描述2](http://xxx.com/xxx2.jpg)
[/album]
//方式3（HTML语法）
[album]
<img src="http://xxx.com/xxx1.jpg" alt="图片描述1" />
<img src="http://xxx.com/xxx2.jpg" alt="图片描述2" />
[/album]
```
**相关问题：[typecho1.1版本编辑器无法解析HTML代码](./common-problem?id=typecho11版本编辑器无法解析html代码)**
#### 文章中使用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} \\)
```
#### 文章内部分隐藏回复可见
在文章使用使用
```html
[hide][/hide]
```
标签包裹住你想要隐藏的内容，游客必须先回复后才能查看隐藏内容。
## 文章内部分内容登录可见
为什么增加这样的功能呢？因为有时候一篇文章并不想完全的加密，部分内容由于隐私问题需要加密。该部分内容仅登录用户（如果是个人博客就是仅博主）可见。
在文章中使用
```html
[login]需要加密的内容[/login]
```
#### 文章中插入短代码高亮文本
```markdown
[scode type="share"]这是灰色的短代码框，常用来引用资料什么的[/scode]
[scode type="yellow"]这是黄色的短代码框，常用来做提示，引起读者注意。[/scode]
[scode type="red"]这是红色的短代码框，用于严重警告什么的。[/scode]
[scode type="lblue"]这是浅蓝色的短代码框，用于显示一些信息。[/scode]
[scode type="green"]这是绿色的短代码框，显示一些推荐信息。[/scode]
```
![](https://ws2.sinaimg.cn/large/006tNc79ly1foutefje7wj30os0g0dgc.jpg)
#### 文章中插入收缩框
示例代码：
```
[collapse title="标题" status="false"]一些文字内容[/collapse]
[collapse title="标题"]一些文字内容[/collapse]
```
其中`status`为`false` 表示默认不显示文字内容，为`true`表示默认显示内容。
不写`status` 属性，默认是展开内容的。
#### 文章内插入图集
示例代码：
```
[alubm]
[普通的图片插入，支持markdown语法和html语法，混合也可以]
[/album]
```
#### 博客时间友好格式化
> **使用效果**
```html
几小时前
几天前
几月前
几年前
```
当时间不是整小时/天/月/年 时会显示默认的时间格式
> **开启方法**
后台选择`设置——评论——评论日期格式` 内填写`natural`。
**在这里同样可以修改博客的时间格式为你需要的时间格式，值为标准的php格式。**
如标准时间格式：`Y-n-j H:i:s`

15
docs/home.md
Unescape View File

@ -1,15 +0,0 @@
# handsome
> 如少年般，迎风而立
[在线预览 Preview ](https://www.ihewro.com/archives/489/) | [使用文档](https://handsome.ihewro.com/)
![handsome](https://ww2.sinaimg.cn/large/a15b4afegy1feyoyrzlhtj20rs0e40um)
## [开发日志 Changelog](/changelog)
<p style="float: right;">Hosted by <a href="https://pages.coding.me" style="font-weight: bold">Coding Pages</a></p>

124
docs/i18n.md
Unescape View File

@ -1,124 +0,0 @@
主题内置了多语言包，默认选择根据浏览器自动选择语言，后台外观设置可以手动修改语言。
多语言分为两部分：
* 主题默认集成多语言文件（在主题的根目录的`lang`文件夹下）
* 用户自定义语言文件（在主题的根目录`usr/lang`文件夹下）
用户自定义语言文件优先级最高，**请勿修改默认翻译文件**（`lang/`目录下面的语言文件），只要修改`usr/lang`下的语言文件即可。
<p class="warn">通过修改相应的语言文件，可以更改主题里面**任何词组**和**时间格式**。在本文最后会举几个例子方便大家自行修改。</p>
### 语言显示规则
![](https://ws1.sinaimg.cn/large/006tNc79ly1fjhqfsjzg3j31kw084t9u.jpg)
* `Auto` ：自动根据用户浏览器的语言设置显示相应的语言文件。
* `简体中文` ：显示顺序依次是：usr/lang/zh_CN.php —> lang/zh_CN.php，其他的语言文件（如zh_TW.php）则不会生效。其他语言设置同理。
### 修改主题默认翻译
以语言设置中选择了使用**简体中文**为例
**比如：**文章页面的「浏览次数」默认显示为「200次浏览」，希望改成「200次小伙伴来过」
在`usr/lang/zh_CN.php`修改如下：
```php
/**
* @return array 返回包含翻译文本的数组
*/
public function translated() {
return array(
'次浏览' => '次小伙伴来过'
//添加翻译的词汇,每两组之间，用英文逗号隔开
);
}
```
<p class="tip">注意，语言文件的翻译，是针对**已存在的词组**进行重新翻译，**而不是对任意汉字或不存在的词组翻译**。打开`lang/zh_TW.php` 可以看到所有可以翻译的词组。（目前所有翻译词组没有分类，有些凌乱，v4.0.0会进行整理）</p>
**再比如：**文章顶部的「最后修改时间的时间格式」，默认为：「Y 年 m 月 d 日 h : i A」，想要修改为24进制时间
在相应的语言文件的翻译函数里面增加：
```
'Y 年 m 月 d 日 h : i A' => 'Y 年 m 月 d 日 G : i "
```
修改其他语言同上所述，是完全一样的。
### 增加自定义语言文件
主题默认集成了中文简体、中文繁体、英语三种语言设置。
首先需要了解**多语言文件的命名规则：**
**多语言文件名称 = `Locale Code + .php`**。如 `zh_CN.php`和`en.php`
一些常见语言的Local Code：
```
zh_CN: 中文简体
zh_HK: 中文繁体，港澳
zh_TW: 中文繁体，台湾
en : 英语
en_US: 英语，美式
en_CA: 英语，加拿大
en_AU: 英语，澳洲
ja : 日语
ko : 韩语
```
如果你想再增加一份新的语言文件，比如 日语
首先在`usr/lang`目录下创建语言文件：`ja.php`
文件初始化内容如下：
```php
<?php
if (!defined('__TYPECHO_ROOT_DIR__')) exit;
/**
* ja.php
* Author : Your name
* Date :
* Version :
* Description:
*/
class Usr_Lang_ja extends Lang {
/**
* @return string 返回语言名称
*/
public function name() {
return "日语";
}
/**
* @return array 返回包含翻译文本的数组
*/
public function translated() {
return array(
'首页' => '家',
'分类' => '分類'
);
}
public function dateFormat() {
return "月のM Y D日";
}
}
```
在文件中的`translated`函数里面，按照格式填写翻译内容即可。
最后在后台语言设置中选择`日语`即可。
<p class="warn">自己创建的语言文件中，需要对所有的**已存在的词组进行翻译**，否则将默认返回简体中文默认的词组。这项工作量要远远大于修改主题默认翻译。</p>

59
docs/icons.md
Unescape View File

@ -1,59 +0,0 @@
主题内置了大量的网页图标 (非图片格式)，方便在 [自定义栏目](/customize)中使用。
## 可用图标
!> handsome v4.3.1 由原来的`fa fa-` 修改为`fontello fontello-`，是为了避免与fontawesome库冲突，你可以自行引入该图标库，以便使用更多图标，但是会带来一定的加载体积。[引入更多图标](https://handsome.ihewro.com/#/functions?id=%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%AE%9A%E4%B9%89%E5%9B%BE%E6%A0%87)
**1. 主题内置的iconfont图标：**
![](https://ws4.sinaimg.cn/large/006tNc79ly1ftr34y793vj31gc0vc75i.jpg)
**2. 主题内置的fontello图标：**
![](https://ws2.sinaimg.cn/large/006tNc79ly1ftr336pqdnj31kw0jlaca.jpg)
**3. bootcss自带的Glyphicons字体图标：** 详细见[Glyphicons 字体图标](http://v3.bootcss.com/components/#glyphicons)
?> 第一项和第二项的图标很少，如果找不到相应图标，建议在第三项的图标库中寻找
## 使用方法
举个例子：
```html
<!--首页名称左侧的图标设置项，直接填写class的内容即可，如：-->
<!--iconfont图标-->
iconfont icon-xxx
<!--Glyphicons图标-->
glyphicon glyphicon-eur
<!--fontello图标-->
fontello fontello-xxx
<!--下面三种是一般的HTML用法，一般是使用不到的-->
<!--iconfont图标-->
<i class="iconfont icon-xxx"></i>
<!--Glyphicons图标-->
<i class="glyphicon glyphicon-eur"></i>
<!--fontello图标-->
<i class="fontello fontello-xxx"></i>
```
使用用途：
* 直接修改主题内的图标，主题的所有图标都是使用的是网页图标，你可以更换图标的类名来更换图标。
（不推荐，因为更新后会覆盖修改内容）
* 在 `自定义左侧边栏栏目` 和 `自定义顶部导航按钮` 和 `首页名称左侧的图标设置项` 中使用。
具体见：[自定义栏目](/customize)

85
docs/page.md
Unescape View File

@ -1,85 +0,0 @@
主题内置了**五套自定义模板** `时光机`、`文章归档`、`友情链接`和`留言板`和`豆瓣书单`。
### 使用方法
![2.jpg][1]
在后台了**撰写——创建页面**的右下角的`自定义模板`选择相应的自定义模板即可。下面简单介绍自定义模板的使用方法。
### 时光机
!> 关注微信公众号`ihewro（我要起飞啦熬）`按照[微信公众号发送时光机](/wechat) 即可通过微信公众号同步发送到handsome主题的博客中
* 填写地址的时候，**必须**填写为 <span style="color: rgb(255, 255, 255); background-color: rgb(250, 192, 143);">cross</span>.html（是地址，不是标题！！！标题随便写，但是地址要固定的，否则首页无法读取内容）
* 外观设置——初级设置——首页左侧边栏头像的链接地址 默认是时光机页面的地址，你可以修改
* 内容框里面不用填任何东西，这个页面在**前台**（就是直接打开这个独立页面，然后在登录的状态下）就可以发布“说说”，用来记录你的日常和心情的~
**看不到输入框**：请确保你已经登录了，并且该独立页面允许评论（只有管理员登录后才会显示输入框，游客是看不见的，请放心）
**如何删除说说：**在后台的评论管理中删掉该页面的对应评论即可。
**说说不能发表图片**： 见[常见问题](common-problem?id=%e8%af%84%e8%ae%ba%e5%8c%ba%e4%b8%8d%e8%83%bd%e6%96%97%e5%9b%be%e4%b8%8d%e8%83%bd%e6%98%be%e7%a4%ba%e5%9b%be%e7%89%87%e8%af%b4%e8%af%b4%e4%b8%8d%e8%83%bd%e6%98%be%e7%a4%ba%e5%9b%be%e7%89%87)
### 文章归档
* 地址随意填写。
* 内容框不用填任何内容。这个页面会自动把你所有文章以时间树的形式显示出来。
### 友情链接
* 地址随意填写。
* 这个页面自动输出`links`插件里面设置的友情链接。（具体用法见**插件设置**）友情链接页面的`本博信息`在独立页面的输入框中填写即可，会和链接一起输出。
### 留言板
* 地址随意填写。
* 这个页面会自动输出评论数最多的前15名。如果需要填写自定义内容在输出框中填写即可，会一起输出。
### 豆瓣清单
* 地址随意填写。
* 这个页面会自动输出你的豆瓣书单（`已读的书`）、电影清单（`已看的电影`）。
* 在自定义字段中填写：名称为`doubanID`,值为`你的豆瓣ID`。访问该网址以检查的ID是否正确：<https://www.douban.com/people/你的豆瓣ID/>，填写的是豆瓣ID，不是整个url地址
* 因为需要写入缓存文件，请确保你的主题下的`aseets/cache`目录可写
* 请确保的你的豆瓣有`已看的电影`和`已读的书`的数据，不然会显示错误。
* 图书数据不能显示，一直显示“数据已添加成功，请刷新一次”，刷新了还是显示不了的话，一般是全站静态缓存了，请修改你的cdn缓存策略，不要全站静态缓存，缓存静态资源（.jpg .css .js）之类文件即可
![3.jpg][2]
[1]: https://www.ihewro.com/usr/uploads/2017/03/3674342886.jpg
[2]: https://www.ihewro.com/usr/uploads/2017/03/2880093812.jpg
### github项目
* 地址随意填写
* 这个页面会输出你所想要输出的github项目名称
你有两种方式显示你的github项目：
##### 输出所有的你的github项目
!> 受限制与github提供的api限制，你只能显示30个你的github项目清单
* 在自定义字段中填写：名称为`github`，值为你的`github用户名`
##### 自定义输出项目（待开发，暂不能使用）
在编辑器中按照下面的格式填写：
```
[github="用户名/仓库名"]
//举例：
[github="ihewro/typecho-theme-leaf"]
```

4
docs/pjaxanimate.md
Unescape View File

@ -1,4 +0,0 @@
!> 待补充文档

23
docs/plugin.md
Unescape View File

@ -1,23 +0,0 @@
## 插件使用方法
下载主题文件夹下面的`插件文件夹`里面的相应插件，并且安装到`\usr\plugins`目录下。
## 友情链接管理
对于某些服务器配置，如果不使用该插件，会导致页面无法正常显示。
**Links**是一个管理友情链接的插件。左侧边栏的`友链`栏目和独立页面中的自定义模板`友情链接`会调用这里面设置的友情链接。
启用该插件后，`后台`——`管理`栏目下会多一个`友情链接`的栏目。
进入后，添加一个链接，只需要填写`链接名称`、`链接地址`、`链接分类`、 `链接描述` 和 `链接图片`这四个项目的内容。
**图示：**
![](https://ws2.sinaimg.cn/large/006tNc79ly1fzzfb162hgj30zk0mqt9p.jpg)

49
docs/rss.md
Unescape View File

@ -1,49 +0,0 @@
# 万物皆可RSS 配置
> 想法来源于[熊猫小A](https://blog.imalan.cn)的博客。
### 能做哪些事情？
可以把**任何有RSS源网站内容可以聚合在时光机页面内**。比如微博、微信公众号、（前两个需要RSShub的开源服务支持）另一个博客的内容等等。
**对代码不了解的伙伴们直接看下一个说明（简单配置微博），后面的都不要看了！！**
### 简单配置微博
```json
{"id":"weibo","name":"微博","url":"https://rsshub.app/weibo/user/5631723091"}
```
直接把上面的代码复制到配置框中，`https://rsshub.app/weibo/user/5631723091` 最后的一串数字`5631723091`是你的微博UID，打开你的微博的主页的地址中有的
### 配置项填写
* `id` ：rss标识符，任何字母（id**请勿重复**）。
* 比如微博，可以是`weibo`
* `name` ：rss内容标题，一般是中文。如果是`微博`，就直接填`微博`
* `url` ：rss源地址
* 比如微博，就是`https://rsshub.app/weibo/user/5631723091`（这个源有时候不稳定，可以用另一个）或者`https://rsshub.app/weibo/user2/5631723091`
* 比如别的博客内容：一般的博客系统都支持生成RSS订阅地址的，比如我的博客就是`https://www.ihewro.com/feed/`
* 只要是RSS源地址，都是支持的
* `img` （非必填项）：代表该栏目的图片，以头像形式显示。建议是正方形的。填写图片的url地址即可
* `type`（非必填项）：显示的内容形式
* `discription` 仅显示文章摘要（有的RSS源摘要中包含整个文章内容）（不填的话，默认是这个）
* `title` 仅显示文章标题
* `mix` 显示标题+摘要 （暂不支持）
### RSS 源禁止跨域怎么办？
最简单的解决办法是：在原有的RSS源地址前面加上`https://cors-anywhere.herokuapp.com/`
**举例**：
`https://api.fanfou.com/statuses/user_timeline/~k40sgjV_6kg.rss` 该源是禁止跨域的，所有无法请求到（浏览器可以正常访问，但是无法通过代码获取数据），修改后的源地址为：
`https://cors-anywhere.herokuapp.com/https://api.fanfou.com/statuses/user_timeline/~k40sgjV_6kg.rss`
填`url`属性就填后者即可。（可能速度会有些影响）

2
docs/setting.md
Unescape View File

@ -1,2 +0,0 @@
后台外观的所有设置都已经有说明文字，这里还是补充几点。

66
docs/speed.md
Unescape View File

@ -1,66 +0,0 @@
### 本地图片云存储(镜像)加速
!> 4.3.0 进行了升级，请务必重新更新配置
![](https://ws3.sinaimg.cn/large/006tKfTcly1frk5olgebaj31kw0kz75v.jpg)
在配置框按照格式填写
`（镜像空间的自定义域名）| (域名商)`
如：`http://assets.ihewro.com | UPYUN`
实现思路就是：**将博客服务器本地图片资源地址都转换为镜像空间的地址**，访问云服务商的镜像空间，通常能获得更快的速度。
下面分别写下又拍云和七牛云的配置过程：
> 又拍云举例：
* 创建服务——CDN
* 按照下图配置
![](https://ws1.sinaimg.cn/large/006tKfTcly1frk6664mfkj31hk0z6q4u.jpg)
* 创建完成后，需要在域名解析中，将刚才的加速域名解析到给定分配的cname地址
![](https://ws1.sinaimg.cn/large/006tKfTcly1frk67z8ozmj31cw0ms3zk.jpg)
* 在服务配置的——回源管理——开启源站资源迁移
![](https://ws4.sinaimg.cn/large/006tKfTcly1frk6a73sr5j31kc16ogn6.jpg)
> 七牛云举例：
```
选择对象存储——镜像存储——填写镜像空间地址
```
![](https://ws4.sinaimg.cn/large/006tKfTcly1frk6exdylsj31kw12sdn6.jpg)
注意：你的七牛空间必须在`镜像存储的设置项`中填写你的**博客地址**(例如：https://www.ihewro.com/)，这样才能达到加速的效果。
### 云存储选项
其实主题外观设置那里写的比较清楚了。
webp格式目前主要是Chrome支持，所以一般正确的用法是，不要在后台启用webp图片格式。
而是**去云服务器商的图片处理设置里开启webp的自适应**（比如又拍云的就是在`性能优化——WebP自适应`选项，开启了就可以了），会自动根据浏览器支持情况来是否转换为webp格式。
### 将本地静态资源上传到你的cdn上
!> 如果设置了`本地图片云存储(镜像)加速`，这个选项无需再配置了。因为上面的选项就相当于全站镜像到云服务器商，博客的静态资源会直接访问镜像空间的资源。
!> 请在你的云存储服务商设置允许资源的跨域访问，否则会导致字体文件无法访问而显示页面图标。如果不知道如何设置，**可以发工单问客服**（这是最简单的方法，因为不同服务器提供商具体设置我也不是很清楚），一般能够得到解决方法。
* 需要在`后台外观设置——将本地静态资源上传到你的cdn上`中配置：
* 使用该项设置前，你必须有自己搭建的cdn服务器（不是指当前服务器）
* 主题目录下的/assets/目录下有 css、js、fonts、img四个静态资源文件夹。
* 你需要把asset目录上传到你的cdn服务器上，比如CDN服务器的 handsome目录里，地址即为 `https://cdn.ihewro.com/handsome/assets/`
* 在当前框中就填入该地址，主题就会引用你搭建的cdn上面的资源，而不再引用当前服务器上的资源

42
docs/start.md
Unescape View File

@ -1,42 +0,0 @@
!> 关注微信公众号`ihewro（我要起飞啦熬）`按照[微信公众号发送时光机](/wechat) 即可通过微信公众号同步发送到handsome主题的博客中
## 安装主题
* 下载主题文件包并解压后，会得到两个文件夹：`主题`和`插件`。
* 将`主题`文件夹下面的`-*handsome-*`文件夹上传至typecho的`/usr/themes`目录下。
* 将`插件`文件夹下面的`links`文件夹上传至typecho的`/usr/plugins/`目录下。（插件使用方法见[插件使用方法](/plugin)）
* 启用插件和主题。（**主题的个性化设置：后台设置——控制台——外观——设置外观**）
!>正常使用主题前，请务必安装[links插件](/plugin)！！！
!> 请阅读[常见问题文档](/common-problem)：这里的是最常见被问频率最高的一些问题
## 更新主题
* 下载最新版本主题后
* 使用handsome的后台外观设置数据备份功能备份（以避免万一）
* 删除/usr/themes/handsome/目录中的所有文件
* 然后新主题中的文件复制到/usr/themes/handsome/目录。
!> 更新后，如果有页面样式问题请自己检查以下事项：
* 清除浏览器缓存
* 刷新CDN缓存
* （如果使用了`将本地静态资源上传到你的cdn上`功能）请同步更新你的CDN服务器上面的静态资源文件
!> 主题目录下的`/usr`目录存放的为用户自定义数据文件，一般情况无需更新（除非更新提示中有提到需要更新这部分）</p>
!> 注意 ：切换主题的时候typecho会自动清空上一个主题的所有备份数据，备份数据存储在数据库中。所以请及时使用handsome主题内置外观设置数据备份功能
!> 只要不切换主题，删除主题旧版本主题文件夹再上传新版本主题文件夹，是不会丢失以前的配置数据。
## 备份外观设置
* 后台外观设置支持完整的备份管理：备份、备份删除、恢复备份，快来体验吧
* 切换主题，会自动清空当前被切换的主题的外观数据**，但是如果你备份了数据，**切换主题，再切换回来通过`恢复备份`既可以恢复之前的数据了。

30
docs/typecho.md
Unescape View File

@ -1,30 +0,0 @@
以下内容与主题无关，是为了方便typecho新手更快熟悉这个博客系统而创建的。
以下内容不断补充，如果你有更好的推荐和建议，欢迎一起充实。
### 好用的编辑器插件
| 插件名称 | 介绍 |
| ---------------------------------------- | ---------------------------------------- |
| [Editor.md for Typecho](https://github.com/DT27/EditorMD) | Markdown 编辑器，主要是支持markdown语法的 |
| [UEditor-for-Typecho](https://github.com/chanshengzhi/UEditor-for-Typecho) | 这款是html编辑器，适合新手用，简单方便，功能强大 |
| [MyEditor:MyEditor](http://mytypecho.com/post-myeditor.html) | 是一款采用TinyMCE核心，支持切换编辑器、插入图片的Typecho编辑器插件。 |
### 邮件通知插件插件
| 插件名称 | 介绍 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| **[Mailer](https://pan.baidu.com/s/1Ob2EyVQvly8AAKLpYlsU9g)** | [typecho 创始人](https://joyqi.com/typecho/typecho-async-service.html)对typecho1.1 适配的插件，必须是1.1+版本才可以，因为文字中给的是[Mailer.tar.gz](https://joyqi.com/usr/uploads/2017/11/3224167191.gz) 后缀，我解压了上传到百度云的是`zip`包，直接下载百度云那个即可。 |
| [CommentToMail（羽飞原版）](http://typecho.byends.com/post/CommentToMail-v2-0-0.html) | 老牌的typecho评论通知插件，可是很多小伙伴们说后台怎么配置都无法发信，韩红听了都想打人，我用的可以。 |
| [CommentToMail（更新版1）](https://9sb.org/58) | [王忘杰](https://9sb.org/)更新版本： 更新了PHP Mailer版本关闭了使用SMTP发信的证书认证（QQ邮箱证书加密级别太低） |
| [CommentToMail（更新版2）](https://blog.zhiyuanyun.cc/archives/CommentToMail.html) | [致远博客](https://blog.zhiyuanyun.cc/)更新版本：使用网址监控方法避免异步触发失败 |
### 个人喜欢的其他插件
| 插件名称 | 介绍 |
| ---------------------------------------- | ---------------------------------------- |
| [SmartSpam](http://www.yovisun.com/archive/typecho-plugin-smartspam.html) | 非常强大的一款Typecho智能评论过滤插件，就此别过垃圾评论的入侵者吧。 |
| [ AutoTags](https://dt27.org/php/autotags-for-typecho/) | 标签自动生成插件，避免了手动填写Tag，对我这种懒得填tag的人很有帮助。 |
| [Parsedown Plugin](https://github.com/kokororin/typecho-plugin-Parsedown) | 弥补了typecho1.0正式版本md语法不支持表格的缺陷。 |
| [Sticky](http://www.boke8.net/typecho-sticky-plugin.html) | 一个小巧的文章置顶插件。 |
| [APlayer](https://github.com/FaithPatrick/APlayer-Typecho-Plugin) | 是在原作者ZGQ394基础上由[FaithPatrick](https://github.com/FaithPatrick)修改而来。一款很好看的音乐播放器插件。 |

102
docs/wechat.md
Unescape View File

@ -1,102 +0,0 @@
!> 使用该功能前提是已经使用[时光机]的自定义模板，新建了独立页面 [时光机](/page?id=时光机)
## 关注微信公众号
微信公众号搜索`ihewro` 或者 `我要起飞啦熬` 或者扫描下方二维码关注
![](https://ws1.sinaimg.cn/large/006tNbRwly1fv7361tqv1j30760760st.jpg)
## 绑定自己的handsome主题博客
#### 1. 找到`时光机页面`的cid号码
在`时光机`的修改页面的地址栏可以看见：
![](https://ws2.sinaimg.cn/large/006tNbRwly1fv737wzbryj313a0cy74f.jpg)
!> 比如，我的时光机url为`https://www.ihewro.com/admin/write-page.php?cid=459`，则`cid`为`459`
#### 2. 填写时光机验证编码（仅handsome4.5.0+支持该功能）
![](https://ws3.sinaimg.cn/large/006tNbRwly1fv739ocn7dj313q0bxwew.jpg)
后台外观设置——高级设置——时光机身份验证编码
在这里随便填写一个你想填的值，当然越不容易被别人猜到安全性越高
!> 解释一下这个编码，这个编码等价于密码，通过这个密码，不需要后台用户名就可以发送时光机。所以请勿向别人泄露，如果泄露了，请及时修改。
#### 3. 在微信公众号按照下面格式输入：
```
绑定handsome(加号)完整博客地址(加号)时光机验证编码(加号)时光机cid
```
举个例子：
```
绑定handsome+https://www.ihewro.com+uniquecode+459
```
!> **uniquecode 是你的时光机编码，请替换成你的时光机编码！！！**时光机编码不是随便填的！！要和第二步一致的编码才可以
## 向时光机发送消息
支持**文字**、**图片**、**地理位置**、**链接**四种消息类型。
!> 其他消息类型等后续开发，暂不支持（如果发送了，会提示不支持该类型的，如语音消息）。
如果发送的是图片会自动将图片存放到typecho 的 `usr/uploads/time` 目录下。
> v5.1.0 及其以上版本支持发送私密说说。只需要在发送内容前加入`#`即可。
>
> > 举例发送：`#这是私密的说说，仅发送者可见。`
## 连续发送多条信息(v5.1.0+支持)
!> （v5.1.0支持（现在还不支持，等下个版本更新））多条信息支持各种已支持的消息类型组合
* 发送`开始`，开始一轮连续发送
* 发送`结束`，结束当前轮的发送
## 其他操作
* 发送 `博客`收到你的博客地址的链接
* 发送 `发博客`收到发博文的字的链接
* 发送 `解除绑定` 或 `解绑` 或 `解绑handsome`即可删除掉你的绑定信息
* 发送 `帮助` 查看帮助信息
* 发送 `赞助` 或 `赏` 或 `赞赏` 可以进行小额赞助服务器开发
!> 可能的疑问：使用你开发的这个功能，作者可以任意进入用户后台，发送时光机或者其他消息吗？
答：不可能。
1. 这个**时光机编码只能进行验证身份发送时光机这一个功能**，不能进入后台，无法得知用户的后台用户名和密码
2. 用户通过公众号绑定后，**时光机编码会通过md5加密存储到云数据库中**，即使开发者（我）拿到了加密后的数据也无法还原真实的数据操作用户的博客。
3. 虽然说云端服务器会加密的大家的数据，但是微信公众后台会暂时保存大家的消息（**消息保存5天，多媒体消息3天后无法查看**），请悉知。
4. 如有漏洞，敬请提交，非常感谢！
5. **微信公众号的服务器使用bmob云端服务器，每月花费50元，如果有能力，随意打赏任何金额，Thanks♪(･ω･)ﾉ**
## 常见问题
!> 无法向博客时光机发送内容？
A:
1. 时光机编码不正确
2. 某些服务器做了ua判断，所以无法通过请求
3. 某些服务器有cc防护，禁止请求
4. 域名填错了...（填写绝对地址，浏览器地址栏什么样的就填什么！https/http 要分清楚，不要看心情选择）
!> 不显示图片？
A：请参阅[常见问题](./common-problem?id=评论区不能斗图不能显示图片-说说不能显示图片音乐播放器视频播放器) 的关于“时光机不显示图片问题”
## 后续计划
我觉得微信号关联博客是一种很有趣的玩法，后续会增加一些我个人觉得有必要的操作，欢迎提出你的创意，当然并不一定实现哈~
Write Preview
Loading…
Cancel
Save