Hexo 的安裝
Hexo 是一款基于 Node.js 的靜態(tài)博客框架,依賴少易于安裝使用,可以方便的生成靜態(tài)網(wǎng)頁托管在 、Gitee 上,是搭建博客的首選框架。
安裝 Git
Git 是目前世界上最先進的分布式版本控制系統(tǒng),可以有效、高速的處理從很小到非常大的項目版本管理。
apt-get install git -y
安裝 Node.js
Hexo 是基于 Node.js 編寫的,所以需要安裝一下 Node.js 和 npm 工具,Node.js 默認包含 npm 。
apt-get install nodejs npm -y
安裝完后,輸入如下命令,檢查是否安裝成功。
node -v
npm -v
升級 npm 到最新版本,更換 npm 源為淘寶源。
npm install -g npm
npm config set registry https://registry.npm.taobao.org
升級 Node.js 版本
npm cache clean -f
npm install n -g
npm view node versions
# 升級到指定的版本:n 版本號
n 16.0.0
# 升級到最新的穩(wěn)定版本
n stable
# 升級到最新版本,不推薦
n latest
用 node -v 查看 Node.js 版本,如果版本號改變?yōu)橄胍膭t升級成功。如果版本號沒變,可以重啟機器或者嘗試以下方法:
查看安裝 Node.js 的位置,輸入如下命令后顯示 Node.js 的安裝路徑。
which node
/usr/local/n/versions/node/16.0.0 // 具體的安裝路徑
配置環(huán)境變量,進入該位置。
cd /usr/local/n/versions/node
編輯 /etc/ ,將 Node.js 安裝的環(huán)境變量添加到文件末尾。
export NODE_HOME=/usr/local/n/versions/node/16.0.0 // 16.0.0 是Node.js 的版本號

export PATH=$NODE_HOME/bin:$PATH
保存文件,再刷新 /etc/ 使配置生效,輸入如下命令:
source /etc/profile
安裝 Hexo
前面 Git 和 Node.js 安裝好后,就可以正式進行安裝 Hexo 。
安裝 Hexo 。
npm install -g hexo-cli
查看版本信息 。
hexo -v
升級 Hexo 版本
npm install -g npm-check npm-upgrade
npm-check
npm-upgrade
正確運行后 Hexo 及插件已經(jīng)升級成功,執(zhí)行 hexo 查看版本。
初始化 Hexo
hexo init filename(文件名隨意定義)
cd filename //進入這個文件夾
npm install
說明:自動在文件夾()中創(chuàng)建項目所需的文件。
說明:將操作位置轉(zhuǎn)移到將要存放項目的文件夾目錄。
說明:安裝依賴包。
上述步驟操作完成后,指定 Hexo 根目錄下有如下文件:
啟動 Hexo 服務(wù)
正確安裝完成后便按照下面操作啟動 Hexo 博客。
hexo generate # 生成靜態(tài)頁面至 public 目錄
hexo server # 開啟預(yù)覽訪問端口(默認端口 4000 ,ctrl + c 關(guān)閉 server )
打開瀏覽器輸入對應(yīng)的網(wǎng)址 :4000 ,就可以看到生成的博客。
Hexo 部署到 在 官網(wǎng)上創(chuàng)建個人倉庫
登錄 官網(wǎng),點擊右上角加號,點擊 New ,新建倉庫。
創(chuàng)建一個和賬號名相同的倉庫(即 ,其中 xxx 是 的賬號名),點擊 創(chuàng)建。
Git 初始化設(shè)置
git config --global user.name "你的 github 賬號名"
git config --global user.email "你的 github 郵箱號"
查看設(shè)置是否正確
git config user.name
git config user.email
生成 SSH 公鑰添加到
ssh-keygen -t rsa -C "你的郵箱號"
cat ~/.ssh/id_rsa.pub
ssh -T git@github.com
deploy:
type: git
repo:
github: git@github.com:xxx/xxx.github.io.git # `xxx` 是 github 配置的倉庫名
branch: master
Hexo 部署到 Pages
npm install hexo-deployer-git --save
hexo g -d
上述操作完成后,打開瀏覽器訪問設(shè)置的網(wǎng)絡(luò)地址 (xxx 是 賬號昵稱),就可以看見和本地網(wǎng)絡(luò)地址 :4000 一樣的 Hexo 博客頁面。
Hexo 部署到 Gitee 在 Gitee 官網(wǎng)上創(chuàng)建個人倉庫
打開碼云官網(wǎng),注冊登陸,創(chuàng)建項目,點擊右上角加號,新建倉庫。
開啟 Gitee Pages 服務(wù)。
點擊啟動后出現(xiàn)的藍色鏈接就是生成的博客網(wǎng)址地址,每次部署都要進入 Gitee Pages 服務(wù)頁面點擊啟動按鈕才能更新更改。
初始化 Git 設(shè)置
git config --global user.name "你的 gitee 賬號名"

