个人网站搭建：Hexo + Kaze + Gitee Pages

前 言

建网站本身是一个很大的工程，涉及前端页面的搭建，网站数据的存储，还要购置服务器资源，甚至是后期的维护，过程相当繁琐。

不过如果仅仅是想搭建个人的网站，写写博客，想要美观，又不想操心太多和写博客无关的事情。那么，Hexo + Kaze + Gitee Pages 的方式就很适合你。

本文就讲下如何借助这三样免费的技术或服务，来搭建一个可访问的静态博客网站。

一个参考例子和大段代码文章里就不贴了，免得又说我水字数，需要的同学点击文档获取

Hexo 简介

Hexo 是什么？

Hexo[1] 是一个快速，简单且功能强大的博客框架。如果你用 Markdown 写博客，Hexo 可以在几秒内生成带有精美主题的静态文件。

Hexo 安装

前置要求

• Node.js（版本 10.13 以上，建议使用 12.0 以上版本）
• Git

安装 Git

• Windows：下载并安装 git[2] 。
• Mac：使用 Homebrew[3] 安装。
• Linux（Ubuntu，Debian）：sudo apt-get install git-core
• Linux（Fedora，Red Hat，CentOS）：sudo yum install git-core

安装 Node.js

Node.js 为大多数平台提供了 官方安装程序[4] 。

替代安装方法：

• Windows：使用 nvs[5] 安装它。
• Mac：使用 Homebrew[6] 安装。
• Linux（基于 DEB / RPM）：与 NodeSource[7] 一起安装。
• 其他：通过相应的软件包管理器进行安装。请参阅 Node.js 提供的指南[8] 。

安装 Hexo

用 npm 安装 Hexo。

npm install -g hexo-cli复制代码

使用以下指令查看是否安装成功。

hexo version复制代码

如果你想卸载 Hexo，使用以下指令：

npm uninstall -g hexo-cli复制代码

运行 hexo

安装后，你可以通过 hexo 运行 Hexo。比如通过 hexo help 指令来获取使用帮助。

hexo help复制代码

帮助里提到 hexo init 命令可以创建一个新的 Hexo 文件夹，这个文件夹其实就是利用 Hexo 生成的站点信息了。接下来讲下怎么建站。

Hexo 建站

初始化操作

使用 hexo init 指令就可以在指定文件夹下建立站点信息：

hexo init java4u.cn复制代码

站点初始化中：

站点初始化完成，会生成指定的文件夹：

目录结构

进入该站点，我们看下目录结构，如下：

这些文件有着各自的职责：

• _config.landscape.yml：自定义的主题配置文件，此处的 landscape 是默认主题。配置其他主题可以参考这种方式。
• _config.yml：站点全局的配置文件。
• node_modules：node 模块文件夹。包含可执行文件和依赖的资源。
• package-lock.json：node_modules 文件中所有模块的版本信息，模块来源。
• package.json：Hexo 框架的基本参数信息以及它所依赖的插件。
• scaffolds：scaffolds 原意是脚手架，这里可以理解为模板文件夹。当你创建新的文章时，Hexo 会根据该文件夹下的对应文件进行初始化构建。
• source：资源文件夹。这里是你放自己资源比如博文和图片的地方。_posts 文件夹下的 Markdown 和 HTML 文件会被解析并放到 public 文件夹下。其他文件或文件夹，如果开头命名不是 _ (下划线)，也都会被拷贝过去。
• themes：主题文件夹。Hexo 会根据主题来生成静态页面。

基于这样的结构，Hexo 就具备了生成静态网站的能力。

本地启动

我们先本地启动，看下实际效果。输入以下命令：

hexo server复制代码

Hexo 会启动服务，将默认生成的网站运行在本机的 4000 端口上，可以直接访问 http://localhost:4000 就能看到网站首页，它基于默认主题生成，同时有一篇默认文章。

