本專案提供了一個簡潔的 LaTeX 範本,旨在協助使用者快速開始撰寫高品質的文件。該範本支援程式碼語法高亮顯示,並使用 minted 套件進行程式碼的格式化展示。
您可以透過此範本快速建立自己的 LaTeX 專案。請按照以下步驟進行:
-
建立新專案
- 前往此範本的 GitHub 頁面:https://github.com/AaronWu-train/latex-template
- 點擊綠色的「Use this template」按鈕。
- 在彈出的視窗中,輸入您的新專案名稱,並選擇是否將其設為公開或私人專案。
- 點擊「Create repository from template」按鈕,GitHub 將自動為您建立一個基於此範本的新儲存庫。
-
複製儲存庫
-
在您的新儲存庫頁面,點擊「Code」按鈕,複製儲存庫的 URL。
-
在您的終端機中,執行以下命令以將儲存庫複製到本地:
git clone https://github.com/您的使用者名稱/您的專案名稱.git cd 您的專案名稱
-
-
安裝必要的軟體
-
Python:請確保系統已安裝 Python,建議使用最新版本。
-
Pygments, latexminted:需要安裝 Pygments 套件以支援程式碼語法高亮。安裝方法如下:
pip install Pygments pip install latexminted
-
TeX Live:建議安裝 TeX Live,這是一個跨平台的 TeX 發行版,包含了大部分常用的 TeX 套件和工具。
-
XeLaTeX:請確保您的 TeX 發行版中包含 XeLaTeX。對於基於 Debian 的系統,可以使用以下命令安裝:
sudo apt-get install texlive-xetex
-
-
編譯文件
您可以使用
makefile來自動化編譯過程。請確保您的系統已安裝make工具,然後執行:make
這將執行以下命令來編譯
main.tex:# If bibtex needed # xelatex -shell-escape main.tex # bibtex main xelatex -shell-escape main.tex xelatex -shell-escape main.tex
注意:使用
minted套件進行程式碼高亮時,需要啟用-shell-escape選項,以允許 LaTeX 在編譯過程中調用外部程式(如pygmentize)。 -
自訂內容
- 主文件:在
main.tex中撰寫您的內容。 - 圖片:將所需圖片放置於
images/目錄,並在main.tex中引用。
- 主文件:在
latex-template/
├── .gitignore # Git 忽略清單
├── images/ # 圖片資源目錄
├── main.pdf # 編譯後的 PDF 文件
├── main.tex # 主 LaTeX 文件
├── README.md # 專案說明文件
└── makefile # 自動化編譯腳本
歡迎對本專案提出建議、報告問題或提交改進。您可以透過 GitHub 的 Issues 或 Pull Requests 功能與我們交流。
本專案採用 MIT 授權條款。詳情請參閱 LICENSE 文件。