Hexo + GitHub Pages 搭建专属博客

发表于 | 分类于

前言：2017年伊始，先给自己定了一个小目标，将Blog迁移到Hexo。本文是我2017年的开始，也是我在Hexo的开端，Mark一下！

摘要：本文的核心是介绍如何利用Github Pages 和 Hexo搭建自己的Blog，至于Git的使用，页面的美化，Hexo的命令等，敬请期待。。。别扔鸡蛋

Hexo GitHub GithubPages 介绍

Hexo

Hexo是一个快速、简洁且高效的博客框架，Hexo使用Markdown（或其他渲染引擎）解析文章，在几秒内即可利用靓丽的主题生成静态网页。

Github

不知道Github的程序猿，不是一只好猿 ~ Github是一个面向开源及私有软件项目的托管平台，仅支持Git作为唯一的版本库格式进行托管。

Github Pages

Github Pages可以理解为用户编写的、托管在github上的静态网页，你只需将你的改动提交到Github，就可以实现更改你的网页。

环境搭建

Node.js 点击有惊喜

选择对应的安装包下载，安装我就不啰嗦了，以下命令验证安装是否成功

1
2
$ node -v
$ npm -v

Git

  • Window下载直接安装即可点我下载

  • Mac建议使用HomeBrew安装Git。

    • 安装HomeBrew，终端运行下面命令

      1
      $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

    • 安装Git

      1
      $ brew install git

Hexo

安装命令：
$ npm install -g hexo-cli

Hexo初始化(建站)

初始化Blog文件夹

1
2
3
$ hexo init <folder>
$ cd <folder>
$ npm install

文件目录

1
2
3
4
5
6
7
8
.
├── _config.yml    配置文件
├── package.json   应用程序信息
├── scaffolds      模板文件夹 draft.md post.md page.md    
├── source         资源文件夹
|   ├── _drafts
|   └── _posts
└── themes         主题

Blog配置

打开_config.yml文件，懵逼了~眼花缭乱。。。挑几个常用的说一下，详解移步Hexo 站点配置
屏幕快照 2017-02-08 23.03.22.png-179.7kB

本地查看Blog效果

1
2
3
4
#生成静态文件
$ hexo generate
#启动服务器
$ hexo server
1
2
3
$ hexo s
INFO  Start processing
INFO  Hexo is running at http://localhost:4000/. Press Ctrl+C to stop.

部署Blog至Github Pages

注册GitHub账户

创建仓库

  • 点击New Repository
    屏幕快照 2017-02-08 21.58.51.png-12.7kB

  • Create a new repository
    屏幕快照 2017-02-08 22.01.23.png-85.7kB

配置SSH密钥

Git本地仓库和远程仓库之间的传输协议主要使用ssh协议，所以我们需要设置ssh

  • Step 1 查看是否存在SSH密钥
    1
    $ cd ~/.ssh;ls

如果id_rsa.pub和id_rsa文件存在，则证明ssh存在，直接进行Step 3操作

  • Step 2 创建ssh

    1
    2
    3
    4
    5
    6
    # 将根据提供的Email地址生成一对密钥
    $ ssh-keygen -t rsa -C "youremail@example.com"
    # 回车则创建默认的ssh，文件名为id_rsa 和 id_rsa.pub

    # 下面的命令可以自定义文件名
    $ cat ~/.ssh/<ssh file name>.pub

  • Step 3 添加SSH key 到 Github 账户

    1. 添加公钥到Github
      屏幕快照 2017-02-08 22.14.09.png-88.6kB

    2. 左侧工具栏点击SSH and GPG keys
      title 随意填，Key 将id_rsa.pub中的内容copy的这里

    3. 验证链接
      1
      2
      3
          $ ssh -T git@github.com
      Hi LeoPoldCrossing! You've successfully authenticated, but GitHub does not provide shell access.
          # bingo! SSH配置完成

  • Step 4 绑定Git 和 Github

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

关联Hexo和GitHub

  • Step 1 Copy仓库地址
    屏幕快照 2017-02-08 22.35.10.png-106.9kB

  • Step 2 修改_config.yml文件

    1
    2
    3
    4
    deploy:
      type: git
      repository: https://github.com/LeoPoldCrossing/LeoPoldCrossing.github.io.git
      branch: master

  • Step 3 在博客目录下执行：

    1
    2
    3
    4
    5
    6
    7
    $ hexo generate
    or 
    $ hexo g
    ------------华丽的分割线---------
    $ hexo deploy
    or 
    $ hexo d![blog-main.png-368.1kB][6]

根据提示输入github账号和密码，然后见证劳动成果的时刻
浏览器打开 username.github.io(我的是LeoPoldCrossing.github.io)，效果图如下：
blog-main.png-368.1kB

author: @ygwang