搭建Hexo博客的精简步骤与使用Git同步博客项目文件

2018-02-03
上学期末就有搭建一个个人博客的想法,寒假到来,终于付诸实施,选择了比较简单易行的HexoGitHub Pages上建立博客,使用Markdown进行文章编写。(使用Windows 10环境)
相关链接:

环境配置

[文中有些命令执行完会出现yes/no的选项,如果要选yes,一定要输入yes,否则可能出现失败]

安装GitNode.js,完成环境配置

之后的命令基本都在Git Bash中进行输入

仓库部署

为了满足可以在不同的电脑上写文章的需求,我们需要将项目部署在GitHub上,由于Hexo会自动将public文件夹发布在master分支下以供展示,因此我们新建一个分支来保存项目文件,同时因为同时因为有配置.gitignore文件,无需担心node_modules等文件被手动发布到hexo分支下,达到文件分类存放的目的( •̀ ω •́ )y。

创建仓库

进入自己的GitHub,创建一个repo,名称一定要命名为:yourname.GitHub.io,其中yourname是你的GitHub的名称,按照这个规则创建才可以使用的哦

创建两个分支

  • master: 用来存放自动发布的页面内容
  • hexo: 这个分支用来存放项目内容
    设置hexo为默认分支,因为我们需要进行手动管理的只有这个hexo里面的项目文件,master里的页面内容是由Hexo自动发布。

    拷贝仓库到本地

    在自己想要的文件夹中使用Git Bash将自己的仓库拷贝到本地
    [yourname是自己的GitHub的名字]
1
$ git clone git@GitHub.com:yourname/yourname.GitHub.io.git

这一步如果无法完成请先和GitHub进行关联

关联GitHub

设置Git的账户信息

回到Git Bash,配置GitHub账户信息

1
2
$ git config --global user.name "yourname"
$ git config --global user.email "youremail"

其中yourname你懂的

设置SSH

在Git Bash中输入:

1
$ ssh-keygen -t rsa -C "youremail@example.com"

生成SSH-Key,其中youremailexample你懂的
然后再使用

1
2
$ cd ~/.ssh
$ cat id_rsa.pub

找到id_rsa.pub的内容
将上面获得的内容复制
打开GitHub 自己的Settings,选择SSH and GPG keys并添加一个New SSH keytitle随意,key就放刚才的内容。

[更新20190509]关于SSH Key以及RSA等相关内容请见另一篇博文:SSH Key登录与初识RSA加密

验证SSH

在Git Bash中验证是否添加成功:$ ssh -T git@GitHub.com
如果验证成功就可以进入下一步了

建立Hexo

安装Hexo

Hexo官网
Hexo所有操作以官网的文档为准,有关博客主题也推荐从官网选取。

安装使用命令:

1
$ npm install -g hexo

安装完成后可以使用:$ hexo -v命令查看版本
接下来进行Hexo初始化
在本地的yourname.GitHub.io文件夹中进行操作(必须是空文件夹,具体如何实施就看自己的灵性了,我是先把能复制的文件移出去然后再移回来,注意Windows下隐藏的git文件(夹))

1
2
3
$ hexo init
$ npm install
$ npm install hexo-deployer-git

修改设置文件

修改_config.yml中的deploy参数,

1
2
3
4
deploy: 
type: git
repo: https://GitHub.com/yourname/yourname.GitHub.io.git
branch: master

运行本地博客

然后回到Git Bash中进入blog的目录,执行以下命令:

1
$ hexo clean && hexo generate && hexo server

[若服务器出现问题可能需要安装$ npm install hexo-server]

接着打开浏览器输入:http://localhost:4000
就可以看到天使啦~
不过这还是本地的项目,我们还需要和GitHub进行关联并上传项目文件

发布博客并上传项目

上传项目

1
2
3
$ git add . 
$ git commit -m "..."
$ git push origin hexo

或其他等价代码,如:

1
$ git add . && git commit -m "..." && git push origin hexo

在第一次上传时可能会出现GitHub的登录提示,登录完成即可上传

发布博客

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

或者:

1
$ hexo clean && hexo g -d

可以将博客发布,
发布之后在浏览器中输入:http://yourname.GitHub.io就可以看到自己的个人博客啦~

其他可能用到的命令

1
2
3
$ git branch hexo       #创建hexo分支
$ git checkout hexo #切换到hexo分支
$ git status

Hexo的常用命令

hexo根目录进行

新建文章

1
$ hexo new post "yourtitle"

新建页面

1
$ hexo new page "yourname"

清楚生成文件与缓存

1
$ hexo clean

生成与部署

1
$ hexo g -d

_config文件

博客根目录的_config文件与主题文件夹中的_config文件配置的内容不同,具体可以看注释,修改自己需要的部分。
注意:_config文件中的英文冒号后一定要加空格,其他一些控制符号后也要加空格!!!具体设置时可以尝试以下= =
至于其他主题什么的设置我就不讲了,那些可以在Hexo官方网站找到推荐的主题,各主题也有自己的配置方式,请参考各主题的文档。

0%