{"id":22852892,"url":"https://github.com/jakoch/latex-devbox","last_synced_at":"2026-04-18T11:31:32.002Z","repository":{"id":267316881,"uuid":"900440502","full_name":"jakoch/latex-devbox","owner":"jakoch","description":"A Docker-based devcontainer for documentation development. Based on Debian with LaTeX (TexLive+TexLS), Pandoc, AsciiDoc, and Docbook. ","archived":false,"fork":false,"pushed_at":"2025-03-25T18:49:22.000Z","size":68,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T19:37:12.532Z","etag":null,"topics":["asciidoc","devcontainer","docbook","docker","documentation","latex","pandoc","texlive"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jakoch.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"jakoch"}},"created_at":"2024-12-08T19:23:32.000Z","updated_at":"2025-03-25T18:49:01.000Z","dependencies_parsed_at":"2024-12-09T17:32:50.720Z","dependency_job_id":"71e2582a-a6dc-4162-97cc-aef9e89ef514","html_url":"https://github.com/jakoch/latex-devbox","commit_stats":null,"previous_names":["jakoch/latex-devbox"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Flatex-devbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Flatex-devbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Flatex-devbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jakoch%2Flatex-devbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jakoch","download_url":"https://codeload.github.com/jakoch/latex-devbox/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246429493,"owners_count":20775808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asciidoc","devcontainer","docbook","docker","documentation","latex","pandoc","texlive"],"created_at":"2024-12-13T06:09:47.282Z","updated_at":"2025-09-22T17:49:17.320Z","avatar_url":"https://github.com/jakoch.png","language":"Dockerfile","funding_links":["https://github.com/sponsors/jakoch"],"categories":[],"sub_categories":[],"readme":"# Latex DevBox [![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/jakoch/latex-devbox/release.yml?branch=main\u0026style=flat\u0026logo=github\u0026label=Image%20published%20on%20GHCR)](https://github.com/jakoch/latex-devbox)\n\nA Docker development box for documentation creation using LaTeX.\n\n**Debian Linux 13 Trixie with LaTeX (TexLive + TexLS), Pandoc, AsciiDoc, Docbook.**\n\n## What is this?\n\nThis repository maintains a Dockerfile for generating a container image based on Debian Linux.\n\nThe image includes TexLive on Debian 13 Trixie, along with other essential documentation tools like Pandoc, AsciiDoc, and Docbook.\n\nThe image is published to the Github Container Registry (GHCR).\n\nThe 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.\n\n## Prerequisites\n\nYou need the following things to run this:\n\n- Docker\n- Visual Studio Code\n\n## How to run this?\n\nThere are two ways of setting the container up.\n\nEither by building the container image locally or by fetching the prebuild container image from the Github container registry.\n\n### Building the Container Image locally using VSCode\n\n- **Step 1.** Get the source: clone this repository using git or download the zip\n\n- **Step 2.** In VSCode open the folder in a container (`Remote Containers: Open Folder in Container`):\n\n   This will build the container image (`Starting Dev Container (show log): Building image..`)\n\n   Which takes a while...\n\n   Then, finally...\n\n- **Step 3.**  Enjoy! :sunglasses:\n\n### Fetching the prebuild container images using Docker\n\nThis container image is published to the Github Container Registry (GHCR).\n\nYou may find the package here: https://github.com/jakoch/latex-devbox/pkgs/container/latex-devbox\n\n**Command Line**\n\nYou can install the container image from the command line:\n\n```bash\ndocker pull ghcr.io/jakoch/latex-devbox:trixie-latest\n```\n**Dockerfile**\n\nYou might also use this container image as a base image in your own `Dockerfile`:\n\n```bash\nFROM ghcr.io/jakoch/latex-devbox:trixie-latest\n```\n### Fetching the prebuild container images using a .devcontainer config\n\n**Devcontainer.json**\n\nYou might use this container image in the `.devcontainer/devcontainer.json` file of your project:\n\n\n```\n{\n    \"name\": \"LaTeX Dev Container\",\n    \"image\": \"ghcr.io/jakoch/latex-devbox:trixie-latest\"\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakoch%2Flatex-devbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjakoch%2Flatex-devbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjakoch%2Flatex-devbox/lists"}