基于樹莓派搭建Hexo博客部署到GitHub/Gitee

本文是基于樹莓派的零基礎搭建個人博客零基礎教程,手把手教你在樹莓派上配置Git/安裝Nood.js/部署到GitHub/Gitee/更換yilia主題


raspberry pi

0.寫在前面

筆者一直想搭建自己的個人博客,但是一直都被云服務器價格 勸退,宅在家為武漢加油的這段時間偶然間發現Hexo這個博客框架,用Hexo官網的話說這是一個:

快速、簡潔且高效的博客框架

Hexo基于Nood.js,因此頁面渲染速度大大加快,我們在自己的樹莓派上搭建好環境后,通過Hexo將通.md格式的文章生成靜態的Html,進而將生成的Html頁面上傳到Github或者Gitee,利用GithubPages/GiteePages的靜態網頁托管服務,托管我們的博客。下面是詳細教程。

1.配置Git

1.1為樹莓派更換國內鏡像源

1.1.1修改軟件更新源

首先為樹莓派更換國內鏡像源,在終端輸入:sudo nano /etc/apt/sources.list ,文件內容如下圖所示:

sources.list

用 # 號將原來的國外鏡像源注釋掉,并添加國內源,我用的是清華源,在文件后添加如下代碼

    deb http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ buster main contrib non-free rpi
    #deb-src http://mirrors.tuna.tsinghua.edu.cn/raspbian/raspbian/ buster main contrib non-free rpi

完成后如下圖所示:

sources.list

Ctrl+X退出,然后按Y保存

1.1.2修改系統更新源

終端輸入:sudo nano /etc/apt/sources.list.d/raspi.list ,如下圖所示:

raspi.list

用 # 號將原來的國外鏡像源注釋掉,并添加國內鏡像源,我用的是清華源,在文件后添加如下代碼:

deb http://mirrors.ustc.edu.cn/archive.raspberrypi.org/debian/ buster main ui

完成后如下圖所示:

raspi.list

Ctrl+X退出,然后按Y保存

1.2更新樹莓派

更新樹莓派系統,在終端輸入:

sudo apt-get update

更新樹莓派軟件,在終端輸入:

sudo apt-get upgrade

由于網速與個人更新習慣不同,更新所需時間也不同,可能需要較長時間,請耐心等待。

1.3安裝Git

在樹莓派終端輸入:

sudo apt-get install git

1.4全局修改用戶名

在樹莓派終端輸入下列命令修改全局用戶名(注意將引號內替換為個人帳號):

git config --global user.name "你的GitHub/Gitee用戶名"
git config --global user.email "你的GitHub/Gitee郵箱"

然后查看是否已經全局修改用戶名:

git config --list

配置完成后如下圖:

全局修改用戶名

2.安裝Nood.js

2.1查看樹莓派架構是否對應下載的版本

首先查看樹莓派的架構,樹莓派終端輸入命令

uname -a

可以看到博主使用的樹莓派4B是基于armv7架構

查看樹莓派架構

然后登錄Nood.js官網,我們可以看到長期支持版是v12.16.1

長期支持版是v12.16.1

點擊Downloads進入下載頁面我們可以看到在Linux Binaries (ARM)下支持ARMv7架構

支持ARMv7架構

2.2下載Nood.js

在樹莓派終端輸入:

wget https://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-armv7l.tar.xz

這里注意將版本改為相應的最新長期支持版的版本序號,比如更新到v12.19.2則相應的將命令進行修改,下同,不再贅述。
如果出現下載緩慢的問題我們也可以使用國內開源鏡像源(某寶源)下載:

wget https://npm.taobao.org/mirrors/node/latest/node-v12.16.1-linux-armv7l.tar.xz

2.3解壓二進制包

在樹莓派終端輸入如下命令解壓:

xz -d node-v12.13.1-linux-armv7l.tar.xz
tar -xavf node-v12.13.1-linux-armv7l.tar

先將系統內原本存在的/usr/bin.node刪除,在終端輸入:

sudo rm -rf /usr/bin/node
#如果不存在,忽略此步驟

解壓后,將二進制包移動到/usr/local/node下,在終端輸入:

sudo mv ./node-v10.0.0-linux-armv7l /usr/local/node

2.3建立軟連接

然后為nodenpm建立軟連接,在終端輸入:

sudo ln -s /usr/local/node/bin/node /usr/bin/node
sudo ln -s /usr/local/node/bin/npm /usr/bin/npm
#這類似于Windows中的快捷方式

我們通過查看nodenpm版本的方式來查看是否成功,在終端輸入:

 node -v && npm -v

可以看到對應的版本號說明安裝成功,如下圖(不同支持版或版本號不同):

node -v && npm -v

至此我們完成了hexo博客兩大準備工作GitNood.js的配置,我們正式進入安裝hexo博客框架。


3.安裝Hexo

