用Hexo和GitHub搭建博客

网上用Hexo配合GitHub搭建个人博客的文章已经有不少了,不过还是简单写一下这个博客搭建的过程。

第一步:准备一个GitHub账号以及仓库

首先去注册一个GitHub账号(如果没有的话)。

现在账号有了,之后就是必须得准备一个GitHub仓库(respository);

首先点击New Respository(首页右边或者点左上角的+号展开按钮选择)进入创建页面:

输入:你的GitHub用户名.github.io创建一个博客用的仓库,注意必须是这个格式的,不能随意起名,并且注意是github.io而不是github.com,你的用户名就是显示在斜杠前面的那个。

第二步:安装Git和Node.js

GitNode.js都是Hexo所依赖的环境,这边安装都是按照OSX来写,Windows的话可能终端命令上会有稍许不同,可以去Hexo官方文档查阅安装说明。

Git其实OSX自带了,如果没有的话直接安装一个命令行的Git即可。Node.js的话去官网下一个LTS版的安装程序安装即可。

第三步:安装Hexo

Hexo其实是一个基于Node.js写的框架,所以之前安装GitNode.js都是为了安装Hexo做准备。

在终端中输入:

1
sudo npm install -g hexo-cli

等待Hexo安装完成即可。

第四步:初始化以及发布博客

终端输入:

1
hexo init 你的用户名.github.io

等待Hexo帮你初始化博客。

初始化完成后,会多出一个你的用户名.github.io命名的博客文件夹,之后就可以进行写文章和发布了。

下面所有命令都必须在博客文件夹目录下使用:

  • 新建一篇文章(本地)

    1
    hexo new "文件名"

    新建的文章会在文件夹的博客文件夹/source/_post/文件夹下,以文件名.md命名,文章开头会有默认添加一些文章信息,如文章标题,默认会用文件名来命名文章标题,注意文件名和文章标题没有任何关系,可以随便改。

  • 生成博客静态页面(本地)

    1
    hexo g
  • 启动本地服务器,可以在本地预览文章

    1
    hexo s

    启动之后可以通过:http://localhost:4000 在本地预览博客文章,Ctrl+C可以终止服务。

  • 部署,即上传文章到博客,之前操作都只是在本地生效的,需要部署后才能在博客中看到;

    首先必须安装一个Hexo部署专用的Git工具:

    1
    npm install hexo-deployer-git --save

    修改配置文件_config.yml,该文件位于博客文件夹根目录下,用编辑器打开,修改末尾处的deploy部分:

    1
    2
    3
    4
    deploy:
    type: git
    repository:https://github.com/你的用户名/你的用户名.github.io.git
    branch: master

    在配置完成后,就可以一键把文章部署到博客了(文章必须先生成静态页面)。

    部署命令:

    1
    hexo d

    如果是第一次使用GitGitHub的话,终端会让你输入邮箱和密码,输入完成之后就会把你的文章上传发布到GitHub了。浏览器中输入:http://你的用户名.github.io 就可以访问到你的博客了。