Skip to content

Home

Jump to bottom
Heinrich Stamerjohanns edited this page Nov 23, 2021 · 13 revisions

texmlbus

Texmlbus (Tex to XML BUild System) supports the conversion process of documents written in LaTeX. Documents can not only be converted to pdf, but also to other output formats – such as markup languages like html. In particular, conversion to XML and MathML is supported via LaTeXML. texmlbus can schedule jobs among several workers (possibly on different hosts), extracts and analyzes the conversion process of each document and stores results in its own database. Result documents as well as statistics about the results of the build process can be easily retrieved using a web browser.

Getting Started

The whole system runs inside docker containers.

Download Docker Desktop for Mac or Windows. Docker Compose is now part of Docker Desktop. On Linux, make sure you have the latest version of Compose.

1. git clone https://github.com/stamer/texmlbus.git
2. cd texmlbus
3. docker-compose up
5. # Please be patient when images are downloaded the very first time, as a full 
   # TeXLive system will be installed. Later the system will startup much faster.
6. # Go to http://localhost:8080 or https://localhost:8443
7. # press Ctrl-C to stop the system.

If you would like to develop with latexml, you can also build the images yourself and update the images after changes.

1. git clone --recursive https://github.com/stamer/texmlbus.git
2. cd texmlbus
3. git submodule update --init --recursive
4. docker-compose -f docker-compose.yml -f docker-compose-build.yml build
   # `docker compose build` (v2, without hyphen) does not currently work, use `build-images.bat` 
   # or `build-images.sh` then.
   # see issues for explanation.
   # Please be patient when the system is installed the very first time, as a full 
   # TeXLive system will be installed. Later the system will startup much faster.
   # The system will continue after displaying OK: 3xxx MiB in 1xx packages. Please be patient.
5. docker-compose up
6. # Go to http://localhost:8080 or https://localhost:8443
7. # press Ctrl-C to stop the system.

Run several workers

In order to run several (here three) workers in parallel enter

docker-compose up --scale latexml_dmake=3
Clone this wiki locally