Skip to content

2. 主题常规配置

Jump to bottom
Michael.Lu edited this page Apr 30, 2019 · 10 revisions

以下无特别说明均为：主题配置文件themes/mellow/_config.yml中的配置

全局配置

是否启用less压缩

建议压缩，并且不要修改默认paths

less:
  compress: true #是否压缩
  paths:
    - source/css/style.less #压缩后的文件路径

站点ico图标

favicon: /img/favicon.ico

头部背景

# 如/img/banner.jpg 或 https://i.loli.net/2017/12/12/5a2fd18a74471.jpg
headerBg: false

动态定义title

title_change:
  normal: (つェ⊂)咦!又好了!     #页面获得焦点时显示(短暂存在)
  leave: 死鬼去哪里了！         #页面失去焦点后显示

规范网址

让搜索引擎重定向你的不同域名、不同子域、同域不同目录的站点到你期望的路径

假设配置为 canonical: http://www.lujingtao.com

那么从搜索引擎中 www.lujingtao.com 进入会重定向到 lujingtao.com

canonical: false

主页文章排序方式

## true 按照文章更新时间排序
## false 按照文章创建时间排序
articleSort: false

站浏览数统计

## false关闭
visit_counter: 
  site_uv: true # 访客数量
  site_pv: true # 浏览次数

菜单配置

头像

avatar: /img/avatar.jpg

头像点击后的链接地址

avatar_link: / #默认为主页

头像区域背景图

brand: /

电子邮件

email: 277133779@qq.com

电子邮件下方的链接图标

新连接规则 [name]: url | icon

使用fontawesome图标。

自动添加前缀，只需要写图标名。github 相当于 icon-github 或者 fa-github

menu_link: 
  github: https://github.com/codefine | github

菜单

## 添加新菜单项遵循以下规则：
## menu:
##  link:               [必要][不渲染] 用于区分类别
##    icon: _blank      [必要][渲染] 菜单图标。使用内置fontawesome图标，省略前缀
##    text: About       [必要][渲染] 菜单文字信息
##    url: /about       [必要][渲染] 菜单链接，绝对或相对路径。
##    target: _blank    [必要][不渲染] 是否跳出，省略则在当前页面打开

menu:
  home:
    text: HOME
    url: /
    icon: home
  th-list:
    text: CATEGORIES
    url: /categories
    icon: th-list
  tags:
    text: TAGS
    url: /tags
    icon: tags
  archives:
    text: ARCHIVES
    url: /archives
    icon: archives
  #about:
    #text: ABOUT
    #url: /about
    #icon: user
  demo:
    text: CUSTOM
    url: /custom
    icon: plus-square
  #github:
    #url: https://github.com/codefine
    #target: _blank
    #icon: github
  #weibo:
    #url: http://www.weibo.com/codefine
    #target: _blank

开启与目录中对应页面方法，以标签页为例:

  1. 初始化页面
$ hexo new page tags
  1. 修改blog/source/tags/index.md元数据
layout: tags # 自定义页面无需layout字段

首页配置

首页是否开启置顶标志

top_icon: true

在文章头部添加top: 1字段，主题引擎会根据会面的数字进行置顶排序

文章配置

页面标题

标签页 / 分类页 / 归档页的标题只能在这里设置

其他自定义页面标题在页面markdown文件的title中设置

tags_title: Tags              #标签页
categories_title: Categories  #分类页
archives_title: Archives      #归档页

主页文章摘要缩略图

全局设置：

defaultthumb: false #//i.loli.net/2017/12/12/5a2fd18a74471.jpg

以下三种设置默认均可开启：

defaultthumb: true #主题内置10张图，倒序循环插入
defaultthumb: //i.loli.net/2017/12/12/5a2fd18a74471.jpg #所有文章缩略图全部显示为这张图片
defaultthumb: ["/img/thumb/1.jpg", "/img/thumb/2.jpg"] #正序循环数组，倒序循环插入

也可以在文章文件头中进行单独设置，详见6. 文件头常用设置

主页中的文章摘要

excerpt_length只在excerpt_render为true时生效。

excerpt_render为false时可进行手动截断。

手动截断: 在文章的markdown文件中加入<!--more-->，其之前的内容视为摘要部分。

excerpt_render: false   #自动截断
excerpt_length: 200     #截断长度
excerpt_link: more...   #按钮内容

是否显示文章最后更新时间

最后更新时间位于文章底部的copyright栏目中

show_last_updated: true

版权信息copyright

hexo中所有变量及辅助函数等均可调用，具体请查阅hexo.io

postMessage: 转载注明出处，原文地址：<a href="<%- url_for(page.path).replace(/index\.html$/, "") %>" target="_blank" rel="external"><%- page.permalink.replace(/index\.html$/, "") %></a>

打赏

全局移除该功能直接注释下方配置

reward:
  title: 我们一起来让这个世界有趣一点
  wechat: /img/reward-wechat.jpg     #微信
  alipay: /img/reward-alipay.jpg     #支付宝

可以在指定文章头部设置reward: false来取消本篇文章的打赏功能

分享

内置6种分享途径，不需要的设置对应的为false*

全局移除该功能直接注释下方配置

share_items:
  weibo: true
  wechat: true
  qq: true
  facebook: false
  twitter: false
  google: false

可以在指定文章头部设置share: false来取消本篇文章的分享功能

索引

自动捕捉文章markdown的#一级标题 / ##二级标题 / ###三级标题等

位于文章右侧，移动端或者小屏幕自动隐藏。自动收缩。

toc:
  enable: true
  list_number: true  # 是否显示数字排序

页脚配置

友情链接

blogroll:
  item1:
    name: github
    url: https://www.github.com
  item2:
    name: gitee
    url: https://www.gitee.com
  item3:
    name: coding
    url: https://www.coding.net

版权起始年份

since_year: 2017

icp备案号

例如ICP_license: 京ICP备123456号

ICP_license: false

驱动引擎/主题等信息

power: true

搭载的服务器信息

如果使用github或者gitee等pages功能，可以设置为false

如果使用coding.net的pages作为host，该选项将帮助您清除默认广告页面

详情见https://coding.net/help/doc/pages/guide-page.html

hosted: false

第三方配置

搜索

local_search: true

需要在站点配置文件blog/_config.yml中加入如下配置

search:
  path: search.xml
  field: post

百度统计

baidu_tongji: #appid

gitment评论系统

gitment:
  enable: false
  lazy: true #是否开启初始化隐藏评论
  owner: codefine #github账号
  repo: gitment #留言仓库
  oauth: 
    client_id: #client_id
    client_secret: #client_id
  perPage: 10 #分页

valine评论系统

文档https://valine.js.org/

valine:
  enable: true
  appid: # appid
  appkey: # appkey
  notify: false  #是否开启邮箱提醒
  verify: false  #是否开启验证码
  placeholder: give me some sugers plz... #留言板中的预留信息
  avatar: 'wavatar'  #用户头像

可以在指定文章头部设置comment: false来取消本篇文章的评论功能

文章浏览统计

leancloud_visitors:
  enable: true
  app_id: # appid
  app_key: # appkey
  icon: true #true只显示图标，false只显示文字

数学公式

mathjax:
  enable: true
  cdn: //cdn.bootcss.com/mathjax/2.7.1/latest.js?config=TeX-AMS-MML_HTMLorMML

是否使用按钮waves插件

waves: true

如果您有好的建议或使用中发现问题，请通过如下方式进行问题反馈

  • 在主题仓库中提交 Issues
  • Fork主题仓库到自己的仓库中，修改并提交 Pull requests
Clone this wiki locally