Hexo 搭建個人博客

安裝

首先需要安裝 node.js,node.js 安裝教程可參看 https://www.runoob.com/nodejs/nodejs-install-setup.html
然后執(zhí)行npm install -g hexoyarn 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.ymlthemepure。

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
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容