NKUST thesis template 操作說明

本章分為已有環境的操作、Docker、CLI 文件編寫、VSCode 文件編寫。

如果沒有時間架設環境，可以選擇使用 Overleaf 環境。

已有環境

直接透過 CLI 執行編譯指令。

$ make all               # 編譯文件
$ make clean             # 清除暫存檔
$ make distclean         # 完整清除編譯產生的檔案

安裝 remote extension
連線遠端伺服器
- 詳細教學請見文件 SSH keygen+VSCODE。
透過 latex extension 進行自動編譯或使用 CLI 進行操作。
- VSCode 的自動編譯設定，請見 setting.json。
- CLI 操作請見已有環境小節。

佈署編譯環境到伺服器經常是 linux 新手網管的惡夢，在加上希望支援 windows 系統的目標，因此決定加入 docker 的支援。

安裝部份請見 docker 文件。

編譯後 image 為 4.32GB。

編譯時間約485秒
CPU: Intel i5-1035G1 4核8緒
Memory: 16GB
DISK: SSD

專案中內建 docker image 編譯腳本，可直接雙擊檔案執行或以指令進行。

### Linux / Mac
$ ./Docker/linux/build

### Windows PowerShell / cmd
> Docker\windows\build.bat

### Linux / Mac
$ ./Docker/linux/start

### Windows PowerShell / cmd
> Docker\windows\start.bat

使用腳本

### Linux / Mac
$ ./Docker/linux/stop

### Windows PowerShell / cmd
> Docker\windows\stop.bat

接管 Container

### Linux / Mac
$ ./Docker/linux/attach

### Windows PowerShell / cmd
> Docker\windows\attach.bat

在 Container 中關閉

$ exit

如接管後不想關閉機器可按 ctrl+P + ctrl+Q 退出 Container。

使 container 運作於背景中，開機時會把 host 中的 NKUST-thesis-template 掛載到 Container 上。
利用 vscode remote development extension 進行遠端編輯，與編譯。

本節主要提供給使用非 VSCode 的使用者。

啟動 Docker 與進入容器

$ ./Docker/linux/start   # 啟動容器
$ ./Docker/linux/attach  # 從 Host 端進入容器

編譯與清除

$ make all               # 編譯文件
$ make clean             # 清除暫存檔
$ make distclean         # 完整清除編譯產生的檔案

關閉 Docker 容器

$ exit                   # 在 docker 容器中進行
$ ./Docker/linux/stop    # 在 Host 端進行

本節提供給 VSCode 的使用者。

安裝 remote extension
啟動 container 進行服務可雙擊檔案或以 terminal 於專案目錄中執行啟動指令。如果正常運作執行後終端機將會自動關閉。
- Linux / Mac
```
$ ./Docker/linux/start
```
- Windows
```
> ./Docker/windows/start.bat
```
ctrl+p 呼叫命令工具，找到(可直接輸入) > Remote-Container: Attach to Running container ...，點擊後選擇 latex-srv 即可進入開發環境。
開啟資料夾，論文目錄預設掛載在 /home/<使用者名稱>/thesis 中。