GitHub个人博客搭建主要有两种方法:一是基于Ruby的jekyll+github方法,二是基于Nodejs的Hexo+github方法。这是本人的第一篇个人博客,希望能够坚持写下去。下面我将介绍下Hexo+github方法的具体过程:
搭建过程
Hexo安装
1 | $ npm install hexo-cli -g |
第一句是安装Hexo,第二句是安装Hexo部署到git page的deployer保证与github关联。
主题建站
1 | $ cd your_blog_dir |
安装完成后,根据自己喜好建立目录。Hexo 将会在指定文件夹中新建所需要的文件。之后我们可以在Hexo官网上选取主题从Github上clone到本地的themes文件夹下。
针对于不同的主题,blog下的_config.yml需进行如下操作更换主题、与Github关联:
1 | theme: 主题名 |
在这里,我们配置Github的SSH密钥可以让本地git项目与远程的github建立联系,让我们在本地写了代码之后直接通过git操作就可以实现本地代码库与Github代码库同步。
1 | $ cd ~/ .ssh |
之后在Github的Account Settings-SSH Keys中粘贴添加密钥即可。
更多信息详见: 参考博客
配置与测试
这部分主要介绍Hexo命令的使用。
1 | $ hexo clean |
hexo clean与hexo generate一般一起使用清理并生成编写内容,执行完hexo server后可在本地使用https://localhost:4000 查看建站情况,hexo deploy会更新Github端个人博客的内容:Jun的个人主页
Markdown写作
本人使用Mac OS,推荐Typora软件进行Markdown编写。Typora是一款轻便简洁的Markdown编辑器,支持即时渲染技术。
Typora语法相对简单,可参考简书typora、博客园typora。
Hexo博客内容图片显示问题
1 | $ npm install eslint |
由于缺少eslint依赖直接安装Hexo图片插件会有警告。完成安装后用hexo新建文章的时候会发现_posts目录下面会多出一个和文章名字一样的文件夹。图片就可以放在文件夹下面。插入图片的方式采用Markdown语法即可。
Note:把主页配置文件_config.yml
里的post_asset_folder:
这个选项设置为true