master
hewro 6 years ago
parent 878112cdc5
commit cb04246629
  1. 10
      changelog.md
  2. 78
      common-problem.md
  3. 24
      emotion.md
  4. 7
      enhancedPackage.md
  5. 14
      functions.md
  6. 10
      page.md
  7. 16
      start.md

@ -1,7 +1,5 @@
> #### 2018-02-14 更新至4.2.0
<br />
> 新功能
1. 新的后台,给你新的体验
2. 增加了更多的pjax动画管理,包括动画样式、遮罩、返回顶部的速度(后台外观设置——PJAX)
@ -17,9 +15,6 @@
12. 增加了自定义摘要的功能(后台外观设置——高级设置)
13. 增加了评论框的选择位置(评论设置——评论框位置)
14. 增加了拼音注解的功能(主题增强功能——markdown扩展)
> 优化
1. 优化了视频的鼠标指针样式
2. 全局播放器未点击播放不会加载音乐信息,减少流量负担
3. 优化了表格的css问题
@ -33,10 +28,6 @@
11. 优化了左侧边栏电脑端在折叠下的hover悬浮效果
12. 优化了顶部的闲言碎语在手机端由于内容过多导致显示不全的问题
13. 更多细节优化等你发现
> bug 修复
1. 修复了某些情况下登录出错
2. 修复文章中的h4标签和目录树冲突的bug
3. 修复首页输出列表的作者为登录名称
@ -46,6 +37,7 @@
7. 修复了书单页面的css问题
8. 修复了typecho1.0下的404页面问题
> #### 2017-12-02 更新至4.1.0

