簡(jiǎn)介
Hexo 是一款使用Node.js的博客框架,可以使用它來(lái)快速生成靜態(tài)網(wǎng)頁(yè),還有很多可選用的主題,也可以自己修改主題。
中文官網(wǎng):https://hexo.io/zh-cn/
安裝 Hexo
在安裝Hexo之前需要安裝Node.js環(huán)境,Node.js 官網(wǎng) https://nodejs.org/en/ 。
除了Node.js之外,還需要Git:https://git-scm.com/ 。
在國(guó)內(nèi)的話下載速度可能很慢,可以使用淘寶鏡像下載:淘寶 Node.js 鏡像 , 淘寶Git for Windows 鏡像 。
在配置好環(huán)境之后,就可以使用npm安裝Hexo了:
$ npm install -g hexo-cli
建站
安裝完成后,在指定文件夾下新建一個(gè)個(gè)人博客只需要執(zhí)行下面幾條命令:
$ hexo init <folder>
$ cd <folder>
$ npm install
新建完成后,需要我們注意的文件和文件夾有以下幾個(gè):
- __config.yml:配置信息
- scaffolds:模板文件夾,Hexo會(huì)使用其中的markdown文件作為模板來(lái)新建文件
- source:存放資源的地方,里面有個(gè)_posts文件夾就是放blog的地方
- themes:放主題的文件夾,下載的主題一般需要放在這個(gè)文件夾里面
部署到GitHub Pages
如果希望使用開(kāi)啟了GitHub Pages的倉(cāng)庫(kù)來(lái)搭載Hexo生成的個(gè)人博客,需要更改__config.yml 中的 url 和 root。注意:這里只需要倉(cāng)庫(kù)開(kāi)啟GitHub Pages功能即可,也可以不在那個(gè)xxx.github.io里存放。
首先,需要配置__config.yml中的 deploy 部分,比如這里我是使用名為 blog 的倉(cāng)庫(kù)的 master 分支來(lái)存儲(chǔ)網(wǎng)站的:
deploy:
type: git
repository: https://github.com/Ahrisya/blog.git
branch: master
如果使用自定義域名的話,比如我在xxx.github.io中使用了自定義域名 https://ahrisy.com,但想在 blog 這個(gè)倉(cāng)庫(kù)里存放Hexo生成的網(wǎng)站,這時(shí)需要更改__config.yml的url和root如下即可:
url: https://ahrisy.com/blog
root: /blog/
保存修改后,打開(kāi) git bash 執(zhí)行下列命令即可:
$ hexo g
$ hexo d
hexo g 的意思是生成網(wǎng)站,hexo d 的意思是部署到你指定的 url 上去。等待部署完成后即可在指定的url上看到自己的網(wǎng)站了。
PS:這時(shí)有可能會(huì)報(bào)錯(cuò),大意是說(shuō) Deployer not found 之類的,這是因?yàn)闆](méi)有安裝和 hexo 配套的 git 插件導(dǎo)致的,只需要用如下命令安裝之后再 hexo g&d 即可:
$ npm intall hexo-deployer-git --save
部署到 Vercel
GitHub Pages 對(duì)國(guó)內(nèi)的訪客來(lái)說(shuō)連接速度可能很慢,這時(shí)候我們可以使用Vercel來(lái)部署 Hexo blog。 在我的上一個(gè)blog:搭建個(gè)人網(wǎng)站(2):Github和Vercel建站以及配置DNS 中講了如何使用Vercel以及使用自定義域名。
我們同樣需要一個(gè)GitHub倉(cāng)庫(kù),這里不需要開(kāi)啟GitHub Pages功能,然后將該倉(cāng)庫(kù)導(dǎo)入到 Vercel 中,設(shè)置好域名(也可以使用二級(jí)域名)。
在設(shè)置好域名之后,同樣修改 __config.yml 的 deploy 部分到指定的 GitHub repo, 然后修改 url 到對(duì)應(yīng)的域名即可。
這樣在執(zhí)行 hexo g&d 之后,改動(dòng)就會(huì)推送到 GitHub 倉(cāng)庫(kù)中,而 Vercel 會(huì)根據(jù)GitHub倉(cāng)庫(kù)的改動(dòng)自動(dòng)同步更新。
PS:如果不是子目錄的話,不要修改root! 否則資源和網(wǎng)頁(yè)的鏈接會(huì)出錯(cuò)。
Hexo 常用命令
$ hexo new "文件名" # 新建文章
$ hexo g # 生成靜態(tài)網(wǎng)頁(yè)
$ hexo s # 本地預(yù)覽
$ hexo d # 部署
接下來(lái)就是配置模板以及使用 Hexo + Typora 寫(xiě) blog 需要注意的一些事了。