这个页面只是官方提供的一个样例，看到它就意味着你本地环境跑通了。我们可以通过修改配置的方式，对页面相关元素做调整。

核心配置

以下是我们需要了解或者修改的配置信息。

package.json

这个文件列出了 Hexo 的基本参数信息以及它所依赖的插件。可以看到，EJS[9] ，Stylus[10] 和 Markdown[11] 渲染器都是默认安装的。

{
  "name": "hexo-site",
  "version": "0.0.0",
  "private": true,
  "scripts": {
    "build": "hexo generate",
    "clean": "hexo clean",
    "deploy": "hexo deploy",
    "server": "hexo server"
  },
  "hexo": {
    "version": ""
  },
  "dependencies": {
    "hexo": "^5.0.0",
    "hexo-generator-archive": "^1.0.0",
    "hexo-generator-category": "^1.0.0",
    "hexo-generator-index": "^2.0.0",
    "hexo-generator-tag": "^1.0.0",
    "hexo-renderer-ejs": "^1.0.0",
    "hexo-renderer-marked": "^3.0.0",
    "hexo-renderer-stylus": "^2.0.0",
    "hexo-server": "^2.0.0",
    "hexo-theme-landscape": "^0.0.3"
  }
}
复制代码

如果后边要切换主题，记得把最后一个默认的主题依赖删除掉。

_config.yml

可设置网站、网址、目录、文章、分类&标签、日期/时间格式、分页和扩展等信息。

网站

参数描述title网站标题subtitle网站副标题description网站描述，用于 SEOkeywords网站的关键词，支持多个关键词。author文章作者。language网站使用的语言。对于简体中文用户来说，使用不同的主题可能需要设置成不同的值，请参考你的主题的文档自行设置，常见的有 zh-Hans和 zh-CN。timezone网站时区。Hexo 默认使用你电脑的时区。请参考 时区列表[12] 进行设置，如 America/New_York, Japan, 和 UTC 。一般的，对于中国大陆地区可以使用 Asia/Shanghai。

URL

参数描述默认值url网址, must starts with http:// or https://http://example.comroot网站根目录，如果放子目录，设置 /blog//permalink文章的 永久链接[13] 格式:year/:month/:day/:title/permalink_defaults永久链接中各部分的默认值

pretty_urls改写 ​permalink​[14] 的值来美化 URL

pretty_urls.trailing_index是否在永久链接中保留尾部的 index.html，设置为 false 时去除truepretty_urls.trailing_html是否在永久链接中保留尾部的 .html, 设置为 false 时去除 (对尾部的 index.html无效)true

目录

参数描述默认值source_dir资源文件夹，这个文件夹用来存放内容。sourcepublic_dir公共文件夹，这个文件夹用于存放生成的站点文件。publictag_dir标签文件夹tagsarchive_dir归档文件夹archivescategory_dir分类文件夹categoriescode_dirInclude code 文件夹，source_dir 下的子目录downloads/codei18n_dir国际化（i18n）文件夹:langskip_render跳过指定文件的渲染。匹配到的文件将会被不做改动地复制到 public 目录中。

文章

参数描述默认值new_post_name新文章的文件名称:title.mddefault_layout预设布局postauto_spacing在中文和英文之间加入空格falsetitlecase把标题转换为 title casefalseexternal_link在新标签中打开链接trueexternal_link.enable在新标签中打开链接trueexternal_link.field对整个网站（site）生效或仅对文章（post）生效siteexternal_link.exclude需要排除的域名。主域名和子域名如 www 需分别配置[]filename_case把文件名称转换为 (1) 小写或 (2) 大写0render_drafts显示草稿falsepost_asset_folder启动 Asset 文件夹[15] falserelative_link把链接改为与根目录的相对地址，建议使用绝对地址。falsefuture显示未来的文章truehighlight代码块的设置, see Highlight.js[16] section for usage guide

prismjs代码块的设置, see PrismJS[17] section for usage guide

