{"id":14985600,"url":"https://github.com/jotavare/latex-preview-container","last_synced_at":"2026-02-14T21:30:46.300Z","repository":{"id":245362663,"uuid":"818031875","full_name":"jotavare/latex-preview-container","owner":"jotavare","description":"A web IDE akin to Overleaf, featuring automatic LaTeX compilation and PDF preview.","archived":false,"fork":false,"pushed_at":"2024-07-22T23:54:50.000Z","size":370,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-10T00:35:10.484Z","etag":null,"topics":["codespaces","devcontainer","docker","git","gitlab","gitpod","latex","latex-workshop","pearl","texlive","yml"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/jotavare.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-21T00:41:07.000Z","updated_at":"2025-10-03T22:21:43.000Z","dependencies_parsed_at":"2024-06-21T19:44:13.842Z","dependency_job_id":"7810beb1-4677-4204-8868-4401b5a0ee5d","html_url":"https://github.com/jotavare/latex-preview-container","commit_stats":{"total_commits":52,"total_committers":3,"mean_commits":"17.333333333333332","dds":"0.23076923076923073","last_synced_commit":"ae1412a103c8e8036feb97e1098f2da2ed7f6251"},"previous_names":["jotavare/latex-codespaces-container"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jotavare/latex-preview-container","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jotavare%2Flatex-preview-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jotavare%2Flatex-preview-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jotavare%2Flatex-preview-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jotavare%2Flatex-preview-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jotavare","download_url":"https://codeload.github.com/jotavare/latex-preview-container/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jotavare%2Flatex-preview-container/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29456199,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T21:29:27.764Z","status":"ssl_error","status_checked_at":"2026-02-14T21:28:11.111Z","response_time":53,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["codespaces","devcontainer","docker","git","gitlab","gitpod","latex","latex-workshop","pearl","texlive","yml"],"created_at":"2024-09-24T14:11:20.412Z","updated_at":"2026-02-14T21:30:46.282Z","avatar_url":"https://github.com/jotavare.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"## ABOUT\r\n\r\nThis repository provides a Codespace environment for instantly and automatically building and previewing LaTeX files.\r\n\r\nThe initial goal was to develop a Visual Studio Code extension for building LaTeX files and previewing PDFs \"on-the-fly\" within the web IDE. However, this is impractical due to the following limitations:\r\n\r\n1. LaTeX processing relies on various packages and dependencies typically run in a local environment.\r\n2. Web IDEs have limited access to the file system and system-level utilities.\r\n\r\nThe optimal approach is to create an extension using a codespace with all necessary dependencies. However, using a Docker image with Codespaces remains the simplest and most reliable solution for me at the current moment.\r\n\r\n## HOW TO USE\r\n#### CODESPACES:\r\n\r\n1. Fork or use this repository and click on `Code`.\r\n2. Click `Create codespace on main`.\r\n3. Wait 2-3 minutes for the codespace to finish building.\r\n4. Open `latex/sample.tex`.\r\n5. Click the green triangle or press `Ctrl + Alt + B` to build the LaTeX project.\r\n6. View `sample.pdf` in the `latex/PDF` directory.\r\n7. Customize the layout, e.g., 50% `sample.tex` and 50% `sample.pdf`.\r\n8. Changes to the `.tex` file will automatically rebuild and update the PDF preview.\r\n\r\n\u003e [!NOTE]\r\n\u003e The initial PDF preview may take about 30 seconds to set up correctly. It will also open a new window for port forwarding. Once successful, this window can be closed.\r\n\r\n#### GITPOD:\r\n\r\nCan also use Gitpod to create an environment based on this repository, click [here](https://gitpod.io/#https://github.com/jotavare/latex-preview-container/) or use the link below:\r\n\r\n```\r\nhttps://gitpod.io/#https://github.com/jotavare/latex-preview-container/\r\n```\r\n\r\n\u003e [!NOTE]\r\n\u003e Unlike Codespaces, Gitpod offers instant PDF previews from the start. No waiting for the first time.\r\n\r\n## DOCKER IMAGE\r\n\r\nThe Docker image pulls the latest full version of TeX Live without documentation and source files, installs `git` and `perl`, and cleans unnecessary files, totalling 2.33GB. Depending on the project needs, other tags like `minimal`, `small`, or `medium` may also be used, to reduce codespaces build time.\r\n\r\n- [TeX Live Docker Images Tags](https://hub.docker.com/r/texlive/texlive/tags)\r\n\r\n## FOLDER AND FILE STRUCTURE\r\n\r\n```bash\r\nlatex-preview-container/\r\n│\r\n├── .devcontainer/\r\n│   ├── devcontainer.json   # Configuration file for Codespaces devcontainer\r\n│\r\n├── docker/\r\n│   ├── Dockerfile          # Dockerfile for setting up the development environment\r\n│   ├── docker-compose.yml  # Docker Compose file for managing Docker containers\r\n│\r\n├── latex/\r\n│   ├── sample.tex          # Sample LaTeX file for testing purposes\r\n│\r\n├── LICENSE                 # Licensing information for the project\r\n└── README.md               # Project documentation\r\n```\r\n\r\n## REFERENCES\r\n\r\nBelow are links I used to create this repository and other information that may be useful in the future.\r\n\r\n| Link | Source |\r\n| :--  | :----- |\r\n| [TeX Live](https://tug.org/texlive) | `Website` |\r\n| [TeX Live Docker Image](https://hub.docker.com/r/texlive/texlive) | `Website` |\r\n| [Installing TeX Live](https://tug.org/texlive/acquire-netinstall.html) | `Website` |\r\n| [The Comprehensive TeX Archive Network](https://www.ctan.org/) | `Website` |\r\n| [James-Yu/LaTeX-Workshop](https://github.com/James-Yu/LaTeX-Workshop) | `GitHub` |\r\n| [PDFTeX](https://www.tug.org/applications/pdftex/) | `Website` |\r\n| [WebLaTex](https://github.com/sanjib-sen/WebLaTex) | `GitHub` |\r\n| [TinyTeX](https://yihui.org/tinytex/) | `Unix` |\r\n| [MiKTeX](https://miktex.org/) | `Windows` |\r\n| [MacTeX](https://tug.org/mactex/) | `Macintosh` |\r\n\r\n## TYPST\r\n\r\nTypst is a new markup-based typesetting system that is designed to be as powerful as LaTeX while being much easier to learn and use.\r\n\r\n| Link | Source |\r\n| :--  | :----- |\r\n| [Typst](https://github.com/typst/typst) | `GitHub` |\r\n| [Typst Setup](https://github.com/typst-community/setup-typst) | `GitHub` |\r\n| [Typst Actions](https://github.com/lvignoli/typst-action) | `GitHub` |\r\n| [Typst Live](https://github.com/ItsEthra/typst-live) | `GitHub` |\r\n\r\n## FUTURE PLANS\r\n\r\n- [ ] Create a smaller and optimized Docker image with minimal tools for LaTeX, to build and preview PDF files.\r\n- [ ] Include new extensions in the `devcontainer.json` to enhance the workflow, such as grammar check, code formatting, Copilot, dark mode, etc.\r\n- [ ] Explore the [LaTeX Workshop](https://github.com/James-Yu/LaTeX-Workshop/wiki) extension wiki to provide more features and utilities to the devcontainer.\r\n\r\n## CONTRIBUTING\r\n\r\nIf you find any issues or have suggestions for improvements, feel free to fork the repository and open an issue or submit a pull request.\r\n\r\n## LICENSE\r\n\r\nThis project is available under the MIT License. For further details, please refer to the [LICENSE](https://github.com/jotavare/latex-preview-container/blob/main/LICENSE) file.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjotavare%2Flatex-preview-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjotavare%2Flatex-preview-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjotavare%2Flatex-preview-container/lists"}