git config --global user.email "你的 gitee 郵箱號"
查看設(shè)置是否正確
git config user.name
git config user.email
生成 SSH 公鑰添加到 Gitee
ssh-keygen -t rsa -C "你的郵箱號"
cat ~/.ssh/id_rsa.pub
ssh -T git@gitee.com
# 賬號名和倉庫名不一致時添加如下配置形式,否則不用添加
url: Gitee Pages 服務(wù)
網(wǎng)站地址: https://空間名.gitee.io/倉庫名
root: /倉庫名/
deploy:
type: git
repo:
gitee: git@gitee.com:xxx/xxx.git # `xxx` 是 gitee 的賬號名
branch: master
和 Gitee 雙部署的 Hexo 根目錄下的配置文件 .yml 配置形式:
deploy:
type: git
repo:
github: git@github.com/cqupthao/cqupthao.github.io.git # cqupthao 為賬號名
gitee: git@gitee.com/cqupthao/cqupthao.git # cqupthao 為賬號名
branch: master
Hexo 部署到 Gitee Pages
npm install hexo-deployer-git --save
hexo g -d
上述操作完成后跳轉(zhuǎn)頁面如何加統(tǒng)計代碼,打開瀏覽器訪問設(shè)置的網(wǎng)絡(luò)地址 (xxx 是 gitee 賬戶號),就可以看見和本地網(wǎng)址地址 :4000 一樣的 Hexo 博客頁面。
主題安裝及優(yōu)化 Hexo 插件的安裝 代碼高亮
從 Hexo5.0 版本開始自帶了 代碼語法高亮的支持,如果博客安裝過 hexo-prism- 的插件,須執(zhí)行 npm hexo-prism- 來卸載掉它,否則生成的代碼中會有 { 和 } 的轉(zhuǎn)義字符。
修改 Hexo 根目錄下 .yml 文件中 . 的值為 false ,并將 . 的值設(shè)置為 true ,主要配置如下:
highlight:
enable: false
line_number: true
auto_detect: false
tab_replace: ''
wrap: true
hljs: false
prismjs:
enable: true
preprocess: true
line_number: true
tab_replace: ''
主題中默認的 主題是 Night ,如果想定制自己的主題,可前往 下載頁面 定制下載自己喜歡的主題 css 文件,然后將此 css 主題文件取名為 prism.css,替換掉 主題文件夾中的 /libs/prism/prism.css 文件。
搜索
使用 hexo-- 的 Hexo 插件來實現(xiàn)內(nèi)容搜索,安裝命令如下:
npm install hexo-generator-search --save
在 Hexo 根目錄下的 .yml 文件中,新增以下的配置項:
search:
path: search.xml
field: post
中文鏈接轉(zhuǎn)拼音
使用 hexo-- 的 Hexo 插件使在生成文章時生成中文拼音的永久鏈接,安裝命令如下:
npm i hexo-permalink-pinyin --save
在 Hexo 根目錄下的 .yml 文件中,新增以下的配置項:
permalink_pinyin:
enable: true
separator: '-' # default: '-'
執(zhí)行 hexo clean && hexo g 重新生成博客文件,就可以生成拼音鏈接。
文章生成永久鏈接
使用 hexo- 的 Hexo 插件來實現(xiàn)文章生成永久鏈接,安裝命令如下:
npm install hexo-abbrlink --save
在 Hexo 根目錄下的 .yml 文件中跳轉(zhuǎn)頁面如何加統(tǒng)計代碼,新增以下的配置項:
abbrlink:
alg: crc16 #算法:
rep: hex #輸出進制:十進制和十六進制,默認為10進制。丨dec為十進制,hex為十六進制

將 .yml 文件中的 的值修改為如下內(nèi)容:
permalink: posts/:abbrlink.html # 此處可以自己設(shè)置,也可以直接使用 :/abbrlink
執(zhí)行 hexo clean && hexo g 重新生成博客文件,就可以生成永久鏈接。生成完后,原 md 文件的 Front- 內(nèi)會增加 字段,值為生成的 ID 。
外鏈跳轉(zhuǎn)
使用 hexo--link 的 Hexo 插件來實現(xiàn)外鏈跳轉(zhuǎn),安裝命令如下:
npm install hexo-external-link --save
在 Hexo 根目錄下的 .yml 文件中,新增以下的配置項:
hexo_external_link:
enable: true
enable_base64_encode: true
url_param_name: 'u'
html_file_name: 'go.html'
target_blank: true
link_rel: 'external nofollow noopener noreferrer'
domain: 'your_domain' # 如果開啟了防盜鏈,填寫你的域名
safety_chain: true
執(zhí)行 hexo clean && hexo g 重新生成博客文件,就可以實現(xiàn)外鏈跳轉(zhuǎn)。
文章字?jǐn)?shù)統(tǒng)計
使用 hexo- 的 Hexo 插件來實現(xiàn)在文章中統(tǒng)計顯示文章字?jǐn)?shù)、閱讀時長信息,安裝命令如下:
npm i hexo-wordcount --save
在 主題下的 .yml 文件中,將各個文章字?jǐn)?shù)相關(guān)的配置激活:
postInfo:
date: true
update: false
wordCount: false # 設(shè)置文章字?jǐn)?shù)統(tǒng)計為 true
totalCount: false # 設(shè)置站點文章總字?jǐn)?shù)統(tǒng)計為 true
min2read: false # 閱讀時長
readCount: false # 閱讀次數(shù)
執(zhí)行 hexo clean && hexo g 重新生成博客文件,就可以實現(xiàn)文章字?jǐn)?shù)統(tǒng)計。
添加 Emoji 表情支持
使用 hexo--- 的 Hexo 插件來支持 emoji 表情的生成,安裝命令如下:
npm install hexo-filter-github-emojis --save
在 Hexo 根目錄下的 .yml 文件中,新增以下的配置項:
githubEmojis:
enable: true
className: github-emoji
inject: true
styles:
customEmojis:
執(zhí)行 hexo clean && hexo g 重新生成博客文件,然后就可以在文章中用 emoji 語法寫表情。