Hexo-Next搭建个人博客（主题优化）

发表于 | 更新于 | 分类于 | 阅读次数：
本文字数： 8.8k | 阅读时长 ≈ 11 分钟


  • Hexo版本是3.7.1
  • NexT.Pisces v5.1.4

1. 常用命令

  • Hexo的命令极简单，安装后只需要记住四个常用的即可。执行命令需要Git当前处于blog文件夹根目录下。
  • generate 生成静态文件。
    hexo g
  • server 启动服务器。
    hexo s
  • deploy 部署网站。部署网站前，需要预先生成静态文件。
    hexo d
  • clean 清除缓存文件 (db.json) 和已生成的静态文件 (public)。
    hexo clean
  • 卸载Hexo
    npm uninstall hexo-cli -g

2.更换主题,以Next主题为例

1
2
$ cd your-hexo-site
$ git clone https://github.com/iissnan/hexo-theme-next themes/next
  • 修改Hexo 站点目录下的_config.yml的主题
1
2
3
4
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

3.站点初始设置

1
2
3
4
5
6
7
# Site
title: Hexo #网站标题
subtitle: #网站副标题
description: #网站描述
author: author #您的名字
language: zh-Hans #网站使用的语言
timezone: Asia/Shanghai #网站时区。Hexo 默认使用您电脑的时区。
  • 打开Hexo 站点目录下的_config.yml修改内容如下

4.设置主题风格

  • 打开themes/next下的_config.yml文件，搜索 scheme关键字，将你需用启用的scheme 前面注释 # 去除即可。
1
2
3
4
5
6
7
8
9
# ---------------------------------------------------------------
# Scheme Settings
# ---------------------------------------------------------------

# Schemes
#scheme: Muse # 默认 Scheme，这是 NexT 最初的版本，黑白主调，大量留白
#scheme: Mist # Muse 的紧凑版本，整洁有序的单栏外观
scheme: Pisces # 双栏 Scheme，小家碧玉似的清新
#scheme: Gemini # 类似 Pisces

5.设置菜单项的显示文本和图标

  • 更新说明：NexT.Pisces v5.1.3, 版本更换了修改菜单图标方式。参看详细信息

  • NexT 使用的是 Font Awesome 提供的图标， Font Awesome 提供了 600+ 的图标，可以满足绝大的多数的场景，同时无须担心在 Retina 屏幕下 图标模糊的问题。
5.1设置菜单项的显示文本：
  • 打开themes/next/languages下的zh-Hans.yml文件,搜索 menu关键字，修改对应中文或者新增
1
2
3
4
5
6
7
8
9
10
11
12
menu:
  home: 首页
  archives: 归档
  categories: 分类
  tags: 标签
  about: 关于
  search: 搜索
  schedule: 日程表
  sitemap: 站点地图
  commonweal: 公益404
  # 新增menu
  catalogue: 目录
5.2设定菜单项的图标
  • 打开themes/next下的_config.yml文件，搜索 menu_icons关键字，修改对应图标名称或者新增对应menu的图标
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# Enable/Disable menu icons.
# Icon Mapping:
#   Map a menu item to a specific FontAwesome icon name.
#   Key is the name of menu item and value is the name of FontAwesome icon. Key is case-senstive.
#   When an question mask icon presenting up means that the item has no mapping icon.
menu_icons:
  enable: true
  #KeyMapsToMenuItemKey: NameOfTheIconFromFontAwesome
  home: home
  about: user
  categories: th
  schedule: calendar
  tags: tags
  archives: archive
  sitemap: sitemap
  commonweal: heartbeat
  #新增menu_icon
  catalogue: th-list
5.3设置菜单项对应的文件目录
  • 打开themes/next下的_config.yml文件，搜索 menu关键字，以#注释原有的菜单项，或者新增新的菜单项
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# ---------------------------------------------------------------
# Menu Settings
# ---------------------------------------------------------------

# When running the site in a subdirectory (e.g. domain.tld/blog), remove the leading slash (/archives -> archives)
menu:
  home: /
  categories: /categories/
  #about: /about/
  archives: /archives/
  #tags: /tags/
  #sitemap: /sitemap.xml
  #commonweal: /404/
  #新增menu
  catalogue: /catalogues/
  • 除了home，archives,/后面都需要手动创建这个页面
5.4创建菜单项对应文件目录,以分类为例
  • 在终端窗口下，定位到 Hexo 站点目录下。使用 hexo new page 新建一个页面，命名为 categories ：
1
2
$ cd your-hexo-site
$ hexo new page categories
5.5编辑刚新建的页面,设置分类
1
2
3
4
5
title: 分类
date: 2014-12-22 12:39:04
categories: Testing #分类名
type: "categories"
---

