開發工具總結（13）之Hexo制作文檔并釋出到GitHub

本文出自 AWeiLoveAndroid的部落格

Hexo是一個很不錯的文檔工具，有着大量豐富的模闆，很多開發者都在使用Hexo模闆建立個人部落格。如果你看到一個不錯的模闆，可以直接下載下傳下來，然後修改一下配置，寫自己的MD檔案，一鍵生成html檔案，可以直接部署到github。是不是很爽？省時省力。下面講解一下Hexo之多文檔詳細的過程。

一、安裝必備工具

（1）安裝git（大家基本都會）

具體操作請檢視我的部落格：開發工具總結（3）之Git及GitHub快速入門圖文全面詳解https://www.jianshu.com/p/3f12bd3ccf2a

（2）安裝Node.js

具體操作請檢視我的部落格：開發工具總結（11）之nodejs、npm和yarn安裝和使用和填坑詳解 https://www.jianshu.com/p/9eba0e2c0697

（3）執行

npm install -g hexo-cli

下載下傳hexo工具。

二、通用配置步驟（不管是什麼hexo模闆基本都有這幾個步驟）

1.下載下傳主題代碼

hexo init blogname

建立一個名為

blogname

的檔案夾

cd blogname

打開

blogname

檔案夾

git clone https://github.com/xxx/yyy.git themes/aaa

從github下載下傳源碼，我這裡選擇的是

https://github.com/xxx/yyy

這個庫。這個指令意思是把github下載下傳到指定檔案夾裡面的

themes/aaa

這個檔案目錄。我們可以看到

blogname/themes/

目錄裡面多了一個aaa檔案夾。

2.修改hexo配置檔案

修改hexo的配置檔案：

blogname/_config.yml

：

例如：

# ... 
title: 您自己的網站标題
subtitle: # 不需要填寫
description: 您自己的網站描述
keywords: 您自己的網站關鍵詞
author: 您的姓名
language: zh-Hans # 目前僅支援中文
timezone: # 不需要填寫

permalink: passages/:title/  # 如果您需要開啟評論和文章統計，請修改此配置

# 設定主題
theme: aaa # 啟用 "aaa" 主題

# ...           

複制

當然這個配置有很多，根據不同的hexo主題的要求進行個性化設定即可。

3.修改主題配置檔案：

主題配置檔案：

blogname/themes/bmw/_config.yml

4.啟動部落格

執行指令

hexo s

啟動部落格，然後使用Chrome等主流浏覽器打開 http://localhost:4000/ ，檢視部落格。

5.生成html源碼

如果想部署到外部伺服器，可以使用指令

hexo g

生成html源碼。

三、遇到的坑

1、項目裡面的

node_module

檔案夾删除之後報錯

Local hexo not found in xxx

【解決方案】指令行進入項目路徑，執行指令

npm install

。

四、美化Hexo文檔（可選）

注：本文參考hexo文檔位址：https://hexo.io/zh-cn/docs/ 有不懂的可以去檢視。