Github Pages + Hexo + Linux = Blog

前言


(Banner图片来自一喜欢摄影的同学:心碎乌托邦)

网上已经有很多类似主题的博客了,为什么还要再写一篇呢, 因为网上基本上都是写到搭建完成就完了, 而不告诉我们后续如何使用,看来只能由本博主来完成这个任务了。

文章中所有操作均是在Fedora下完成的.

本文包含以下几部分:

  1. 博客搭建
  2. 添加Categories/Tags/About页面
  3. Markdown语法
  4. 添加评论系统
  5. 如何写一篇博客直到发表出去

1. 博客搭建


声明:这部分我只是互联网的搬运工,具体Hexo,git,node.js是什么,请自行google.

转至:根据这篇文章足以完成建站

本博客使用的是icarus主题,一下所有操作也均是 基于此主题的。

Milestone 0 :至此建站完成

2. 添加Categories/Tags/About页面


由于主题里面的这三个页面都是空缺的,需要手动添加。当然也很简单,一条命令了事。

以创建categories为例。

1
2
$ hexo new page "categories"
INFO Created: xxx/source/categories/index.md

创建完以后,如果你懂markdown语法尽可在生成的index.md文件中添加东西。 不懂也没有关系,只要你愿意学,我想也是分分钟的事情,接下来就来学习一下 Markdown怎么写。

通过hexo server命令来预览

1
2
$ hexo server 
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

Milestone 1 :至此网站成型

3. Markdown语法


网上资料甚多,在此我只列出几篇文章,然后再贴出一个About页面的md内容,请大家自行学习。

修改GFM换行规则

首先,我想说明hexo使用的GFM 版本的Markdown语法,与标准Markdown的稍有不同。

最不爽的GFM中文档的换行就对应到页面中的换行,所以你必须把一段长文放在一行中, 这样看着就很不爽(特别是对某些vi的大神)。

我们希望使用Markdown的换行规则(即使用空行来换行)。

解决方案如下(icarus主题):将第11行的breaks设为false。

1
2
$ vi node_modules/hexo-renderer-marked/index.js
# breaks: true 改为 breaks: false

重新生成即可

1
$ hexo g

Markdown语法资料

通过这三篇文章足以满足平时写博客的需求。

下面贴出一段About页面的md示例

1
2
3
4
5
6
7
8
9
10
11
12
title: 关于
date: 2015-10-14 16:20:42
comments: true
---
## 个人简介
---
我是一个有追求的人,一直未来的世界必然有属于我的一片天。
## 喜欢的句子
---
* __生活不易,全靠演技__
## 联系方式
__Email: liuqi.edward(AT)gmail.com__

Milestone 2 :恭喜你,至此你已经具备了写博客的所有条件了。

4. 添加评论系统


添加多说评论:http://popozhu.github.io/2013/06/04/add-comment-of-duoshuo/

Milestone 3 :你的博客看起来更完善了。

5. 如何写一篇博客并发表出去

  1. 新建一篇博文

    1
    2
    $ hexo new post "tmp"
    INFO Created: xxx/source/_posts/tmp.md
  2. 启动hexo server来查看博文的展示效果(相当于调试)

    1
    $ hexo server
  3. 编写博文(写的时候可定时查看相关页面,看看效果。)

    1
    $ vi source/_posts/tmp.md
  4. 编写完成无误后,即可生成静态页面,提交到github上

    1
    2
    $ hexo g
    $ hexo deploy

就是这么简单,感谢hexo,感谢github

Milestone 4 :至此你已经具备控制博客的能力了。

参考


hexo官方文档