Readme.md

Container

您可以參考 docker 或 podman.

安裝

docker engine

• Windows install
• Mac OS install
• Ubuntu install

podman engine

• Podman GUI
• Podman Github Releases page

Remove all unused pods, containers, images, networks, and volume data, run this command $ podman system prune -f

命令列介面環境

以下命令在 docker 目錄下執行。

$ cd docker

適用於 Linux/Mac

• 建立 Docker 映像，定制用戶開發環境參數，基礎源自 texlive/texlive。

$ sh unix/build.sh

腳本資訊

• [Advanced] 腳本中會偵測你電腦中已啟動的服務 docker or podman，若二者服務同時啟動，則以 podman 為主要服務。

• 啟動 latex-srv 並使用腳本在後台運行。

$ sh unix/start.sh

• 如果需要進入環境的 bash，可以通過 attach 進入環境。如果想離開環境，請使用 Ctrl+P + Ctrl+Q。如果使用 exit，容器將被關閉。

$ sh unix/attach.sh

• 關閉 latex-srv 並關閉在後台運行的容器。

$ sh unix/stop.sh

適用於 Windows 未驗證 (cmd / PowerShell)

Warning

Windows 腳本尚未測試，請謹慎使用。

• 編譯 Docker 映像並定制用戶開發環境參數。基礎源自 ubuntu。可以用鼠標雙擊 build.bat 或使用 cmd / powershell 執行。

> ./windows/build.bat

• 啟動 latex-srv，腳本將在後台運行。可以用鼠標雙擊 build.bat 或使用 cmd / powershell 執行。

> ./windows/start.bat

• 如果需要進入環境的 bash，可以通過 attach 進入環境。如果想離開環境，請使用 Ctrl+P + Ctrl+Q。如果使用 exit，容器將被關閉。可以用鼠標雙擊 build.bat 或使用 cmd / powershell 執行。

> ./windows/attach.bat

• 關閉 latex-srv 並關閉在後台運行的容器。可以用鼠標雙擊 build.bat 或使用 cmd / powershell 執行。

> ./windows/stop.bat

如何構建代碼

在容器中清理構建目錄後重新編譯

$ rm -rf build/
$ sh built.sh

故障排除

• How to make Visual Studio Code forward caught keystrokes?

在當前版本中，你可以：

啟用 terminal.integrated.sendKeybindingsToShell - 這將把大多數按鍵發送到 shell，有些按鍵仍會被跳過。

編輯 terminal.integrated.commandsToSkipShell - 你可以在這裡設置具體發送或不發送到 shell 的命令。這會被上面的選項覆蓋。例如，要禁用默認的 Ctrl + B，可以使用 -workbench.action.toggleSidebarVisibility：

"terminal.integrated.commandsToSkipShell": [
  // 開頭的減號表示應該通過
  "-workbench.action.toggleSidebarVisibility"
]

Ctrl + K 的問題在於它被很多命令用作組合鍵。你可以禁用 terminal.integrated.allowChords 設置來完全取消組合鍵，這個設置也提到應該這樣做以使這些快捷鍵正常工作：

注意，當設置為 true 且按鍵結果為組合鍵時，它將繞過 Terminal > Integrated: Commands To Skip Shell，設置為 false 尤其適用於希望 Ctrl + K 發送到 shell（而不是 VS Code）的情況 你可以在這裡閱讀更多相關信息。

取消綁定/重新綁定所有以你所需按鍵組合（例如 Ctrl + K -> Ctrl + M）開頭的組合鍵通常也能正常工作，我相信這是你可以嘗試的所有方法。