快速創建風格一致的《自由知識協作平台》主題
https://gitlab.com/libre-knowledge/gitlab-organization-templates/subject-template
本章節說明如何使用這個主題範本創建新的《自由知識協作平台》主題：
-
確保已將自由知識協作平台 Libre Knowledge Collaboration Platform · GitLab 專案的 Git 版控庫拓製至本地，且已拉取當前最新的修訂版
-
開啟自由知識協作平台 Libre Knowledge Collaboration Platform · GitLab 頁面
-
點擊上側的「New project」藍色按鈕建立新的專案（目前本專案不支持使用 GitLab 的子群組架構，請一律將專案創建在最上層群組中）
- 「Project name」欄位填入適當的主題標題（中文 + 英文）
- 「Project slug」欄位填入適當的主題識別名稱（可以採用比較常見的英文縮寫）
- 「Project deployment target (optional)」欄位下拉式選單選擇「Registry (package or container)」
- 「Visibility Level」選擇「Public」
- 「Project Configuration」區塊勾選「Initialize repository with a README」
-
點擊新專案頁面左側欄的 Settings > General 選項開啟 General Settings 設定頁面，進行下列設定：
- Topics
自由知識協作平台 Libre Knowledge Collaboration Platform自由知識協作平台主題 L.K.C.P. Topics
- Project description 欄位輸入主題適當的文字描述
- Topics
-
回到專案主頁面，點擊頁面右側的藍色「Clone」按鈕以獲取 Git 版控庫的拓製(clone)地址
-
於本地啟動一個文字終端應用
-
切換作業目錄至要放置該主題的「自由知識協作平台」目錄
-
執行下列命令將主題專案的 Git 版控庫以 Git 子模組的形式新增至本地先前已拓製到本地的「自由知識協作平台」：
git submodule add \ --name '_主題中文名稱_ _主題英文名稱_' \' https://gitlab.com/libre-knowledge/_主題識別名稱_.git \ '/path/to/自由知識協作平台 Libre Knowledge Collaboration Platform/_親主題路徑（如果有）_/_主題中文名稱_ _主題英文名稱_' -
編輯「自由知識協作平台 Libre Knowledge Collaboration Platform」主版控庫的 .gitmodules 文件，合併新主題子模組下列 Git 子模組配置：
[submodule "_主題中文名稱_ _主題英文名稱_"] ignore = dirty
-
以下列修訂版提交訊息將「自由知識協作平台 Libre Knowledge Collaboration Platform」主版控庫的變更提交為一新修訂版：
chore: 新增「_主題中文名稱_ _主題英文名稱_」主題 -
切換作業目錄至「自由知識協作平台」主目錄
-
執行下列命令將變更推送到遠端版控庫：
git push
-
將本專案除下列以外專案文件複製到新的主題專案中：
- README.md
- .git
- .markdownlint.yml
-
編輯子模組專案 real.README.md 主題說明文件模板，將
_佔位字_替換為適當之內容（別忘了替換libre-knowledge/_專案ID_），並移除未使用之（待補）章節 -
用 real.markdownlint.yml Markdownlint 配置文件替換掉 .markdownlint.yml 本專案專屬的 Markdownlint 配置文件
-
將「real.gitattributes Git 路徑屬性配置文件」更名為「.gitattributes」
-
替換 .reuse/dep5 REUSE DEP5 機器可讀著作權宣告文件文件中的
Upstream-Name（替換為 主題名稱）欄位、Upstream-Contact（替換為該主題專案議題追蹤系統的網頁標題與網址）欄位跟Source（替換為專案網址）欄位 -
將變更提交為新修訂版（參考提交標題：
docs: 撰寫主題說明文件雛型） -
將本地變更推送到遠端版控庫
-
回到「自由知識協作平台 Libre Knowledge Collaboration Platform」主版控庫以下列修訂版提交訊息將新主題專案子模組的變更的提交為新修訂版：
chore: 引入新版本的「_主題中文名稱_ _主題英文名稱_」主題 -
執行下列命令將變更推送到遠端版控庫：
git push
本章節列舉開發本專案期間所參考的第三方資料：
- Machine-readable debian/copyright file
說明 REUSE DEP5 檔案的撰寫格式 - Tutorial: How to become REUSE-compliant | REUSE
說明如何使專案遵從 REUSE 規範 - How to test whether a Debian package is installed in a shell script? | Google Bard
說明如何在 Shell 腳本中檢查特定 Debian 軟體包是否已安裝 - How to verify whether the APT repository cache has been refreshed recently? | Google Bard
說明如何檢查 APT 軟體庫本地快取是否近期有被刷新 - Predefined variables reference | GitLab
說明 GitLab CI 環境會設定的環境變數 - gitlab CI example - Contributing - pre-commit documentation
說明如何於 GitLab CI 中配置 pre-commit 資源的快取以減少後續流水線所需的運行時間 - Share caches between jobs in the same branch | Caching in GitLab CI/CD | GitLab
說明 GitLab CI 如何在同分支的同 CI 工作(job)間共享快取資料 - debconf(7) 的 manpage 使用手冊頁面
說明不同類型 debconf 前端界面的用途