Hexo系列(四) NexT主题配置

Hexo 框架允许我们更换合适的主题,以便于构建不同风格的网站,这里介绍目前最常使用的一款主题之一 —— NexT

一、NexT 安装

在正式开始讲解 NexT 安装之前,我们必须明确以下几个概念:

在使用 Hexo 框架建立的网站中,存在两份重要的配置文件,它们的文件名称都是 _config.yml

一份是 站点配置文件,位于 站点根目录 下,用于网站的基础配置

另外一份是 主题配置文件,位于 themes 目录 下,用于主题的相关配置

不同的主题会有不同的主题配置文件,由主题作者所提供

1、下载 NexT

站点根目录 中打开 git bash 窗口,使用如下命令下载 NexT 主题文件到 themes 目录

$ git clone https://github.com/iissnan/hexo-theme-next themes/next

Cloning into 'themes/next'...
remote: Counting objects: 12033, done.
remote: Total 12033 (delta 0), reused 0 (delta 0), pack-reused 12033
Receiving objects: 100% (12033/12033), 13.00 MiB | 1.37 MiB/s, done.
Resolving deltas: 100% (6991/6991), done.
Checking out files: 100% (351/351), done.

注意:如果出现以下错误

error: RPC failed; curl 18 transfer closed with outstanding read data remaining
fatal: The remote end hung up unexpectedly
fatal: early EOF
fatal: index-pack failed

请尝试使用以下命令

$ git clone git://github.com/iissnan/hexo-theme-next themes/next

2、启用 NexT

打开 站点配置文件, 将 theme 选项的值改为 next,注意要在属性和值之间要加上一个空格

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

此时,登陆自己的站点,应该可以看到更改已经成功

二、NexT 配置

1、设置 Scheme

Scheme 是用于 改变网站布局 的一个设置项,NexT 目前提供四种 Scheme:

  • Muse :默认 Scheme,黑白主调,大量留白
  • Mist:Muse 的紧凑版本,整洁有序的单栏外观
  • Pisces:双栏 Scheme,小家碧玉的清新
  • Gemini:新增 Scheme

更改时,打开 主题配置文件,通过搜索关键字 Scheme Settings 定位,然后将使用的 scheme 打开注释即可

# ---------------------------------------------------------------
# Scheme Settings
# ---------------------------------------------------------------

# Schemes
#scheme: Muse
#scheme: Mist
scheme: Pisces
#scheme: Gemini

2、设置动态背景

更改时,打开 主题配置文件,通过搜索关键字 Canvas-nest 定位,然后将 canvas_nest 的值改成 true 即可

# Canvas-nest
canvas_nest: true

3、设置侧栏行为

默认情况下,侧栏仅在文章页面(拥有目录列表时)才显示,并放置于右侧位置

可以通过修改 主题配置文件 中的 Sidebar Settings 字段控制侧栏的行为

(1)侧栏位置:position

  • left:靠左放置
  • right:靠右放置

(2)侧栏显示时机:display

  • post:默认行为,在文章页面(拥有目录列表时)显示
  • always:在所有页面中都显示
  • hide:在所有页面中都隐藏
  • remove:完全移除
# Sidebar Position, available value: left | right (only for Pisces | Gemini).
position: left
#position: right

# Sidebar Display, available value (only for Muse | Mist):
#  - post    expand on posts automatically. Default.
#  - always  expand for all pages automatically
#  - hide    expand only when click on the sidebar toggle icon.
#  - remove  Totally remove sidebar including sidebar toggle.
display: post
#display: always
#display: hide
#display: remove

4、设置菜单

(1)设置菜单项

打开 主题配置文件,搜索关键字 Menu Settings 进行定位,各个菜单项通过 # 注释开启或关闭

# ---------------------------------------------------------------
# Menu Settings
# ---------------------------------------------------------------

# When running the site in a subdirectory (e.g. domain.tld/blog), remove the leading slash from link value (/archives -> archives).
# Usage: `Key: /link/ || icon`
# Key is the name of menu item. If translate for this menu will find in languages - this translate will be loaded; if not - Key name will be used. Key is case-senstive.
# Value before `||` delimeter is the target link.
# Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, question icon will be loaded.
menu:
  home: / || home
  #about: /about/ || user
  #tags: /tags/ || tags
  categories: /categories/ || th
  archives: /archives/ || archive
  #schedule: /schedule/ || calendar
  #sitemap: /sitemap.xml || sitemap
  #commonweal: /404/ || heartbeat

部分菜单项的功能描述如下:

  • home:主页
  • about:关于
  • tags:标签
  • categories:分类
  • archives:归档

(2)创建文件夹

这里演示创建 categories 分类页面的文件夹,其它菜单项的添加类似

站点根目录 下,打开 git bash,输入命令 $ hexo new page "categories"

$ hexo new page "categories"
INFO  Created: C:\Desktop\test\source\categories\index.md

(3)添加文档头部

这里演示添加 categories 分类页面的文档头部,其它菜单项的添加类似

打开新建的 index.md 文件,在 文档头部 添加以下描述:

---
title: categories
date: 2015-12-04 15:37:22
type: "categories"
comments: false
---

5、设置头像

打开 主题配置文件, 搜索关键字 Sidebar Avatar 进行定位,将 avatar 的值设置成头像图片的链接地址即可

# Sidebar Avatar
# in theme directory(source/images): /images/avatar.gif
# in site  directory(source/uploads): /uploads/avatar.gif
avatar: <url>

头像图片的链接地址可以是:

  • 完整的互联网地址:例如,https://www.example.com/avatar.jpg
  • 站点内的相对地址:例如,假设图片命名为 avatar.jpg,存放在 source/images/ 目录下,则链接地址可以写成 /images/avatar.jpg

6、添加社交链接

打开 主题配置文件,搜索关键字 Social Links 进行定位,social 的值按 Key: permalink || icon 格式设置

# Social Links.
# Usage: `Key: permalink || icon`
# Key is the link label showing to end users.
# Value before `||` delimeter is the target permalink.
# Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, globe icon will be loaded.
social:
  GitHub: https://github.com/Forwhfang || Github
  CSDN: https://blog.csdn.net/wsmrzx || CSDN
  cnblogs: https://www.cnblogs.com/wsmrzx || cnblogs

7、添加文字统计功能

进入 站点根目录,打开 git bash 窗口,输入如下命令安装插件

$ npm install hexo-wordcount --save

然后打开 主题配置文件,进行如下配置

# Post wordcount display settings
# Dependencies: https://github.com/willin/hexo-wordcount
post_wordcount:
  item_text: true
  wordcount: true
  min2read: true
  totalcount: true
  separated_meta: true

8、添加阅读量统计功能

主题配置文件 中修改 busuanzi_count 字段启用不蒜子统计功能

# Show PV/UV of the website/page with busuanzi.
# Get more information on http://ibruce.info/2015/04/04/busuanzi/
busuanzi_count:
  # count values only if the other configs are false
  enable: true
  # custom uv span for the whole site
  site_uv: true
  site_uv_header: <i class="fa fa-user"></i>
  site_uv_footer: 
  # custom pv span for the whole site
  site_pv: true
  site_pv_header: <i class="fa fa-eye"></i>
  site_pv_footer: 
  # custom pv span for one page only
  page_pv: true
  page_pv_header: <i class="fa fa-file-o"></i>
  page_pv_footer: 

【参考资料】

【Hexo系列相关文章】

posted @ 2018-08-07 21:07 wsmrzx的博客 阅读(...) 评论(...) 编辑 收藏