https://github.com/thoughtscript/latex_docker

LaTeX in Docker with client to view, edit
https://github.com/thoughtscript/latex_docker

docker golang latex

Last synced: 6 months ago
JSON representation

LaTeX in Docker with client to view, edit

• Host: GitHub
• URL: https://github.com/thoughtscript/latex_docker
• Owner: Thoughtscript
• Created: 2024-05-05T00:25:45.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-05-21T02:00:01.000Z (8 months ago)
• Last Synced: 2025-05-21T02:44:55.802Z (8 months ago)
• Topics: docker, golang, latex
• Language: HTML
• Homepage: https://www.thoughtscript.io/papers
• Size: 39.1 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# LaTeX Docker

[![](https://img.shields.io/badge/Go-1.22.2-blue.svg)](https://golang.org/pkg/)

[![](https://img.shields.io/badge/LaTeX-TexLive-turquoise.svg)](https://www.latex-project.org/get/)

[![](https://img.shields.io/badge/LATEX.js-0.12.6-red.svg)](https://latex.js.org/)

- [x] Setup the necessary LaTeX dependencies

- [x] Mount files

- [x] Generate a PDF

- [x] Host the PDF through a static file server

- [x] Support for uploading text through the browser

- [x] Support for regenerating the pdf within the container

- [x] Support for writing LaTeX in the browser (and rendering it)

- [x] Support for saving LaTeX in the browser to `paper.tex`

- [ ] Better styling

- [ ] Better editing

- [ ] Better navigation

- [x] Tweak some JS and HTML functionality around redirects, rerendering, and prevent default

```bash

docker-compose up

# If using Docker Compose Engine V2:

docker compose up

```

View the PDF and write LaTeX:

1. https://localhost/public/

    * A view, into the container (can also get the PDF from **Docker Desktop** > **Container Files**). (**Experimental**)

2. https://localhost/public/editor.html

    * A compressed view into the container to edit and modify LaTeX. (**Experimental**)

    * Lacks support for many commonly used libraries like `amsmath` (but does support basic LaTeX to some extent).

    * This is mostly to explore the limits of the [LATEX.js](https://github.com/michael-brade/LaTeX.js)

3. https://localhost/public/viewer.html 

    * A compressed view into the container to compile and view pdf's.

4. https://localhost/public/pdfeditor.html 

    * Slightly more reliable way to edit and render text live.

    * **Use this view by default.**

    * Has supprt for `amsmath` and most other commonly used libraries.

## API Endpoints

1. https://localhost/api/pdf/make - POST endpoint that'll regenerate the PDF file without having to restart the container. Is called from the view above.

1. https://localhost/api/pdf/upload - POST endpoint that'll allow a file to be uploaded to overwrite `paper.tex` so it can be recompile (allows raw `.tex` files to uploaded to the container to be compiled into `.pdf`).

1. https://localhost/api/latex/save - POST endpoint to save inputted text to `paper.tex` (better UI and Nav features to be added to provide basic but fuller text editor support).

> Note: all of the commands assume `paper.tex` is the relevant filename and filetype.

## Resources and Links

1. https://wch.github.io/latexsheet/latexsheet-0.png

1. https://linuxconfig.org/how-to-install-latex-on-ubuntu-20-04-focal-fossa-linux

1. https://www.latex-project.org/help/documentation/usrguide-historic.pdf

1. https://askubuntu.com/questions/1034019/18-04-cannot-install-texlive-full

2. https://tutorialedge.net/golang/go-file-upload-tutorial/

3. https://opensource.com/article/18/6/copying-files-go