給博客使用Butterfly主題並部署到GitHub服務器


目錄

前言

一、安裝Butterfly主題

二、將本地博客部署到GitHub服務器

三、將個人域名與GitHub綁定


前言

安裝完Hexo框架后,自帶的主題在thems文件夾下可以查看,應用后界面:

Hexo提供了290+主題,點擊可前往官網訪問:Hexo主題 

我選擇的主題是 Butterfly ,安裝后的界面如下:

圖源:Butterfly官方Github   我的個人博客:XJHui'S BLOG

一、安裝Butterfly主題

1、可供選擇的版本

注意:兩個版本供使用者選擇,我首次安裝的是第二個開發版,雖是開發版但裝完還沒發現什么Bug,教程就以開發版為例。

2、命令行安裝主題

sudo su //進入root賬戶

git clone -b dev https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly

安裝成功:

注意:如果此過程報錯,可能是git的問題,請翻看 上篇文章 或自行百度解決。

3、修改配置

說明:主題安裝完成后並不會自動應用,要修改框架下的_config.yml配置文件。

①進入安裝Hexo框架的文件夾(文件夾名稱未必為blog,取決於安裝的位置):

cd blog/

注意:查看blog文件夾中包含的文件是否與下圖相同,否則代表進錯文件夾了。

②修改配置文件:

vim _config.yml

錯誤:原因是未安裝vim,,執行 apt install vim 后繼續輸入上面命令。

往下翻找到thems,將其后面的文字修改為Butterfly(與前面thems之間有一個空格)

注意:需要vim基礎,用ubuntu先把基礎的vim學好233333333。

4、將Butterfly的配置文件移動到source/_data下

說明:這樣是為了讓主題更平滑,Butterfly 使用了 data files特性(可樂不加冰),移動后平滑效果可能更好(個人猜測)。

mkdir source/_data //創建文件夾
cp themes/Butterfly/_config.yml source/_data/butterfly.yml //復制並重命名

注意:以后的配置修改都是基於butterfly.yml

5、測試配置是否修改成功

hexo clean
hexo g //報錯看錯誤1
hexo s //報錯看錯誤2

瀏覽器輸入localhost:4000查看主題是否應用成功

錯誤1:

解決方法:在 Butterfly主題官方GitHub主頁 給出了解決方案

npm install cheerio@0.22.0 --save //如果使用cpnm可能更快

 

錯誤2:

解決方法:cyw1227(需要安裝pug以及stylus的渲染器,安裝速度有點慢耐心等待)

npm install --save hexo-renderer-jade hexo-generator-feed hexo-generator-sitemap hexo-browsersync hexo-generator-archive

 

安裝成功:

注意:上圖即為Butterfly原始樣式,未對配置文件做任何修改。

 

二、將本地博客部署到GitHub服務器

說明:僅本地訪問博客遠遠不能滿足我們的需求,實現遠程訪問離不開將其部署到服務器上,服務器可以購買雲服務器也可選用其它例如GitHub提供的免費服務器。

1、准備GitHub倉庫

①新建倉庫(如果你已經創建了該倉庫請務必備份數據,因為倉庫內原始數據會被覆蓋,然后跳至第③步)

②輸入新倉庫信息

注意:填寫的域名信息格式必須為:用戶名.github.io 否則即使創建成功也不可使用。

③安裝git插件

cnpm install --save hexo-deployer-git

注意:如果未安裝cnpm會報錯,可以用npm代替上面命令中的cnpm。

④修改配置文件

vim _config.yml 

翻到最底部:按照下圖修改,repo填寫自己的url

⑤部署到遠端

hexo clean //依次執行這三個命令,不建議直接執行hexo d
hexo g
hexo d

錯誤1:

解決方法:

npm install --save hexo-deployer-git  

感謝:喬小喬jojo

錯誤2:原因:git未配置郵箱和名字

解決方法:

git config --global user.name "yourname"  //自己的用戶名
git config --global user.email "youremail@163.com"  //自己的郵箱

錯誤3:GitHub上未配置公鑰

圖源:沒沒沒沒沒沒沒

解決方法:

ssh-keygen -C '你的郵箱賬號@163.com' -t rsa //一路回車
vim ~/.ssh/id_rsa.pub      //復制里面的密鑰

注意:SSH key title 任意。感謝:王雨城

⑥推送完成

瀏覽器輸入:https://用戶名.github.io 即可訪問。

錯誤:報錯404 

①如果未綁定個人域名,按照下圖操作:

②已綁定個人域名,按照下圖操作(親測可行):

感謝:半緣青荇

三、將個人域名與GitHub綁定

說明:GitHub提供的域名太長,可以自己購買喜歡的域名與之綁定。阿里雲購買的域名為例(XJH'S BLOG

2、進入 阿里雲 依次點擊:域名-》解析

3、添加兩條記錄,分別為:

添加完成后如下圖:

4、進入GitHub,添加 CNAME 文件:

輸入file名稱和域名點擊保存:

5、修改GitHub設置:

①進入項目的設置(如圖):

GitHub Pages下添加自己的域名:

感謝:Mr_XQ

就可以使用自己的域名遠程訪問搭建好的博客啦。

新手操作,不足請留言評論。

下一篇:短短1天我學會了如何修改Butterfly的配置文件 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM