搭建基于 Hexo 和 Git Pages 的个人技术博客

导言


搭建一个个人博客需要什么?

一般来说,建立一个网站所必需的要素有以下几个内容:

  • 主机(Git Pages)
  • 域名(Freenom)
  • 内容(Hexo)

Git Pages 是什么?

GitHub Pages is a static site hosting service.
GitHub Pages is designed to host your personal, organization, or project pages directly from a GitHub repository
GitHub Pages 是一个静态网站托管服务。
GitHub Pages 可以从一个 GitHub 仓库来建立个人、组织或者项目页面。

通俗地讲,Git Pages 是 GitHub 提供的一项静态页面托管服务,服务依托于 GitHub 仓库,用户可以利用这项功能,简单、快速的建立个人、组织或项目的静态页面。我们这里就选择 GitHub Pages 作为个人网站的主机,GitHub Pages 的主机服务,提供了一个 username.github.io 的二级域名,采用了 SSL 加密,也可以绑定自己的顶级域名,这里推荐 Freenom,免费提供 .tk/.ml 等后缀的顶级域名。

Hexo

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

解决了主机和域名的问题,接下来就需要解决内容的问题,由于 Git Pages 只能支持静态界面,也不支持数据库,所以这里没有办法搭建如 WordPress 之类的博客,Git Pages 本身提供了 Automatic Page Generator 工具,可以生成简单的基础页面,你也可以将自己的静态页面提交到仓库,进行展示。
不过 Hexo 和 Jekyll 为我们提供了一个更为简单的方法,分别基于 Node.js 和 Ruby 开发,可以在本地快速、简单的生成静态网页,我们这里选择 Hexo 作为我们的生成工具。

建立 GitHub Pages 仓库


如果你之前没有注册过 GitHub,请先注册一个 GitHub 账号,你的 GitHub 账号就是以后 Git Pages 二级域名的前缀。

登录 GitHub 之后,新建(New)一个仓库(Repository),注意仓库的名字必须是 username.github.io,其中的 username 是你的 GitHub 用户名。

之后,你可以在 Repo 中新建一个 index.html 文件,测试一下是否能够访问 username.github.io,如果能够访问,那么你已经完成了 Git Pages 的建立工作。

index.html 文件:

Hello world!

搭建本地 Hexo 环境


Hexo 要求的环境不高,只有以下两项:

安装 Node.js 和 Git

  • 在 Node.js 的官网下载适合系统版本的安装包,这里选择的是 V4.5.0 LTS 版本
  • 运行安装包,按照默认设置安装
  • 在 Git 官网下载适合系统的安装包,这里下载的是 2.10.0 版本
  • 采用默认设置安装 Git
  • 打开命令提示符(PowerShell),采用下面的命令测试环境安装情况
npm --version
git --version

如果能够返回版本号,则说明环境安装正常。

安装 Hexo

在 Node.js 环境下安装 Hexo 相当简单,直接在命令提示符(PowerShell)执行下面的命令就可以自动安装:

npm install -g hexo-cli

Hexo 安装完成后,需要在本地建立一个目录,作为 Hexo 初始化和保存文章的根目录,为了更好的备份和同步,建议放在 OneDrive 或 DropBox 的目录,这里以 ~/OneDrive/Hexo/ 目录为例:

# 切换到根目录
cd ~/OneDrive/Hexo
# 初始化Hexo
hexo init

初始化完成后,Hexo 目录的结构如下:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

其中:

_config.yml
网站的 配置 信息,您可以在此配置大部分的参数。

package.json
应用程序的信息。

scaffolds
模版 文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。

source
资源文件夹是存放用户资源的地方。除 _posts 文件夹之外,开头命名为 _(下划线) 的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

themes
主题 文件夹。Hexo 会根据主题来生成静态页面。

现在,我们就可以尝试在本地测试我们的站点, 更多的配置请参考官方文档:

hexo g
hexo s

打开浏览器,访问 http://localhost:4000 即可看到目前的网站效果,之后也可以用来预览部署之后的网站。

写作和部署


开始写作文章

本地 Hexo 环境配置好后,就可以开始写作了,Hexo 中,文章保存在 source/_post/ 文件夹下,默认是 .md 格式的 Markdown 文档,Markdown 编辑器有很多,这里推荐一个开源的 Markdown 编辑器: Typora

写作可以直接在 _post 文件夹新建 .md 文档,也可以使用命令生成文档,需要注意,自行新建的文档需要严格按照指定格式

hexo new 文章标题

---
title: 文章标题
date: 2016-08-24
categories: 文章分类
tags: 
    - 关键词1
    - 关键词2
    - 关键词3
---
正文

将网站部署到 Git Pages

Hexo 可以一键部署到 Git Pages,首先安装 hexo-deployer-git:

npm install hexo-deployer-git --save

之后修改配置文件 _config.yml:

deploy:
 type: git
 repo: <repository url>
 branch: [branch]
 message: [message]

其中:

<repository url> 是你在 GitHub 上建立的仓库的地址,如https://github.com/username/username.github.io
[branch] 是分支名称,一般填 master
[message] 是 commit 信息,默认为 Site updated at {{ now('YYYY-MM-DD HH:mm:ss') }}

之后,在根目录输入以下命令,即可将网站部署到 Git Pages(中途可能会要求输入 GitHub 用户名和密码):

hexo d -g

进阶


安装主题和插件

示例网站 中采用了 IIssNan 开发的 NexT 主题,Hexo 也支持更多的主题和插件,请自行阅读相关文档。

绑定私人域名

  • Freenom 注册免费的域名
  • ping username.github.io
  • 在 Freenom 的后台,将 A 记录解析到上面 ping 出来的 ip 地址上
  • 在 /source 目录建立 CNAME 文件,内容为注册的 ip 地址

CDN 加速和 SSL 加密

这里采用了 CloudFlare 提供的 CDN 和 SSL 服务:

  • 注册账号
  • 按照提示添加站点
  • 在 Freenom 后台中,将 Nameserver 服务器改为 CloudFlare 中提供的 NS 地址
  • 开启 Flexible SSL
  • 开启 Always Online
  • 其他设置

参考文档


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,372评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,368评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,415评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,157评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,171评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,125评论 1 297
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,028评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,887评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,310评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,533评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,690评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,411评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,004评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,659评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,812评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,693评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,577评论 2 353

推荐阅读更多精彩内容