本篇文章将介绍NexT
的主题设定与配置
在
Hexo
中有两份主要的配置文件,其名称都是_config.yml
。其中,一份位于站点根目录下,主要包含Hexo
本身的配置;另一份位于主题目录下,这份配置由主题作者提供,主要用于配置主题相关的选项。
我们约定,将前者称为 站点配置文件,后者称为 主题配置文件
Scheme
是 NexT
提供的一种特性,借助于Scheme``,NexT
为你提供多种不同的外观。同时,几乎所有的配置都可以 在 Scheme
之间共用。目前 NexT
支持三种 Scheme
,他们是:
-Muse
- 默认 Scheme
,这是NexT
最初的版本,黑白主调,大量留白
- Mist
- Muse
的紧凑版本,整洁有序的单栏外观
- Pisces
- 双栏 Scheme
,小家碧玉似的清新
Scheme
的切换通过更改主题配置文件,搜索scheme
关键字。 你会看到有三行 scheme
的配置,将你需用启用的 scheme
前面注释 # 去除即可。
选择 Pisces Scheme
#scheme: Muse
#scheme: Mist
scheme: Pisces
编辑站点配置文件, 将 language
设置成你所需要的语言。建议明确设置你所需要的语言,例如选用简体中文,配置如下:
language: zh-Hans
菜单配置包括三个部分,第一是菜单项(名称和链接),第二是菜单项的显示文本,第三是菜单项对应的图标。 NexT 使用的是Font Awesome
提供的图标,Font Awesome
提供了 600+
的图标,可以满足绝大的多数的场景,同时无须担心在Retina
屏幕下 图标模糊的问题。
编辑主题配置文件
,修改以下内容:1、 设定菜单内容,对应的字段是menu
。 菜单内容的设置格式是:item name
:link
。其中 item name
是一个名称,这个名称并不直接显示在页面上,她将用于匹配图标以及翻译。
menu:
home: /
archives: /archives
#about: /about
#categories: /categories
tags: /tags
#commonweal: /404.html
若你的站点运行在子目录中,请将链接前缀的
/
去掉
NexT
默认的菜单项有(标注 的项表示需要手动创建这个页面):
键值 | 设定值 | 显示文本(简体中文) |
---|---|---|
home | home: / | 主页 |
archives | archives: /archives | 归档页 |
categories | categories: /categories | 分类页 |
tags | tags: /tags | 标签页 |
about | about: /about | 关于页面 |
commonweal | commonweal: /404.html | 公益 404 |
2、 设置菜单项的显示文本。在第一步中设置的菜单的名称并不直接用于界面上的展示。Hexo
在生成的时候将使用 这个名称查找对应的语言翻译,并提取显示文本。这些翻译文本放置在NexT
主题目录下的languages/{language}.yml
({language
} 为你所使用的语言)。
以简体中文为例,若你需要添加一个菜单项,比如 something
。那么就需要修改简体中文对应的翻译文件languages/zh-Hans.yml
,在 menu
字段下添加一项:
menu:
home: 首页
archives: 归档
categories: 分类
tags: 标签
about: 关于
search: 搜索
commonweal: 公益404
something: 有料
3、 设定菜单项的图标,对应的字段是menu_icons
。 此设定格式是item name: icon name
,其中 item name
与上一步所配置的菜单名字对应,icon name
是 Font Awesome
图标的 名字。而enable
可用于控制是否显示图标,你可以设置成false
来去掉图标。
menu_icons:
enable: true
# Icon Mapping.
home: home
about: user
categories: th
tags: tags
archives: archive
commonweal: heartbeat
在菜单图标开启的情况下,如果菜单项与菜单未匹配(没有设置或者无效的
Font Awesome
图标名字) 的情况下,NexT 将会使用 作为图标。
默认情况下,侧栏仅在文章页面(拥有目录列表)时才显示,并放置于右侧位置。 可以通过修改 主题配置文件
中的sidebar
字段来控制侧栏的行为。侧栏的设置包括两个部分,其一是侧栏的位置, 其二是侧栏显示的时机。
1、设置侧栏的位置,修改 sidebar.position
的值,支持的选项有:
left
- 靠左放置 right
- 靠右放置sidebar:
position: left
2、 设置侧栏显示的时机,修改sidebar.display
的值,支持的选项有:
post
- 默认行为,在文章页面(拥有目录列表)时显示always
- 在所有页面中都显示hide
- 在所有页面中都隐藏(可以手动展开)remove
- 完全移除sidebar:
display: post
编辑 主题配置文件
, 修改字段avatar
, 值设置成头像的链接地址。其中,头像的链接地址可以是:
地址 | 值 |
---|---|
完整的互联网 | URI :http://example.com/avatar.png |
站点内的地址 | 将头像放置主题目录下的source/uploads/ (新建 uploads 目录若不存在) 配置为:avatar: /uploads/avatar.png 或者 放置在 source/images/ 目录下 , 配置为:avatar: /images/avatar.png |
avatar: http://example.com/avatar.png
编辑 站点配置文件, 设置author
为你的昵称。
站点描述
编辑 站点配置文件, 设置 description
字段为你的站点描述。站点描述可以是你喜欢的一句签名:)
## 主题配置
RSS
NexT
中RSS
有三个设置选项,满足特定的使用场景。 更改主题配置文件
rss
字段的值:
-false
:禁用 RSS
,不在页面上显示RSS
连接。
- 留空:使用Hexo
生成的Feed
链接。 你可以需要先安装hexo-generator-feed
插件。
- 具体的链接地址:适用于已经烧制过Feed
的情形。
新建「标签」页面,并在菜单中显示「标签」链接。「标签」页面将展示站点的所有标签,若你的所有文章都未包含标签,此页面将是空的。 底下代码是一篇包含标签的文章的例子:
title: tags
tags:
- Testing
- Another Tag
---
在终端窗口下,定位到Hexo
站点目录下。使用hexo new page 新建一个页面
,命名为 tags
:
$ cd your-hexo-site
$ hexo new page tags
编辑刚新建的页面,将页面的类型设置为tags
,主题将自动为这个页面显示标签云。页面内容如下:
title: 标签
date: 2018-2-22 23:39:04
type: "tags"
---
在菜单中添加链接。编辑主题配置文件
, 添加tags
到
menu
中,如下:
menu:
home: /
archives: /archives
tags: /tags
注意:如果有集成评论服务,页面也会带有评论。 若需要关闭的话,请添加字段
comments
并将值设置为false
,如:
title: 标签
date: 2018-2-22 23:39:04
type: "tags"
comments: false
---
新建「分类」页面,并在菜单中显示「分类」链接。「分类」页面将展示站点的所有分类,若你的所有文章都未包含分类,此页面将是空的。 底下代码是一篇包含分类的文章的例子:
title: categories
categories: Testing
---
在终端窗口下,定位到 Hexo
站点目录下。使用 hexo new page 新建一个页面
,命名为categories
:
$ cd your-hexo-site
$ hexo new page categories
编辑刚新建的页面,将页面的type
设置为 categories
,主题将自动为这个页面显示分类。页面内容如下:
title: categories
date: 2018-2-22 23:39:04
type: "categories"
---
在菜单中添加链接。编辑主题配置文件
, 添加categories
到
menu
中,如下:
menu:
home: /
archives: /archives
categories: /categories
注意:如果有集成评论服务,页面也会带有评论。 若需要关闭的话,请添加字段
comments
并将值设置为false
,如:
title: categories
date: 2018-2-22 23:39:04
type: "categories"
comments: false
---
NexT
开放了 5 个特定范围的字体设定,他们是:
(h1, h2, h3, h4, h5, h6)
Logo
字体:Logo
所使用的字体 Fallback
到 NexT
设定的基础字体组:Fallback
到 PingFang SC
, Microsoft YaHei
, sans-serif
Fallback
到 consolas
, Menlo
, PingFang SC
, Microsoft YaHei
, monospace
external
属性,此属性用来控制是否使用外链字体库。 开放此属性方便你设定那些已经安装在系统中的字体,减少不必要的请求(请求大小)。font:
enable: true
# 外链字体库地址,例如 //fonts.googleapis.com (默认值)
host:
# 全局字体,应用在 body 元素上
global:
external: true
family: Monda
# 标题字体 (h1, h2, h3, h4, h5, h6)
headings:
external: true
family: Roboto Slab
# 文章字体
posts:
external: true
family:
# Logo 字体
logo:
external: true
family: Lobster Two
size: 24
# 代码字体,应用于 code 以及代码块
codes:
external: true
family: PT Mono
NexT
使用 Tomorrow Theme
作为代码高亮,共有5款主题供你选择。NexT
默认使用的是 白色的 normal
主题,可选的值有normal
,night
,night blue
, night bright
,night eighties
:
更改 highlight_theme
字段,将其值设定成你所喜爱的高亮主题,例如:
高亮主题设置示例
# Code Highlight theme
# Available value: normal | night | night eighties | night blue | night bright
# https://github.com/chriskempson/tomorrow-theme
highlight_theme: night
侧栏社交链接的修改包含两个部分,第一是链接,第二是链接图标。 两者配置均在主题配置文件
中。1、 链接放置在 social
字段下,一行一个链接。其键值格式是 显示文本: 链接地址
。
# Social links
social:
GitHub: https://github.com/your-user-name
Twitter: https://twitter.com/your-user-name
微博: http://weibo.com/your-user-name
豆瓣: http://douban.com/people/your-user-name
知乎: http://www.zhihu.com/people/your-user-name
# 等等
2、 设定链接的图标,对应的字段是 social_icons。其键值格式是 匹配键:Font Awesome
图标名称, 匹配键 与上一步所配置的链接的 显示文本 相同(大小写严格匹配),图标名称 是Font Awesome
图标的名字(不必带 fa- 前缀)。 enable
选项用于控制是否显示图标,你可以设置成 false 来去掉图标。
# Social Icons
social_icons:
enable: true
# Icon Mappings
GitHub: github
Twitter: twitter
微博: weibo
越来越多的平台(微信公众平台,新浪微博,简书,百度打赏等)支持打赏功能,付费阅读时代越来越近,特此增加了打赏功能,支持微信打赏和支付宝打赏。 只需要主题配置文件
中填入 微信 和 支付宝 收款二维码图片地址 即可开启该功能。reward_comment: 坚持原创技术分享,您的支持将鼓励我继续创作!
wechatpay: /path/to/wechat-reward-image
alipay: /path/to/alipay-reward-image
编辑主题配置文件
添加:# title
links_title: Links
links:
MacTalk: http://macshuo.com/
Title: http://example.com/
这个时间将在站点的底部显示,例如© 2018
。编辑主题配置文件
since: 2018
在每篇文章的末尾显示微信公众号二维码,扫一扫,轻松订阅博客。
在微信公众号平台下载您的二维码,并将它存放于博客source/uploads/
目录下。
然后编辑主题配置文件
,如下:# Wechat Subscriber
wechat_subscriber:
enabled: true
qcode: /uploads/wechat-qcode.jpg
description: 欢迎您扫一扫上面的微信公众号,订阅我的博客!
NexT
默认开启动画效果,效果使用JavaScript
编写,因此需要等待 JavaScript
脚本完全加载完毕后才会显示内容。 如果您比较在乎速度,可以将设置此字段的值为 false
来关闭动画。
编辑 主题配置文件
, 搜索use_motion
,根据您的需求设置值为
true
或者
false
即可:
use_motion: true # 开启动画效果
use_motion: false # 关闭动画效果