由于國內網速問題npm包管理器的速度會較慢,我們利用npm安裝cnpm也就是前文提到的某寶源,在終端輸入:

npm install -g cnpm --registry=https://registry.npm.taobao.org

同理我們為cnpm建立軟連接,在終端輸入:

sudo ln -s /usr/local/node/bin/cnpm /usr/bin/cnpm

安裝Hexo博客框架,在終端輸入:

cnpm inastall -g hexo-cli

等待執行完,我們通過查看hexo版本的方式來查看是否成功,在終端輸入:

 hexo -v

可以看到對應的版本號說明安裝成功,如下圖(不同支持版或版本號不同):

hexo -v

4.使用Hexo搭建博客

創建一個目錄,作為博客的根目錄,名字任取,這里取blog,并進入blog目錄,在終端輸入:

sudo mkdir blog
cd blog

初始化Hexo,在終端輸入:

sudo hexo init

啟動Hexo,在終端輸入:

sudo hexo s

出現如下圖提示后:

localhost:4000端口

在樹莓派本地瀏覽器輸入

localhost:4000

可以看到我們的博客已經搭建完成了,如下圖hexo自動生成了一篇Hello World的文章,文章內簡介了hexo的用法,這里不再贅述,請仔細閱讀。

16.png

然后我們回到命令行按住Ctrl+C退出。所有文章均以.md格式保存在/source/_posts我們可以在此目錄下刪除或添加文章。


至此我們完成了hexo的搭建,接下來我們將本地的hexo靜態Html推到遠端GitHubGitee上,讓大家都可以從公網進行訪問。


5.將本地Hexo博客部署到遠端Github

我們在github上新建一個倉庫Create a new repository,注意倉庫名字必須為

你的github賬戶名.github.io

比如博主的賬戶為Fengweicui1996,博主倉庫名字就是

Fengweicui1996.github.io

后面我們將用此名字作為域名訪問博客。
回到樹莓派終端,在博客根目錄下,這是/blog目錄下,在終端輸入:

sudo cnpm install --save hexo-deployer-git

然后我們需要配置博客根目錄下的_config.yml文件,在終端輸入:

sudo nano _config.yml

進入_config.yml后到文件末端,如下圖
將此處修改為

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: https://github.com/你的賬戶名/你的賬戶名.github.io
  branch: master
  #注意這里的冒號后要加空格

Ctrl+X退出,按Y保存
然后依次執行下列三條命令

sudo hexo clean
sudo hexo g
sudo hexo s

出現如下圖提示后:

localhost:4000端口

在樹莓派本地瀏覽器輸入如下端口查看本地預覽:

localhost:4000

然后回到終端Ctrl+C退出,在終端輸入:

sudo hexo d

輸入自己的github用戶名跟密碼,即可推送到github,我們可以輸入如下域名查看個人博客。

你的用戶名.github.io

至此我們完成了博客的全部搭建,出于可讀性以及美觀的角度我們需要給博客更換主題,這里給出github上的一個主題名yilia的開源主題。博主博客就是基于yilia主題→老魚匠的個人棧


6.為Hexo更換yilia主題

進入博客根目錄/blog,在樹莓派終端輸入:

git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia

等待主題克隆完成,在樹莓派終端輸入:

sudo nano _config.yml

找到下圖位置:
修改為:

theme: yilia
##注意這里的冒號后要加空格

Ctrl+X退出,按Y保存
然后依次執行下列三條命令

sudo hexo clean
sudo hexo g
sudo hexo s

出現如下圖提示后:

localhost:4000端口

在樹莓派本地瀏覽器輸入如下端口查看本地預覽:

localhost:4000

可以看到新主題

yilia主題

然后回到終端Ctrl+C退出,在終端輸入:

cd /blog/source/yilia
#進入到主題目錄下

自定修改主題目錄下的_config.yml

sudo nano _config.yml

在這里自定義自己的個性化內容,修改后按Ctrl+X退出,按Y保存,然后依次執行下列三條命令

sudo hexo clean
sudo hexo g
sudo hexo s

出現如下圖提示后:

localhost:4000端口

在樹莓派本地瀏覽器輸入如下端口查看本地預覽:

localhost:4000

然后回到終端Ctrl+C退出,在終端輸入:

sudo hexo d

輸入自己的github用戶名跟密碼,即可推送到github,我們可以輸入如下域名查看個人博客。

你的用戶名.github.io

每次寫完博客都要重復這幾個步驟。


這樣就完成了博客的搭建與更換主題,大家也可以更改自己喜歡的主題進行自定義。
歡迎訪問→博主博客:老魚匠的個人棧


最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,606評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,582評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,540評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,028評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,801評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,223評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,294評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,442評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,976評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,800評論 3 354
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,996評論 1 369
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,543評論 5 360
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,233評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,662評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,926評論 1 286
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,702評論 3 392
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,991評論 2 374

推薦閱讀更多精彩內容