LaTeX-Pandoc Editor for VSCode Dev Container

Features

• Base Image: Debian Bookworm Slim

• Pre-installed Tools:

  • Pandoc: Universal document converter
  • LaTeX: Typesetting system with chktex for style checking
  • Git: Version control system
  • Typst: Markup-based typesetting for technical documents

• VSCode Extensions:

  • LaTeX Workshop by James Yu
  • LaTeX by Mathematic Inc
  • LTeX – LanguageTool grammar/spell checking by Julian Valentin
  • Tinymist Typst by Myriad Dreamin

• Preconfigured Settings:

  • Automatic cleaning of auxiliary files
  • PDF viewer integration within VSCode
  • IntelliSense for LaTeX packages

Installation

The structure of this repository is designed to be most effectively used as a submodule or as a subdirectory within a larger repository or project.

If This Is Your Only Dev Container

Add this Dev Container directly as your .devcontainer folder:

1. Navigate to your project’s root directory.

2. Add the Dev Container as a submodule:

   git submodule add https://github.com/Accommodus/LaTeX-Pandoc_Editor_devcontainer.git .devcontainer

3. Initialize and update the submodule:

   git submodule update --init --recursive

If You Want Multiple Dev Containers

If you want to use more than one Dev Container in your project (for example, one for running code and this one for writing the associated paper):

1. Navigate to your project’s root directory.

2. cd into your project’s .devcontainer directory

   cd .devcontainer

3. Add the Dev Container as a submodule within this subdirectory:

   git submodule add https://github.com/Accommodus/LaTeX-Pandoc_Editor_devcontainer.git

4. Initialize and update the submodule:

   git submodule update --init --recursive

5. When reopening the project in a remote container, select the desired Dev Container configuration from the list.

Usage

1. Open your project folder in Visual Studio Code.
2. Ensure the Dev Containers extension is installed.
3. Press F1 or Shift+Ctrl+P to open the Command Palette and select Dev Containers: Reopen in Container.
4. VS Code will build and start the Dev Container. Once ready, you can begin working with LaTeX.