在github上搭建hexo博客教程

作者 胡萝虎 日期 2018-04-11
在github上搭建hexo博客教程

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在几秒内,即可利用靓丽的主题生成静态网页。Hexo相对于wordpress更加轻量,且不需要数据库,比较适合没有服务器的爱好者。以下是我自己实际安装部署的过程,分享给大家。
Github Pages可以被认为是用户编写的、托管在github上的静态网页。

安装git

git下载,大家根据自己的系统下载相应安装包安装即可,这里就不详细介绍了。

git教程,如果不熟悉git,可以先简单看下教程。

安装Node.js

Hexo基于Node.js开发,因此开始Hexo之前还需要先安装Node.js,大家到这个地址下载相应版本安装即可,不再赘述。Linux用户建议使用nvm安装,Mac用户建议使用Homebrew安装。

安装hexo

准备完git和Node.js后,可以正式开始Hexo了。

  • 首先安装Hexo:
$ npm install -g hexo

-g 表示全局安装。

  • 初始化Hexo
$ cd ~/workspace
$ hexo init hexo-blog

到工作目录(可以按自己情况确定),然后初始化hexo,hexo-blog 是项目的名称,自由确定。
此时,已经在workspace目录下生成了一个新的工程:hexo-blog
工程结构如下:
mage-20180411142600

  • 启动Hexo

    $ npm install
    $ hexo generate
    $ hexo server

    然后在浏览器中输入:localhost:4000 即可进行访问。

部署到Github

  1. 申请Github账号,这个就不介绍了

  2. 创建repsoitory

    • 在你的Github主页,点击New repository 按钮

    mage-20180411143202

  • 设置Repository

    mage-20180411143352

注意: Repository name一定要是你的github账号的ID加上github.io,否则不会生效。此处我的github账号ID为fooololo,所以Repository name为fooololo.github.io

mage-20180411143614

Description随便填,勾选Public,然后点击Create repsository按钮即可。

  1. 生成SSH key

    $ cd ~/.ssh
    $ ssh-keygen -t rsa -C "xxx@gmail.com"

    然后一路回车,这时候会在~/.ssh目录下生成id_rsa和id_rsa.pub两个文件,前者是私钥,后者是公钥。

  2. 将公钥添加到Github

    • 到Github的settings页面->SSH and GPC keys

    mage-20180411150751

    • 创建新的SSH key

      title任意填,key的内容就是前面生成的公钥文件中的内容,拷过来直接粘贴就好。

  3. 配置Hexo

    在工程的根目录下找到_config.yml,找到deploy项,编辑如下:

    deploy:
    type: git
    repo: https://github.com/xxx/xxx.github.io.git
    branch: master
    message: deploy

    type设置为git

    repo设置为上面创建的Repository的地址

    branch设置为master

    message可以随便填或忽略

  4. 安装deploy扩展

    接下来安装部署扩展,帮助我们在生成静态页面后自动部署到Github(或其他托管服务)

    $ cd ~/workspace/hexo-blog
    $ npm install hexo-deploy-git --save
  5. 生成并部署博客

    现在终于可以发布博客了,执行以下命令

    $ cd ~/workspace/hexo-blog
    $ hexo generate
    $ hexo deploy

    如果不报错,就OK了,这时候在浏览器中输入http://xxx.github.io(xxx为你的Github账号ID),就可以访问到你的博客了。

    我使用的是Anisina主题,效果如下:

    mage-20180413131142

mage-20180413131224

你可能会喜欢

“扫一扫接着看”