使用 Hexo 搭建博客

Hexo 是一个基于 Node.js 的静态博客框架，它可以帮助你快速创建和管理静态博客网站。以下是如何使用 Hexo 搭建博客的简要说明：

安装 Hexo

首先，在一个新建文件夹下使用以下命令来全局安装 Hexo：

1
2
3
4
5
npm install hexo-cli -g     # 安装 Hexo 的命令行工具到cli
hexo init my-blog           # 初始化一个名为my-blog的Hexo项目
cd my-blog                  # 进入项目目录
npm install                 # 安装项目依赖项
hexo server                 # 启动Hexo本地服务器

现在，你可以在浏览器中访问 http://localhost:4000 来查看你的博客网站。

开始写作

现在，你可以使用 hexo new post 命令来快速创建一篇新文章。然后在 source/_posts 目录下，对新的 post_title.md 文件使用 Markdown 语法来撰写文章内容。

你也可以使用 hexo new page **** 命令来创建一个新的页面。比如友情链接和图库等…

生成静态文件

在编写完成文章后或对网页配置进行了任何修改，都需要执行以下命令来生成静态文件：

1
hexo generate   # 生成静态文件

这将会在 public 目录下生成静态的 HTML 文件，可用于部署到服务器上。

部署到服务器

在将项目部署到服务器之前，建议首先在本地进行测试。您可以使用以下命令清除旧的生成文件、生成新的文件，并在本地启动一个 Hexo 服务器，确保网站可以正常访问：

1
hexo clear && hexo generate && hexo server

接下来，您可以选择自己喜欢的方式将生成的静态文件部署到服务器上，从而让您的博客能够被公众访问。

生成后的静态文件在路径下：public里面。

Hexo 提供了一个快速、方便的一键部署功能，让您只需一条命令就可以将网站部署到服务器上：

1
hexo deploy

在使用该功能之前，请确保在 _config.yml 文件中正确配置了部署参数。每个有效的部署配置至少需要有 type 参数。例如：

1
2
deploy:
  type: git

您还可以同时使用多个部署器，Hexo 会按照顺序执行每个部署器。如下所示：

1
2
3
4
5
deploy:
- type: git
  repo: <repository_url>
- type: heroku
  repo: <repository_url>

使用 Git 进行部署

首先，确保安装了 hexo-deployer-git 插件：

1
npm install hexo-deployer-git --save

然后，更新配置文件：

1
2
3
4
5
deploy:
  type: git
  repo: <repository_url>  # 例如：https://github.com/YourUsername/YourRepo.git
  branch: [branch_name]   # 默认分支，例如 'gh-pages'
  message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}"

一些重要的参数说明如下：

  • repo：存储库地址.
  • branch：要部署到的分支.
  • message：自定义提交信息.
  • token：可选的令牌值，用于认证 repo。用 $ 作为前缀从而从环境变量中读取令牌.

在完成配置后，您可以使用以下命令来生成站点文件并将其推送到远程库：

1
hexo clean && hexo deploy

如果没有使用令牌或 SSH 密钥进行认证，您可能会被提示输入目标仓库的用户名和密码。请注意，hexo-deployer-git 不会存储您的凭据。要临时存储用户名和密码，您可以使用 git-credential-cache。

登录 GitHub、Bitbucket 或 GitLab 后，请确保在仓库设置中，将默认分支设置为与 _config.yml 中的分支相同。稍等片刻，您的站点就会在对应的 Pages 服务上显示出来。