@ -1,68 +1,86 @@
?> **1. 安装完主题后,页面错乱**
#### 安装完主题后,页面中间部分空白
* 依次检查主题文件夹名称是否为`handsome`
* 是否已经安装并且启用主题必要的插件
?> **2. 全局音乐播放器一直在加载无法播放**
#### 点击首页头像,显示404页面
* PHP必须满足 PHP>=5.4
* 某些国外服务器无法云解析,请使用手动添加歌曲功能
* QQ音乐歌单最近出现问题,分享给他人,他人打开显示404,请更换解析源(比如网易云)
* 需要新建“时光机”独立页面,具体方法见[独立页面](/page)
如果仍有问题,请联系我。
#### links插件无法启用,显示500错误
* 更新主题包中最新版本的links插件`1.1.2`
* 一般是由于你的`usr/plugin`没有足够的权限导致的。
?> **3. 使用EditorMD前台文章首次不加载,刷新一次才能加载**
如果是Linux服务器尝试,在typecho的usr目录下输入此命令:
* 主题pjax与EditorMD的前台解析js有冲突,在该插件的设置界面,将`接管前台Markdown解析并启用ToC、TeX科学公式、流程图 Flowchart、时序图 Sequence Diagram 等扩展`
选择否即可。
```bash
sudo chmod -R 777 plugin
```
如果仍有问题,请联系我
#### 友链设置后前台不输出内容(使用无效)
* links插件需要填写`链接分类`来判断输出的位置,请详细阅读[友链设置文档](./plugin)
#### 无法评论,提示输入内容不符合规则
请依次检查以下内容:
* cdn缓存静态缓存了HTML页面,导致评论功能失败(cdn缓存建议只缓存静态资源文件,如css js image)
* 使用了服务器缓存功能
* 使用了数据库缓存插件
* 使用了页面代码压缩的插件
如仍有问题,请联系我。
#### typecho1.1版本编辑器无法解析HTML代码
?> **4. typecho1.1版本编辑器无法解析HTML代码**
* typecho 1.0原生markdown解析器非常弱,无法解析表格。
* typecho 1.1原生markdown解析器必须使用特权模式才可以解析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)
* 你可以使用该插件替换掉typecho的markdown的解析引擎:
[kokororin / typecho-plugin-Parsedown](https://github.com/kokororin/typecho-plugin-Parsedown)
* 启用该插件后,无需任何设置,自动替换前台文章解析,支持解析表格和HTML代码。
?> **5. 点击首页头像,显示404页面**
#### 全局音乐播放器一直在加载无法播放
* 需要新建“时光机”独立页面,具体方法见[独立页面](/page)
* PHP必须满足 PHP>=5.4
* 某些国外服务器无法云解析,请使用手动添加歌曲功能
* 网易云会时常封禁cookie,导致解析失败,请打开主题目录下面的`libs/Get.php` 根据注释要求修改`$netease_cookie`变量。(一般有问题的话,我会在群内通知的)
?> **6. 评论区不能斗图不能显示图片/说说不能显示图片**
如果仍有问题,请联系我。
#### 评论区不能斗图不能显示图片 | 说说不能显示图片/音乐播放器/视频播放器**
* 后台 `设置——评论——允许使用的HTML标签和属性` 里面添加html标签
```html
<img src="">
<audio class="" src="" preload>
<video src=""></video>
```
?> **7. 评论区无法使用markdown语法**
#### 评论区无法使用markdown语法
* 后台 `设置——评论——在评论中使用Markdown语法(选中)`
后台 `设置——评论——允许使用的HTML标签和属性` 里面添加html标签
后台 `设置——评论——允许使用的HTML标签和属性` 里面添加markdown语法对应的html标签
```html
<blockquote><pre><code><strong><em><h5><h6><a href title><table><thead><tr><th><tbody><td>
```
#### 使用EditorMD前台文章首次不加载,刷新一次才能加载
?> **8. links插件无法启用,显示500错误**
* 一般是由于你的`usr/plugin`没有足够的权限导致的。
如果是Linux服务器尝试,在typecho的usr目录下输入此命令:
```bash
sudo chmod -R 777 plugin
```
* 主题pjax与EditorMD的前台解析js有冲突,在该插件的设置界面,将`接管前台Markdown解析并启用ToC、TeX科学公式、流程图 Flowchart、时序图 Sequence Diagram 等扩展`
选择否即可。
如果仍有问题,请联系我

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

@ -21,7 +21,10 @@
访问地址即:`./music` (不要加上`index.php`否则访问错误)
【注意】:最后一个歌单id后不用加上英文逗号(,)
!> 最后一个歌单id后不用加上英文逗号(,)
!> 请保证目录下的`play/cache` 缓存目录可写,否则会发生错误
### 画廊相册
@ -51,3 +54,5 @@
访问地址即`./album/index.php`
【注意】:最后一个图片信息块后不用加上英文逗号(,)

@ -28,7 +28,7 @@
* 显示顺序:thumb自定义字段——文章第一个附件——文章第一张图片——随机图片(推荐)
* 显示顺序:thumb自定义字段——随机图片
以第三种为例,当thumb字段为空的时候,会寻找文章的第一个附件,附件不是图片,寻找文章中第一张图片,文章中如果没有图片的话再去加载随机图片。
以第三种为例,当thumb字段为空的时候,会寻找文章的第一个附件,附件不是图片,会继续寻找文章中第一张图片,文章中如果没有图片的话再去加载随机图片。
其他选项亦是同理。
@ -82,6 +82,8 @@ DNS prefetching通过指定具体的URL来告知客户端未来会用到相关
大版式头图默认摘要字数200字,小版式头图默认摘要字数80字。你可以在`后台外观设置->自定义大版式头图摘要/自定义小版式头图摘要`来改变这两个默认值。
你还可以使用`摘要分隔符`进行自主截断内容输出,**但是自主生成的摘要不会超过默认摘要字数**。
举例:你的默认摘要字数设置为200字,使用`摘要分隔符`截断的摘要为230字,则摘要只会显示200字。
```markdown
<!--more-->
@ -167,9 +169,14 @@ handsome支持以下类型的按钮:
示例:
```html
<video src="http://xxx.com/xxx.mp4"></video>
[vplayer url="http://xxx.com/xxx.mp4" pic="http://xxx.com/xxx.png"]
```
* `url`:视频地址
* `pic`:视频背景图片
### 文章内调用其他文章
**点击编辑器的调用文章的按钮**可以调用其他文章并显示。
@ -246,8 +253,9 @@ $\Gamma(n) = (n-1)!\quad\forall n\in\mathbb N$
后台选择`设置——评论——评论日期格式` 内填写`natural`。
在这里同样可以修改博客的时间格式为你需要的时间格式,值为标准的php格式。
**在这里同样可以修改博客的时间格式为你需要的时间格式,值为标准的php格式。**
如标准时间格式:`Y-n-j H:i:s`
### 图片附件加速

@ -34,14 +34,16 @@
* 这个页面会自动输出评论数最多的前15名。如果需要填写自定义内容在输出框中填写即可,会一起输出。
### 豆瓣信息
### 豆瓣清单
* 地址随意填写。
* 这个页面会自动输出你的豆瓣书单(分别为:`正在读的书`,`已读的书`,`想读的书`三个栏目)、电影清单(`正在看的电影`、`看的电影`、`想看的电影`)。
* 这个页面会自动输出你的豆瓣书单(`已读的书`)、电影清单(`已看的电影`)。
* 在自定义字段中填写:名称为`doubanID`,值为`你的豆瓣ID`。
* 因为需要写入缓存文件,请确保你的主题下的`aseets/json`目录可写
![3.jpg][2]
[1]: https://www.ihewro.com/usr/uploads/2017/03/3674342886.jpg
@ -55,13 +57,13 @@
你有两种方式显示你的github项目:
#### 输出所有的你的github项目
##### 输出所有的你的github项目
!> 受限制与github提供的api限制,你只能显示30个你的github项目清单
* 在自定义字段中填写:名称为`github`,值为你的`github用户名`
#### 自定义输出项目(待开发,暂不能使用)
##### 自定义输出项目(待开发,暂不能使用)
在编辑器中按照下面的格式填写:

@ -2,12 +2,14 @@
1. 下载主题文件包并解压后,会得到三个文件夹:`主题`和`插件`和`主题增强包`。
2. 将`主题`文件夹下面的`handsome`文件夹上传至typecho的/usr/themes目录下。
3. 将`插件`文件夹下面的`links`文件夹上传至typecho的/usr/plugins/目录下。(插件使用方法见[插件使用方法](/plugin))
4. 启用插件和主题。
5. `主题增强包`完全独立于主题,一般上传至服务器的根目录下即可。(为第三方开发,版权信息见[版权申明](/copyright),使用方法见[主题增强包](/enhancedPackage))
2. 将`主题`文件夹下面的`handsome`文件夹上传至typecho的`/usr/themes`目录下。
3. 将`插件`文件夹下面的`links`文件夹上传至typecho的`/usr/plugins/`目录下。(插件使用方法见[插件使用方法](/plugin))
4. 启用插件和主题。(**主题的个性化设置:后台设置——控制台——外观——设置外观**)
5. `主题增强包`完全独立于主题,**一般上传至服务器的根目录下即可。**(为第三方开发,版权信息见[版权申明](/copyright),使用方法见[主题增强包](/enhancedPackage))
<p class="tip">正常使用主题前,请务必安装[links插件](/plugin)。</p>
!>正常使用主题前,请务必安装[links插件](/plugin)!!!
!> 请阅读[常见问题文档](./comon-problems):这里的是最常见被问频率最高的一些问题
## 更新主题
@ -17,7 +19,7 @@
2. 先删除/usr/themes/handsome/目录中的内容,然后新主题中的内容复制到/usr/themes/handsome/目录。(推荐√)
<p class="tip">请勿删除主题目录下的`/usr`目录,该目录存放的为用户自定义数据文件,一般情况无需更新(除非更新提示中有提到需要更新这部分)</p>
!> 主题目录下的`/usr`目录存放的为用户自定义数据文件,一般情况无需更新(除非更新提示中有提到需要更新这部分)</p>
**\* 注意** 每次更新会有具体的更新方法,会提示是否有必要删除旧版本的主题文件夹和其他一些更新细节,请注意。
@ -28,3 +30,5 @@
1. 先按照上面的截图方法备份数据
2. 更新后,将备份的数据手动的复制到更新后的主题外观设置中

Loading…
Cancel
Save