| Title:
|
Publikace LaTeXových dokumentů na webu pomocí TeX4ht a GitHub Actions (Czech) |
| Title:
|
Publishing LaTeX Documents on the Web Using TeX4ht and GitHub Actions (English) |
| Author:
|
Hoftich, Michal |
| Language:
|
Czech |
| Journal:
|
Zpravodaj Československého sdružení uživatelů TeXu |
| ISSN:
|
1211-6661 (print) |
| ISSN:
|
1213-8185 (online) |
| Volume:
|
35 |
| Issue:
|
1 |
| Year:
|
2025 |
| Pages:
|
11-25 |
| Summary lang:
|
Czech |
| . |
| Category:
|
informatics |
| . |
| Summary:
|
Článek představí sadu šablon pro nástroj TeX4ht, který slouží k převodu LaTeXových dokumentů do HTML. Tyto šablony výrazně usnadňují publikaci různých typů dokumentů na webu a přinášejí možnosti zpracování a automatizace. První šablona je určena pro převod knižních dokumentů do webové podoby. Umožňuje rozdělení textu do jednotlivých kapitol s automaticky generovanou navigací a podporou responzivního designu, takže je výsledek dobře čitelný i na mobilních zařízeních. Druhá šablona slouží k tvorbě staticky generovaných blogů. Každý příspěvek je psán jako samostatný LaTeXový dokument, který je pomocí TeX4ht převeden do HTML. Následně jsou tyto články zpracovány statickým generátorem webů, jako je například Jekyll, který se postará o sestavení celého blogu, vytvoření rozcestníků, archivů a další navigace. Třetí šablona je zaměřena na převod prezentací vytvořených v prostředí Beamer do formy tzv. handoutů – přehledových materiálů pro posluchače. Výsledkem je čitelný a dobře strukturovaný webový dokument vhodný pro sdílení po přednášce. Všechny šablony jsou navrženy tak, aby fungovaly v rámci GitHub Actions. To znamená, že dokumenty mohou být automaticky zkompilovány a publikovány online pokaždé, když dojde ke změně v repozitáři. (Czech) |
| Summary:
|
The article presents a set of templates for the TeX4ht tool, which serves to convert LaTeX documents into HTML. These templates greatly simplify the publication of various types of documents on the web and bring modern capabilities for processing and automation. The first template is intended for converting book-style documents into a web format. It allows the text to be divided into individual chapters with automatically generated navigation and support for responsive design, making the result easily readable even on mobile devices. The second template is used for creating statically generated blogs. Each post is written as a separate LaTeX document, which is converted to HTML using TeX4ht. Subsequently, these articles are processed by a static site generator such as Jekyll, which takes care of assembling the entire blog, creating indexes, archives, and other navigation elements. The third template focuses on converting presentations created in the Beamer environment into so-called handouts – overview materials for the audience. The result is a readable and well-structured web document suitable for sharing after the lecture. All templates are designed to work within GitHub Actions. This means that the documents can be automatically compiled and published online whenever a change is made in the repository. This approach ensures that the web version of the document is always up to date. (English) |
| DOI:
|
10.5300/2025-1-4/11 |
| . |
| Date available:
|
2025-12-10T18:26:42Z |
| Last updated:
|
2025-12-10 |
| Stable URL:
|
http://hdl.handle.net/10338.dmlcz/153196 |
| . |
| Reference:
|
[1] Hoftich, Michal: Publikování z LaTeXu na web pomocí TeX4ht.Zpravodaj CSTUG. 2018, 28(1), 11–21. |
| Reference:
|
[2] GitHub: Quickstart for GitHub Actions.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://docs.github.com/en/actions/get-started/quickstart. |
| Reference:
|
[3] Xu-Cheng: texlive-action: GitHub Action to run arbitrary commands in a TeXLive environment.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://github.com/xu-cheng/texlive-action. |
| Reference:
|
[4] Ueda, Shohei, Peaceiris: actions-gh-pages: GitHub Actions for GitHub Pages (deploy static files).[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://github.com/peaceiris/actions-gh-pages. |
| Reference:
|
[5] Hoftich, Michal: tex4ht-booksite: Template for web versions of LaTeX books.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://github.com/michal-h21/tex4ht-booksite. |
| Reference:
|
[6] Hoftich, Michal: Testblog: Blogging template for TeX4ht.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://github.com/michal-h21/testblog. |
| Reference:
|
[7] The Jekyll Team: Jekyll: Simple, blog-aware, static sites.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://jekyllrb.com/. |
| Reference:
|
[8] cookiecutter: Cookiecutter: A command-line utility that creates projects from project templates.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://github.com/cookiecutter/cookiecutter. |
| Reference:
|
[9] Hoftich, Michal: tex4ht-presentation: Template for web versions of LaTeX Beamer presentations.[online]. 2025. [cit. 2025-11-21]. Dostupné z: https://github.com/michal-h21/tex4ht-presentation. |
| . |
