From b210ac05820f3f907e69dfc1274b1a611717b7ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=99=BD=E4=BA=91=E8=8B=8D=E7=8B=97?= Date: Mon, 26 Sep 2022 10:46:46 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=93=83=20docs:=20v1.1.8=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/.vitepress/assets/log.json | 41 ++++++++++++++++++++++ docs/guide/config.md | 57 ++++++++++++++++++++++++++++--- docs/guide/third-party-support.md | 15 +++++++- 3 files changed, 107 insertions(+), 6 deletions(-) diff --git a/docs/.vitepress/assets/log.json b/docs/.vitepress/assets/log.json index a9191cfa..a9b17ce2 100644 --- a/docs/.vitepress/assets/log.json +++ b/docs/.vitepress/assets/log.json @@ -2,6 +2,47 @@ { "large_version": "v1.1.x", "children": [ + { + "version": "1.1.8", + "logs": [ + { + "type": "feat", + "text": "增加百度自动推送" + }, + { + "type": "feat", + "text": "增加文章版权信息" + }, + { + "type": "perf", + "text": "分类页可选择只显示标题" + }, + { + "type": "perf", + "text": "主题可根据系统选择加载样式" + }, + { + "type": "perf", + "text": "Pjax 下支持动态加载脚本插件" + }, + { + "type": "fix", + "text": "修复单闭合 img 懒加载替换错误" + }, + { + "type": "fix", + "text": "修复 lang 属性取值错误" + }, + { + "type": "fix", + "text": "修复移动端 theme-color 取值异常" + }, + { + "type": "fix", + "text": "修复初次安装无配置时兼容处理" + } + ] + }, { "version": "1.1.7", "logs": [ diff --git a/docs/guide/config.md b/docs/guide/config.md index f95ae1af..31391152 100644 --- a/docs/guide/config.md +++ b/docs/guide/config.md @@ -50,6 +50,7 @@ zh-Hans: - `default`:设置主题默认模式 - `style-light`:亮色模式 - `style-dark`:暗色模式 + - `auto`:跟随系统选择 - `switch`:如果为 false,将不会出现主题切换按钮,只加载设置默认主题模式。 ``` yaml theme: @@ -333,7 +334,12 @@ footer: custom_text: Hosted by Github Pages ``` -## 打赏 Reward +## 文章 Article + +这里是一些关于文章相关配置合集。 + +### 打赏 Reward + 开启后,将在每篇文章 `post` 末尾显示打赏按钮。 - `enable`: 开启打赏 @@ -341,7 +347,7 @@ footer: - `url`: 你的打赏链接(当你开启打赏链接时,将自动跳转你的外部链接而不是展开二维码) - `methods`: 数组,打赏方式 -### 打赏二维码 +#### 打赏二维码 - `name`: 打赏方式 - `path`: 图片路径 @@ -364,15 +370,15 @@ reward: true # reward: false ``` -## 目录 Toc +### 文章目录 -文章详情页目录,默认关闭。开启后,您可以再文章页配置当前文章不需要开启。[参考这里](/guide/page.html#文章-posts) +文章详情页目录,默认关闭。开启后,您可以在文章页单独配置当前文章关闭。[参考这里](/guide/page.html#文章-posts) ``` yaml is_toc: true ``` -## 图片懒加载 Lazyload +### 图片懒加载 默认开启,将会为 Markdown 的图片 img 加上 loading="lazy" 属性。 @@ -381,6 +387,47 @@ lazyload: enable: true ``` +### 归档页 + +默认下归档页时间轴卡片显示了标题和摘要信息,如果设置为 `less` 将只显示标题。 + +- `type`: 显示方式,可选 `more` || `less` + +``` yaml +archive: + type: more # less more +``` + +### 版权信息 + +设置您的文章的分享版权 + +> [关于许可协议](https://creativecommons.org/licenses/) +> 默认使用 署名-非商业性使用-相同方式共享 4.0,即 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh)。 + + +- `license`:设置证书 (by | by-nc | by-nc-nd | by-nc-sa | by-nd | by-sa | zero) +- `language`:设置语言 (deed.zh | deed.en | deed.ja | ...) +- `post`:在每篇文章末尾显示 +- `clipboard`:是否在复制文章时,在剪贴板中追加版权信息(默认关闭) + +```yaml +creative_commons: + license: by-nc-sa + language: deed.zh + post: false + clipboard: false +``` + +> 你的 `url` 请在 Hexo 工作目录下的 `_config.yml` 中设置。 +> [配置| Hexo](https://hexo.io/zh-cn/docs/configuration#%E7%BD%91%E5%9D%80) + +```yaml +# URL +# # If your site is put in a subdirectory, set url as 'https://yoursite.com/child' and root as '/child/' +url: https://www.imalun.com +``` + ## 自定义图标 Icon 博客中存在一些固定的图标,譬如主题切换图标、分类图标等。 diff --git a/docs/guide/third-party-support.md b/docs/guide/third-party-support.md index 0b8a2b5e..e320c0ca 100644 --- a/docs/guide/third-party-support.md +++ b/docs/guide/third-party-support.md @@ -3,7 +3,7 @@ 所有配置默认在 `_config.async.yml` 文件下进行。 与额外依赖库支持的区别,此处主要为使用第三方服务商提供的服务实现。 -## 访问统计 +## 分析统计 默认内置了 百度、谷歌、腾讯三个种。 - `enable`: 是否开启 @@ -113,4 +113,17 @@ npm install hexo-generator-searchdb search: enable: true type: local +``` + +## SEO + +### 百度自动推送 + +自动推送# +将其设置为 true,以开启百度自动推送。 + +> 即每次页面被访问时,将自动向百度提交该页面链接。(有利于百度的 SEO) + +``` yaml +baidu_push: true ``` \ No newline at end of file