Hexo + Github pages 搭建个人博客

把搭建博客的每一步都记录下来.

Github hexo

可以根据Hexo文档来开发,这里都有详细的教程.

准备工作

  • 安装Node.js
  • 安装Git
  • 安装hexo
  • 在终端里面执行以下代码安装 npm:

    1
    npm install

安装完之后在分别终端里面输入:

1
2
3
git --version
node -v
npm -v

看到各个插件的版本之后才说明是准备工作完成.

开始搭建博客

  • 找一个自己喜欢的路径,创建一个的文件夹Hexo,在终端里打开这个Hexo 文件夹,然后执行:

    1
    hexo init
  • 到现在就安装好了所有的东西

    继续在打开的Hexo文件的终端分别输入:

    1
    2
    hexo generate
    hexo server

    也可以简写为:

    1
    2
    hexo g
    hexo s

hexo generate 是生成静态页面, hexo server 是启动本地调试.

完成之后打开浏览器输入网址 localhost:4000,就可以看到本地已经出现hexo初始的博客了

在Github上面创建新的仓库

  • 点击 New repository 进入创建仓库界面,新建的仓库名字格式必须是:xxxx.github.io,如下图

    Alt text

  • 创建 SSH keys 在终端里面输入

    1
    cd ~/.ssh
  • 查看此文件夹里面是否有 id _rsa id _rsa.pub 两个文件,如果有的话就说明已经有 SSH keys

    如果没有的话就自己生成一个,终端里面输入你自己的邮箱:

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

    然后会出现 :

    1
    2
    Generating public/private rsa key pair.
    Enter file in which to save the key (/Users/you/.ssh/id_rsa):

    意思是让你输入 SSH keys 的保存地址 直接回车就好,不用理会,然后会出现:

    1
    Enter passphrase (empty for no passphrase): [Type a passphrase]

    意思是让你输入密码,这个要记住,以后会用的到,创建成功之后他会提示你 SSH keys 保存到哪里,按照这个地址找到 id _rsa.pub. 这个就是 SSH key,用终端打开这个文件,然后拷贝里面的内容,最上面的那部分

  • 为github仓库添加 SSH key,进入Github的设置里面,找到 SSH and GPG keys进入里面点击 New SSH key 把之前拷贝的内容放进去,然后确定就OK了.

    在终端里面输入:

    1
    ssh -T git@github.com

来测试链接是否成功.

它可能会出现一些乱七八糟的提示,最后是问你yes/no,就输入yes.

如果是:

1
Enter passphrase for key '/c/Users/2000104591/.ssh/id_rsa':

输入之前让你记住的那个密码就行了.

最后提示你:

1
Hi, 用户名/用户名.github.io! You've successfully authenticated, but GitHub does notprovide shell access.

这样就配置完毕了

  • 配置 _config.yml 文件,在让你新建的 Hexo 目录下有个 _ config.yml 文件,打开他把里面的 deploy: 下的东西改为

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

    配置完成以后,执行:

    1
    2
    hexo generate
    hexo deploy

如果报错:

1
Error: Deployer not found : github

执行如下命令:

1
npm install hexo-deployer-git --save

成功之后再试一次输入:

1
2
hexo g
hexo d

提示你成功之后你就可以打开xxxx.github.io来查看你的博客了.

坚持原创技术分享,您的支持将鼓励我继续创作!