無腦手冊 - sppmg/TW_Thesis_Template GitHub Wiki

本文目錄：

我知道很多人拿來就直接用，所以這是給他們看的最簡易說明。（這裡儘量不涉及選擇、設定）

建議的 LaTeX 編輯器

擇一選用。

打字用，只要是純文字編輯器即可。但建議用 LaTeX 專用編輯器較方便，可以省去記指令的功夫。以下是推薦列表。

  1. Kile , KDE 環境下的軟體，Linux 使用者推薦使用，Windows 安裝較麻煩。
  2. TeXstudio , 持續更新，但比 kile 少去即時文字補完，Linux / Mac / Windows 均有。 (若須選擇文字編碼，請使用UTF-8，通常 LaTeX 專用編輯器已經預設使用了。請勿用微軟產品，有 BOM 問題。)

建議的 TeX 發行版 - 包山包海 TeX 大補帖

擇一選用。

  • TeX Live , Linux / Mac / Windows 均有。通常 Linux 的套件庫已經有了，由其套件管理程式(apt, yum, pacman )安裝即可。
  • MiKTeX , Linux / Mac / Windows 均有，但似乎 Windows 使用者較偏愛。能編譯時才自動下載所須 TeX 套件。（會跳出視窗詢問是否安裝，請直接勾左下角方塊讓他不再詢問，否則你會很煩。）MiKTeX 使用者請閱讀注意事項

所須 LaTeX 編譯程式

通常 TeX 發行版已內附。

程式名 說明
xelatex 必要，不可替換。
biber 預設使用的文獻資料庫(.bib)編排程式，可改用傳統BibTeX，但須修改 config.tex 設定
latexmk 非必要，自動處理編譯次數（LaTeX 編譯須多次執行才能完檔）

patch 版建立方法

如果你使用的學校目錄為 *_patch ，須產生完整版方能使用。

Linux 使用者請執行 bash build.sh

Windows 使用者請執行 build.bat

執行後輸入 zh(中文樣板) 或 en(英文樣板) ，程式會自動新建一個完整版目錄。

詳細說明見patch 版樣板使用說明

產生 PDF 檔 - 編譯流程

  • 樣版中的各檔案(.tex)為樹狀結構，最上層為 main.tex ，其下是各章子檔。
  • 樣板中只要是 \documentclass 起始的檔案都可以直接編譯（大部分的 *.tex 都是）。
  • 僅產生單一檔案可編譯單一章節子檔(eg, chapter_introduction.tex)。僅編譯子檔可縮短編譯時間，用於檢視修改結果。(註)
  • 要產生完整的 PDF 文件請編譯 main.tex 。

註：部份編輯器(如 TeXstudio)會自動設定主文件，並於編譯(子檔)時自動改編譯主文件。目前請自行搜尋解決辦法，或是改用指令手動編譯。

寫作流程

  1. 確認 main.tex 可編譯。（檢查編譯環境）
  2. 修改 config.tex 內資訊，包含姓名、題目等等。這會影響封面等資訊頁。
  3. 編輯內容。建議一章一檔。先不要管排版是否好看，圖片等等讓它自己浮動。
    1. 使用到的套件、導言區指令，全部加到 macros_preamble.tex。
  4. 檢查編譯結果，可以只編譯單章。
  5. 完成草稿。編譯 main.tex 。
  6. 修改排版。將不好看的浮動物件手動指定為 [t] 或 [b] 或 [h] 。將 config.tex 中的 publish 設為 true。
  7. 完成正式文件。

注意事項：

  • 無論是摘要、內文、附錄，統統都用 \chapter{標題} 開始寫。其屬性由插入 main.tex 的位置決定。
  • 中英摘要限定章題為「摘要」與「Abstract」，因為會自動依此於標題前插入文件資訊。（要改的話請進 .cls 修改）
  • 排版數學式若有多個環境（如對齊、聯立....），可另開一個測試用的空 TeX 檔（由 chapter_template.tex 複製），單獨編譯、測試以縮短等待時間。
  • 部份PDF閱讀器 (如：Adobe) 會在開啟檔案時將PDF檔鎖上，不允許其他程式變更，導致編譯失敗。遇到此類事情請關閉PDF檔後再編譯（或是換用PDF閱讀器）。

論文上傳、列印流程

  1. 依各校規定附上已簽名過的各項文件 (config.tex可以設定檔名，main.tex 未設定之學校請自行仿照指令插入) 。
  2. 利用 tools/toc2txt.sh 或 tools/toc2txt.bat 於編譯後生成純文字目錄檔。用法詳見 初級手冊之說明。（直接由 PDF 複製文字有出錯的風險！）
    1. Windows 使用者若遇到生成之目錄檔無法斷行的情況，請利用 toots/unix2dos4toc.bat 進行換行字元的轉換。（或是使用較進階的文字編輯器如 wordpad）
  3. 若須單獨上傳摘要，直接編譯該章即可。若須包含浮水印於單章請於章首加入 \startWatermark

其他

建議至少花15分鐘快速瀏覽過教學。不懂沒關係，至少知道 LaTeX 有哪些功能、要到哪裡找。瀏覽一遍只要15分鐘，不知道好用功能可以浪費你好幾天還會出錯。 （學弟妹們！不要再手打圖表編號了啊!!）