安裝
首先需要安裝 node.js,node.js 安裝教程可參看 https://www.runoob.com/nodejs/nodejs-install-setup.html
然后執(zhí)行npm install -g hexo 或 yarn global add hexo 安裝 Hexo。
建站
安裝 Hexo 完成后,請執(zhí)行下列命令,Hexo 將會在指定文件夾中新建所需要的文件。
$ hexo init <folder>
$ cd <folder>
$ npm i 或 yarn install
目錄結(jié)構(gòu)如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
在執(zhí)行 hexo init 的時候可能git會報錯,可以到 https://github.com/hexojs/hexo-starter.git 這個地址直接把 Hexo 項目下載下來,然后改成自己項目名字。
scaffolds
模版 文件夾。當(dāng)您新建文章時,Hexo 會根據(jù) scaffold 來建立文件。
Hexo 的模板是指在新建的文章文件中默認填充的內(nèi)容。例如,如果您修改 scaffold/post.md 中的 Front-matter 內(nèi)容,那么每次新建一篇文章時都會包含這個修改。
_config.yml
網(wǎng)站的配置信息,可以配置網(wǎng)站名稱、關(guān)鍵字、語言、作者、時區(qū)等信息。
source
資源文件夾是存放用戶資源的地方。除 _posts 文件夾之外,開頭命名為 _ (下劃線)的文件 / 文件夾和隱藏的文件將會被忽略。Markdown 和 HTML 文件會被解析并放到 public 文件夾,而其他文件會被拷貝過去。
themes
主題文件夾。可以去 https://hexo.io/themes/ 尋找喜歡的主題。
安裝主題
我使用的主題是 pure
啟用主題
在你的 hexo 項目文件夾下執(zhí)行:
git clone https://github.com/cofess/hexo-theme-pure.git themes/pure
修改配置文件 hexo/_config.yml 中 theme 為 pure。
gitalk 評論
Gitalk 是一個基于 Github Issue 的評論插件,每增加一條評論相應(yīng)的在 GitHub 項目增加一條 Issue。
注冊 GitHub Application
到 https://github.com/settings/applications/new 注冊 GitHub Application
填寫 Application name(項目名稱),Homepage URL(博客鏈接),Application description(描述),authorization callback URL(回調(diào)地址,博客鏈接)等信息,完成注冊,獲取到 Client ID 和 Client Secret。
如果項目在 Organization 下,需要進入到相應(yīng)的 Organization,點擊 Settings > OAuth Apps,注冊 GitHub Application。
配置 _config.yml
配置文件位置 themes/pure/_config.yml。
修改 comment > type 為:gitalk,將 Client ID 和 Client Secret 填寫的相應(yīng)位置,并填寫 owner,admin,repo。owner 為項目所有者,如果是 Organization,這填寫 Organization 名稱。admin 為你的用戶名,repo 對應(yīng) GitHub 中的項目名。
常用命令
創(chuàng)建一個新網(wǎng)站
hexo init [folder]
新建一篇文章
$ hexo new [layout] <title>
layout 可選,如果沒有設(shè)置 layout 的話,默認使用 _config.yml 中的 default_layout 參數(shù)代替。如果標題包含空格的話,請使用引號括起來。如:
$ hexo new "post title with whitespace"
| 參數(shù) | 描述 |
|---|---|
| -p, --path | 自定義新文章的路徑 |
| -r, --replace | 如果存在同名文章,將其替換 |
| -s, --slug | 文章的 Slug,作為新文章的文件名和發(fā)布后的 URL |
默認情況下,Hexo 會使用文章的標題來決定文章文件的路徑。對于獨立頁面來說,Hexo 會創(chuàng)建一個以標題為名字的目錄,并在目錄中放置一個 index.md 文件。你可以使用 --path 參數(shù)來覆蓋上述行為、自行決定文件的目錄:
hexo new page --path about/me "About me"
生成靜態(tài)文件
$ hexo generate 或 g
| 參數(shù) | 描述 |
|---|---|
| -d, --deploy | 文件生成后立即部署網(wǎng)站 |
| -w, --watch | 監(jiān)視文件變動 |
示例
檢測文件變動實時預(yù)覽:
$ hexo g -w
生成文件自動部署:
$ hexo g -d
啟動服務(wù)器
$ hexo server 或 s
默認情況下,訪問網(wǎng)址為: http://localhost:4000/。
部署
$ hexo deploy
部署方式請看 https://hexo.io/zh-cn/docs/one-command-deployment
清除緩存文件
$ hexo clean