借助 Hexo + Github Page 搭建个人博客,使用主题为nexT
环境准备
hexo 配置
进入 hexo 官网,点击文档,参考文档进行配置。
首先安装需要安装 Node.js(版本要大于6.9) 和 Git。随后执行命令安装hexo。
1 | # 全局安装 hexo-cli |
安装 Hexo 完成后,执行下列命令,新建一个Hexo项目
1 | $ hexo init <folder> |
随后修改 _config.yml 配置文件,首先配置网站的基本信息,我的配置如下所示
1 | title: 张蕴鹏的博客 # 你的网页标题 |
至此,Hexo 的基础配置就已完成,执行下列命令,启动本地预览(默认地址为 localhost:4000)
1 | $ hexo s |
效果如下
Hexo基础操作
发布一篇文章
执行下列的命令来发布一篇新的文章
1 | $ hexo new [layout] <title> |
其中 layout 是可选参数,默认设置的 layout 为 post
,如果需要修改默认配置的 layout ,可以通过修改 _config.yml
的 default_layout
来变更默认 layout
。
title 是对应文章的名称,生成的 MD 文件的名称可以通过修改 _config_yml
的 new_post_name
来变更。
Layout
Hexo 默认包含了下列表格中所示的 Layout ,具体如果新建 Layout ,笔者暂时还没有弄清楚。
Layout | 路径 | 功能 |
---|---|---|
post | source/_posts | 发布 |
page | source | 未知功能 |
draft | source/_drafts | 草稿 |
草稿
执行下列的命令可以将 layout
为 draft
内的文章移动至 source/_posts
下
1 | $ hexo publish [layout] <title> |
文章模板(Scaffold)
新建文章时,可以通过指定模板名称来新建文件,命令如下
1 | $ hexo new [layout] [scaffold name] <title> |
其中 scaffold name
为 scaffolds/
目录下对应的模板名称。
注意,layout 要在模板名称之前, 否则默认 layout 为 post
主题选择及配置
本博客选用的主题为 nexT。
nexT 主题的安装和配置
本文选择了下载最新的 release
版本,手动配置的方式,实际可以下载git仓库版本等,具体请参考 nexT 文档。
执行下列命令获取最新的 release
版本,并将下载后主题样式文件放在 Hexo 生成目录的 themes/
文件夹下
1 | $ cd your-blog-path/ |
修改 themes/next/_config.yml
文件,修改下列内容。更多定制内容可以根据 nexT 的文档
1 | # 页脚设置 |
hexo 部署至Github Pages
部署之前,要进行配置,修改 _config.yml
修改下列参数
1 | deploy: |
- repo 即为仓库地址。
- branch 为部署页面提交至的分支, GitHub 应该设置为 gh-pages。
- message 为提交时的信息,这里默认设置即可。
如果要配置多个部署环境,参考以下配置方式
1 | deploy: |
这里我们使用 git 来进行配置,更为详细的配置文档,请参考 hexo 官方文档。
首先安装 hexo-deployer-git
1 | npm install hexo-deployer-git --save |
随后部署至 GitHub 上,输入下列命令
1 | hexo deploy -g |
-g 相当于
1 | hexo clean |
最后进入 GitHub 对应仓库的设置页,开启 GitHub Pages 功能即可,将分支配置为 gh-pages
。
输入 https://yourName.github.io/repository
进行访问。