本文是基于樹莓派的零基礎搭建個人博客零基礎教程,手把手教你在樹莓派上配置Git
/安裝Nood.js
/部署到GitHub/Gitee
/更換yilia
主題
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
,文件內容如下圖所示:
用 # 號將原來的國外鏡像源注釋掉,并添加國內源,我用的是清華源,在文件后添加如下代碼
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
完成后如下圖所示:
Ctrl+X
退出,然后按Y
保存
1.1.2修改系統更新源
終端輸入:sudo nano /etc/apt/sources.list.d/raspi.list
,如下圖所示:
用 # 號將原來的國外鏡像源注釋掉,并添加國內鏡像源,我用的是清華源,在文件后添加如下代碼:
deb http://mirrors.ustc.edu.cn/archive.raspberrypi.org/debian/ buster main ui
完成后如下圖所示:
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
點擊Downloads
進入下載頁面我們可以看到在Linux Binaries (ARM)
下支持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建立軟連接
然后為node
和npm
建立軟連接,在終端輸入:
sudo ln -s /usr/local/node/bin/node /usr/bin/node
sudo ln -s /usr/local/node/bin/npm /usr/bin/npm
#這類似于Windows中的快捷方式
我們通過查看node
和npm
版本的方式來查看是否成功,在終端輸入:
node -v && npm -v
可以看到對應的版本號說明安裝成功,如下圖(不同支持版或版本號不同):
至此我們完成了hexo
博客兩大準備工作Git
和Nood.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
可以看到對應的版本號說明安裝成功,如下圖(不同支持版或版本號不同):
4.使用Hexo搭建博客
創建一個目錄,作為博客的根目錄,名字任取,這里取blog
,并進入blog
目錄,在終端輸入:
sudo mkdir blog
cd blog
初始化Hexo
,在終端輸入:
sudo hexo init
啟動Hexo
,在終端輸入:
sudo hexo s
出現如下圖提示后:
在樹莓派本地瀏覽器輸入
localhost:4000
可以看到我們的博客已經搭建完成了,如下圖hexo
自動生成了一篇Hello World
的文章,文章內簡介了hexo
的用法,這里不再贅述,請仔細閱讀。
然后我們回到命令行按住Ctrl+C
退出。所有文章均以.md
格式保存在/source/_posts
我們可以在此目錄下刪除或添加文章。
至此我們完成了hexo
的搭建,接下來我們將本地的hexo
靜態Html
推到遠端GitHub
或Gitee
上,讓大家都可以從公網進行訪問。
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
然后回到終端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
可以看到新主題
然后回到終端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
然后回到終端Ctrl+C
退出,在終端輸入:
sudo hexo d
輸入自己的github
用戶名跟密碼,即可推送到github
,我們可以輸入如下域名查看個人博客。
你的用戶名.github.io
每次寫完博客都要重復這幾個步驟。
這樣就完成了博客的搭建與更換主題,大家也可以更改自己喜歡的主題進行自定義。
歡迎訪問→博主博客:老魚匠的個人棧