【Hexo实战】让你鸟枪换大炮-NexT主题

蔚落 2022-02-19 11:25 207阅读 0赞

上一节我们讲到如何利用hexo快速搭建一个网站，但是hexo默认的主题实在是太难看了，严重不符合我们的审美，所以今天给大家介绍一下：hexo如何更换主题，让你丑小鸭变成白天鹅。

![image][]

### 绪论 ###

在 Hexo 中有两份主要的配置文件，其名称都是 \_config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。

为了描述方便，在以下说明中，将前者称为 **站点配置文件**， 后者称为 **主题配置文件**

### 安装 NexT ###

Hexo 安装主题的方式非常简单，只需要将主题文件拷贝至站点目录的 themes 目录下， 然后修改下配置文件即可。具体到 NexT 来说，安装步骤如下。

**下载主题**

在终端窗口下，定位到 Hexo 站点目录下。使用 Git checkout 代码： ![image][image 1]

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

> 还有一种方法是去NexT的GitHub地址下载对应版本，这边就不多做介绍。

### 启用NexT主题 ###

与所有 Hexo 主题启用的模式一样。 当 克隆/下载 完成后，打开 站点配置文件， 找到 theme 字段，并将其值更改为 next。 ![image][image 2]![image][image 3]

theme: next

到此，NexT 主题安装完成。下一步我们将验证主题是否正确启用。在切换主题之后、验证之前， 我们最好使用 hexo clean 来清除 Hexo 的缓存。

### 验证主题 ###

首先启动 Hexo 本地站点，并开启调试模式（即加上 --debug），整个命令是 hexo s --debug。 在服务启动的过程，注意观察命令行输出是否有任何异常信息，如果你碰到问题，这些信息将帮助他人更好的定位错误。 当命令行输出中提示出：

INFO  Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

