软件——Hexo-NexT配置个人博客

2020-04-13 11:31:08 浏览数 (1)

Hexo-NexT配置个人博客

一、安装NexT

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

1.克隆最新版本

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

代码语言：javascript复制
$ cd your-hexo-site
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

2.直接下载

  1. 前往 NexT 版本 发布页面。
  2. 选择你所需要的版本，下载 Download 区域下的 Source Code (zip) 到本地。例如，下载 v0.4.0 版本：
  1. 解压所下载的压缩包至站点的 themes 目录下， 并将 解压后的文件夹名称（hexo-theme-next-0.4.0）更改为 next。

二、启用主题

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

代码语言：javascript复制
# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next

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

三、验证主题

到此，我们已经设置好了next主题，现在我们需要来验证一下我们的配置是否成功

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

代码语言：javascript复制
INFO  Hexo is running at http://0.0.0.0:4000/. Press Ctrl C to stop.

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

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

四、主题设置

1.选择Scheme

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

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

Scheme 的切换通过更改 主题配置文件，搜索 scheme 关键字。 你会看到有三行 scheme 的配置，将你需用启用的 scheme 前面注释 # 去除即可。

代码语言：javascript复制
# Schemes
scheme: Muse   #
# scheme: Mist     #菜单横着排列 菜单在上面
# scheme: Pisces     #菜单在左边
# scheme: Gemini

2.设置语言

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

代码语言：javascript复制
language: zh-Cn

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

语言

代码

设定示例

English

en

language: en

简体中文

zh-Cn

language: zh-Cn

Français

fr-FR

language: fr-FR

Português

pt

language: pt or language: pt-BR

繁體中文

zh-hk 或者 zh-tw

language: zh-hk

Русский язык

ru

language: ru

Deutsch

de

language: de

日本語

ja

language: ja

Indonesian

id

language: id

Korean

ko

language: ko

3.设置菜单

菜单配置包括三个部分，第一是菜单项（名称和链接），第二是菜单项的显示文本，第三是菜单项对应的图标。 NexT 使用的是 Font Awesome 提供的图标， Font Awesome 提供了 600 的图标，可以满足绝大的多数的场景，同时无须担心在 Retina 屏幕下 图标模糊的问题。

编辑 主题配置文件，修改以下内容：

①、设定菜单内容，对应的字段是 menu。 菜单内容的设置格式是：item name: link。其中 item name 是一个名称，这个名称并不直接显示在页面上，她将用于匹配图标以及翻译。

代码语言：javascript复制
menu:
  home: / || fa fa-home  #首页
  about: /about/ || fa fa-user  #关于
  # tags: /tags/ || fa fa-tags  #标签
  # categories: /categories/ || fa fa-th #分类
  # archives: /archives/ || fa fa-archive  #归档
  # schedule: /schedule/ || fa fa-calendar #日程表
  # sitemap: /sitemap.xml || fa fa-sitemap #站点地图
  # commonweal: /404/ || fa fa-heartbeat  # 404页面

若你的站点运行在子目录中，请将链接前缀的 / 去掉

NexT 默认的菜单项有（标注 的项表示需要手动创建这个页面）：

键值

设定值

显示文本（简体中文）

home

home: /

主页

archives

archives: /archives

归档页

categories

categories: /categories

分类页

tags

tags: /tags

标签页

about

about: /about

关于页面

commonweal

commonweal: /404.html

公益 404

注意：设置菜单时记得在Hexo的source目录下创建相对应的目录，否则会出现

比如要创建标签文件夹，终端中输入（前提在Hexo文件路径下）： hexo new page "tags" 创建完目录后的页面再次打开是这样的

编辑Blog/source/categories中index.md文件，添加type: "categories"，其他Menu也同理创建。 添加type后的页面是这样的

②、设置菜单项的显示文本。在第一步中设置的菜单的名称并不直接用于界面上的展示。Hexo 在生成的时候将使用 这个名称查找对应的语言翻译，并提取显示文本。这些翻译文本放置在 NexT 主题目录下的 languages/{language}.yml （{language} 为你所使用的语言）。

以简体中文为例，若你需要添加一个菜单项，比如 something。那么就需要修改简体中文对应的翻译文件 languages/zh-Cn.yml，在 menu 字段下添加一项：

代码语言：javascript复制
menu:
  home: 首页
  archives: 归档
  categories: 分类
  tags: 标签
  about: 关于
  search: 搜索
  commonweal: 公益404
  something: 有料

③、设定菜单项的图标，对应的字段是 menu。 ||后面的这是图标名称，icon name 是 Font Awesome 图标的 名字。而 menu_settings中icons 可用于控制是否显示图标，你可以设置成 false 来去掉图标。

代码语言：javascript复制
menu:
  home: / || fa fa-home  #首页
  about: /about/ || fa fa-user  #关于
  # tags: /tags/ || fa fa-tags  #标签
  # categories: /categories/ || fa fa-th #分类
  # archives: /archives/ || fa fa-archive  #归档
  # schedule: /schedule/ || fa fa-calendar #日程表
  # sitemap: /sitemap.xml || fa fa-sitemap #站点地图
  # commonweal: /404/ || fa fa-heartbeat  # 404页面
menu_settings:
  icons: true
  badges: false

在菜单图标开启的情况下，如果菜单项与菜单未匹配（没有设置或者无效的 Font Awesome 图标名字） 的情况下，NexT 将会使用 作为图标。 请注意键值（如 home）的大小写要严格匹配

4.设置侧栏

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

①、设置侧栏的位置，修改 sidebar.position 的值，支持的选项有：

  • left - 靠左放置
  • right - 靠右放置
代码语言：javascript复制
sidebar:
  position: left

②、设置侧栏显示的时机，修改 sidebar.display 的值，支持的选项有：

  • post - 默认行为，在文章页面（拥有目录列表）时显示
  • always - 在所有页面中都显示
  • hide - 在所有页面中都隐藏（可以手动展开）
  • remove - 完全移除
代码语言：javascript复制
sidebar:
  display: post

5.设置头像

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

地址

值

完整的互联网 URI

http://example.com/avatar.png

站点内的地址

将头像放置主题目录下的 source/uploads/ （新建 uploads 目录若不存在） 配置为：avatar: /uploads/avatar.png或者 放置在 source/images/ 目录下 配置为：avatar: /images/avatar.png

头像设置示例

代码语言：javascript复制
avatar: http://example.com/avatar.png

6.设置作者昵称

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

7.站点描述

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

hexo

0 人点赞