Creation of LaTeX documents using a cloud-based pipeline

Marei Peischl; Marcel Krüger; Oliver Kopp

Zpravodaj Československého sdružení uživatelů TeXu (2024)

  • Issue: 1-4, page 59-72
  • ISSN: 1211-6661

Abstract

top
Using web-based platforms for collaborative editing of LaTeX documents is common these days. These tools focus on writing documents and not on creation of templates or packages. Using build servers with automated pipelines is common within software development but can easily be adapted for TeX & friends. This article will show how to get started using automated workflows on platforms like GitHub, Forgejo, or GitLab for document authors as well as TeX developers.

How to cite

top

Peischl, Marei, Krüger, Marcel, and Kopp, Oliver. "Příprava (La)TeXových dokumentů v cloudu." Zpravodaj Československého sdružení uživatelů TeXu (2024): 59-72. <http://eudml.org/doc/299648>.

@article{Peischl2024,
abstract = {Používání webových služeb pro kolaborativní přípravu dokumentů v (La)TeXu je dnes běžné, ale tyto nástroje se zaměřují na psaní dokumentů, nikoliv na tvorbu šablon nebo balíčků. Používání serverů pro průběžnou integraci a doručení je běžné ve vývoji softwaru, ale může být snadno přizpůsobeno pro TeX a přátele. Tento článek ukazuje, jak začít s používáním automatizace na webových službách jako GitHub, Forgejo nebo GitLab, a to jak pro autory dokumentů, tak pro vývojáře (La)TeX ových balíčků.},
author = {Peischl, Marei, Krüger, Marcel, Kopp, Oliver},
journal = {Zpravodaj Československého sdružení uživatelů TeXu},
language = {cze},
number = {1-4},
pages = {59-72},
publisher = {Československé sdružení uživatelů TeXu},
title = {Příprava (La)TeXových dokumentů v cloudu},
url = {http://eudml.org/doc/299648},
year = {2024},
}

TY - JOUR
AU - Peischl, Marei
AU - Krüger, Marcel
AU - Kopp, Oliver
TI - Příprava (La)TeXových dokumentů v cloudu
JO - Zpravodaj Československého sdružení uživatelů TeXu
PY - 2024
PB - Československé sdružení uživatelů TeXu
IS - 1-4
SP - 59
EP - 72
AB - Používání webových služeb pro kolaborativní přípravu dokumentů v (La)TeXu je dnes běžné, ale tyto nástroje se zaměřují na psaní dokumentů, nikoliv na tvorbu šablon nebo balíčků. Používání serverů pro průběžnou integraci a doručení je běžné ve vývoji softwaru, ale může být snadno přizpůsobeno pro TeX a přátele. Tento článek ukazuje, jak začít s používáním automatizace na webových službách jako GitHub, Forgejo nebo GitLab, a to jak pro autory dokumentů, tak pro vývojáře (La)TeX ových balíčků.
LA - cze
UR - http://eudml.org/doc/299648
ER -

References

top
  1. Peischl, Marei, Krüger, Marcel, Kopp, Oliver, Creation of LaTeX documents using a cloud-based pipeline, (2024) 
  2. Novotný, Vít, 10.5300/2021-1-4/3, Dostupné z DOI: 10.5300/2021-1-4/3. (2021) DOI10.5300/2021-1-4/3
  3. Stano, Michal, Starý Novotný, Vít, Overleaf Community Edition: Postup inštalácie a rozdiely oproti Overleaf Professional, [online]. [B.r.] [cit. 2024-09-03]. Dostupné z: http://www.overleaf.com/read/hmxhshbgnbzm. 
  4. LaTeX Team, The LaTeX Project, [online]. [cit. 2024-08-29]. Dostupné z: https://github.com/latex3/. 
  5. The LaTeX Project, l3build: A testing and building system for (La)TeX, [online]. [cit. 2024-08-29]. Dostupné z: https://ctan.org/pkg/l3build. 
  6. Wright, Joseph, 10.47397/tb/43-1/tb133wright-l3build, Dostupné z DOI: 10.47397/tb/43-1/tb133wright-l3build. (2022) DOI10.47397/tb/43-1/tb133wright-l3build
  7. Peischl, Marei, Krüger, Marcel, Kopp, Oliver, TeXhackse/tugboat-tug2024-cicd, [online]. [cit. 2024-08-30]. Dostupné z: https://tug.org/l/peischl-cicd2024. 
  8. Xu, Cheng, xu-cheng/latex-action: GitHub Action to compile LaTeX documents, [online]. [cit. 2024-09-03]. Dostupné z: https://github.com/xu-cheng/latex-action/. 
  9. GitHub, Workflow syntax for GitHub Actions, [online]. [cit. 2024-09-03]. Dostupné z: https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions. 
  10. GitHub, Choosing GitHub-hosted runners, [online]. [cit. 2024-09-03]. Dostupné z: https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#choosing-github-hosted-runners. 
  11. GitHub, GitHub Workflow template for LaTeX packages, [online]. [cit. 2024-09-03]. Dostupné z: https://github.com/islandoftex/tug2024-workflow-github. 
  12. Island of TeX, Providing Docker images for TeX Live and ConTeXt, Dostupné také z: https://tug.org/TUGboat/tb40-3/tb126island-docker.pdf. (2019) 
  13. Island of TeX, 10.47397/tb/44-2/tb137island-docker, Dostupné z DOI: 10.47397/tb/44-2/tb137island-docker. (2023) DOI10.47397/tb/44-2/tb137island-docker
  14. GitHub, Checkout action, [online]. [cit. 2024-09-03]. Dostupné z: https://github.com/actions/checkout/. 
  15. Collins, John, latexmk: Fully automated LaTeX document generation, [online]. [cit. 2024-09-03]. Dostupné z: https://ctan.org/pkg/latexmk. 
  16. Forgejo, Forgejo Repository, [online]. [cit. 2024-07-27]. Dostupné z: https://codeberg.org/forgejo/forgejo. 
  17. Forgejo, Using Forgejo Actions (Self-hosted), [online]. [cit. 2024-09-10]. Dostupné z: https://docs.codeberg.org/ci/actions/. 
  18. GitHub, GitLab Workflow template for LaTeX documents, [online]. [cit. 2024-09-10]. Dostupné z: https://gitlab.com/islandoftex/texmf/tug2024-workflow-document-gitlab. 
  19. Island of TeX, TeX Live Docker image, [online]. [cit. 2024-07-20]. Dostupné z: https://gitlab.com/islandoftex/images/texlive. 
  20. Island of TeX, DEPP: Dependency Printer for TeX Live, [online]. [cit. 2024-09-15]. Dostupné z: https://gitlab.com/islandoftex/texmf/depp. 
  21. Kopp, Oliver, File tl_packages, [online]. [cit. 2024-09-15]. Dostupné z: https://github.com/islandoftex/tug2024-workflow-document-github/blob/main/.github/tl_packages. 
  22. Krüger, Marcel, teatimeguest/setup-texlive-action: A GitHub Action to set up TeX Live, [online]. [cit. 2024-09-15]. Dostupné z: https://github.com/zauguin/install-texlive. 
  23. teatimeguest, teatimeguest/setup-texlive-action repository, [online]. [cit. 2024-09-15]. Dostupné z: https://github.com/teatimeguest/setup-texlive-action. 
  24. Peischl, Marei, File minimal-portable-tl-setup.sh, [online]. [cit. 2024-09-16]. Dostupné z: https://gitlab.com/islandoftex/texmf/depp/-/blob/main/setup-examples/texlive-minimal-portable/minimal-portable-tl-setup.sh. 
  25. Krüger, Marcel, zauguin/l3build-failure-artifacts, [online]. [cit. 2024-09-16]. Dostupné z: https://github.com/zauguin/l3build-failure-artifacts. 
  26. Casey Lee, nektos/act: Run your GitHub Actions locally, [online]. [cit. 2024-09-16]. Dostupné z: https://github.com/nektos/act. 
  27. TeX Users Group, Pretesting TeX Live 2024, [online]. [cit. 2024-09-16]. Dostupné z: https://www.tug.org/texlive/pretest.html. 

NotesEmbed ?

top

You must be logged in to post comments.

To embed these notes on your page include the following JavaScript code on your page where you want the notes to appear.

Only the controls for the widget will be shown in your chosen language. Notes will be shown in their authored language.

Tells the widget how many notes to show per page. You can cycle through additional notes using the next and previous controls.

    
                

Note: Best practice suggests putting the JavaScript code just before the closing </body> tag.