經過一段時間的折騰終于用 Hexo + GitHub 搭建起了一個個人博客站點,第一時間邊學邊寫,弄出了這第一篇博客,心里甚是歡喜。
Hexo是一款“快速、簡潔且高效的博客框架”,支持 Markdown 的所有功能。所以,寫出一篇博客必須學習 Hexo 和 Markdown 的使用規則。
1. 配置文件命名規則和路由地址
Hexo 默認以標題作為文件名稱,可以通過 Hexo 的配置文件 _config.yml 中的 new_post_name 參數來改變默認的文件名稱,例如:
new_post_name: :year-:month-:day-:title.md
當創建博客時,就會以這種格式生成Markdown文件,如這篇博客的文件名就生成 2017-01-13-hexo-blog.md 這種形式。其中相關變量說明如下表:
變量 | 說明 |
---|---|
:title | 標題(小寫, 空格將會被替換為短杠) |
:year | 創建的年份,如:2017 |
:month | 創建的月份(有前導零),如:01 |
:i_month | 創建的月份(無前導零),如:1 |
:day | 創建的日期(有前導零),如:09 |
:i_day | 創建的月份(無前導零),如:9 |
配置瀏覽器地址欄中的URL。同樣在 Hexo 的配置文件 _config.yml 中, 配置 permalink 屬性 ,例如:
permalink: /blog/:year/:month/:day/:title/
當在地址欄訪問時,就會如下方式呈現出來:
http://localhost:4000/blog/2017/01/13/hexo-blog/
2. 創建博客
在命令行中用如下命令創建一篇新的文章
$ hexo new [layout] <title>
布局(layout) | 存儲路徑 | 說明 |
---|---|---|
post | source/_posts | 默認,可以直接發布 |
page | source | 在source下新建一個文件夾 |
draft | source/_drafts | 新建文件將保持到_drafts中 |
可以用 publish 命令將草稿移動到 source/_posts 文件夾下
$ hexo publish [layout] <title>
3. 寫作
經過上面上面一系列的準備工作,現在差不多就可以安心的寫作了。打開 source/_posts 文件夾下剛創建的 Markdown 文件,你會發現有如下內容:
---
title: hexo-blog
date: 2017-01-13 16:07:32
tags:
---
注意,這里的 title 是可以隨便改的,當然了 date 也是可以改,不過沒有改的必要;這里要說一下 tags 這個屬性,如果需要配置多個有兩種方式:
tags: [tag1, tag2, tag3]
或者
tags:
- tag1
- tag2
- tag3
之前說過 Hexo 是支持 Markdown 的所有功能的,所以,下面去學習一下 Markdown 的語法規范。
3.1 斜體和粗體
寫法:
*這是斜體* 或 _這也是斜體_
**這是粗體**
***這是加粗斜體***
~~這是刪除線~~
效果:
這是斜體 或 這也是斜體
這是粗體
這是加粗斜體
這是刪除線
3.2 分級標題
寫法:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
效果:
3.3 超鏈接
寫法:
行內形式:[我的博客](https://kevinpu.github.io/)
參考形式:[我的博客][1],有一個很好的平臺-[簡書][2]
[1]:https://kevinpu.github.io/
[2]:http://www.lxweimin.com/
自動鏈接:我的博客地址<https://kevinpu.github.io/>
效果:
行內形式:我的博客
參考形式:[我的博客][1],有一個很好的平臺-[簡書][2]
[1]:https://kevinpu.github.io/
[2]:http://www.lxweimin.com/
自動鏈接:我的博客地址https://kevinpu.github.io/
3.4 列表
無序列表:
寫法:
* 無序列表項1
+ 無序列表項2
- 無序列表項3
效果:
- 無序列表項1
- 無序列表項2
- 無序列表項3
有序列表:
寫法:
1.有序列表項1
2.有序列表項2
3.有序列表項3
效果:
1.有序列表項1
2.有序列表項2
3.有序列表項3
3.5 插入圖片
在 Hexo 中插入圖片,首先需要將圖片放在 source/images/ 文件夾下,然后如下方式進行插入:

效果:
3.6 表格
| 表頭1|表頭2|表頭3|表頭4
|-| :- | :-: | -: |
|默認左對齊|左對齊|居中對其|右對齊|
|默認左對齊|左對齊|居中對其|右對齊|
|默認左對齊|左對齊|居中對其|右對齊|
效果:
表頭1 | 表頭2 | 表頭3 | 表頭4 |
---|---|---|---|
默認左對齊 | 左對齊 | 居中對其 | 右對齊 |
默認左對齊 | 左對齊 | 居中對其 | 右對齊 |
默認左對齊 | 左對齊 | 居中對其 | 右對齊 |
4. 總結
記錄了一下 Hexo 寫博客的環境配置,了解創建博客的過程和一些相關的變量,然后學習一下 Markdown 的基本語法規范,下次有時間在將 Markdown 更深入的使用方法記錄一下。