{"id":13337389,"url":"https://github.com/stamer/texmlbus","last_synced_at":"2025-03-11T06:32:00.765Z","repository":{"id":41825961,"uuid":"264744498","full_name":"stamer/texmlbus","owner":"stamer","description":"Texmlbus (Tex to XML BUild System) supports the conversion process of documents written in LaTeX to pdf, html, xhtml or jats. ","archived":false,"fork":false,"pushed_at":"2023-04-30T09:19:50.000Z","size":4115,"stargazers_count":17,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-04-30T10:34:12.843Z","etag":null,"topics":["build-system","html","jats","latex","latexml","mathml","pdflatex","tex","xhtml","xml"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stamer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-17T19:48:38.000Z","updated_at":"2023-01-23T18:01:03.000Z","dependencies_parsed_at":"2023-01-31T19:16:04.646Z","dependency_job_id":null,"html_url":"https://github.com/stamer/texmlbus","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stamer%2Ftexmlbus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stamer%2Ftexmlbus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stamer%2Ftexmlbus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stamer%2Ftexmlbus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stamer","download_url":"https://codeload.github.com/stamer/texmlbus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213069676,"owners_count":15532832,"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":["build-system","html","jats","latex","latexml","mathml","pdflatex","tex","xhtml","xml"],"created_at":"2024-07-29T19:14:20.264Z","updated_at":"2024-10-23T16:30:24.190Z","avatar_url":"https://github.com/stamer.png","language":"PHP","readme":"# texmlbus\n\nTexmlbus (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, HTML and MathML is supported via [LaTeXML](https://dlmf.nist.gov/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.\n\n## Getting Started\n\nThe whole system runs inside docker containers.\n\nDownload [Docker Desktop](https://www.docker.com/products/docker-desktop) for Mac or Windows. [Docker Compose](https://docs.docker.com/compose) will be automatically installed. On Linux, make sure you have the latest version of [Compose](https://docs.docker.com/compose/install/).\n\n```\n1. git clone https://github.com/stamer/texmlbus.git\n2. cd texmlbus\n3. docker-compose up\n5. # Please be patient when images are downloaded the very first time, as a full \n   # TeXLive system will be installed. Later the system will startup much faster.\n6. # Go to http://localhost:8080 or https://localhost:8443\n7. # press Ctrl-C to stop the system.\n```\n\nIf you would like to develop with latexml, you can also build the images yourself and update the images after changes.\n\n```\n1. git clone --recursive https://github.com/stamer/texmlbus.git\n2. cd texmlbus\n3. git submodule update --init --recursive\n4. docker-compose -f docker-compose.yml -f docker-compose-build.yml build\n   # `docker compose build` (v2, without hyphen) does not currently work, use `build-images.bat` \n   # or `build-images.sh` then.\n   # see issues for explanation.\n   # Please be patient when the system is installed the very first time, as a full \n   # TeXLive system will be installed. Later the system will startup much faster.\n   # The system will continue after displaying OK: 3xxx MiB in 1xx packages. Please be patient.\n5. docker-compose up\n6. # Go to http://localhost:8080 or https://localhost:8443\n7. # press Ctrl-C to stop the system.\n```\n\n## Run several workers\nIn order to run several (here three) workers in parallel enter\n```\ndocker-compose up --scale latexml_dmake=3\n```\n\n## Usage\n\nInstall and start the app as described above.\n\n1. Goto http://localhost:8080\n2. Click on \u003ca href=\"https://github.com/stamer/texmlbus/wiki/images/texmlbus_home.png\" target=\"_texmlbus\"\u003e__Create Sample Set__\u003c/a\u003e in the top menu.\n2. Click on \u003ca href=\"https://github.com/stamer/texmlbus/wiki/images/texmlbus_create_samples.png\" target=\"_texmlbus\"\u003e__Create Samples__\u003c/a\u003e button.\n3. Click on \u003ca href=\"https://github.com/stamer/texmlbus/wiki/images/texmlbus_scan_samples.png\" target=\"_texmlbus\"\u003e__Scan samples directory__\u003c/a\u003e button to import some sample documents\n4. Goto \u003ca href=\"https://github.com/stamer/texmlbus/wiki/images/texmlbus_documents_start.png\" target=\"_texmlbus\"\u003eDocuments alphabetically\u003c/a\u003e to see the documents.\n5. Click on \u003ca href=\"https://github.com/stamer/texmlbus/wiki/images/texmlbus_sample_documents.png\" target=\"_texmlbus\"\u003e__queue__\u003c/a\u003e to convert a document.\n6. Click on \u003ca href=\"https://github.com/stamer/texmlbus/wiki/images/texmlbus_sample_documents.png\" target=\"_texmlbus\"\u003e__Destfile__\u003c/a\u003e to see the converted document.\n\n## Upgrade ##\n\nIf you upgrade from previous versions, you might want to adapt your makefiles to the new source code layout. Go to `Import / Manage` --\u003e Fix Makefiles and click on the button there. \n\n## Documentation\n\nThe [wiki](https://github.com/stamer/texmlbus/wiki) contains how-tos and provides help if you have any issues using texmlbus.\n\nAny feedback is welcome, you can use the the [issues](https://github.com/stamer/texmlbus/issues) page for that.\n\n## Sponsors\n\nMany thanks to the great people at [Overleaf](https://www.overleaf.com) for sponsoring this project.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstamer%2Ftexmlbus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstamer%2Ftexmlbus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstamer%2Ftexmlbus/lists"}