主题配置文件 使用介绍

主题配置文件 结构

• head
• url
• scheme
• uiux
• js_effect
• reading
• thumbnail
• background
• img
• fonts
• sns
• pages
• 第三方服务
  • comment
  • search
  • leancloud
  • busuanzi

head

head 条目用于配置生成的 HTML 文件的头部信息。

• favicon
• high_res_favicon: 高清 favicon
• high_res_favicon: iOS 主屏按钮图标
• keywords: 网站关键词

url

url 条目设置跳转链接。

• about: 默认为 注释 状态，当 生成 about 页面 后，将注释 # 去掉，关于 的入口会自动显示在独立页面菜单中。
• daily_pic: 设置 daily_pic 模块 跳转 url。
• logo: 设置 blog_info 模块中 点击 logo 的跳转 url。

scheme

scheme 参考：

如果要使用其中一个主题，将前面的注释 # 去掉即可。

uiux

uiux 条目设置主题 UI 与 UX。

• slogan: 显示在 blog_info 模块中的标语
• theme_color: 主题主要颜色。大部分地方使用此颜色
• theme_sub_color: 主题辅助颜色。其中 FAB 使用此颜色
• hyperlink_color: 超链接颜色。
• android_chrome_color: 安卓 Chrome 浏览器地址栏颜色。
• nprogress_color: 页面加载时顶部加载进度条的颜色。
• nprogress_buffer: 页面加载时顶部加载进度条的缓冲。

js_effect

js_effect 条目用来控制 Material 主题中自带的多种 js 特性。

• fade: 页面加载时部分模块的渐显效果。默认为 true。
• smoothscroll: 页面平滑滚动特效。默认为 true。

reading

reading 条目用来设置阅读体验。

• markdown: Markdown 解析样式。目前有两种样式，分别是 Material 和 Github。
• entry_excerpt: 首页文章输出摘要的字符长度。默认为80。

thumbnail

thumbnail 条目设置文章缩略图相关。

• purecolor: 填入颜色代码。如果文章内无设置缩略图，此项又不为空，则使用纯色缩略图。
• random_amount: 随机图片数量，根据 主题文件夹 -> source -> img -> random 中的图片数量设置。

background

background 条目设置站点背景。

• purecolor: 填入颜色代码。则站点使用纯色背景。
• bgimg: 背景地址，默认调用 主题文件夹 -> source -> img 中的 bg.png。可更换此图片或者自己填入 url。

img

img 条目设置站点图片。

• logo: 显示于 blog_info 模块中。
• avatar: 你的头像设置。
• daily_pic: 显示于 daily_pic 模块中。
• sidebar_header: 显示于 sidebar 顶部。
• footerico: 设置 footer 中 SNS 图标的路径。
• upyun_logo: 默认注释掉。取消注释后显示于 sidebar 底部。用于又拍云联盟的使用。
• random_thumbnail: 随机缩略图的路径。

fonts

fonts 条目用来设置站点的字体。

默认值为 Roboto, "Helvetica Neue", Helvetica, "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", "微软雅黑", Arial, sans-serif

该字体设定较为规范，如无特殊要求 无需额外修改。

sns

sns 条目用于填写你的 SNS 信息，除了 email，其他信息会以按钮的形式显示在 footer。

• email: 显示在侧边栏中。
• twitter
• facebook
• googleplus
• weibo
• instagram
• tumblr
• github

pages

此条目用于设置独立页面，默认为空，填写后独立页面入口将显示在：

• blog_info Page 按钮的下拉菜单中。(Scheme Paradox)
• 侧边栏 独立页面 菜单中。(Scheme Paradox)
• 站点左侧。(Scheme Isolation)

参考配置样式

pages:
    友情链接: "/links/"
    时间轴归档: "/timeline/"

首个参数为入口名字；后一个参数为相对路径，对应 hexo 目录下的 source 文件夹内的相应文件夹。

comment

该条目用于设置评论系统。

具体设置参考 评论系统

目前可使用 duoshuo disqus。

• use:
• shortname:
• duoshuo_embed_js_url: 多说 js。

search

该条目用于设置搜索系统。

具体设置参考 搜索系统

目前可使用 google swiftype。

• use
• swiftype_key

leancloud

具体设置参考 设置 Leancloud 浏览次数统计

• enable: 默认为 false。
• app_id: APP ID。
• app_key: APP Key。
• av_core_mini: 统计 js。

busuanzi

具体设置参考 不蒜子

• enable: 默认为 false。
• all_site_uv: 默认为 false。
• post_pv: 默认为 false。
• busuanzi_pure_mini_js: 统计 js。