小白的 Hexo + Github - 建站指引

本文是有关Hexo+Github建站的基础流程,抛除相关技术深入探研,根据本文指引能迅速搭建一个基本的博客空间。这篇文章能为你解决下面的问题:

  1. 迅速建站
  2. 多PC同步

准备工具

依赖:NodeJS、git、hexo
首先得把依赖的工具安装好,这里找了几个教程,不一一描述了。

新建Blog并部署上Github

确保你的Github已经配置好当前使用PC的shh公钥。不清楚的可以看下面的链接:
git-ssh 配置和使用

这里提一点:如果你的Blog Git提交账户和平时使用的Git账户不同(比如一个公司的一个私人的),可以进入你新建的blog文件夹,配置:

1
2
$ git config -- user.name "your github name"
$ git config -- user.email "your github email"

完成上述Github配置后,就可以开始正式开发我们的Blog了~

1. 新建blog目录,安装hexo

进入新建的blog目录下,输入命令

1
2
hexo init
hexo s

如无意外,会提示

1
INFO Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

2. 更换hexo主题(可跳过)

hexo默认的主题是landscape,对于某些追求简约个性的人来说,这个主题可能不太对口。我们可以根据个人喜好选择hexo主题。
进入hexo theme选择自己喜欢的主题,我用的是“next”。参考主题Github README文档,下载并使用主题。

如“next”使用方法如下

1
2
$ cd your-hexo-site
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

用编辑器打开blog的_config.yml配置文件,找到theme将其改为
theme: next

3. 发布blog并上传至Github

使用命令

1
$ hexo new new_post_name

新建文章,新建的文章可在“yourblog/source/_posts/”中找到。每一个文章都是一个md(markdown)文件,不熟悉markdown编辑的同学可以找找相关教程。
打开 “new_post_name.md” 对新建的文章进行markdown编辑。

添加远程github地址,需要在你的github中新建一个名为“yourname.github.io”的仓库,使用以下命令,关联远程地址,这里默认是提交到master分支

1
2
$ git init
$ git remote add origin <remote_repo>

最后使用hexo命令生成并发布blog

1
2
3
$ hexo clean
$ hexo g
$ hexo d

这时候就能在 “yourname.github.io”看到你的blog了~
前提是没被墙。

多PC共同管理同一个站点

有时候,我们可能会在多台PC共同管理我们的博客,比如公司电脑和家用电脑。但是使用hexo d部署blog时,会直接将原始的hexo代码转换生成静态的页面,并上传至master分支,这样一来,
我们便无法在另一台电脑获得原始的代码再进行新文章发布。所以,我们需要新建一个hexo分支,来管理我们原始的hexo代码。

1
2
3
4
5
6
$ git checkout -b hexo
Switched to a new branch "hexo"
$ git add .
$ git commit -m "issue"
$ git push origin hexo

这个时候,我们就已经将原始代码push到远程的hexo分支啦~
在另一台电脑下,将hexo分支的代码clone下来

1
$ git clone -b hexo <remote_repo>

使用hexo(确保电脑已安装hexo-cli),注意这里不需要再hexo init了,不然会覆盖掉之前的配置。

1
2
3
4
$ cd yourname.github.io
$ npm install
...
$ hexo s

这样一来就可以实现多PC共同管理一个站点了~~

暗中微笑