LaTeX开发容器

适用于Visual Studio Code的终极LaTeX开发容器

![构建状态]([] ![Docker拉取量]([] ![Docker星标数]([***]

![加入Slack频道]([] ![GitHub最后提交]([] ![GitHub提交活动]([] ![GitHub issues]([]

核心功能与特性

• 保存.tex文件时快速编写LaTeX并生成PDF文件的最快方式
• 使用texlive 2025
• 基于Debian Bullseye Slim，使用qmcgaw/basedevcontainer
• 兼容amd64和aarch64架构
• 两种Docker镜像：
  • qmcgaw/latexdevcontainer:latest（默认）：使用TexLive基础方案，未压缩镜像大小为467MB
  • qmcgaw/latexdevcontainer:latest-full：使用TexLive完整方案，未压缩镜像大小为4.2GB - 已预装大多数常用包
• 内置tlmgr工具，可根据需要安装更多LaTeX包
• 使用latexmk将LaTeX编译为PDF
• 使用latexindent在保存时自动格式化
• 使用从源代码构建的chktex进行LaTeX代码检查
• 集成LaTex-Workshop VScode扩展
• 兼容amd64、ARM 64位、ARM 32位v6和v7（TeXLive暂不支持ARM，如需请创建issue）
• 跨平台支持：
  • 轻松挂载SSH密钥以用于git
  • 从开发容器内管理主机Docker，详情见qmcgaw/basedevcontainer
• 可通过docker-compose.yml扩展
• 最小未压缩镜像大小为467MB

![演示]([***]

环境要求

• 已安装并运行Docker
  • 若不使用Linux，请在Docker Desktop中共享~/.ssh目录和项目目录
• 已安装Docker Compose
• 已安装VS code
• 已安装VS code远程容器扩展

项目设置

1. 设置配置文件

   • 带风格的方式 💯

     sh
     docker run -it --rm -v "/你的仓库路径:/repository" qmcgaw/devtainr:v0.4.0 -dev latex -path /repository -name 项目名称
     

     或使用预编译二进制文件

   • 手动方式：下载本仓库并将.devcontainer目录放入你的项目中

2. 在Visual Studio Code中打开命令面板（CTRL+SHIFT+P），选择Remote-Containers: Open Folder in Container...，然后选择你的项目目录

![安装]([***]

安装LaTeX包

例如，若需要安装lastpage包，在VS Code中打开集成终端，选择zsh并输入：

sh
tlmgr install lastpage
texhash

![安装包]([***]

更新LaTeX Docker镜像

1. 拉取Docker镜像

   sh
   docker pull qmcgaw/latexdevcontainer
   

2. 在Visual Studio Code中打开命令面板（CTRL+SHIFT+P），选择Remote-Containers: Rebuild and Reopen in Container...。⚠️ 这将清除容器的shell历史记录和在基础镜像上添加的自定义LaTeX包。

更多信息

devcontainer.json配置

• 可根据需求修改"postCreateCommand"。例如：

  json
  "postCreateCommand": "tlmgr install acronym pgf && texhash",
  

• 可在"customizations/vscode/extensions"数组中修改Docker镜像中安装的扩展

• 可在"customizations/vscode/settings"对象中修改或添加其他LaTeX设置

开发镜像

• 可自行构建开发镜像：

  sh
  docker build -t qmcgaw/latexdevcontainer -f Dockerfile [***]
  

• 可使用自定义指令扩展qmcgaw/latexdevcontainer镜像：

  1. 创建文件.devcontainer/Dockerfile，内容为FROM qmcgaw/latexdevcontainer

  2. 在创建的Dockerfile中追加指令。例如：

     Dockerfile
     FROM qmcgaw/latexdevcontainer
     RUN tlmgr install lastpage
     

  3. 修改.devcontainer/docker-compose.yml，在vscode服务中添加build: .

  4. 打开VS Code命令面板，选择Remote-Containers: Rebuild container

• 可将shell脚本挂载到/home/vscode/.welcome.sh以替换当前欢迎脚本

待办事项

• qmcgaw/basedevcontainer的待办事项

许可证

本仓库采用MIT许可证（除非另有说明）。