基于HEXO在GITHUB PAGE建立简单博客
前言
如果你不想折腾,那么托管WordPress是最好的选择。
HEXO不止可以部署到Github Pages,因为其本质是通过Markdown生成静态页面,所以任何你想到的网页容器都行。
WordPress虽然一站式解决,但是安装很麻烦,故我选择了HEXO。
环境
HEXO基于Node.js,建议使用nvm(或nvm-windows)安装,方便管理各种版本的node.js。
在nvm中安装管理node.js版本请看别的教程。
然后安装HEXO:
1 |
|
开始
到达你要放置博客的文件夹,通过
1 |
|
建立博客的“脚手架”,当然也可以
1 |
|
创建一个文件夹并建立“脚手架”。
配置
博客根目录下的_config.yml有博客的基本设置,如标题、主题等。
详细的配置,还是看HEXO官方文档比较方便。
主题
虽然许多主题作者都开始转向使用npm来分发主题,但这里还是建议手动解压主题文件到themes文件夹。这样一来问题会少一些。
一般而言,你只需要下载主题压缩包,解压到themes/,然后在博客根目录新建或重命名一个_config.主题名称.yml文件,最后更改_config.yml中的theme即可。
通常_config.主题名称.yml文件是对主题额外的东西的设置。
热门的主题都有对应的详尽的安装方法。
撰写
可以通过
1 |
|
来创建新的文件,新的文件在博客根目录下的source/_posts,你也可以自己创建。
一个新文件的头部通常是这样的:
1 |
|
发布
这里只介绍使用GITHUB PAGES的方法,即HEXO文档中的Git部署方法。
需要安装依赖:
1 |
|
–save、-S参数意思是把模块的版本信息保存到dependencies(生产环境依赖)中,即你的package.json文件的dependencies字段中
然后编辑_config.yml,找到deploy项,改成如下:
1 |
|
其中,branch为push的分支,【一定】不要是本来存放博客内容的“脚手架”的分支,deploy将会把并且只会把编译(生成)好的前端静态页面push到这个分支。
还要在Github仓库中,在Settings -> Pages -> Source中把Branch改为你上面设置的分支。
最后,在你通过hexo new
创建文件,hexo clean
清理生成缓存(可选),hexo generate
生成静态文件后,你就可以
1 |
|
将更新部署到Github,等待一下就生效。
CNAME
就在上面设置分支时,你会看到一个Custom domain,如果你直接在那里添加,只会在远程仓库中的指定分支中创建一个CNAME文件,下次push就会失效。
你应该在博客根目录的source文件夹中,放入这个CNAME文件,内容是你的域名。
记得先在DNS添加CNAME记录。