前言

某天我突发奇想，在查阅了一些文章后使用Github Pages与Hexo搭建了本站。我汇总了我搭建本站的经验，并写在这里。

准备

要安装Hexo，你首先需要安装node.js，git。

建议先更换npm淘宝源：
打开cmd或终端，输入以下命令切换淘宝源：
npm config set registry https://registry.npmmirror.com
更换后可使用以下命令查看是否切换成功：
npm config get registry
成功输出：
npm config get registry
| https://registry.npmmirror.com/
输入以下命令来安装Hexo本体：
npm install -g hexo-cli
可使用hexo v检测是否安装完成
当输出很长一串列表时，那就是安装成功了
安装完成后，在终端内输入以下内容来初始化博客文件夹：
hexo init hexo
其中，hexo是一个文件夹名称，可以换成其他的名称使用。如果要安装多个博客，该命令也可以用来初始化其他博客文件夹（注意不要重名）。
当提示Start blogging with Hexo!时，文件夹便初始化完成了。
（官方文档对该命令的解释为新建一个网站）
之后，使用cd *你的博客目录*进入博客目录。

在你的博客文件夹内，会有一个config.yml。在这个文件中，你可以自由修改配置。你可以在官方文档中了解更多信息。

运行以下命令安装主题：

git clone -b master https://gitee.com/immyw/hexo-theme-butterfly.git themes/butterfly

安装完成后，运行以下命令安装所需插件：

npm install hexo-renderer-pug hexo-renderer-stylus --save

接下来，打开博客目录下的_config.yml文件，找到theme: xxx，修改为：
theme: butterfly
接下来，进入你的博客目录/themes/butterfly/目录，把里面的_config.yml重命名为_config.butterfly.yml，剪切到你的博客目录去。
打开_config.butterfly.yml，进行主题配置。更多信息请参阅Butterfly 安裝文檔(三) 主題配置-1

进入你的博客目录/source文件夹，一般来说你的文章、页面都在此处。

一些常见的撰写命令：

命令	作用
hexo new xxx	新建一篇文章，标题为 xxx 。文章的markdown文件可在输出路径中找到
hexo new page xxx	新建一个页面，标题为 xxx 。页面的markdown文件可在输出路径中找到

进入你的文章/页面目录，使用你心仪的markdown编辑器开始撰写吧！（删除文章只需删除对应的文件就可以）

关于图片等文件的存放位置，请参阅Hexo官方文档

更多信息请参阅Hexo官方文档

本部分参照了Hexo官方文档

安装所需插件hexo-deployer-git：
npm install hexo-deployer-git --save
安装后，在_config.yml末尾添加如下内容：
deploy:
type: git
repo: https;//github.com/xxx/xxxxx.git
branch: main
在这里，repo填写你的Github仓库地址（如果你复制了链接，直接粘贴即可）。xxx是你的用户名，xxxxx是你的仓库名。
branch指的是你仓库的分支，默认新仓库均为main。
配置后，运行以下命令来部署你的网站（网站有修改需要上线时也需要用到这个命令）：
hexo cl && hexo g && hexo d
若出现Deploy done: git，说明部署成功。
之后，访问你的Github用户名.github.io查看效果即可。

至此，网站部署完成。建议参阅其他文章以进一步配置你的网站。

发布于：1722043807000
分类：