此时即可使用浏览器访问 [http://localhost:4000][http_localhost_4000]，检查站点是否正确运行。

当你看到站点的外观与下图所示类似时即说明你已成功安装 NexT 主题。这是 NexT 默认的 Scheme —— Muse ![image][image 4]

现在，你已经成功安装并启用了 NexT 主题。下一步我们将要更改一些主题的设定，包括个性化以及集成第三方服务。

### 主题设定 ###

选择 Scheme Scheme 是 NexT 提供的一种特性，借助于 Scheme，NexT 为你提供多种不同的外观。同时，几乎所有的配置都可以 在 Scheme 之间共用。目前 NexT 支持三种 Scheme，他们是：

Muse - 默认 Scheme，这是 NexT 最初的版本，黑白主调，大量留白

1.  Mist - Muse 的紧凑版本，整洁有序的单栏外观
2.  Pisces - 双栏 Scheme，小家碧玉似的清新
3.  Scheme 的切换通过更改

**主题配置文件**，搜索 scheme 关键字。 你会看到有三行 scheme 的配置，将你需用启用的 scheme 前面注释 \# 去除即可。 ![image][image 5]![image][image 6]

#scheme: Muse
    #scheme: Mist
    scheme: Pisces

这边我选择的是Mist主题

### 设置 语言 ###

编辑 站点配置文件， 将 `language` 设置成你所需要的语言。建议明确设置你所需要的语言，例如选用简体中文，配置如下：

language: zh-Hans

目前 NexT 支持的语言如以下表格所示：

<table> 
 <thead> 
  <tr> 
   <th>语言</th> 
   <th>代码</th> 
   <th>设定示例</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>English</td> 
   <td><code>en</code></td> 
   <td><code>language: en</code></td> 
  </tr> 
  <tr> 
   <td>简体中文</td> 
   <td><code>zh-Hans</code></td> 
   <td><code>language: zh-Hans</code></td> 
  </tr> 
  <tr> 
   <td>Français</td> 
   <td><code>fr-FR</code></td> 
   <td><code>language: fr-FR</code></td> 
  </tr> 
  <tr> 
   <td>Português</td> 
   <td><code>pt</code></td> 
   <td><code>language: pt</code>&nbsp;or&nbsp;<code>language: pt-BR</code></td> 
  </tr> 
  <tr> 
   <td>繁體中文</td> 
   <td><code>zh-hk</code>&nbsp;或者&nbsp;<code>zh-tw</code></td> 
   <td><code>language: zh-hk</code></td> 
  </tr> 
  <tr> 
   <td>Русский язык</td> 
   <td><code>ru</code></td> 
   <td><code>language: ru</code></td> 
  </tr> 
  <tr> 
   <td>Deutsch</td> 
   <td><code>de</code></td> 
   <td><code>language: de</code></td> 
  </tr> 
  <tr> 
   <td>日本語</td> 
   <td><code>ja</code></td> 
   <td><code>language: ja</code></td> 
  </tr> 
  <tr> 
   <td>Indonesian</td> 
   <td><code>id</code></td> 
   <td><code>language: id</code></td> 
  </tr> 
  <tr> 
   <td>Korean</td> 
   <td><code>ko</code></td> 
   <td><code>language: ko</code></td> 
  </tr> 
 </tbody> 
</table>

我们可以看到文字已经变成汉语了，说明我们语言设置已经成功了。

![image][image 7]

### 设置 菜单 ###

菜单配置包括三个部分，第一是菜单项（名称和链接），第二是菜单项的显示文本，第三是菜单项对应的图标。 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 默认的菜单项有（标注  的项表示需要手动创建这个页面）：
    
    <table> 
     <thead> 
      <tr> 
       <th>键值</th> 
       <th>设定值</th> 
       <th>显示文本（简体中文）</th> 
      </tr> 
     </thead> 
     <tbody> 
      <tr> 
       <td>home</td> 
       <td><code>home: /</code></td> 
       <td>主页</td> 
      </tr> 
      <tr> 
       <td>archives</td> 
       <td><code>archives: /archives</code></td> 
       <td>归档页</td> 
      </tr> 
      <tr> 
       <td>categories</td> 
       <td><code>categories: /categories</code></td> 
       <td>分类页&nbsp;</td> 
      </tr> 
      <tr> 
       <td>tags</td> 
       <td><code>tags: /tags</code></td> 
       <td>标签页&nbsp;</td> 
      </tr> 
      <tr> 
       <td>about</td> 
       <td><code>about: /about</code></td> 
       <td>关于页面&nbsp;</td> 
      </tr> 
      <tr> 
       <td>commonweal</td> 
       <td><code>commonweal: /404.html</code></td> 
       <td>公益 404&nbsp;</td> 
      </tr> 
     </tbody> 
    </table>
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 将会使用  作为图标。
    
    请注意键值（如 `home`）的大小写要严格匹配

### 设置 侧栏 ###

默认情况下，侧栏仅在文章页面（拥有目录列表）时才显示，并放置于右侧位置。 可以通过修改 主题配置文件 中的 `sidebar` 字段来控制侧栏的行为。侧栏的设置包括两个部分，其一是侧栏的位置， 其二是侧栏显示的时机。

1.  设置侧栏的位置，修改 `sidebar.position` 的值，支持的选项有：
    
    目前仅 Pisces Scheme 支持 `position` 配置。影响版本5.0.0及更低版本。
    
        sidebar:  position: left
    
     *  left - 靠左放置
     *  right - 靠右放置
2.  设置侧栏显示的时机，修改 `sidebar.display` 的值，支持的选项有：
    
        sidebar:  display: post
    
    已知侧栏在 `use motion: false` 的情况下不会展示。 影响版本5.0.0及更低版本。
    
     *  `post` - 默认行为，在文章页面（拥有目录列表）时显示
     *  `always` - 在所有页面中都显示
     *  `hide` - 在所有页面中都隐藏（可以手动展开）
     *  `remove` - 完全移除

### 设置 头像 ###

编辑 主题配置文件， 修改字段 `avatar`， 值设置成头像的链接地址。其中，头像的链接地址可以是：

<table> 
 <thead> 
  <tr> 
   <th>地址</th> 
   <th>值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>完整的互联网 URI</td> 
   <td><code>http://example.com/avatar.png</code></td> 
  </tr> 
  <tr> 
   <td>站点内的地址</td> 
   <td> <p>将头像放置主题目录下的&nbsp;<code>source/uploads/</code>&nbsp;（新建 uploads 目录若不存在）&nbsp;<br> 配置为：<code>avatar: /uploads/avatar.png</code></p> <p>或者 放置在&nbsp;<code>source/images/</code>&nbsp;目录下&nbsp;<br> 配置为：<code>avatar: /images/avatar.png</code></p> </td> 
  </tr> 
 </tbody> 
</table>

头像设置示例

avatar: http://example.com/avatar.png

### 设置 作者昵称 ###

编辑 站点配置文件， 设置 author 为你的昵称。

### 站点描述 ###

编辑 站点配置文件， 设置 description 字段为你的站点描述。站点描述可以是你喜欢的一句签名:)

**注意事项：**

不知道大家看到最后，有没有发现一个问题，就是列表显示是全文显示的，根本起不到一个分页的作用。不要慌，这边我们只要在主题配置文件设置列表显示的长度即可。

auto_excerpt:
      enable: true
      length: 150

![image][image 8]

到这边我们的Next主题配置就介绍完毕了，是不是满满的成就感呀。下一节课将给大家介绍：如何通过hexo编写文章。

**林老师带你学编程**：[https://wolzq.com][https_wolzq.com]

[image]: /images/20220219/e86490a0e5b04e458c032ee1753b45ea.png
[image 1]: /images/20220219/9a9446751c58471d981d6da6bcac97bc.png
[image 2]: https://www.wolzq.com/20190416/1002.png?ynotemdtimestamp=1555396289596
[image 3]: /images/20220219/167509f9f590416ea0f4cbf68c4937d0.png
[http_localhost_4000]: http://localhost:4000/
[image 4]: /images/20220219/8885b62c0cea40b285e91d28ec2d8afe.png
[image 5]: https://www.wolzq.com/20190416/1005.png?ynotemdtimestamp=1555396289596
[image 6]: /images/20220219/1865ccbc147c43a3868cdf958664a4e4.png
[image 7]: /images/20220219/e2b74962f09445b0a1030c7f6a942497.png
[Font Awesome]: http://fontawesome.io/
[image 8]: /images/20220219/cb809309cf1a4ea680f5d7f73a6e059f.png
[https_wolzq.com]: https://wolzq.com/