Hexo与github搭建个人博客

GitHub个人博客搭建主要有两种方法:一是基于Ruby的jekyll+github方法,二是基于Nodejs的Hexo+github方法。这是本人的第一篇个人博客,希望能够坚持写下去。下面我将介绍下Hexo+github方法的具体过程:

搭建过程

Hexo安装

1
2
$ npm install hexo-cli -g
$ npm install hexo-deployer-git --save

第一句是安装Hexo,第二句是安装Hexo部署到git page的deployer保证与github关联。

主题建站

1
2
3
$ cd your_blog_dir
$ hexo init blog
$ git clone https://github.com/dongyuanxin/theme-ad.git themes/ad

安装完成后,根据自己喜好建立目录。Hexo 将会在指定文件夹中新建所需要的文件。之后我们可以在Hexo官网上选取主题从Github上clone到本地的themes文件夹下。

针对于不同的主题,blog下的_config.yml需进行如下操作更换主题、与Github关联:

1
2
3
4
5
theme: 主题名
deploy:
type: git
repository: git@github.com:nijunssdut/nijunssdut.github.io.git
branch: master

在这里,我们配置Github的SSH密钥可以让本地git项目与远程的github建立联系,让我们在本地写了代码之后直接通过git操作就可以实现本地代码库与Github代码库同步。

1
2
3
4
5
$ cd ~/ .ssh
$ ssh-keygen -t rsa -C "your_email@example.com"
# 这将按照你提供的邮箱地址,创建一对密钥
$ pbcopy < ~/.ssh/id_rsa.pub
# 将公钥的内容复制到系统粘贴板

之后在Github的Account Settings-SSH Keys中粘贴添加密钥即可。

更多信息详见: 参考博客

配置与测试

这部分主要介绍Hexo命令的使用。

1
2
3
4
$ hexo clean
$ hexo generate
$ hexo server
$ hexo deploy

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
2
$ npm install eslint
$ npm install hexo-asset-image --save

由于缺少eslint依赖直接安装Hexo图片插件会有警告。完成安装后用hexo新建文章的时候会发现_posts目录下面会多出一个和文章名字一样的文件夹。图片就可以放在文件夹下面。插入图片的方式采用Markdown语法即可。

Note:把主页配置文件_config.yml 里的post_asset_folder:这个选项设置为true