分类 & 标签

参数描述默认值default_category默认分类uncategorizedcategory_map分类别名

tag_map标签别名

日期/时间格式

Hexo 使用 Moment.js[18] 来解析和显示时间。

参数描述默认值date_format日期格式YYYY-MM-DDtime_format时间格式HH:mm:ssupdated_option当 Front Matter 中没有指定 ​​updated​​[19] 时 updated 的取值，支持 mtime(文件最后修改时间)，date(使用 date 的值)，empty(不指定)mtime

分页

参数描述默认值per_page每页显示的文章量 (0 = 关闭分页功能)10pagination_dir分页目录page

扩展

【主题】

参数描述默认值theme当前主题名称。值为false时禁用主题landscapetheme_config主题的配置文件。在这里放置的配置会覆盖主题目录下的 _config.yml 中的配置无初始配置deploy部署部分的设置

meta_generatorMeta generator[20] 标签。值为 false 时 Hexo 不会在头部插入该标签true

【部署】

配置如下：

deploy:
  type: git
  repo: <repository url> #https://bitbucket.org/JohnSmith/johnsmith.bitbucket.io
  branch: [branch]
  message: [message]
复制代码

参数描述默认repo库（Repository）地址

branch分支名称gh-pages (GitHub) coding-pages (Coding.net) master (others)message自定义提交信息Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }})tokenOptional token value to authenticate with the repo. Prefix with $ to read token from environment variable

常用指令

创建文章

使用以下指令：

hexo new "test"
复制代码

或者简写：

hexo n "test"
复制代码

运行服务器

输入以下命令以启动服务器，你的网站会在 http://localhost:4000 下启动。在服务器启动期间，Hexo 会监视文件变动并自动更新，你无须重启服务器。

hexo server
复制代码

或者简写：

hexo s
复制代码

生成静态文件

hexo generate
复制代码

或者简写

hexo g
复制代码

监视文件变动立即重新生成。该操作会阻塞命令。

hexo g --watch
复制代码

生成完毕后自动部署网站。

hexo generate --deploy
复制代码

部署

Hexo 提供了快速方便的一键部署功能，让你只需一条命令就能将网站部署到服务器上。

hexo deploy
复制代码

或者简写为：

hexo d
复制代码

Hexo 主题

为什么选择 Kaze

Hexo 默认主题为 landscape，但我觉得不够美观，这里推荐 kaze[21] ,它有以下特性：

• 响应式设计，适配桌面端、平板、手机等各种设备
• 前端性能优化，加载快速，眨眼之间即可加载完成

• 图片懒加载，应用懒加载技术加快页面的生成速度
• 资源压缩，提升本地资源请求速度
• 精简设计，不包含 Jquery 等额外库

• 支持侧边栏小组件，例如最近文章，作者卡片
• 暗黑模式，享受黑夜的魅力
• 代码高亮，支持 prismjs
• 公式渲染，支持 katex 和 mathjax
• 评论系统，集成 valine、gitalk 和 livere
• 访问量统计和谷歌分析支持

安装 Kaze

在 your site/themes 下输入

cd themes
git clone https://github.com/theme-kaze/hexo-theme-Kaze.git
复制代码

安装成功后，会生出目录：hexo-theme-Kaze。

修改站点配置文件 _config.yml 下的主题值为：hexo-theme-Kaze。

用 hexo server 启动 Hexo 服务看下效果。

会看到已经生成了默认的主题，只是很多东西都没有，需要改造一下。

主题配置

可在该主题目录下的 _config.yml 文件里配置。

主题颜色

在 color 中进行配置，以下是默认值。

