generator-latex-template 2026.10.13 → 2026.10.16

package/README.md

@@ -2,20 +2,15 @@
 
 > Generates latex templates (e.g., for thesis, workshops, conferences, IEEEtran, LNCS, ...) out of "micro-templates"
 
-## Talks and papers
-
-- Paper: [Oliver Kopp - The LaTeX template generator: How micro-templates reduce template maintenance effort](https://tug.org/TUGboat/tb44-2/tb137kopp-microtemplates.html)
-- Talk: [Oliver Kopp - The LaTeX Template Generator - DANTE Herbsttagung 2019](https://github.com/dante-ev/Vortraege_Tagungen/blob/master/2019-Herbst/Oliver%20Kopp%20-%20The%20LaTeX%20Template%20Generator%20-%20dante2019-herbst.pdf) - a talk on the motivation, user experience, and the contribution
-
 ## Background information
 
-There are many latex templates out there.
+LaTeX templates abound.
 All of them make use of certain packages such as [hyperref], [listings], or [minted].
 The packages have to be a) included in the `.tex` file somehow and b) configured.
 Moreover, some packages offer interfaces (such as new commands or new environments) to users.
 Minimal examples help to understand how a package works.
 
-The aim of the repository is to provide for each common latex package
+The aim of the repository is to provide for each common LaTeX package
 
 1. Configuration
 2. Usage example
@@ -30,7 +25,7 @@ and a generation into templates:
 
 Besides the paper and thesis document classes, the generator offers a **minimal Markdown quick start**, selectable as the `mwe` document class — for people who want a fast start with writing rather than a full thesis with all the tricks.
 
