Skip to content

linux-taiwan/arch.linux.org.tw

Repository files navigation

Arch Linux Taiwan Community Website

Join the chat at https://gitter.im/linux-taiwan/arch.linux.org.tw

這是 Arch Linux 臺灣社群網站原始碼,我們使用 Jekyll 做內容管理、GitHub Flow 做流程管理、GitHub Actions 自動佈署。

環境配置

方法 A:手動安裝

  1. 請架設好基本的 Ruby 執行環境,我們推薦您使用 RVM 簡化這一步驟。
  2. 將此原始碼 git clone 到您的本地端之後,在原始碼根目錄下執行 bundle install 安裝必要的元件。
  3. 在原始碼根目錄執行 jekyll server 讓它自動偵測檔案異動。
  4. 新增、修改網站內容。您可以在 http://127.0.0.1:4000/ 看到目前編修的網站樣貌。

方法 B:使用 Docker

  1. 將此原始碼 git clone 到您的本地端之後,執行 make build 建立 Docker image。
  2. 執行 make start 把網站編修過程所需的 Docker container 跑起來。
  3. 新增、修改網站內容,再執行 make update 將變動更新至 Docker container 裡。您可以在 http://127.0.0.1:4000/ 看到目前編修的網站樣貌。
  4. 如欲進入容器內部,可執行 make inspect

佈署

  • 本網站代管於 GitHub Pages。

  • 設定客製化網域 archlinux.twCNAMEjekyll build 會將此檔案複製至 docs/CNAME

  • 有新的 pull request 會自動執行 CI/CD。

  • CI/CD 由 GitHub Actions 執行。

    • 透過 jekyll build 產生靜態網頁於 docs 資料夾底下。
    • 細節請參考 .github/workflows/build.yaml
  • 由於 GitHub Action 會自動產生 git commit,可於自己的 fork 內關閉該功能。

    img

編輯原則

  • 可利用 GitHub 的 Pull Request 機制貢獻內容,或使用 git format-patch, git send-email 至 [email protected]
  • 您貢獻的內容需同意以 CC BY-SA 4.0 授權條款或更新版本授權公眾使用。
  • 我們接受 Jekyll 可處理的 HTML, Markdown, Textile 格式檔案。
  • 不同主題的內容新增、異動請分別用不同的 commit 儲存,且寫清楚 commit message,俾利追蹤管理。
  • 遇英文、阿拉伯數字夾在中文句子當中時,前後請加上空白,若遇標點符號則不用,如:Arch Linux 是一套支援 i686/x86-64 架構的通用 GNU/Linux 發行版本。
  • 網站相關錯誤,例如版面錯置或內容有誤,請前往 GitHub 追蹤系統回報問題,我們會盡快處理。
  • 主編保留內容潤飾、刊登與否的最終裁量權。任何違背關乎宗教、政治、性別、性傾向、種族、身心障礙等需遵循政治正確原則的爭議內容,本站恕不接受。

專案授權