提交 f3e48af2 编写于 作者: EvanOne(文一)'s avatar EvanOne(文一)

chore(release): 1.1.3

chore: Delete console

docs: Update
上级 32eb4deb
......@@ -2,6 +2,14 @@
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
### 1.1.3 (2019-07-22)
### Features
* Add the copy button in copyright of posts ([26155b7](https://github.com/liuyib/hexo-theme-stun/commit/26155b7))
* Add a mark icon to external icon ([2f11fd7](https://github.com/liuyib/hexo-theme-stun/commit/2f11fd7))
* Add support for front-matter: link ([79b73bf](https://github.com/liuyib/hexo-theme-stun/commit/79b73bf))
### 1.1.2 (2019-07-20)
### Bug Fixes
......
# 优化建议
## 打包、压缩文件
## 打包、压缩资源文件 <Badge text="disrelated" type="warning"/>
Stun 主题的源码中,`HTML`, `CSS`, `JavaScript`, `图片` 等资源文件是没有打包压缩的。**绝大部分的 Hexo 主题也是如此**。庆幸的是 Hexo 提供了相关的插件,来帮助用户解决这一问题。
......
......@@ -3,7 +3,7 @@
::: tip 前言
- 修改配置文件、安装新的依赖等,都需要重启 hexo 服务器。
- 没有特别说明,配置项默认从 `v1.0.0` 版本开始支持。
- 稳定的配置项使用 <Badge text="stable"/> 标明,表示基本不会变动;不稳定的配置项使用 <Badge text="beta" type="warn"/> 标明,表示未来可能会变动甚至删除
- 稳定的配置使用 <Badge text="stable"/> 标明,表示基本不会变动。不稳定的配置使用 <Badge text="beta" type="warn"/> 标明,表示未来可能会变动甚至删除。目前还不支持的配置使用 <Badge text="not support" type="error"/> 标明。最早开始支持的版本号使用 <Badge text="v x.x.x"/> 标明。与主题无关的配置项使用 <Badge text="disrelated" type="warning"/> 标明
:::
## 配置文件
......@@ -133,11 +133,11 @@ nav:
`Front-matter` 在 Hexo 主题中,占据了极其重要的地位,如果你还不了解 `Front-matter`,可以查看这里:[https://hexo.io/zh-cn/docs/front-matter](https://hexo.io/zh-cn/docs/front-matter)
下面是 Hexo 中默认`Front-matter`,Stun 主题完美支持了它们(除了 `layout`
下面是 Hexo 中默认提供的几种 `Front-matter` 属性
- `title` - 标题
- `date` - 文件建立日期
- `updated` - 文件更新日期
- `title` <Badge text="stable"/> - 标题
- `date` <Badge text="stable"/> - 文件建立日期
- `updated` <Badge text="stable"/> - 文件更新日期
例如:
......@@ -151,17 +151,17 @@ updated: 2019-5-16 10:23:46
![](https://raw.githubusercontent.com/liuyib/picBed/master/hexo-theme-stun/doc/20190722105740.png)
> Hexo 会帮你记录文件的更新日期,所以一般不需要手动指定 `updated` 字段。并且当你使用 `hexo new xxx` 指令生成文件时,Hexo 会帮你添加好 `title` 和 `date` 字段。因此这三个字段一般不需要手动设置。
> Hexo 会帮你记录文件的更新日期,所以一般不需要手动指定 `updated` 属性。并且当你使用 `hexo new xxx` 指令生成文件时,Hexo 会帮你添加好 `title` 和 `date` 属性。因此这三个属性一般不需要手动设置。
- `comments` - 是否开启评论功能
- `comments` <Badge text="stable"/> - 是否开启评论功能
在 Stun 主题中,如果你启用了某个评论系统,默认是对所有通过 markdown 文件生成的页面(除首页,归档页,单个分类页,单个标签页以外的所有页面)生效。因此,你可以使用该字段单独设置某个页面 / 文章是否启用评论。
在 Stun 主题中,如果你启用了某个评论系统,默认是对所有通过 markdown 文件生成的页面(除首页,归档页,单个分类页,单个标签页以外的所有页面)生效。因此,你可以使用该属性单独设置某个页面 / 文章是否启用评论。
- `permalink` - 覆盖文章网址
- `permalink` <Badge text="stable"/> - 覆盖文章网址
使用该字段可以为某篇文章单独指定一个网址。
使用该属性可以为某篇文章单独指定一个网址。
- `categories` - 设置文章分类
- `categories` <Badge text="stable"/> - 设置文章分类
你可以同时设置几个同级分类,例如:
......@@ -179,7 +179,7 @@ categories:
- [foo, bar, baz]
```
- `tags` - 设置文章标签
- `tags` <Badge text="stable"/> - 设置文章标签
标签只能设置为同级的。也就是说,如果你将标签设置为:
......@@ -190,35 +190,54 @@ tags:
那么它会被解析为 `foo,bar,baz`,也就是一个标签。
- `layout` - 布局
- `layout` <Badge text="not support" type="error"/> - 布局
> 该字段在相册页面中会用到,目前 Stun 还没有开发相册页面,所以暂时不支持此字段。
> Stun 主题目前暂时还不支持,最近的版本中考虑进行支持。
还有几种 `Front-matter` 属性在 Hexo 文档中并没有出现(也许是 Hexo 的文档没有更新吧),但在官方提供的主题开发测试文件中出现。按照测试文件的要求,一个合格的 Hexo 都应该支持它们。这些属性如下:
- `link` <Badge text="stable"/> <Badge text="v1.1.3"/>
如果为某篇文章指定该属性,当点击该文章标题时,应该在新窗口或新的标签页中打开链接地址。
- `photos` <Badge text="not support" type="error"/>
> Stun 主题目前暂时还不支持,最近的版本中考虑进行支持。
用于指定一些图片,这些图片应该全部被显示在文章中。例如:
``` yaml
photos:
- http://xxxxx1.jpg
- http://xxxxx2.jpg
- http://xxxxx3.jpg
```
---
下面是 Stun 主题中,**特有的**几种 `Front-matter`
下面是 Stun 主题中,特有的几种 `Front-matter` 属性
- `top_image: https://xxxx.jpg`
- `top_image: https://xxxx.jpg` <Badge text="stable"/>
用于设置文章顶部的大图。详情:[指定顶部图](http://localhost:8080/hexo-theme-stun/zh-CN/advanced/theme-config.html#指定顶部图)
- `toc_max_depth: 6`
- `toc_max_depth: 6` <Badge text="stable"/>
用于设置文章中,解析标题生成目录的最大深度。取值 `1 ~ 6`。例如:`toc_max_depth: 3`,只会解析文中的 `h1`, `h2`, `h3` 来生成目录。详情:[文章目录](http://localhost:8080/hexo-theme-stun/zh-CN/advanced/theme-config.html#文章目录)
- `math: true`
- `math: true` <Badge text="stable"/> <Badge text="v1.1.2"/>
是否需要解析数学公式。详情:[数学公式](http://localhost:8080/hexo-theme-stun/zh-CN/advanced/third-part.html#数学公式)
---
下面是安装某些插件后,可以设置的 `Front-matter`
下面是安装某些插件后,可以设置的几种 `Front-matter` 属性
- `top: true`
- `top: true` <Badge text="stable"/>
文章是否置顶。详情:[文章置顶](http://localhost:8080/hexo-theme-stun/zh-CN/advanced/theme-config.html#文章置顶)
- `no-emoji: true`
- `no-emoji: true` <Badge text="disrelated" type="warning"/>
是否解析文章中的 emoji 代码。详情:[添加-emoji-支持](http://localhost:8080/hexo-theme-stun/zh-CN/advanced/third-part.html#%E6%B7%BB%E5%8A%A0-emoji-%E6%94%AF%E6%8C%81)
......@@ -337,7 +356,7 @@ footer:
# 是否启用
enable: true
# 显示的文字信息,例如:xxx All Rights Reserved.
# 如果不设置,将显示 hexo 配置文件中的 author 字段的内容
# 如果不设置,将显示 hexo 配置文件中的 author 属性的内容
text:
# 开始时间(如果不设置,将显示最新的年份)
since:
......@@ -506,7 +525,7 @@ toc:
# 是否始终展开所有文章目录。true:始终展开,false:当文章中对应的标题到达顶部时自动展开。
expand_all: false
# 生成目录时,解析 h 标签的最大深度。
# 你可以在文章的 markdown 源文件的 Front-matter 中,通过添加 `toc_max_depth` 字段
# 你可以在文章的 markdown 源文件的 Front-matter 中,通过添加 `toc_max_depth` 属性
# 来指定某篇文章生成目录时,解析 h 标签的最大深度。
max_depth: 6
```
......
......@@ -4,7 +4,7 @@
第三方支持正在不断加入中 (๑•̀ㅂ•́)و✧
:::
## 添加 Emoji 支持
## 添加 Emoji 支持 <Badge text="disrelated" type="warning"/>
如果想要使用 Emoji,你可以直接在[这里](http://emojihomepage.com/)复制粘贴使用。如果你更喜欢使用 Emoji 代码,例如:`:sparkles:` 将会显示为 :sparkles:, 那么你需要安装插件 [hexo-filter-github-emojis](https://github.com/crimx/hexo-filter-github-emojis) 来支持这种语法。
......@@ -416,11 +416,11 @@ markdown:
Stun 主题默认提供了一些 MathJax 和 Katex 的插件。
- mhchem
- mhchem <Badge text="stable"/> <Badge text="v1.1.2"/>
mhchem 是 MathJax 的插件,你可以使用这个插件来渲染化学方程式。详情请看:[MathJax/mhchem Manual](https://mhchem.github.io/MathJax-mhchem/)。
- Copy-tex
- Copy-tex <Badge text="stable"/> <Badge text="v1.1.2"/>
Copy-tex 是 KaTex 的插件,当启用这个插件之后,你只需要单击公式即可复制其源码。详情请看:[Copy-tex extension](https://github.com/KaTeX/KaTeX/tree/master/contrib/copy-tex)。
......
{
"name": "hexo-theme-stun",
"version": "1.1.2",
"version": "1.1.3",
"description": "A beautiful blog theme - stun",
"homepage": "https://liuyib.github.io",
"scripts": {
......
......@@ -138,7 +138,6 @@ Stun.utils = Stun.$u = {
}
document.body.removeChild(input);
} catch (e) {
console.log(e);
return false;
}
},
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册