-- Content is written in **Markdown** inside a `\begin{markdown} … \end{markdown}` block in `main.tex` (via the [`markdown`](https://ctan.org/pkg/markdown) package): `#` becomes a chapter, `##` a section; citations (`[@key]`), footnotes, task lists, pipe tables, and images work out of the box.
+- You write the content in **Markdown** inside a `\begin{markdown} … \end{markdown}` block in `main.tex` (via the [`markdown`](https://ctan.org/pkg/markdown) package): `#` becomes a chapter, `##` a section; citations (`[@key]`), footnotes, task lists, pipe tables, and images work out of the box.
 - It compiles with **LuaLaTeX + biber** (the `markdown` package needs Lua; the bibliography uses biblatex).
 - [`zref-clever`](https://ctan.org/pkg/zref-clever) turns the Markdown `{#id}` identifiers into smart `\zcref` cross-references that print the type name (e.g. "Figure 1.1" / "Abbildung 1.1").
 - It generates a single minimal `main.tex` — no thesis scaffolding, abbreviations, or `commands.tex` — hides the paper/thesis-only prompts, and ships a trimmed, quick-start README.
@@ -44,7 +39,7 @@ yo latex-template --documentclass=mwe --lang=en
 ### Precondition for the generator
 
 One has to install [Node.js](https://nodejs.org/en/) version 18 (or later) to get this generator running.
-For simple installation, just head to <https://nodejs.org/> and follow the installation instructions.
+For a simple installation, head to <https://nodejs.org/> and follow the installation instructions.
 
 ### Using the generator
 
@@ -92,162 +87,26 @@ You can use the magic of `git` to prevent that:
 
 ## Resources
 
+- Paper: [Oliver Kopp - The LaTeX template generator: How micro-templates reduce template maintenance effort](https://tug.org/TUGboat/tb44-2/tb137kopp-microtemplates.html)
+- Talk: [Oliver Kopp - The LaTeX Template Generator - DANTE Herbsttagung 2019](https://github.com/dante-ev/Vortraege_Tagungen/blob/master/2019-Herbst/Oliver%20Kopp%20-%20The%20LaTeX%20Template%20Generator%20-%20dante2019-herbst.pdf) - a talk on the motivation, user experience, and the contribution
 - [IEEE](https://latextemplates.github.io/ieee-enhanced/) - example: [paper-conference-minted.tex](https://github.com/latextemplates/ieee-enhanced/blob/main/paper-conference-minted.tex)
 - [LNCS](https://latextemplates.github.io/lncs-enhanced/) - example: [paper.tex](https://github.com/latextemplates/lncs-enhanced/blob/main/paper.tex)
 - [scientific-thesis-template](https://latextemplates.github.io/scientific-thesis-template/) - example: [latexhints-english.tex](https://github.com/latextemplates/scientific-thesis-template/blob/main/latexhints-english.tex)
 - [alpenwasser/TeX](https://github.com/alpenwasser/TeX)
 
-## Development roadmap
-
-In the long run, the contents of the `paper.tex` (and similar) files in repositories of the [latextemplates](https://latextemplates.github.io/) organization should be generated automatically.
-
-## Development hints
-
-- Templating language: <https://ejs.co/>
-- Conditional questions: <https://stackoverflow.com/a/18706640/873282>.
-- Types of prompts: <https://github.com/SBoudrias/Inquirer.js#prompt-types>
-  - E.g., [Question](https://github.com/SBoudrias/Inquirer.js#question)
-- Add a new question
-  - Also adapt `__tests__/app.js`
-  - Execute tests with `npm test` (runs ESLint, then the tests via Node's built-in test runner). A bare run is `node --test`.
-- Update NPM dependencies
-  - `npx npm-update-all`. See [FreeCodeCamp](https://www.freecodecamp.org/news/10-npm-tricks-that-will-make-you-a-pro-a945982afb25/) for more details.
-  - `npx npm-check-updates -u`. [[Source](https://www.carlrippon.com/upgrading-npm-dependencies/)]
-  - See <https://github.com/yeoman/generator/releases> for changes in the generator.
-  - Generate `package-lock.json` only: `npm i --package-lock-only`
-- When one encounters `Cannot find module 'yeoman-generator'`, please update the npm dependencies.
-  That error occurred when using version `4.13.0` and `5.4.2` was available.
-- In case of the error "Error: EACCES, permission denied '/root/.config/configstore/insight-yo.json'", one needs to execute `chmod g+rwx /root /root/.config /root/.config/configstore`
-- Check GitHub actions
-  - Use [actionlint](https://github.com/rhysd/actionlint#readme)
-  - Use [vs.code GitHub actions plugin](https://marketplace.visualstudio.com/items?itemName=cschleiden.vscode-github-actions)
-  - Use [act](https://github.com/nektos/act) for checking: `act --rm --platform ubuntu-latest=fwilhe2/act-runner:latest -W .github/workflows/check-ieee-conference-a4-pdflatex-bibtex-2023-true.yml`
-- When adding a new package use `DEPP` (see above) or execute following steps:
-  1. execute `npx` with `--generatereitzig` (in a clean directory)
-  2. run `pdflatex`
-  3. run `{repository-root}/generate-texlivefile.sh`
-  4. copy `Texlivefile` to the root of the `{repository-root}/generators/app/templates`
-  5. adapt `Texlivefile` as required
-- When issues with the template occur: `npx ejs-lint main.en.tex`
-- Cancel workflows:
-  - `gh run list -L 100 --json databaseId -s queued -R latextemplates/generator-latex-template | jq -r '.[] | .databaseId' | awk '{gsub(/\\r\\n/,RS)} 1' | while read -r run_id; do gh run cancel "$run_id" -R latextemplates/generator-latex-template || true; done`
-  - `gh run list -L 100 --json databaseId -s in_progress -R latextemplates/generator-latex-template | jq -r '.[] | .databaseId' | awk '{gsub(/\\r\\n/,RS)} 1' | while read -r run_id; do gh run cancel "$run_id" -R latextemplates/generator-latex-template || true; done`
-- Update submodule of "derived" templates (LNCS, ...): `scripts/spread-updates.sh`. It also links the generator's `refine-ltg` PR in the description of each template's "Update LTG" PR.
-- Keep the `refine-ltg` PR description current: it links every issue the cycle fixes (the same `[repo#N]` links as the CHANGELOG).
-- Sort `dot.aspell.en.pws`: `cat dot.aspell.en.pws | (sed -u 1q; sort) | sponge dot.aspell.en.pws` <!-- hint by https://stackoverflow.com/a/56151840/873282 -->
-
-### Testing
-
-- All workflows test `overleaf=no` - and (nearly) all possible combinations.
-- All `*-refined` repositories test with `overleaf=true` - and only the typical settings for the template.
-- `refine-ltg` is the development branch for the template generator; only a small set of workflows enabled there due to load during testing.
-- `update-ltg` is the development branch at each `*-refined` template.
-
-### Test locally
-
-- Create empty directory ("target directory")
-- Change to the target directory
-- Run `npx yo <path-to-git-repository>/generators/app/index.js`. Background: Starting from 5.0.0 on, [one needs to specify the full path to index.js](https://github.com/yeoman/yo/issues/797#issuecomment-2541794625).
-- Windows: `npx yo c:\git-repositories\latextemplates\generator-latex-template\generators\app\index.js`
-
-#### Linux
-
-Parameters can be set using command line
-
-- LNCS: `npx yo /tmp/repo/generators/app/index.js --documentclass=lncs --papersize=a4 --latexcompiler=pdflatex --bibtextool=bibtex --texlive=2026 --docker=false --lang=en --font=default --listings=listings --enquotes=csquotes --tweakouterquote=babel --todo=pdfcomment --examples=true --howtotext=true`
-
-#### Windows
-
-Parameters can be set using command line
-
-- IEEE template (with pdflatex and bibtex): `npx yo c:\git-repositories\latextemplates\generator-latex-template\generators\app\index.js --overleaf=false --documentclass=ieee --ieeevariant=conference --papersize=a4 --latexcompiler=pdflatex --bibtextool=bibtex --texlive=2026 --docker=reitzig --lang=en --font=default --listings=listings --enquotes=csquotes --tweakouterquote=babel --todo=pdfcomment --examples=true --howtotext=true`
-- LNCS template (with pdflatex and bibtex): `npx yo c:\git-repositories\latextemplates\generator-latex-template\generators\app\index.js --overleaf=false --documentclass=lncs ---papersize=a4 --latexcompiler=pdflatex --bibtextool=bibtex --texlive=2026 --docker=false --lang=en --font=default --listings=listings --enquotes=csquotes --tweakouterquote=babel --todo=pdfcomment --examples=true --howtotext=true`
-- Scientific Thesis template: `npx yo c:\git-repositories\latextemplates\generator-latex-template\generators\app\index.js --overleaf=false --documentclass=scientific-thesis --papersize=a4 --latexcompiler=pdflatex --bibtextool=bibtex --texlive=2026 --lang=en --font=default --listings=listings --enquotes=csquotes --tweakouterquote=babel --todo=pdfcomment --examples=true --howtotext=true`
-- USTUTT template: `npx yo c:\git-repositories\latextemplates\generator-latex-template\generators\app\index.js --overleaf=false --documentclass=ustutt --papersize=a5 --latexcompiler=lualatex --bibtextool=biblatex --texlive=2026 --lang=en --font=default --listings=listings --enquotes=csquotes --tweakouterquote=babel --todo=todonotes --examples=true --howtotext=true` -- `todonotes` is the preferred TODO package here.
-
-<!-- markdownlint-disable-next-line MD004 -->
-* Run `latexmk` to build the PDF
-
-##### Using DEPP
-
-To fire up a TeX Live installation and use the [Dependency Printer for TeX Live](https://gitlab.com/islandoftex/texmf/depp) to refine `Texlivefile`, execute following steps:
-
-```cmd
-docker run -it --rm -v c:\temp\ltg:/ltg registry.gitlab.com/islandoftex/images/texlive:latest
-```
+## Contributing
 
-```bash
-cd /tmp
-git clone https://gitlab.com/islandoftex/texmf/depp.git
-cd depp
-l3build install
-cd /ltg
-# edit paper.tex and add `\RequirePackage[dependency-file=Texlivefile]{depp}`
-lualatex/pdflatex paper
-```
-
-##### Running reitzig
-
-1. `docker build --progress=plain -t reitzig -f Dockerfile .`
-2. `docker run -it --rm -v c:\temp\ltg:/work/src -v c:\temp\ltg-out:/work/out reitzig work latexmk`
-
-### Useful snippets
-
-```ejs
-<% if (howtotext) { -%>
-<% } else { -%>
-<% } -%>
-```
-
-```ejs
-<% switch (documentclass) { case "lncs": -%>
-<% break; case "ieee": -%>
-<% break; default: -%>
-<% break; } -%>
-```
-
-### Debugging
-
-A `launch.json` configured for Windows and Visual Studio Code is included.
-Just press <kbd>F5</kbd> and the generator should run in debug mode.
-
-```terminal
-ejslint.cmd c:\git-repositories\latextemplates\generator-latex-template\generators\app\templates\main.en.tex
-```
-
-### Releasing a new version
-
-> **Cut the release from `main`, never from `refine-ltg`.**
-> Releasing from the dev branch publishes an unmerged tree with a not-yet-finalized CHANGELOG — that is what broke the 2026.6.26 release (a stale `## [2026.6.25]` heading, a missing `[2026.6.26]:` compare link, and an `[Unreleased]:` link that was never bumped).
-> So after the squash-merge, `git switch main && git pull` and confirm `git branch --show-current` prints `main` before doing anything below.
-
-1. Once the `refine-ltg` PR is green, **squash-merge** it into `main`, then `git switch main && git pull` (confirm you are on `main`).
-2. Update `CHANGELOG.md`: rename the top `## [Unreleased]` heading to `## [<version>]`, add the matching `[<version>]: …/compare/<prev>...<version>` link definition, and bump `[Unreleased]: …/compare/<version>...main`.
-3. **Verify the CHANGELOG before publishing:**
-   - Run heylogs (the same check as CI's `check-changelog.yml`) and get **0 problems**:
-     `jbang com.github.nbbrd.heylogs:heylogs-cli:0.18.1:bin check CHANGELOG.md`
-   - heylogs **cannot** validate the version links here: our CalVer headings omit the date, so `linkable`/`date-displayed`/`all-h2-contain-a-version` are off in `heylogs.properties` and heylogs skips link-checking a dateless heading. So **also check the links by hand** — the top `## [<version>]` must equal the version `release-it` will publish, and both the `[<version>]:` and the bumped `[Unreleased]:` definitions must be present and point at the right tags. Quick grep:
-     `grep -nE '^## \[|^\[Unreleased\]:|^\[<version>\]:' CHANGELOG.md`
-4. Update `package.json`, publish to [npmjs](https://www.npmjs.com/package/generator-latex-template), create GitHub release.
-   Use [release-it](https://www.npmjs.com/package/release-it) (do not create a release on GitHub) and [github-release-from-changelog](https://www.npmjs.com/package/github-release-from-changelog).
-
-   - `npx release-it`
-   - Confirm the publish: `npm view generator-latex-template version` must print the new version (2026.10.1 was tagged and released on GitHub but never published to npm).
-   - `GITHUB_TOKEN=$(gh auth token) npx github-release-from-changelog` (Git Bash; it needs a GitHub token, which the logged-in `gh` CLI provides)
-5. On `main`, run `scripts/end-new-cycle.sh`, then **squash-merge** each template's "Update LTG" PR once it is green.
-6. Release the templates: `scripts/release-templates.sh <YYYY-MM-DD>` (try `--dry-run` first) finalizes the CHANGELOG of every template with unreleased entries, commits "Release <date>", tags, pushes, and creates the GitHub release with the CHANGELOG section as notes.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for how to contribute and for development hints, including testing and releasing.
 
 ## License
 
-The code is licensed [0BSD](https://choosealicense.com/licenses/0bsd/#), the snippets (both LaTeX and text) 0BSD, too.
-See [benbalter/talks#15](https://github.com/benbalter/talks/issues/15#issuecomment-599704662), for a reasoning, why [CC0](https://creativecommons.org/share-your-work/public-domain/cc0/) cannot be used.
+The code has the license [0BSD](https://choosealicense.com/licenses/0bsd/#), the snippets (both LaTeX and text) 0BSD, too.
+See [benbalter/talks#15](https://github.com/benbalter/talks/issues/15#issuecomment-599704662), for the reasoning why we cannot use [CC0](https://creativecommons.org/share-your-work/public-domain/cc0/).
 
-- `generators/app/templates/splncs04nat.bst` is taken from [tpavlic/splncs04nat](https://github.com/tpavlic/splncs04nat) and is MIT-licensed.
-- `generators/app/templates/logos/`: This directory contains logos, which have special licenses.
+- `generators/app/templates/splncs04nat.bst` comes from [tpavlic/splncs04nat](https://github.com/tpavlic/splncs04nat) and is MIT-licensed.
+- `generators/app/templates/logos/`: This directory contains logos, which have special licenses (see [`logos/README.md`](generators/app/templates/logos/README.md)).
 - `generators/app/templates/figures/ulm-minster.jpg` is [Landappbw 79389 1820 Ulmer Münster Ulm.jpg](https://commons.wikimedia.org/w/index.php?curid=131463041) by wkrauth, dedicated to the public domain under [CC0 1.0](https://creativecommons.org/publicdomain/zero/1.0/).
 
 [hyperref]: https://ctan.org/pkg/hyperref
 [listings]: https://ctan.org/pkg/listings
 [minted]: https://ctan.org/pkg/minted
-
-<!-- markdownlint-disable-file MD013 MD033 -->

package/generators/app/CLAUDE.md

@@ -29,7 +29,8 @@ the feature vanishes for some switch combination without any error.
 3. **`Texlivefile`** — add the TeX Live package name, guarded (usually
    `githubpublish || <condition>`; `githubpublish` deliberately bundles everything).
 4. **Shell-escape is derived, never hardcoded.** It is the boolean
-   `requiresShellEscape` in `index.js` (`listings == "minted" || uml == "plantuml"`).
+   `requiresShellEscape` in `index.js` (`uml == "plantuml"`, and minted only up to TeX Live 2024:
+   minted 3 runs `latexminted`, which TeX Live permits in restricted shell escape).
    Extend that expression if the new package needs `\write18`; the `latexmkrc` and the
    `main.*.tex` editor hints read the flag.
 5. **New user switch?** Decide **prompt vs. plain flag** first:
@@ -82,6 +83,7 @@ The consequence (and a real footgun): **the blank-line layout of the output is n
 layout of the source.** Because `-%>` eats one trailing newline, two adjacent
 `-%>`-terminated blocks/includes render with **no** blank line between them. To get a
 blank line between blocks you need one of:
+
 - the first block's file to **end with a trailing blank line** (how most
   `*.preamble.*.tex` separate themselves — e.g. `font.preamble` ends with a blank line
   then `<% } -%>`), **or**
@@ -111,5 +113,5 @@ formats) catch things a single local `yo` + compile does not. Two that have bitt
   language's example must be defined in **both** `abbreviations.en.tex` and
   `abbreviations.de.tex` (the unused one just never appears in that document's list). Making
   `\gls` entries language-exclusive breaks the other language's variant with
-  "Glossary entry `…' has not been defined". The same single-shared-file logic applies to
+  ``Glossary entry `…' has not been defined``. The same single-shared-file logic applies to
   other `this.fs.copy`'d siblings (`commands.tex`, …).

package/generators/app/index.js

@@ -12,7 +12,11 @@ export default class extends Generator {
     this.log(yosay(`Welcome to the ${chalk.red("latex-template")} generator!`));
 
     // See "Development hints" in README.md for help on Inquirer.js
-    const props = await this._optionOrPrompt(options);
+    // yeoman-option-or-prompt mutates the prompts (deletes `when`, replaces `choices`/`default`
+    // functions by their result); pass copies so that runs in one process (the tests) stay independent.
+    const props = await this._optionOrPrompt(
+      options.map((prompt) => ({ ...prompt })),
+    );
 
     // To access props later use this.props.someAnswer;
     this.props = props;
@@ -179,10 +183,17 @@ export default class extends Generator {
       this.props.Vref = "\\zvref[S]";
     }
 
-    // Only minted and the PlantUML UML example need shell-escape; tikz-uml and the
-    // remaining thesis content do not.
+    // The program that processes the bibliography: biber for biblatex, bibtex otherwise.
+    this.props.bibrunner =
+      this.props.bibtextool === "biblatex" ? "biber" : "bibtex";
+
+    // Only the PlantUML UML example needs shell-escape. minted 3 (TeX Live 2025 and later)
+    // runs latexminted, which TeX Live permits in restricted shell escape; minted 2
+    // (TeX Live 2024) still needs shell-escape.
     this.props.requiresShellEscape =
-      this.props.listings == "minted" || this.props.uml == "plantuml";
+      (this.props.listings == "minted" && this.props.texlive < 2025) ||
+      this.props.uml == "plantuml" ||
+      this.props.uml == "mermaid";
 
     // Two-column layouts (IEEE, and the ACM conference/journal formats) cannot use
     // `longtable` ("longtable not in 1-column mode"), so the longtable example must
@@ -205,6 +216,45 @@ export default class extends Generator {
         ? "latest"
         : `TL${this.props.texlive}-historic`);
 
+    // The DANTE e.V. image additionally contains PlantUML (and the Mermaid CLI), needed by
+    // --uml=plantuml and --uml=mermaid. Its tags: https://hub.docker.com/r/danteev/texlive/tags
+    const danteTags = {
+      2021: "2021-D",
+      2023: "2023-A",
+      2024: "2024-B",
+      2025: "2026-B",
+      2026: "2026-B",
+    };
+    this.props.danteImage =
+      "danteev/texlive:" + (danteTags[this.props.texlive] ?? "edge");
+
+    // The image used to compile in Docker (README, Makefile, VS Code settings)
+    this.props.dockerImage =
+      this.props.docker === "dante"
+        ? this.props.danteImage
+        : this.props.iotImage;
+    this.props.dockerCompile =
+      this.props.docker === "iot" || this.props.docker === "dante";
+
+    // The generator options of this template, used in the README to tell how to generate an own
+    // copy (e.g., with PlantUML). The options that distinguish the main files of a published
+    // template (thesis variant, language, package for source code) are left open, so that the
+    // generator asks for them.
+    this.props.regenerateOptions = [
+      "documentclass",
+      "latexcompiler",
+      "overleaf",
+      "texlive",
+      "enquotes",
+      "tweakouterquote",
+      "todo",
+      "examples",
+      "howtotext",
+    ]
+      .filter((name) => this.props[name] !== undefined)
+      .map((name) => `--${name}=${this.props[name]}`)
+      .join(" ");
+
     createFeatures(props);
     createHeadingCommands(props);
     createAvailable(props);
@@ -310,7 +360,7 @@ export default class extends Generator {
     );
     this.fs.copyTpl(
       this.templatePath("latexmkrc"),
-      this.destinationPath(this.props.overleaf ? "_latexmkrc" : ".latexmkrc"),
+      this.destinationPath(".latexmkrc"),
       this.props,
     );
     this.fs.copyTpl(
@@ -354,6 +404,40 @@ export default class extends Generator {
       );
     }
 
+    // TeXtidote (spelling, grammar, and style; CI job "textidote") reads its options from .textidote.
+    // Its dictionary contains the words of both aspell word lists (without their header lines).
+    // Both files must not depend on the language: some templates publish both languages into one repository.
+    if (this.props.documentclass !== "mwe") {
+      this.fs.copy(
+        this.templatePath("dot.textidote"),
+        this.destinationPath(".textidote"),
+      );
+      this.fs.copy(
+        this.templatePath("dot.textidote.replacements"),
+        this.destinationPath(".textidote.replacements"),
+      );
+      const words = [
+        ...new Set(
+          ["en", "de"].flatMap((lang) =>
+            this.fs
+              .read(this.templatePath(`dot.aspell.${lang}.pws`))
+              .split("\n")
+              .slice(1)
+              .filter((word) => word !== ""),
+          ),
+        ),
+      ]
+        .sort((a, b) => a.localeCompare(b, "en"))
+        .join("\n");
+      // aspell word lists cannot contain hyphenated words
+      const hyphenated =
+        "zref-clever\nZref-clever\nzref-vario\nZref-vario\npgf-umlsd\nmarkdown-latex-quickstart\n";
+      this.fs.write(
+        this.destinationPath(".textidote.dict"),
+        words + "\n" + hyphenated,
+      );
+    }
+
     if (this.props.documentclass === "lncs") {
       this.fs.copy(
         this.templatePath("splncs04nat.bst"),
@@ -442,6 +526,20 @@ export default class extends Generator {
       );
     }
 
+    if (this.props.documentclass == "scientific-thesis") {
+      const logos = {
+        "university-of-hamburg": "uhh-logo.pdf",
+        thu: "thu-logo.png",
+      };
+      const logo = logos[this.props.thesisvariant];
+      if (logo) {
+        this.fs.copy(
+          this.templatePath("logos/" + logo),
+          this.destinationPath("figures/" + logo),
+        );
+      }
+    }
+
     if (this.props.documentclass == "ustutt") {
       /*
       this.props.documentclass = "ustutt-include";
@@ -523,6 +621,14 @@ export default class extends Generator {
       this.fs.copy(this.templatePath("docs/*"), this.destinationPath("docs/"));
     }
 
+    if (this.props.uml === "mermaid") {
+      // lets the headless Chromium of the Mermaid CLI run without sandbox (see uml.mermaid.preamble.en.tex)
+      this.fs.copy(
+        this.templatePath("puppeteer.json"),
+        this.destinationPath("puppeteer.json"),
+      );
+    }
+
     this.fs.copy(
       this.templatePath(".github/dependabot.yml"),
       this.destinationPath(".github/dependabot.yml"),

package/generators/app/options.js

@@ -114,6 +114,10 @@ export const options = [
         name: "Universität Hamburg",
         value: "university-of-hamburg",
       },
+      {
+        name: "Technische Hochschule Ulm",
+        value: "thu",
+      },
     ],
     default: "ustutt",
   },
@@ -159,28 +163,18 @@ export const options = [
     type: "list",
     name: "texlive",
     message: "Which TeXLive compatibility?",
-    choices(state) {
-      const res = [
-        {
-          name: "TeXLive 2024",
-          value: 2024,
-        },
-      ];
-      if (!state.overleaf) {
-        res.push({
-          name: "TeXLive 2025",
-          value: 2025,
-        });
-      }
-      return res;
-    },
-    default(state) {
-      if (state.overleaf) {
-        return 2024;
-      }
-
-      return 2025;
-    },
+    // Overleaf offers the current TeX Live (select it in the project settings).
+    choices: [
+      {
+        name: "TeXLive 2025",
+        value: 2025,
+      },
+      {
+        name: "TeXLive 2026",
+        value: 2026,
+      },
+    ],
+    default: 2026,
   },
   {
     type: "list",
@@ -197,7 +191,7 @@ export const options = [
           value: "pdflatex",
         },
       ];
-      if (state.texlive == 2025) {
+      if (state.texlive == 2026) {
         res.push({
           name: "pdflatex-dev",
           value: "pdflatex-dev",
@@ -207,7 +201,7 @@ export const options = [
         name: "lualatex",
         value: "lualatex",
       });
-      if (state.texlive == 2025) {
+      if (state.texlive == 2026) {
         res.push({
           name: "lualatex-dev",
           value: "lualatex-dev",
@@ -254,30 +248,6 @@ export const options = [
       }
     },
   },
-  {
-    type: "list",
-    name: "docker",
-    message: "Should a Dockerfile be generated?",
-    choices: [
-      {
-        name: "no",
-        value: false,
-      },
-      {
-        name: "yes (Island of TeX)",
-        value: "iot",
-      },
-      {
-        name: "yes (Reiztig)",
-        value: "reitzig",
-      },
-      {
-        name: "yes (DANTE e.V.)",
-        value: "dante",
-      },
-    ],
-    default: false,
-  },
   {
     type: "list",
     name: "lang",
@@ -484,10 +454,53 @@ export const options = [
         value: "tikz-uml",
       },
       {
-        name: "PlantUML (needs LuaLaTeX, --shell-escape, and a PlantUML/Java install)",
+        name: "PlantUML (needs --shell-escape, Java, and PlantUML; contained in the Docker image by DANTE e.V.)",
         value: "plantuml",
       },
+      {
+        name: "Mermaid (needs --shell-escape and the Mermaid CLI; contained in the Docker image by DANTE e.V.)",
+        value: "mermaid",
+      },
     ],
     default: "none",
   },
+  {
+    type: "list",
+    name: "docker",
+    message: "Should a Dockerfile be generated?",
+    // PlantUML and the Mermaid CLI are contained only in the image by DANTE e.V.
+    choices(state) {
+      const needsDante = state.uml === "plantuml" || state.uml === "mermaid";
+      const res = [
+        {
+          name: "no",
+          value: false,
+        },
+      ];
+      if (!needsDante) {
+        res.push(
+          {
+            name: "yes (Island of TeX)",
+            value: "iot",
+          },
+          {
+            name: "yes (Reiztig)",
+            value: "reitzig",
+          },
+        );
+      }
+      res.push({
+        name: needsDante
+          ? "yes (DANTE e.V.; contains PlantUML and the Mermaid CLI)"
+          : "yes (DANTE e.V.)",
+        value: "dante",
+      });
+      return res;
+    },
+    default(state) {
+      return state.uml === "plantuml" || state.uml === "mermaid"
+        ? "dante"
+        : false;
+    },
+  },
 ];

package/generators/app/templates/.github/dependabot.yml

@@ -4,3 +4,6 @@ updates:
     directory: '/'
     schedule:
       interval: 'weekly'
+    groups:
+      actions:
+        patterns: ["*"]