Hexo博客建立指南（1/3）

发表于   |     |   阅读次数   |  

拥有自己的个人天地是一件很酷的事情，你可以记录任何你想要记录的事情，甚至与他人分享你的经验、知识或见解。选择GitHub Pages + Hexo服务能够让你更加多样化地展示你的想法，比如图片、数学公式、代码等。你还可以通过主题的配置获得更加符合个人审美的博客样式，更多的功能特性，比如友情链接，评论、分享、打赏功能等。

最重要的是，一次配置，就能帮助你免去网站版式设计的烦恼。把你的双手解放出来，尽情地写作与记录。

为了更好地做到这一点，通常我们使用·Markdown·来辅助写作需求。

1. 准备工作

1.1 创建新的Github空仓库

创建时只填写仓库名字，格式必须为<yourname>.github.io，例如我的为ramonyeung.github.io.如果不购买域名，这将会是你的博客网址。

1.2 安装软件

Node.js https://nodejs.org/en/

​ Hexo的依赖包，支持其主体功能。版本v4.6.0以上即可。

Git Bash http://git-scm.com/download/

​ 版本管理，将本地的Hexo文件提交到GitHub或Coding中。版本随意。

Hexo

​ npm install -g hexo # -g 表示global，在全局环境中安装Hexo。

2. 初始化Hexo博客

Hexo已经简化了创建一个基本博客的流程。在E盘根目录创建一个名为blog的文件夹。进入E:\blog文件夹，右键点击空白处，选择Git Bash Here，打开一个终端（Terminal / Command Line)。

  • 输入hexo init，Hexo将帮你自动生成建立网站的必要文件。默认使用Landscape主题。
  • 安装依赖包npm install和npm install hexo-deployer-git --save.
  • 输入hexo g.
  • 输入hexo s.

在浏览器访问http://localhost:4000/，即可看到博客的初始效果。

3. 由本地到远程仓库

目前博客的内容仅在本地，用户不可能访问你的电脑中的内容，这太危险了。所以，需要一个托管代码和博客内容的Github仓库，也就是前面创建的ramonyeung.github.io仓库。

3.1 配置_config.yml

注意这个文件位于根目录下，我的是E:\blog.它是站点配置文件。

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

3.2 配置SSH连接

配置SSH连接是为了更好更快地连接到GitHub并提交、存储你的内容。依次输入下面的Shell Script.

1
2
3
4
5
6
7
8
9
10
11
12
# 检查先前是否有SSH keys，如果有，则删除
ls -al ~/.ssh
cd ~/.ssh
rm -rf *
ssh-keygen -t rsa -C "capriceyhh@gmail.com" # 你注册GitHub时使用的邮箱
# 此处需要按两次回车，保存ssh key到默认位置并忽略passphrase
ssh-agent -s # 启动ssh agent
eval `ssh-agent -s` 
ssh-add 
clip < ~/.ssh/id_rsa.pub # 复制你的公钥

前往GitHub进行SSH公钥设置Personal setting->SSH and GPG keys->New SSH key，将剪贴板中的内容复制到Key中并添加。

1
2
# 检查连接是否成功建立
ssh -T git@github.com

切换目录到E:\blog，尝试同步文件到远程仓库。

1
2
3
cd E:\blog
hexo g
hexo d

3.3 发布测试文章

1
2
hexo new "what-is-feature-engineering"
# 最好是英文名

在使用hexo new或hexo n命令时，实际上是在文件夹E:\blog\source\_posts中创建了一个新的Markdown文件，并带有一个固定的yaml格式配置。打开Markdown文件你会看到：

1
2
3
4
5
---
title: Hexo博客建立指南（1/3）
date: 2016-10-30 15:00:59
tags: [Hexo, Building things on you own]
---

所以，写作的过程就是完成这个Markdown文件的后续部分。在你确认将内容提交到博客网站上时，使用hexo g自动生成所有配置文件，再使用hexo s在本地唤醒一个HTTP服务，进行查看；或者使用hexo d将文件直接部署到远程GitHub仓库。

4. Footnotes

1
2
3
4
hexo g # 即 hexo generate 根据主题自动生成必要的文件
hexo s # 即 hexo server   启动本地的HTTP Server预览博客效果
hexo n # 即 hexo new      新建一篇Markdown文章
hexo d # 即 hexo deploy   将内容部署到GitHub仓库
打赏作者一个苹果