color:
  text-color: "#3c4858"
  text-strong-color: "#2f3d4e"
  text-light-color: "#909faf"
  divider-color: "#e6e8ee"
  title-color: "#475b6d"
  link-color: "#3273dc"
  link-hover-color: "#6596e5"
  info-text-color: "#909faf"
  widget-background-color: "#fff"
  body-background-color: "#f2f5f8"
  border-color: "#e1e4e9"
  pre-color: "#2d2d2d"
  code-color: "#50687c"
  code-background-color: "#e9eaf0"
复制代码

字号与字体

在 font 中进行配置，以下是默认值。

font:
  font-size: 16px # global font-size
  font-family: '-apple-system,BlinkMacSystemFont,"Segoe UI","Helvetica Neue","PingFang SC","Microsoft YaHei",sans-serif' # global font-family
复制代码

站点访问量统计

访问量统计目前仅支持不蒜子，默认关闭，可统计站点总访问量和总访客数。

footer:
  #------------------------
  # pv / uv statistics config
  #------------------------
  statistics:
    enable: false
    type: busuanzi # now version only supports busuanzi
    pv:
      enable: true
      style: 本站总访问量{}次 # the style will be shown as $1{pv}$2
    uv:
      enable: true
      style: 本站总访客数{}次 # the style will be shown as $1{uv}$2
复制代码

数据分析

analytics:
  enable: false
  type: google # google
  google:
    id:
复制代码

enable 开启分析支持（默认关闭）

type 目前仅支持 google

google.id 有关谷歌分析的具体使用说明和 id 使用可以参考谷歌文档[22]

首页

文章头图

在文章 Front-matter 中 banner_img 可以设置首页头图

小组件

widgets:
  showWidgetsMobiles: "none"
复制代码

showWidgetsMobiles : 在窄屏幕上是否显示小组件，none 关闭（默认），flex 开启

关于

关于页面需要自行创建，在站点 source 中新建 about 文件夹并在文件夹内创建 index.md，该文件至少需要包含

# at ${yoursite}/about/index.md
---
title: 关于
layout: about
---
复制代码

社交链接

在 about 下的 social_links中进行配置，主题图标依赖于 iconfont[23] ，Hexo 内置了一部分社交图标，你可以自定义其他 icon 文件或者解决方案来添加自定义图标。

