整合 Docker 與 GitHub Codespaces 的國立中正大學學位論文 LaTeX 模板，提供開箱即用的「零配置」寫作環境，確保排版合規並自動備份 PDF。
English version of
READMEfile please refer to README_English.md
- 💻 線上試玩 | Online Demo
- ⚡ 獲取本模板 | Get The Template
- 🚀 快速開始 | Quick Start
- 🐳 本地環境建置 | Local DevContainer
- ☁️ 自動編譯與備份 | Auto Build & Backup
- 📂 模板檔案結構 | Template Structure
- 📖 模板使用說明 | User Guide
- 🎨 模板範例演示 | Template Demonstration
- 🤝 致謝 | Acknowledgement
⚠️ 免責聲明 | Disclaimer- 📄 License
如果你只想看看環境長怎樣，或測試編譯結果，可以點擊下方按鈕快速啟動：
Caution
此模式無法儲存進度，請勿用於正式寫作。
請點擊上方綠色的 [Use this template] 按鈕，並選擇 Private 來建立您的論文儲存庫。
Warning
建議不要直接 Fork 本儲存庫！
論文應保持機密，Fork 的儲存庫預設為公開（除非您想貢獻程式碼）。
適合： 不想安裝任何軟體、電腦效能有限、或想快速開始的使用者。
這將在您的瀏覽器中啟動一個完整的 GitHub Codespaces 環境，無需任何設定。
- 點擊頁面右上角的綠色
Code按鈕 > 切換到Codespaces分頁。 - 點擊
Create codespace on branch-name。 - 等待瀏覽器載入環境（首次約需 10-15 分鐘）。
- 完成!
Tip
打開 main.tex 檔案，按下 Ctrl+S 即可自動觸發編譯。
或點擊左側 "TeX" 圖示 > Build LaTeX project。
編譯完成後，PDF 檔會自動顯示在右側檔案總管視窗中。
在 *.tex 檔案中按下 ctrl+alt+j 會自動跳轉到 PDF 對應的位置。
Note
接下來請跳過 🐳 本地環境建置。根據 模板使用說明 開始撰寫論文。
Warning
免費帳戶每月的 GitHub Codespaces 使用時間配額約為 120 小時。
實際使用限制請參考 GitHub 官方說明 了解更多資訊。
適合： 需要長期離線寫作、希望在自己電腦上離線工作、習慣本地 VS Code 的使用者。
- 安裝 Docker Desktop，安裝後須重新啟動電腦。
- 安裝 VS Code，並安裝
Remote Explorer、Dev Containers、Docker (optional)擴充程式。
git clone您的論文儲存庫。- 使用 VS Code 開啟儲存庫資料夾。
- 點擊視窗右下角的提示 "Reopen in Container" (或按
F1搜尋Dev Containers: Reopen in Container)。 - 等待容器啟動，環境即自動配置完成（首次約需 10-15 分鐘）。
- 完成!
Note
接下來請根據 模板使用說明 開始撰寫論文。
當您將進度推送 (Push) 到 GitHub 時，系統會自動在雲端執行編譯，為您的論文提供額外的 PDF 備份。
- 點擊儲存庫上方的
Actions分頁。 - 點擊最新的 Workflow 紀錄 (通常顯示為 Commit 訊息)。
- 在頁面底部的
Artifacts區域，點擊PDF即可下載。
Note
注意時效：雲端生成的 PDF 檔案僅會保留 5 天。
Template Structure
├── main.tex // 主文件
├── main.pdf // [自動生成] 主文件編譯後的PDF檔
├── frontpages
│ ├── abstract.tex // 中/英文摘要
│ ├── acknowledgement.tex // 致謝
│ ├── denotation.tex // 符號列表
│ └── verification.pdf // 論文審定書PDF檔
├── sections
│ ├── introduction.tex // 緒論
│ ├── related_work.tex // 文獻探討
│ ├── method.tex // 研究方法
│ ├── experiments.tex // 研究結果
│ └── conclusion.tex // 結論
├── backpages
│ ├── appendix.tex // 附錄
│ └── reference.bib // 參考文獻資料庫
├── figures
│ ├── watermark.jpg // 浮水印
│ └── ...
├── ccusetup.tex // 模板設定
└── ccuthesis.cls // 模板文件
Note
請依據內容撰寫在相對應的 .tex 檔案。
如需增減章節，可在 sections 資料夾中增加/移除 .tex 檔，並在 main.tex 中用 \input{./path/to/texfile} 語法進行調整。
詳細模板使用說明請見 Wiki Page，請依造下列順序進行閱讀，並根據指示修改設定 :
模板的範例 PDF 檔案請至 Releases 下載參考。
感謝以下模板作者的貢獻，提供了許多參考，使得本模板能夠順利完成 :
- Hsins/NTU-Thesis-LaTeX-Template
- hasanabs/nsysu-thesis-latex-template
- joeyuping/ccu-thesis-latextemplate
Important
特別感謝 joeyuping 學長的貢獻，使得本模板能夠更加完善 !
本模板為非官方版本，因此格式可能有誤，僅供參考，若使用上有任何問題，請自行承擔風險。
建議使用者根據系上的要求進行調整，若有任何問題，請提 Issues 或是寄信至 作者信箱。
本模板採用 MIT 授權，有關詳細信息請參閱 LICENSE。