Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jakoch/latex-devbox
A Docker-based devcontainer for documentation development. Based on Debian with LaTeX (TexLive+TexLS), Pandoc, AsciiDoc, and Docbook.
https://github.com/jakoch/latex-devbox
asciidoc devcontainer docbook docker documentation latex pandoc texlive
Last synced: 5 days ago
JSON representation
A Docker-based devcontainer for documentation development. Based on Debian with LaTeX (TexLive+TexLS), Pandoc, AsciiDoc, and Docbook.
- Host: GitHub
- URL: https://github.com/jakoch/latex-devbox
- Owner: jakoch
- License: mit
- Created: 2024-12-08T19:23:32.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-01-26T15:01:56.000Z (16 days ago)
- Last Synced: 2025-01-26T15:31:54.346Z (16 days ago)
- Topics: asciidoc, devcontainer, docbook, docker, documentation, latex, pandoc, texlive
- Language: Dockerfile
- Homepage:
- Size: 52.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Latex DevBox [](https://github.com/jakoch/latex-devbox)
A Docker development box for documentation creation using LaTeX.
**Debian Linux 13 Trixie with LaTeX (TexLive + TexLS), Pandoc, AsciiDoc, Docbook.**
## What is this?
This repository maintains a Dockerfile for generating a container image based on Debian Linux.
The image includes TexLive on Debian 13 Trixie, along with other essential documentation tools like Pandoc, AsciiDoc, and Docbook.
The image is published to the Github Container Registry (GHCR).
The purpose of the image is to set up a comprehensive LaTeX development environment within Visual Studio Code using a [devcontainer config](https://github.com/jakoch/latex-devbox#fetching-the-prebuild-container-images-using-a-devcontainer-config). This setup allows for seamless LaTeX document creation, editing, and compilation directly within a Docker container, ensuring a consistent and reproducible environment.
## Prerequisites
You need the following things to run this:
- Docker
- Visual Studio Code
## How to run this?
There are two ways of setting the container up.
Either by building the container image locally or by fetching the prebuild container image from the Github container registry.
### Building the Container Image locally using VSCode
- **Step 1.** Get the source: clone this repository using git or download the zip
- **Step 2.** In VSCode open the folder in a container (`Remote Containers: Open Folder in Container`):
This will build the container image (`Starting Dev Container (show log): Building image..`)
Which takes a while...
Then, finally...
- **Step 3.** Enjoy! :sunglasses:
### Fetching the prebuild container images using Docker
This container image is published to the Github Container Registry (GHCR).
You may find the package here: https://github.com/jakoch/latex-devbox/pkgs/container/latex-devbox
**Command Line**
You can install the container image from the command line:
```bash
docker pull ghcr.io/jakoch/latex-devbox:trixie-latest
```
**Dockerfile**
You might also use this container image as a base image in your own `Dockerfile`:
```bash
FROM ghcr.io/jakoch/latex-devbox:trixie-latest
```
### Fetching the prebuild container images using a .devcontainer config
**Devcontainer.json**
You might use this container image in the `.devcontainer/devcontainer.json` file of your project:
```
{
"name": "LaTeX Dev Container",
"image": "ghcr.io/jakoch/latex-devbox:trixie-latest"
}
```