Hexo+GithubPage搭建博客

发表于

记录下搭建搭建过程，也是自己的第一次开始写博客。
搭建环境：mac

准备

  1. 安装 git
  2. 安装 node

安装前先确认是否已经安装相关组件。

1
2
git --version #git 
node --version #node

若还没安装，参考hexo中文文档进行安装，mac用户建议先下载Xcode，Xcode自带git。
遇到的坑：可能是被墙的问题，按照官方文档无法通过nvm方式安装node，成功过，但是第二天起来node命令失效了，还不知道原因，知情者请告知，所以，最后我是以最原始的下载安装包的方式安装。附官网地址：node.js官网

安装Hexo

安装好git和node之后，就可以安装hexo了，简单一句命令搞定:

1
$sudo npm install -g hexo-cli

创建Hexo本地博客

安装完成后，执行以下命令，Hexo将在指定目录下新建需要的文件

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

新建之后可以看到类似以下目录结构：

目录结构

网站配置文件 _config.yml

网站的配置文件，你可以在这里配置一些基本信息，这里列举部分关键配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: Dududzai’s Blog #网站的标题
subtitle: life is struggle #副标题
description: life is struggle #描述
author: examble #作者信息
avatar: /images/avatar.png #头像，图片位置在相应主题目录下的images
language: zh-Hans #中文简体
email: 838567407@qq.com
timezone:

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: next #配置主题，这里使用next主题
stylus:
  compress: true #自适应布局

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git #部署环境，基于hexo+githubpage,所以这里使用git。注意：不同版本的hexo，type有可能不同，3.x以后应使用git,具体参看官方文档
  repository: git@github.com:username/username.github.io.git #git仓库地址，替换成你的username即可，其他保持不变，后面会提到如何创建git仓库
  branch: master

附：next主题地址

下载next主题

next主题文档: http://theme-next.iissnan.com/
这里我采用git安装，也可下载zip包，但是推荐使用git，可通过git pull更新新版本：

1
2
3
#定位到hexo项目目录下，使用git checkout：
$ cd your-hexo-site
$ git clone https://github.com/iissnan/hexo-theme-next themes/next

在themes/next/目录下也有一个_config.yml文件，这个为相应主题的配置文件，具体参考上面的文档配置，这里不赘述。

关联githubpage

  1. 创建github账号
  2. 创建新的仓库
  3. 建立你的githubpage
  4. 关联SSH key

创建github账号

这个简单，官网按流程注册一个

创建仓库

  1. github上点击右上角“+”号，新建仓库，命名格式为：你的账号名.github.io。这里要勾选创建read.me选项
  2. 成功之后进入你的仓库，点Settings,点Laucher automatic page generator,按步骤完成即可。
  3. 这样你就拥有了githubpage,githubpage稍微了解了下，应该是github提供每个用户的介绍页面，每个账号只有一个

关联SSH key

检查本机秘钥

1
$ cd ~/. ssh 检查本机的ssh密钥

如果提示：No such file or directory 说明你是第一次使用git。

生产新的SSH Key配置

输入之后，直接回车即可

1
$ ssh-keygen -t rsa -C "邮件地址@youremail.com"

添加SSH key到github
  1. 成功后会生成两个文件id_rsa 以及id_rsa.pub。mac用户在Users/.ssh。用文本打开，将里面的内容复制到github上。
  2. 在任意界面右上角，点击你的头像，选择Settings
    git setting
  3. 选择 SSH keys
    setting detail
  4. 点击New SSH key
    new ssh key
  5. “Title”项添加关于你要添加key的描述.如果你使用自己的mac,你可以写成”macair”。复制你的id_rsa.pub的内容到”Key”中
    Add ssh key
  6. 点击Add SSH Key添加
  7. Github会要求你输入Github密码确认

添加新文章以及发布

  1. hexo new #新建一篇文章,但是我习惯到source/_prosts/中直接创建xxx.md文件。（hexo 识别markdown，html文件，其余会被忽略）

  2. 一开始进入了一个误区，以为是手动通过git命令来提交代码至github，虽然本质是这样的，但是配置好hexo后，hexo已经代理了所有的操作，每次部署你都可以这样方便的完成：

    1
    2
    3
    hexo clean
    hexo generator #简写 hexo g
    hexo deploy #简写 hexo d

以上。