6.头像设置

6.1添加头像
  • 打开themes/next下的_config.yml文件，搜索 Sidebar Avatar关键字，去掉avatar前面的#
1
2
3
4
# Sidebar Avatar
# in theme directory(source/images): /images/avatar.jpg
# in site  directory(source/uploads): /uploads/avatar.jpg
avatar: http://example.com/avatar.png
  • 或者使用本地图片,把图片放入themes/next/source/images下,修改avatar
1
avatar: /images/blogLogo.png
6.2设置头像边框为圆形框
  • 打开位于themes/next/source/css/_common/components/sidebar/下的sidebar-author.syl文件,修改如下
1
2
3
4
5
6
7
8
9
10
11
12
.site-author-image {
  display: block;
  margin: 0 auto;
  padding: $site-author-image-padding;
  max-width: $site-author-image-width;
  height: $site-author-image-height;
  border: $site-author-image-border-width solid $site-author-image-border-color;
 // 修改头像边框
  border-radius: 50%;
  -webkit-border-radius: 50%;
  -moz-border-radius: 50%;
}
6.3特效：鼠标放置头像上旋转

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
.site-author-image {
  display: block;
  margin: 0 auto;
  padding: $site-author-image-padding;
  max-width: $site-author-image-width;
  height: $site-author-image-height;
  border: $site-author-image-border-width solid $site-author-image-border-color;
 // 修改头像边框
  border-radius: 50%;
  -webkit-border-radius: 50%;
  -moz-border-radius: 50%;
  // 设置旋转
  transition: 1.4s all;
}
// 可旋转的圆形头像,`hover`动作
.site-author-image:hover {
    -webkit-transform: rotate(360deg);
    -moz-transform: rotate(360deg);
    -ms-transform: rotate(360deg);
    -transform: rotate(360deg);
}

7.浏览页面的时候显示当前浏览进度

  • 打开themes/next下的_config.yml,搜索关键字scrollpercent,把false改为true
1
2
# Scroll percent label in b2t button
 scrollpercent: true
  • 如果想把top按钮放在侧边栏,打开themes/next下的_config.yml,搜索关键字b2t,把false改为true
1
2
3
4
5
# Back to top in sidebar
 b2t: true
    
 # Scroll percent label in b2t button
 scrollpercent: true

效果如下图：

8.文章创建和删除

  • 创建文章
1
2
3
   $ cd you-site
   $ hexo new post "you title"
# 可以使用n代替new

  • 文章目录
    you-site/source/_posts

  • 删除文章

1
2
3
$ hexo clean
在/source/_posts/中直接删除了相应的.md文件
$ hexo g

9.标签设置

9.1创建标签目录
  • hexo初始是没有标签目录的需要自己创建
1
2
$ cd you-site
$ hexo new page tags
  • 创建完成后,打开you-site/source/tags的index.md,修改如下
1
2
3
4
5
---
title:  #页面主题
date: 2017-08-18 15:00:55 #当前创建文件时间
type: "tags" # 设置页面类型
---
  • 得到如下界面

9.2设置标签云
  • 标签云的生成:是根据你创建的文章，设定标签类型，自定生成的。某个标签下的 文章越多则，标签越高大
  • 设置文章标签:打开you-site/source/_posts的you title.md,默认tags:为空,后面加上标签名即可
1
2
3
4
5
6
7
---
layout: layout
title: 标签1
date: 2017-08-18 15:41:18
tags: 标签1 #此文章在`标签1 `标签下
#tags: [标签1,标签2] #此文章在`标签1,标签2`下
---

10侧边栏设置

10.1 设置侧边栏社交链接
  • 打开themes/next下的_config.yml文件,搜索关键字social,然后添加社交站点名称与地址即可。
1
2
3
4
5
6
7
8
# Social links
social:
  GitHub: https://github.com/your-user-name
  Twitter: https://twitter.com/your-user-name
  Weibo: https://weibo.com/your-user-name
  douban: https://douban.com/people/your-user-name
  zhihu: https://www.zhihu.com/people/your-user-name
  # 等等
10.2 设置侧边栏社交图标
  • 打开themes/next下的_config.yml文件,搜索关键字social_icons，添加社交站点名称（注意大小写）图标，Font Awesome图标地址
1
2
3
4
5
6
7
8
social_icons:
  enable: true
  # Icon Mappings.
  # KeyMapsToSocalItemKey: NameOfTheIconFromFontAwesome
  GitHub: github
  Twitter: twitter
  Weibo: weibo
  Linkedin: linkedin
