0%

如何使用hexo,next搭建github主页


刚搭建好这个页面,正好记录一下整个过程。

这个github页面其实存在挺久了,之前一直用github的默认模板,然后直接挂在那里很长一段时间…今天查一些python的东西的时候想到了这个荒废很久的页面,于是就想到有没有什么方法好好利用它。

在很多模板中,我选择了next作为个人主页的模板。以下是我的步骤。

1. 本地环境

next是基于hexo构建的,所以需要安装hexo,具体可以参照hexo官网的教程,一步一步来就可以了。

安装好hexo之后,需要建立本地存放主页的文件夹,然后让hexo对这个文件夹进行初始化,搭建好相关环境。

这个时候可以输入hexo s命令查看效果,默认是landscape主题。要使用next主题的话需要把主题文件放入theme文件夹里。(/theme/next)

next主题可以在github上进行获取,官方文档提供几种参考方法,为了方便,我选择了直接git clone最新的master分支。

放入本地主页文件夹之后需要设置网站根目录下的_config.yml的theme属性为next(默认landscape)

next主题的相关设置可以在主题文件夹里面的_config.yml里面进行设置,比如各种样式等。

2. Github设置

首先需要新建一个Repository,名字最好是{github用户名}.github.io。

然后在项目设置里面选择github pages进行相关的配置。

如果有自己的域名的话,建议在source里面新建一个cname文件存储对应的域名,githubpage的设置里面的那个配置有可能会在之后的更新中莫名其妙的消失。(因为生成cname的位置不同,github默认的是jekyll那套风格的,和hexo有冲突)此外记得在自己申请的域名的网站上增加相关的cname记录。

3. 部署运行

部署前需要安装hexo-deployer-git插件以及网站根目录_config.yml的deploy的设置(主要是配置git相关的信息),具体可查阅hexo提供的这方面的教程

配置好之后执行hexo clean && hexo deploy,hexo为编译好网页文件并将其部署到github对应分支。
(注:该方法只会上传编译好之后的网站页面,源文件不会上传。个人试过hexo上面提供的github在线ci/cd的方法,不过生成的是空文件,所以没有选用)

如果master上面出现对应页面的文件的话,就说明网页成功生成,可以体验自己主页生成的感觉了。

这些只是我对hexo和next的一些初步的认知,之后有时间的话会继续深入探索。