hexo-theme-a4帮助手册

Details

这里的配置皆节选自 _config.a4.yml文件，本身该文件注释已足够详细，可直接参考原文件注释配置你的A4。

特色工具配置

如果想开关暗黑模式小工具，修改_condif.a4.yml的tool配置项的darkMode即可。
如果想开关回到顶部按钮小工具，修改_condif.a4.yml的tool配置项的returnToTop即可。
如果想开关回退页面按钮小工具，修改_condif.a4.yml的tool配置项的returnToLast即可。
如果想全局开关文章顶部目录，修改_condif.a4.yml的tool配置项的topToc即可。
如果想全局开关开关文章左侧目录，修改_condif.a4.yml的tool配置项的leftToc即可。

yml

# 是否启用一些特色工具 false | true
tool:
  darkMode: true # 暗黑模式
  returnToTop: true # 回到顶部按钮 
  returnToLast: true # 回退页面按钮
  topToc: true # 文章顶部目录
  leftToc: true # 文章左侧目录 目前仅支持大屏幕浮现

DANGER

在此之前的为基本配置，实现了A4主题追求的纯净风。

以下为非必要不必更改的配置。

A4全局色调自定义

实验性功能：A4色调调整：颜色搭配是很主观的行为，设置为false为A4 默认灰白色调，可设置为true直接启动体验下另一种护眼预置色调。

更多A4色调搭配推荐一览：https://ninojay.top/hexoplugin/A4-color-change/

yml

# 注：颜色代码需加“#”，颜色单词不需要加“#”
color: 
  enable: false # true | false 
  font: "#9e5345" # 字体颜色
  background: "#e8e0c9" # 最底部层背景颜色
  indexBackGround: "#efeae2" # 首页层颜色
  postBackGround: "#efeae2" # 文章页层颜色
  codeBackGround: "#e8e0c9" # 代码块背景颜色
  codeFont: "#2e5041" # 代码块字体颜色 
  linkBeforeClick: "#2e5041" # 链接点击前的颜色
  linkAfterClick: "#9c9caf" # 链接点击后的颜色

A4背景引入图片

图片你应该先放到 source下，下面选项的图片路径即为相对于 source 目录的路径。

yml

imageShow:
  enable: false
  background: /img/favicon.webp # 最底部层背景

字体

A4默认中文使用霞鹜文楷，如果你想关闭这种字体，首先保证enable为 true 接着可以开关对应字体。霞鹜文楷如果关闭，中文则使用的是思源宋体，思源宋体不提供关闭。

yml

font:
  enable: false # 是否使用字体开关功能
  LXGWWenKai: true # 霞鹜文楷 如果关闭，中文则使用的是 思源宋体，思源宋体不提供关闭

评论模块如何生效？

INFO

推荐使用waline评论，A4做了特定适配，在waline官网申请好了服务过后，

你只需要做如下配置:

在该主题配置文件_config.a4.yml中把comment设置为enable: true,use: waline，填写waline相关信息
启用过后，默认所有新建的post都开启评论模块
如果你想关闭某个post的comment，在对应post的front-matter中添加：comment: false即可

yml

# ---------------------------------------------------------------------------------------
# Comment plugin
# 评论插件：需要根据教程自行部署评论服务
# ---------------------------------------------------------------------------------------
comment:
  enable: false 
  use: waline # values: waline、twikoo、artalk

  # Waline
  # See: https://waline.js.org/guide/get-started.html
  waline:
    serverUrl:  # Waline server url(vercel) example: https://example.example.com
    lang: zh-CN # Waline language, default: zh-CN. See: https://waline.js.org/guide/client/i18n.html
    placeholder: 留下你的评论吧。 # 评论框背景信息

  # Twikoo
  # See: https://twikoo.js.org/quick-start.html
  twikoo:
    envId:  # 腾讯云环境填 envId；其它环境填地址
    region:  # 环境地域，默认为 ap-shanghai，腾讯云环境填 ap-shanghai 或 ap-guangzhou；其它环境不填
    lang:  # 用于手动设定评论区语言，支持的语言列表 https://github.com/imaegoo/twikoo/blob/main/src/client/utils/i18n/index.js


  # Artalk
  # See: https://artalk.js.org/guide/deploy.html
  artalk:
    server:  # Artalk 后端地址

CDN配置

目前硬编码了一些免费CDN，所以有挂的风险，一旦发现网站样式出现原来没有的问题，请尝试关闭CDN。

yml

# 你可能会用到的 https://ninojay.top/2023/website-cdn/
cdn:
  enable: false # 如果你修改了 css/js ，也许需要把cdn设置为false才会生效
  choose: zzko  # zzko | aliyun | unpkg| jsdelivr  # 都调整为利于国内的cdn，建议使用默认的 zzko 即可
  # 因为是免费CDN，所以有挂的风险，一旦发现网站样式出现原来没有的问题，请尝试关闭CDN

特色工具配置 ​

A4全局色调自定义 ​

A4背景引入图片 ​

字体 ​

评论模块如何生效？ ​

CDN配置 ​

特色工具配置

A4全局色调自定义

A4背景引入图片

字体

评论模块如何生效？

CDN配置