10.3RSS

  • 在你Hexo 站点目录下
1
$ npm install hexo-generator-feed --save
  • 打开Hexo 站点下的_config.yml,添加如下配置
1
2
3
4
5
6
7
8
# feed
# Dependencies: https://github.com/hexojs/hexo-generator-feed
feed:
  type: atom
  path: atom.xml
  limit: 20
  hub:
  content:
10.4友情链接
  • 打开themes/next下的_config.yml文件,搜索关键字Blog rolls
1
2
3
4
5
6
7
# Blog rolls
links_title: 友情链接 #标题
links_layout: block #布局，一行一个连接
#links_layout: inline
links: #连接
  baidu: http://example.com/
  google: http://example.com/

11好玩的写作样式

用一些特殊的样式，可以增加文章的可读性。不过也不是越多越好，没必要写一篇文章就把下面的样式全部用一遍，这样只会适得其反，从下面的样式中选几个自己觉得比较好的、经常会用的就行。而且写博客重点是文章的文字内容，而不是这些样式，样式只是为了让文章更美观，更适合阅读。这和我们用 Markdown 写文章是一样的道理，用 Markdown 而不是直接写 HTML 代码，就是为了将更多时间花在文字上。

11.01主题自带样式 文本居中引用

效果：

人生乃是一面镜子，
从镜子里认识自己，
我要称之为头等大事，
也只是我们追求的目的！

源码：

1
2
3
4
5
6
{% cq %}
人生乃是一面镜子，
从镜子里认识自己，
我要称之为头等大事，
也只是我们追求的目的！
{% endcq %}

更多 NexT 主题自带的标签样式，请点击：http://theme-next.iissnan.com/tag-plugins.html

11.02主题自带样式 note 标签

在主题配置文件_config.yml里有一个关于这个的配置，但官方文档没有提供 HTML 的使用方式，个人认为这种方式更简单，也不会产生一些奇怪的显示 bug……

1
<div class="note default"><p>default</p></div>

default

1
<div class="note primary"><p>primary</p></div>

primary

1
<div class="note success"><p>success</p></div>

success

1
<div class="note info"><p>info</p></div>

info

1
<div class="note warning"><p>warning</p></div>

warning

1
<div class="note danger"><p>danger</p></div>

danger

1
<div class="note danger no-icon"><p>danger no-icon</p></div>

danger no-icon

首先可以在主题配置文件中需要配置下，贴上我的：

1
2
3
4
5
6
7
8
9
# Note tag (bs-callout).
note:
  # 风格
  style: flat
  # 要不要图标
  icons: true
  # 圆角矩形
  border_radius: 3
  light_bg_offset:

里面的三种风格长啥样？开启图标长啥样？可以查看这个页面，更多的介绍也在这个页面，请自行查看。

11.03主题自带样式 label 标签

首先可以在主题配置文件中有配置，需要配置下，贴上我的:

1
2
# Label tag.
label: true

然后效果如下（@ 前面的是label的名字，后面的是要显示的文字）：

default 
1
{% label default@default %}
primary 
1
{% label primary@primary %}
success 
1
{% label success@success %}
info 
1
{% label info@info %}
warning 
1
{% label warning@warning %}
danger 
1
{% label danger@danger %}
11.03主题自带样式 tabs 标签

效果：

这是选项卡 1 呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈……

这是选项卡 2

这是选项卡 3 哇，你找到我了！φ(≧ω≦*)♪～

源码：

1
2
3
4
5
6
7
8
9
10
11
{% tabs 选项卡, 2 %}
<!-- tab -->
**这是选项卡 1** 呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈呵呵哈哈哈哈哈哈哈哈……
<!-- endtab -->
<!-- tab -->
**这是选项卡 2**
<!-- endtab -->
<!-- tab -->
**这是选项卡 3** 哇，你找到我了！φ(≧ω≦*)♪～
<!-- endtab -->
{% endtabs %}

首先可以在主题配置文件中有配置，需要配置下，贴上我的：

1
2
3
4
5
6
7
# Tabs tag.
tabs:
  enable: true
  transition:
    tabs: true
    labels: true
  border_radius: 0

然后上面源码中, 2表示一开始在第二个选项卡，非必须，若数值为-1则隐藏选项卡内容。更多用法请查看这个页面。

11.04主题自带样式 tabs 标签

源码：

1
{% btn https://www.baidu.com, 点击下载百度, download fa-lg fa-fw %}

效果：点击下载百度
关于按钮的更多使用可以前往这个页面查看。

如果你觉得这篇文章对你有用，欢迎赞赏哦~
本文结束啦 感谢您阅读
0%