搭建個(gè)人網(wǎng)站(3):Hexo搭建網(wǎng)站

My Blog: https://blog.ahrisy.com

簡(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 需要注意的一些事了。

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

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