Article
DOI: 10.5300/2024-1-4/59
Full entry |
PDF
(0.2 MB)
Feedback
PDF
(0.2 MB)
Feedback
Summary:
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ů.
Summary:
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.
References:
[1] Peischl, Marei, Krüger, Marcel, Kopp, Oliver: Creation of LaTeX documents using a cloud-based pipeline.
[2] Novotný, Vít: Overleaf, Collaborative Online LaTeX Editor. Dostupné z DOI: 10.5300/2021-1-4/3. DOI 10.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: l3build: The beginner's guide. Dostupné z DOI: 10.47397/tb/43-1/tb133wright-l3build. DOI 10.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
[13] Island of TeX: Living in containers—on TeX Live (and ConTeXt) in a Docker setting. Dostupné z DOI: 10.47397/tb/44-2/tb137island-docker. DOI 10.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
Search
Partner of
