用R語言的Blogdown＋Hugo＋Netlify＋Github建博客

最新 02-05

目標

用R語言的blogdown + hugo + netlify + github搭建靜態博客系統，用rstudio專註於寫作。

個性域名

免費，無限流量

靜態網頁，速度快

github保存內容，不需要搭建資料庫，不需要備份

準備工作

軟體準備

系統：本文以Windows操作系統為例來介紹安裝和配置方法。其他操作系統是類似的。

安裝R(https://www.r-project.org/)

安裝rstudio(https://www.rstudio.com/)

安裝git(https://git-scm.com/)

windows下安裝很簡單，就不描述了。

對於git，作為非程序猿的我，一直想學但是一直沒學，直到打算用blogdown建個blog玩之後，就註冊了github看看git是怎麼玩的，不過我倒不是從命令行學起的（雖然我也玩linux），而是裝了個GitKraKen來摸git是怎麼玩的，然後再對應的學一點命令行的。其實只需要會add、commit、push、pull、merge就足夠對付blogdown了。如果想用github對blogdown的主題啟用一個轉移魔法的話，可以看git-submodule(https://yihui.name/cn/2017/03/git-submodule/)。

我們這裡並不需要安裝GitKraKen，因為rstudio已經有git的gui功能了，所以上面提到的命令怎麼打也不用學，直接在rstudio上點點點。

rstudio配置

安裝好上述軟體後，需要對rstudio進行一下簡單配置：

這個是生成PDF文件用的，中文用戶最好選擇XeLaTeX

安裝好git後，打開這裡應該就可以看到git的路徑了

建議選擇一個距離你比較近的鏡像，速度會快點。例如，國內用戶可以選擇一個 China 的鏡像。

安裝blogdown和hugo

安裝blogdown：

install.packages("blogdown")

安裝hugo

blogdown::install_hugo()

如果安裝hugo的時候出現下面的錯誤(貌似有同志也有這個問題)：

> blogdown::install_hugo()

The latest hugo version is 0.32.4

trying URL "https://github.com/gohugoio/hugo/releases/download/v0.32.4/hugo_0.32.4_Windows-64bit.zip"

Error in download.file(url, ..., method = method, extra = extra) : cannot open URL "https://github.com/gohugoio/hugo/releases/download/v0.32.4/hugo_0.32.4_Windows-64bit.zip"

In addition: Warning messages:

1: In download.file(url, ..., method = method, extra = extra) : InternetOpenUrl failed: ""

2: In download.file(url, ..., method = method, extra = extra) : InternetOpenUrl failed: ""

這個時候就直接安裝開發版，就可以解決：

install.packages("devtools")

devtools::install_github("rstudio/blogdown")

如果安裝了開發版的blogdown，還沒有搞定，那麼就把錯誤信息中的鏈接複製到瀏覽器直接下載，把文件解壓發現裡面就只有一個文件，Yihui選擇hugo就是因為hugo只有一個文件，夠簡單，至於為什麼我會知道Yihui選擇hugo的原因？因為我讀了blogdown故事(https://yihui.name/en/2017/12/blogdown-book/)。

把解壓好的hugo.exe文件放在根目錄下，然後輸入下面代碼安裝hugo：

# 注意這裡是三個冒號

blogdown:::install_hugo_bin("d:/hugo.exe")

安裝成功。

不知道是不是網路國際出口的問題，最近從github下載文件都比較慢(瀏覽github網頁倒沒有問題)，經常用安裝包都不成功，就算用瀏覽器下載hugo也經常出現錯誤，估計這就是用安裝不了的原因吧。

ok，我們來到這裡，暫時離開一下rstudio，我們去弄弄github。

註冊域名

怎麼註冊域名就不詳說了，國內的有萬網等，國外有GoDaddy之類的，選擇國內服務商的話，域名要備案，國外就可以省略這個步驟。

下面的內容是針對已經申請個人域名來展示的。

用github創建repository

如圖所示填寫好repository name、Description，默認選擇Public，可以選擇複選框Initialize this repository with a README，選擇吧，點擊Create repository就可以創建好用於保存網站的repository。

這個repository name沒有要求，隨便起，不像github的pages服務要求名字和github的賬號名稱一樣，建議起名domainname.com，當你有多個網站要管理的話，這樣就可以一眼就可以看出是那個網站了，我自己當時就不知道可以用點，所以也不知道這樣來起名字。

blogdown建站

創建項目

現在回到rstudio，，然後填寫Repository URL:，應該自動就生成了，可以選擇一個合適的文件夾存放，點擊Create Project創建項目。

設置gitignore

打開rstudio右下角的標籤，點擊文件，改成下面這樣吧（copy Yihui的）：

.Rproj.user

.Rhistory

.RData

.Ruserdata

public

static/figures

blogdown

上面的文件或者目錄就不會提交到github上。

如果對git命令不是很熟悉，建議在這個時候就把文件修改好的，因為在生成public文件夾之後(後面的步驟會生成public)，再修改文件添加文件夾，那麼標籤那裡還是不會把public文件夾忽略掉，要解決這個問題，可以按如下操作：

git rm -r --cached public

# 然後在.gitignore文件添加規則

public

這樣下次的 git add .就不會把public加進去了。

初始化blogdown

打開：

因為我們已經安裝了hugo，所以去掉hugo選項，Yihui是建議用hugo-xmin主題開始我們的blogdown之旅的，所以這裡就選擇了hugo-xmin。點擊創建項目。

有人會疑問為什麼要兩次新建項目？這並不是必須，其實可以不做創建項目這一步，不過就要另外一個步驟，把本地項目同步到github倉庫，可以按下面步驟處理(詳細解釋可以看這裡)：

git init

git add .

git commit -m "first comment"

git remote add origin https://github.com//

git remote -v

git pull origin master --allow-unrelated-histories

git push -u origin master

到這裡，博客已經可以在本地運行，我們試試看吧，點擊菜單下面的，如下圖所示：

點擊，可能會提示安裝幾個包例如shiny、miniUI等，點擊yes安裝就行了，其實點擊這個跟在console裡面輸入是一樣的，如果你還沒有安裝寫輪眼xaringan(https://github.com/yihui/xaringan)，會有下面的warning信息：

Warning message:

In eval(quote({ :

The xaringan package is not installed. LaTeX math may not work well.

我們乖乖的按照提示把寫輪眼安裝了吧（網頁上的數學公式用的是MathJax.js實現）：

install.packages("xaringan")

這個時候，已經可以在右下角標籤看到網站的美貌了：

Keep it simple, but not simpler

我們也可以在瀏覽器輸入來瀏覽。

寫博客

又來點擊菜單下面的，這次我們點擊，就會彈出下面這個畫面：

處會自動幫你填寫為處的內容，和還是建議使用字母，尤其是，如果博文裡面不需要用到R語言的代碼計算結果生成圖表的話，處就選擇格式，這可以省去一些系統生成的步驟，ok，點擊，就會在文件夾下面生成一個文件名為這樣的文件了，content文件夾下面的文件就是博客的文章了。

這個時候就可以用markdown格式專註於寫作了。

關於修改主題

如果你想修改主題，可以到https://themes.gohugo.io/找主題修改。

關於修改主題的非技術TIPS，可以看看下面兩段話，引用自Yihui的blogdown使用文檔**1.6 Other themes最下面引用的一段話：

If you choose to dig a rather deep hole, someday you will have no choice but keep on digging, even with tears. -— Liyun Chen13

Yihui是這樣說的：

Another thing to keep in mind is that the more effort you make in a complicated theme, the more difficult it is to switch to other themes in the future, because you may have customized a lot of things that are not straightforward to port to another theme.

所以呢，可以先把hugo官網上面的主題都瀏覽一下，看看哪個合眼緣，挑好再改吧。

學習怎麼修改主題的另外一個好去處是hugo-xmin的pull request。如果你有好的改進，也可以在這裡提交pull request讓別人學習。

看看下面的pull request圖：