在Github上搭建一個(gè)免費(fèi)的Hexo博客系統(tǒng)

圖片來(lái)自網(wǎng)絡(luò)

什么是Hexo

Hexo是一個(gè)基于Nodejs快速簡(jiǎn)潔高效的博客框架,Hexo使用Markdown語(yǔ)法來(lái)編輯文章,只需要幾秒鐘的時(shí)間就可以成生靜態(tài)的網(wǎng)頁(yè)。整個(gè)系統(tǒng)就是一個(gè)博客系統(tǒng)。

安裝Hexo

Hexo是基于Nodejs的博客系統(tǒng),在安裝Hexo之前需要安裝Nodejs,把博客搭建在免費(fèi)的GitHub上,所以需要安裝Git。如果你已經(jīng)安裝上述軟件,可以跳過(guò)以下的1,2步驟

安裝Nodejs

Node.js的官網(wǎng)下載地址是:https://nodejs.org/,下載好之后,雙擊安裝,一路Next即可,只需要記住Node.js的安裝路徑,一般路徑是''C:\Program Files\nodejs'' 。注意的是需要添加hexo和npm到環(huán)境變量,路徑分別是 C:\Program Files\nodejs;C:\Program Files\nodejs\node_modules\npm;

hexo 和npm的環(huán)境變量

安裝Git for windows

Git for windows 的下載地址是:https://git-for-windows.github.io/,下載好后也同樣是一路Next安裝即可。

安裝Hexo

右鍵桌面任意位置,打開(kāi)Git Bash,執(zhí)行命令:

npm install -g hexo

如果是出現(xiàn)錯(cuò)誤,一般是因?yàn)楸粔Φ脑?,可以換國(guó)內(nèi)的鏡像源試試。

npm config set registry="http://registry.cnpmjs.org"
npm install -g hexo

創(chuàng)建Hexo文件夾

創(chuàng)建一個(gè)新的文件夾(如E:\hexo),打開(kāi)Git Bash

cd /e/hexo
hexo init

這一步是在hexo目錄下建立網(wǎng)站所需要的所有文件,除了如下的public/文件夾(public文件是生成的靜態(tài)網(wǎng)站)



至此本地的Hexo博客系統(tǒng)算是已經(jīng)搭建完成了

Hexo基本命令

下面是在編輯博客和生成博客所需要的幾個(gè)常見(jiàn)的命令以及它們的縮寫(xiě)形式。即使用新版本的Hexo兩邊是等價(jià)的命令。

hexo generate = hexo g
hexo server = hexo s
hexo delopy = hexo d
hexo new = hexo n

hexo g

hexo g 是生成靜態(tài)博客的命令,一般是對(duì)博客系統(tǒng)修改之后通過(guò)該命令來(lái)重新生成public 文件夾,比如添加、修改、刪除一篇博文,對(duì)博客的卑職文件修改,修改主題和添加插件等操作都是需要通過(guò)該指令Hexo g來(lái)重新生成的。

hexo s

hexo s是在本地上開(kāi)啟博客系統(tǒng),一般修改博客之后需要在本地上預(yù)覽調(diào)試,執(zhí)行hexo g && hexo s 可以在本地瀏覽器上查看(瀏覽器上輸入 http://localhost:4000)。

hexo d

hexo d是上傳你的博客到服務(wù)器,接下來(lái)我會(huì)介紹如何上傳到git,然后就可以在github.io上查看你的博客了。

hexo n

hexo n “< blog name >”是創(chuàng)建一篇新的博客,執(zhí)行該命令之后在 E:\hexo\source_posts 目錄下產(chǎn)生< blog name >.md文件,這是你的一篇新博客??梢栽趍arkdown工具下編寫(xiě),這里我就不詳細(xì)介紹了,詳細(xì)可以看這篇說(shuō)明:Markdown 語(yǔ)法說(shuō)明(簡(jiǎn)體中文版)

部署到Github

在github上創(chuàng)建一個(gè)倉(cāng)庫(kù)

剛才的步驟已經(jīng)可以在本地上編輯文章,然后在本地可以查看效果了。接下來(lái)就是講博客系統(tǒng)部署到Github上。如果不清楚github是干什么用的,可以查看維基百科:github -wiki


在github上注冊(cè)一個(gè)賬號(hào),如果有就省去這一步,創(chuàng)建一個(gè)倉(cāng)庫(kù),Repository name和自己的用戶(hù)名相同。比如我的用戶(hù)名為wenjunoy,那么Repository wenjunoy.github.io

配置SSH

上傳文件需要配置ssh key,不然無(wú)法上傳。

設(shè)置name和emai
git config --global user.name "<your name>"
git config --global user.email "<your email>"

需要注意的是這里的name是隨意的,郵箱是你的聯(lián)系郵箱,與github上的郵箱無(wú)關(guān)。

生成ssh 密鑰
ssh-keygen -t rsa -C "<your github's email>"

一路按回車(chē)鍵即可,如果設(shè)置了密碼請(qǐng)記住。
這一步在~/.ssh/下生成了兩個(gè)文件id_rsa 和 id_rsa.pub

在Github上添加SSH密鑰

打開(kāi)上述的id_rsa.pub 文件,復(fù)制其內(nèi)容,在https://github.com/settings/keys下 add new ssh key,


title隨便填寫(xiě),作為你的電腦的一個(gè)記號(hào)。確定即可。

測(cè)試

ssh git@github.com

顯示如下即成功

The authenticity of host 'github.com (192.30.252.128)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'github.com,192.30.252.128' (RSA) to the list of known hosts.
Hi wenjunoy! You've successfully authenticated, but GitHub does not provide shell access.
Connection to github.com closed.

部署到Github

配置_config.yml

編輯E:\hexo 下的_config.yml,修改 Deployment部分

# Deployment
## Docs: https://hexo.io/docs/deployment.html
# ssh://git@github.com/wenjunoy/wenjunoy.github.io
deploy: 
    type: git
    repo: ssh://git@github.com/wenjunoy/wenjunoy.github.io ##這個(gè)是你的倉(cāng)庫(kù)地址
    branch: master

注意和每個(gè)分好右面需要添加空格

部署

hexo d部署,執(zhí)行該命令發(fā)現(xiàn)報(bào)錯(cuò)

ERROR Deployer not found: git

執(zhí)行如下命令在hexo d

npm install hexo-deployer-git --save
hexo d

根據(jù)提示輸入用戶(hù)名和密碼,等待一會(huì)便成功了


然后瀏覽器上訪問(wèn):http://wenjunoy.github.io,可以看到hexo博客搭建成功。接下來(lái)就是專(zhuān)注于寫(xiě)博客吧。

最后編輯于
?著作權(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ù)。

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

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