引言
Hexo 是一個(gè)快速帝簇、簡潔且高效的博客框架贬芥,使用Markdown解析,生成靜態(tài)網(wǎng)頁调缨。本文介紹Hexo的安裝過程疮鲫,及基本使用。
安裝
準(zhǔn)備
安裝前需準(zhǔn)備以下應(yīng)用:
Git
Node.js
安裝Hexo
準(zhǔn)備完畢后弦叶,執(zhí)行如下命令安裝Hexo
$ npm install hexo-cli -g
$ npm install hexo --save
初始化
安裝 Hexo 完成后俊犯,請(qǐng)執(zhí)行下列命令,Hexo 將會(huì)在指定文件夾中新建所需要的文件伤哺。
$ hexo init <folder>
$ cd <folder>
$ npm install
新建完成后燕侠,文件夾目錄如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── scripts
├── source
| ├── _drafts
| └── _posts
└── themes
其中:
_config.yml 全局配置文件
package.json 應(yīng)用程序的信息
scaffolds 模版文件夾
scripts 腳本文件夾
source 資源文件夾是存放用戶資源的地方
themes 存放皮膚的文件夾,默認(rèn)皮膚為landscape
安裝插件
可按需選擇插件安裝
$ npm install hexo-generator-index --save
$ npm install hexo-generator-archive --save
$ npm install hexo-generator-category --save
$ npm install hexo-generator-tag --save
$ npm install hexo-server --save
$ npm install hexo-deployer-git --save
$ npm install hexo-deployer-heroku --save
$ npm install hexo-deployer-rsync --save
$ npm install hexo-deployer-openshift --save
$ npm install hexo-renderer-marked --save
$ npm install hexo-renderer-stylus --save
$ npm install hexo-generator-feed --save
$ npm install hexo-generator-sitemap --save
至此,安裝完畢立莉,執(zhí)行如下命令后可至127.0.0.1:4000預(yù)覽Hello World绢彤。
hexo server
使用
配置
可以在 _config.yml 中修改大部份的配置,這里引用官方文檔里描述蜓耻。
https://hexo.io/zh-cn/docs/configuration.html
寫文章
可以直接在source/_posts文件夾下新建.md文件茫舶,或者使用如下命令新建文章。
$ hexo new post <title>
使用命令生成的文章刹淌,會(huì)套用scaffolds下面的模板饶氏,模板中可以自定義參數(shù)。
參數(shù) 描述 默認(rèn)值
layout 布局
title 標(biāo)題
date 建立日期 文件建立日期
updated 更新日期 文件更新日期
comments 開啟文章的評(píng)論功能 true
tags 標(biāo)簽(不適用于分頁)
categories 分類(不適用于分頁)
permalink 覆蓋文章網(wǎng)址
文章使用Markdown書寫芦鳍,寫完后
hexo server
就可以本地預(yù)覽了嚷往。
部署到Github
Github為個(gè)人和項(xiàng)目提供了頁面展示的功能,以個(gè)人為例柠衅,創(chuàng)建一個(gè)以
username.github.io
為名稱的公開倉庫皮仁。當(dāng)部署完畢后,便可以訪問個(gè)人主頁菲宴。
Hexo提供了方便的部署功能贷祈,可以將生成的靜態(tài)頁面推到git倉庫。在_config.yml文件中配置如下信息喝峦。
deploy:
type: git
repo: https://github.com/username/username.github.io.git
branch: master
同時(shí)記得安裝hexo-deployer-git插件,就可以將靜態(tài)頁面推到github中了势誊。
hexo g #生成頁面
hexo d #部署
參考
https://hexo.io/zh-cn/docs/
http://wsgzao.github.io/post/hexo-guide/