R 通常被視為統計學家專用的工具，但這種認知大大低估了它的實力。R 固然在統計分析和資料處理方面表現卓越，同時也是一門功能強大的通用程式語言，擁有豐富的生態系統、富有表達力的資料模型和優雅的視覺化工具。它是一個充滿活力的環境，遠遠超越了基礎的數值運算。
超越統計：全面的生態系統 #
R 的核心提供了統計計算的堅實基礎。其豐富的函式庫（稱為「套件」）涵蓋了幾乎所有可以想像的統計方法，從簡單的描述性統計到高級建模技術，應有盡有。然而，R 的能力遠不止於統計，還延伸至廣泛的應用領域，包括：
- 資料清理與轉換： R 提供了強大的工具用於清理、轉換和重塑資料。
dplyr和tidyr等套件提供了直覺的資料操作語法，使資料的分析準備工作變得簡單高效。 - 資料視覺化： R 以其卓越的資料視覺化能力而聞名。基於圖形語法的
ggplot2套件讓使用者能以高度自訂的方式創建精美且富有資訊量的視覺化圖表。除ggplot2外，還有眾多其他套件可用於互動式圖表、地圖和專業視覺化。 - 互動式網路應用程式（Shiny）：
shiny套件讓您可以直接在 R 中構建互動式網路應用程式——從簡單的儀表板到複雜的資料探索工具——無需具備豐富的網頁開發知識。 - 機器學習與深度學習： R 擁有蓬勃發展的機器學習生態系統，
caret、mlr3和keras（與流行的 Python 深度學習庫的介面）等套件提供了對包括深度學習模型在內的各種演算法的存取。R 強大的工具和函式庫在 Apex 演算法的優化和完善中發揮了重要作用。 - 報告生成（R Markdown）： R Markdown 允許您在單一文件中結合程式碼、結果和敘述文字，生成可重現的報告、演示文稿，甚至完整的書籍。
- 以及更多： R 的能力還延伸至地理空間分析、文字探勘、生物資訊學、計量經濟學和許多其他專業領域。
社群驅動的開發：CRAN 儲存庫 #
R 的一大核心優勢在於其充滿活力的活躍社群。全球各地的開發者向綜合 R 檔案網路（CRAN）貢獻套件，這個中央儲存庫讓安裝和使用大量工具變得輕而易舉。這種協作模式確保了 R 持續演進，定期有新套件和功能加入。其開源特性促進了創新，並使 R 始終保持在資料科學的前沿。
本網站：R 多樣性的有力佐證 #
本網站完全在 RStudio 平台（一個專為 R 設計的整合開發環境，IDE）內構建。雖然 HTML、JavaScript 和 CSS 負責樣式設計和前端互動，但核心結構和內容管理均使用 R 完成。這充分展示了 R 非凡的靈活性及其超越傳統統計應用的能力。blogdown 套件（基於 Hugo）使直接從 R Markdown 文件創建靜態網站成為可能。
使用 R 創建網站 #
以下說明將引導您從零開始使用 Hugo 和 Blowfish。大多數所需的相依套件可以使用您平台的套件管理器安裝。您也可以參考 Hugo 的標準 Quick Start 指南快速上手。
安裝 Hugo #
如果您以前沒有使用過 Hugo，您需要將其安裝到本機。可以通過運行命令 hugo version 來檢查是否已安裝。
您平台的詳細安裝說明可在 Hugo 文件中找到。
Blowfish Tools（推薦） #
有一個可用的 CLI 工具可幫助您開始使用 Blowfish。它將自動創建新的 Hugo 專案、安裝主題並設定主題配置文件。目前仍處於 Beta 階段，如發現任何問題請回報。
使用 npm（或其他套件管理器）全域安裝 CLI 工具：
npx blowfish-tools
或
npm i -g blowfish-tools
然後運行 blowfish-tools 命令開始互動式工作階段，它將引導您完成創建和配置流程：
blowfish-tools
您也可以運行 blowfish-tools new 一步完成創建新 Hugo 專案和安裝主題。查看 CLI 幫助以獲取更多資訊：
blowfish-tools new mynewsite
以下是一個快速視頻，展示使用 CLI 工具開始使用 Blowfish 的速度：
不使用 CLI 安裝 #
創建新網站 #
運行命令 hugo new site mywebsite 在名為 mywebsite 的目錄中創建一個新的 Hugo 網站。
您可以自由命名專案目錄，但以下說明將假設其名稱為 mywebsite。如果使用不同的名稱，請相應替換。
下載 Blowfish 主題 #
將 Blowfish 主題安裝到 Hugo 網站有幾種不同的方式，從最簡單到最複雜依序排列：
如果不確定，請選擇 Git 子模組方式。
使用 git 安裝 #
此方法是保持主題最新的最快捷、最簡便的方式。除了 Hugo 和 Go 之外，您還需要確保本機已安裝 Git。
進入您的 Hugo 網站目錄（在上面創建的），初始化一個新的 git 儲存庫，並將 Blowfish 添加為子模組：
cd mywebsite
git init
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
然後繼續設置主題配置文件。
使用 Hugo 安裝 #
使用此方法，Hugo 將管理您的主題。Hugo 使用 Go 來初始化和管理模組，因此在繼續之前請確保已安裝 go。
-
下載並安裝 Go。可以使用命令
go version驗證安裝。請確保使用 Go 1.12 版本或更高版本，因為 Hugo 模組需要此版本才能正常運作。 -
從您的 Hugo 專案目錄（在上面創建的），為您的網站初始化模組：
# 如果您在 GitHub 上管理您的專案 hugo mod init github.com/<username>/<repo-name> # 如果您在本機管理您的專案 hugo mod init my-project -
通過創建新文件
config/_default/module.toml並添加以下內容，將主題添加到您的配置：[[imports]] disable = false path = "github.com/nunocoracao/blowfish/v2" -
使用
hugo server啟動伺服器，主題將自動下載。 -
繼續設置主題配置文件。
手動安裝 #
-
下載最新版本的主題原始碼。
從 Github 下載 -
解壓縮存檔，將資料夾重命名為
blowfish，然後將其移動到 Hugo 專案根目錄內的themes/目錄。 -
繼續設置主題配置文件。
設置主題配置文件 #
在您網站的根目錄中，刪除 Hugo 生成的 hugo.toml 文件。將主題中的 *.toml 配置文件複製到您的 config/_default/ 資料夾。這確保您擁有所有正確的主題設定，並使自訂主題變得輕鬆。
module.toml 文件，請勿覆蓋。
根據您安裝主題的方式，配置文件將位於不同的位置：
- Hugo 模組： 在 Hugo 快取目錄中，或從 GitHub 下載副本
- Git 子模組或手動安裝：
themes/blowfish/config/_default
複製文件後，您的配置資料夾應如下所示：
config/_default/
├─ hugo.toml
├─ languages.en.toml
├─ markup.toml
├─ menus.en.toml
├─ module.toml # 僅在使用 Hugo 模組安裝時才有此文件
└─ params.toml
hugo.toml 文件頂部添加 theme = "blowfish" 這一行。
後續步驟 #
安裝 Blowfish 後，請參考 Mark Gingrass 的「Cradle to Grave R」YouTube 系列（Cradle to Grave R）來構建和提供您的網站，特別是他的教程「R Hugo Website」。他全面且結構清晰的說明是這個工作流程的絕佳資源。網站正常運行後，您可以根據需要自由配置。
安裝更新 #
不定期會發布新版本，修復問題並為主題添加新功能。為了利用這些更新，您需要更新網站上的主題文件。
更新過程取決於您最初選擇的安裝方式。以下是各方式的說明。
使用 git 更新 #
Git 子模組可以用單個 git 命令更新。執行以下命令，最新版本的主題將被拉取到您的本機儲存庫：
git submodule update --remote --merge
子模組更新後，重新構建您的網站並驗證一切正常。
使用 Hugo 更新 #
Hugo 使模組更新變得簡單直接。進入您的專案目錄並執行：
hugo mod get -u
Hugo 將通過檢查您的 module.toml 和 go.mod 文件自動更新所需的模組。如果遇到任何問題，請確認這些文件的配置仍然正確。
重新構建您的網站並確認一切正常。
手動更新 #
手動更新 Blowfish 需要下載最新的主題副本並替換專案中的舊版本。
-
下載最新版本的主題原始碼。
從 Github 下載 -
解壓縮存檔，將資料夾重命名為
blowfish，然後將其移動到 Hugo 專案根目錄內的themes/目錄，覆蓋現有目錄以替換所有主題文件。 -
重新構建您的網站並驗證一切正常。