about:
  description: description
  social_links:
    - { icon: icon-github, link:  https://xxx}
    # - { icon: icon, link: your link }
复制代码

友链

友链格式按如下填写即可生成友链页面

links:
  example-name-1:
    url: https://example.com
    avatar: https://example.com/avatar.jpg
  example-name-2:
    url: https://example.com
    avatar: https://example.com/avatar.jpg
复制代码

文章页

搜索功能

search:
  enable: true
  path: search.json
  field: posts
  searchContent: true
复制代码

• enable 开启搜索功能（默认开启）
• path 文件名称（暂无用处）
• field 需要搜索的范围，支持 posts | pages | all
• searchContent 搜索文件是否包含正文内容（不建议开启，包含所有文章内容这样会使得搜索文件异常巨大）替代方案是搜索分类标签或使用 algolia 等第三方搜索服务（Todo）

目录

主题目录通过 Hexo 原生函数生成，具体可参见我之前的一些代码

toc:
  showListNumber: false
  maxDepth: 6
  minDepth: 1
复制代码

showListNumber 是否生成编号

maxDepth TOC 最大深度

minDepth TOC 最小深度

代码高亮

代码太多了，这里就不贴了，需要的同学点击文档获取

数学公式

主题支持 mathjax 和 katex 两种渲染引擎，具体参见我之前的一些代码

copyright

copyright:
  enable: true
  writer: # if writer is empty we will use config.author as writer
  declare: 本博客所有文章除特别声明外，均采用<a target="_blank" rel="noopener" href="https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh">CC BY-NC-SA 4.0 协议</a>。转载请注明出处！
  style: warning
复制代码

enable 开起版权说明（默认开启）

writer 作者id，如果不填则会使用主题配置 author 或站点配置 author

declare 版权声明具体内容，支持 html 语句

style 声明内容样式，与 note 样式相同

版权内容有三部分：作者、文章链接、版权声明

作者使用 writer 参数，文章链接基于站点配置文件中url参数生成，版权声明使用 declare 参数

Front-matter

banner_img

设置文章与首页头图

banner_img_set

在图片加载时预先加载的图片，可以设置为 loading 图或缩略图等

excerpt

为文章设置在首页显示的简介，还可以通过 来控制显示

评论

支持 valine，gitalk 和 livere

具体设置可参考主题配置文档说明和相关评论插件文档

字数统计

主题集成 hexo-wordcount[27] 插件，在主题配置文件中设置

wordcount:
  enable: true
复制代码

开启（默认开启）

图片画廊

图片画廊功能基于 fslightbox，在主题配置文件中设置

fslightbox:
  enable: true
复制代码

开启（默认开启）

标签插件

主题集成了一些标签方便书写

note

在 markdown 文件中如下书写即可

{% note style %}
...markdown content
{% endnote %}
复制代码

有五种样式可以选择，primary，success，info，warning，danger

备案信息

你可以在主题配置文件内增加备案信息。

footer:
  #------------------------
  # 备案配置
  # 请将公安备案的缩略图置于 ${yoursite}/img/beian.png
  RecordInfo: "" # '某ICP备xxx号'
  govRecordInfo: "" # '某公网安备xxx号'
  govRecordUrl: "" # 公网安备案信息地址
  #------------------------
复制代码

站点托管

为什么选择 Gitee Pages

GitHub 和 Gitee 都提供免费的静态网页托管服务。我们可以使用 GitHub Pages 或 Gitee Pages 托管博客、项目官网等静态网页，这样就省去了购买服务器的钱，也不需要耗费太多精力维护。

GitHub Pages 使用很广泛，我之前也用过，不过访问不够稳定，会影响页面加载速度。Gitee 是国内版的 GitHub，访问速度优秀，并且国内发展势头不错，因此我选取 Gitee Pages 来托管我的网站。

建立仓库

申请一个 Gitee 账号，创建一个新的仓库，仓库名尽量和账号名一致，这样可以避免一些因为路径引发的问题。

然后在仓库首页服务一栏开启 Gitee Pages 服务。

开启后，你就拥有了专属的二级域名网址。

注意：仓库内容有变化，需要手动触发更新，页面才能真正生效。

连接仓库

一、安装 hexo-deployer-git[29] 。

npm install hexo-deployer-git --save
复制代码

二、修改配置。

deploy:
  type: git
  repo: [e-mail]:java4u/java4u.git
复制代码

注意上面的 repo 地址并不是仓库的地址，而是你下载/克隆项目时弹出的那个地址，type 如果是 git 就选择 SSH。

三、生成/添加 SSH 公钥

Gitee 、GitHub 提供了基于 SSH 协议的 Git 服务，在使用 SSH 协议访问仓库仓库之前，需要先配置好账户/仓库的 SSH 公钥。

先看下自己有没有配置过用户名和邮箱：

git config --global user.name
git config --global user.email
复制代码

如果没有就做下配置：

# 设置邮箱
git config --global user.email *********@qq.com

# 设置用户名
git config --global user.name '****'

然后本地生成 SSH 公钥，邮箱为刚配置好的账户：

ssh-keygen -t rsa -C [e-mail]复制代码

生成后可查看 SSH 公钥：

cat ~/.ssh/id_rsa.pub复制代码

复制公钥去 Gitee 粘贴，添加。

测试是否连接成功：

ssh -T [e-mail]复制代码

上传仓库

执行部署命令，即可将本地资源上传远程仓库。

hexo d复制代码

手动更新

远程仓库虽然可以看到提交记录，但静态网站不会感知到实时变更，需要去 Gitee Pages 服务页面做下更新。

稍等片刻，访问链接即可看到 Hexo 结合 kaze 主题搭建的静态网站。