Blogdown

一個開源 (GPL-3) 的 R 套件，用於基於 R Markdown 和 Hugo 生成靜態網站。您可以透過 CRAN 或 GitHub 安裝此套件。

## Install from CRAN
install.packages('blogdown')

## Or, install from GitHub
remotes::install_github('rstudio/blogdown')

您可以使用 blogdown::new_site() 函數在一個空的目錄下建立一個新網站。它將建立一個骨架網站、從 Github 下載一個 Hugo 主題、新增一些範例內容、啟動一個網頁瀏覽器，您將看到新的網站。範例部落格文章 hello-world.Rmd 應該會自動開啟，您可以編輯它。在您儲存檔案後，網站將會自動重新建置，並且頁面將會重新整理。

如果您使用 RStudio，您可以從選單 檔案 -> 新專案 -> 新目錄 -> 使用 blogdown 的網站 為您的網站建立一個新的 RStudio 專案。

函數 blogdown::serve_site() 可能是此套件中最常用的函數。它會建置網站、將其載入您的網頁瀏覽器，並且當您更新 Markdown 或 R Markdown 檔案時，會自動重新整理瀏覽器。請勿使用命令列 hugo server 來建置或伺服網站。它只理解純 Markdown 檔案，無法建置 R Markdown。

您可能對從 new_site() 建立的預設網站不滿意。在您首次成功使用 blogdown 進行實驗後，您可能想要做兩件事

1. 從 http://themes.gohugo.io 選擇您喜歡的 Hugo 主題。您只需要它的 Github 使用者和儲存庫名稱，並將其傳遞給 new_site() 的 theme 參數。
2. 新增更多內容（頁面或文章），或遷移您現有的網站。

完整的說明文件是 blogdown 書籍，可於 https://bookdown.org/yihui/blogdown/ 免費取得。您應該至少閱讀第一章。歡迎您使用 Github issues 向我們發送回饋，或在 StackOverflow 上使用 blogdown 標籤提問。