generator-latex-template 2026.6.30 → 2026.9.23

package/README.md

@@ -26,6 +26,21 @@ and a generation into templates:
 2. Support for separate documents which require `--shell-escape` and not.
 3. Support for integrated pdflatex and lualatex documents
 
+### Markdown quick start (`mwe`)
+
+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.
+- 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.
+
+Generate it non-interactively with:
+
+```bash
+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.

package/generators/app/index.js

@@ -53,6 +53,22 @@ export default class extends Generator {
       this.props.font = "default";
     }
 
+    if (this.props.documentclass === "mwe") {
+      // Minimal Markdown quick start: a fixed, self-contained feature set. The
+      // matching prompts are hidden in options.js, so pin every value here (this
+      // also makes non-interactive `yo --documentclass=mwe` robust regardless of
+      // any flags that leak through).
+      this.props.bibtextool = "biblatex";
+      this.props.font = "default";
+      this.props.latexcompiler = "lualatex"; // Markdown + fontspec need LuaLaTeX
+      this.props.listings = "listings";
+      this.props.enquotes = "csquotes";
+      this.props.tweakouterquote = "babel";
+      this.props.todo = "none";
+      this.props.howtotext = false;
+      this.props.examples = false;
+    }
+
     // --language does not work properly, therefore, we used "lang" above. The templates still use "language"
     this.props.language = this.props.lang;
 
@@ -124,6 +140,40 @@ export default class extends Generator {
         ? true
         : this.options.longtable === true || this.options.longtable === "true";
 
+    // `authoryear` is a plain CLI flag (no prompt): switch citations to
+    // author-year globally. Maps to biblatex's authoryear style (theses, lncs)
+    // and \citestyle{acmauthoryear} (acmart); the mwe quick start is
+    // author-year already. IEEE mandates numeric citations, so it is forced
+    // off there.
+    this.props.authoryear =
+      this.options.authoryear === true || this.options.authoryear === "true";
+    if (this.props.documentclass === "ieee") {
+      this.props.authoryear = false;
+    }
+    if (this.props.documentclass === "lncs" && this.props.authoryear) {
+      // natbib + splncs04nat is numeric-only; author-year for LNCS goes
+      // through biblatex (llncs's own citeauthoryear option needs Springer
+      // .bst files that are not in TeX Live)
+      this.props.bibtextool = "biblatex";
+    }
+
+    // `crossref` is a plain CLI flag (no prompt): zref-clever (default, works
+    // with PDF tagging) or the legacy cleveref. Templates write references as
+    // <%- cref %>{…} / <%- Cref %>{…} (sentence start) and <%- vref %>/<%- Vref %>.
+    this.props.crossref =
+      this.options.crossref === "cleveref" ? "cleveref" : "zref-clever";
+    if (this.props.crossref === "cleveref") {
+      this.props.cref = "\\cref";
+      this.props.Cref = "\\Cref";
+      this.props.vref = "\\vref";
+      this.props.Vref = "\\Vref";
+    } else {
+      this.props.cref = "\\zcref";
+      this.props.Cref = "\\Zcref";
+      this.props.vref = "\\zvref";
+      this.props.Vref = "\\zvref[S]";
+    }
+
     // Only minted and the PlantUML UML example need shell-escape; tikz-uml and the
     // remaining thesis content do not.
     this.props.requiresShellEscape =
@@ -152,6 +202,22 @@ export default class extends Generator {
     }
 
     function isPaperHandling(props) {
+      if (props.documentclass === "mwe") {
+        // The mwe quick start is neither a paper nor a thesis. Its wrapper main
+        // (mwe-main.<lang>.tex) pulls the prose from an external Markdown file
+        // (mwe-manuscript.<lang>.md) via \markdownInput. English keeps the plain
+        // names main.tex / manuscript.md; German gets a -de suffix so both
+        // languages can coexist in one repo (like scientific-thesis below) with
+        // each wrapper referencing its own manuscript -- no rename needed.
+        props.isPaper = false;
+        props.isThesis = false;
+        props.filenames = {
+          main: props.language === "en" ? "main" : "main-de",
+          manuscript: props.language === "en" ? "manuscript" : "manuscript-de",
+          bib: "bibliography",
+        };
+        return;
+      }
       props.isPaper =
         props.documentclass === "acmart" ||
         props.documentclass === "ieee" ||
@@ -255,6 +321,13 @@ export default class extends Generator {
       this.templatePath("dot.aspell.conf"),
       this.destinationPath(".aspell.conf"),
     );
+    // The mwe quick start lints Markdown with its own (template-managed) config
+    if (this.props.documentclass !== "mwe") {
+      this.fs.copy(
+        this.templatePath("dot.textlintrc.json"),
+        this.destinationPath(".textlintrc.json"),
+      );
+    }
     if (this.props.language == "de" || this.props.githubpublish) {
       this.fs.copy(
         this.templatePath("dot.aspell.de.pws"),
@@ -290,12 +363,26 @@ export default class extends Generator {
       );
     }
 
+    // The mwe quick start has its own minimal Markdown main; every other class
+    // shares the big main.<lang>.tex.
+    const mainTemplate =
+      this.props.documentclass === "mwe" ? "mwe-main." : "main.";
     this.fs.copyTpl(
-      this.templatePath("main." + this.props.language + ".tex"),
+      this.templatePath(mainTemplate + this.props.language + ".tex"),
       this.destinationPath(this.props.filenames.main + ".tex"),
       this.props,
     );
 
+    // The mwe wrapper main pulls its prose from an external Markdown file so it
+    // can be edited and linted as plain Markdown (see mwe-main.<lang>.tex).
+    if (this.props.documentclass === "mwe") {
+      this.fs.copyTpl(
+        this.templatePath("mwe-manuscript." + this.props.language + ".md"),
+        this.destinationPath(this.props.filenames.manuscript + ".md"),
+        this.props,
+      );
+    }
+
     if (this.props.feature.abbreviations) {
       this.fs.copy(
         this.templatePath("abbreviations." + this.props.language + ".tex"),
@@ -303,11 +390,14 @@ export default class extends Generator {
       );
     }
 
-    this.fs.copyTpl(
-      this.templatePath("commands.tex"),
-      this.destinationPath("commands.tex"),
-      this.props,
-    );
+    // mwe-main does not \input{commands}; keep the quick start minimal.
+    if (this.props.documentclass !== "mwe") {
+      this.fs.copyTpl(
+        this.templatePath("commands.tex"),
+        this.destinationPath("commands.tex"),
+        this.props,
+      );
+    }
 
     if (this.props.documentclass == "ustutt") {
       /*

package/generators/app/options.js

@@ -24,6 +24,10 @@ export const options = [
         name: "PhD Thesis Template (University of Stuttgart)",
         value: "ustutt",
       },
+      {
+        name: "Minimal quick start — write your content in Markdown (LuaLaTeX + biber)",
+        value: "mwe",
+      },
     ],
     default: "acmart",
   },
@@ -181,6 +185,10 @@ export const options = [
   {
     type: "list",
     name: "latexcompiler",
+    when(response) {
+      // The mwe quick start is Markdown + fontspec, hence LuaLaTeX-only (forced in index.js).
+      return response.documentclass !== "mwe";
+    },
     message: "Which latex compiler should be used?",
     choices(state) {
       const res = [
@@ -218,7 +226,8 @@ export const options = [
       return (
         response.documentclass !== "acmart" &&
         response.documentclass !== "ieee" &&
-        response.documentclass !== "ustutt"
+        response.documentclass !== "ustutt" &&
+        response.documentclass !== "mwe"
       );
     },
     type: "list",
@@ -324,13 +333,19 @@ export const options = [
     default: "default",
     when(response) {
       return (
-        response.documentclass !== "ieee" && response.documentclass !== "ustutt"
+        response.documentclass !== "ieee" &&
+        response.documentclass !== "ustutt" &&
+        response.documentclass !== "mwe"
       );
     },
   },
   {
     type: "list",
     name: "listings",
+    when(response) {
+      // The mwe quick start has no code listings.
+      return response.documentclass !== "mwe";
+    },
     message: "Which package to typeset listings?",
     choices: [
       {
@@ -347,6 +362,10 @@ export const options = [
   {
     type: "list",
     name: "enquotes",
+    when(response) {
+      // The mwe quick start fixes csquotes (forced in index.js).
+      return response.documentclass !== "mwe";
+    },
     message: 'Which package to use to "enquote" text?',
     choices(state) {
       const res = [];
@@ -380,6 +399,9 @@ export const options = [
   {
     type: "list",
     name: "tweakouterquote",
+    when(response) {
+      return response.documentclass !== "mwe";
+    },
     message:
       'Enable hyphenation tweak (e.g., application"=specific for app-lication-specific at a linebreak) or enable easy quotation (e.g., "application"; not common in default latex setups)?',
     choices: [
@@ -397,6 +419,10 @@ export const options = [
   {
     type: "list",
     name: "todo",
+    when(response) {
+      // The mwe quick start has no TODO markers.
+      return response.documentclass !== "mwe";
+    },
     message: "Which package to mark TODOs?",
     choices: [
       {
@@ -421,12 +447,19 @@ export const options = [
   {
     type: "confirm",
     name: "howtotext",
+    when(response) {
+      return response.documentclass !== "mwe";
+    },
     message: "Include hints on text (e.g., how to write an abstract)?",
     default: true,
   },
   {
     type: "confirm",
     name: "examples",
+    when(response) {
+      // The mwe document *is* the example; the LaTeX-hints chapter does not apply.
+      return response.documentclass !== "mwe";
+    },
     message: "Include minimal LaTeX examples?",
     default: true,
   },

package/generators/app/templates/.github/workflows/check.yml

@@ -122,11 +122,13 @@ jobs:
           path: |
             texcount.txt
             texcount.html
+<%# The mwe class writes Markdown, which aspell cannot parse; the check-markdown (Vale) workflow lints its prose instead, so the aspell spell-check job is omitted here. -%>
+<% if (documentclass !== "mwe") { -%>
   spell-check:
     # This is based on https://github.com/mh61503891/action-paper-aspell/tree/master
     #
 <% if (documentclass === "scientific-thesis") { -%>
-    # Disabled for scientific-thesis: the example content trips too many aspell false positives to maintain
+    # Disabled: the example content trips too many aspell false positives to maintain
     if: false
 <% } -%>
     runs-on: ubuntu-latest
@@ -180,6 +182,35 @@ jobs:
              echo 'If you want to ignore words, add them to `.aspell.<%= language %>.pws` (your personal aspell dictionary)' >> $GITHUB_STEP_SUMMARY
             exit 1
           fi
+  textlint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Git repository
+        uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: '22'
+      - name: Lint English prose with textlint
+        run: |
+          # Report-only: findings show up as annotations, the job does not fail.
+          # Rules come from .textlintrc.json. Only English documents (marked by
+          # "% !TeX spellcheck = en-US") are linted: write-good targets English.
+          files=$(grep -l '^% !TeX spellcheck = en' *.tex || true)
+          if [ -z "$files" ]; then
+            echo "No English .tex files to lint." >> "$GITHUB_STEP_SUMMARY"
+            exit 0
+          fi
+          npx --yes \
+            --package textlint \
+            --package textlint-plugin-latex2e \
+            --package textlint-filter-rule-allowlist \
+            --package textlint-rule-terminology \
+            --package textlint-rule-write-good \
+            textlint --format github $files \
+            | sed "s|${GITHUB_WORKSPACE}/||g" | tee annotations.txt || true
+          count=$(grep -c '^::\(error\|warning\)' annotations.txt || true)
+          echo "textlint reported ${count} finding(s) in: ${files//$'\n'/, }" >> "$GITHUB_STEP_SUMMARY"
+<% } -%>
   indent:
     runs-on: ubuntu-latest
     steps:

package/generators/app/templates/README.de.md

@@ -1,4 +1,10 @@
 # LaTeX Dokument
+<% if (documentclass == "mwe") { -%>
+
+Ein **minimaler Markdown-Schnellstart**: Schreibe deinen Inhalt als reines Markdown in `<%= filenames.manuscript %>.md`. Der schlanke Rahmen `<%= filenames.main %>.tex` bindet ihn per `\markdownInput` ein, LaTeX macht daraus ein PDF.
+<% } -%>
+
+Die in dieser Vorlage verwendeten LaTeX-Snippets können unter <https://latextemplates.github.io/latex-snippets/> eingesehen werden.
 
 Kompiliere es mittels
 <% if (latexcompiler == "pdflatex")  { %>

package/generators/app/templates/README.en.md

@@ -4,9 +4,9 @@
 # Enhanced LNCS Template
 
 > Quick start for modern LaTeXing with [LNCS](http://www.springer.com/computer/lncs).
-<% if (texlive > 2024) { -%>
+<% if (texlive > 2025) { -%>
 
-Please be aware that this template is optimized for overleaf, which is based on TeXLive 2024.
+Please be aware that this template is optimized for overleaf, which is based on TeXLive 2025.
 In case you are running a later TeXLive version (or use MiKTeX), please regenerate the template with the help of the [latex template generator].
 <% } -%>
 <% break; case "ieee": -%>
@@ -14,8 +14,8 @@ In case you are running a later TeXLive version (or use MiKTeX), please regenera
 
 > Quick start for modern LaTeXing for an IEEE conference, based on the [Manuscript Template for Conference Proceedings](https://www.ieee.org/conferences_events/conferences/publishing/templates.html).
 
-<% if (texlive > 2024) { -%>
-Please be aware that this template is optimized for overleaf, which is based on TeXLive 2024.
+<% if (texlive > 2025) { -%>
+Please be aware that this template is optimized for overleaf, which is based on TeXLive 2025.
 In case you are running a later TeXLive version (or use MiKTeX), please regenerate the template with the help of the [latex template generator].
 
 <% } -%>
@@ -102,9 +102,47 @@ See [docs/overleaf](docs/overleaf/).
 <%  break; default: -%>
 # LaTeX Document
 <% break; }
-} else { -%>
+} else if (documentclass == "mwe") { -%>
+# LaTeX Document — Markdown Quick Start
+<% } else { -%>
 # LaTeX Document
 <% } -%>
+<% if (documentclass == "mwe") { -%>
+
+This is a **minimal Markdown quick start**. Write your content as plain Markdown in [`<%= filenames.manuscript %>.md`](<%= filenames.manuscript %>.md); the thin wrapper [`<%= filenames.main %>.tex`](<%= filenames.main %>.tex) pulls it in with `\markdownInput` and LaTeX turns it into a PDF — no thesis scaffolding, just the essentials: headings, citations, footnotes, tables, figures, smart cross-references (`\zcref`), and acronyms (defined once in the wrapper, recognized automatically in the running text and collected in an acronym list). Keeping the prose in a real `.md` file means your editor treats it as Markdown and the spell-/prose-checkers below lint it directly.
+<% } -%>
+
+The LaTeX snippets this template is assembled from can be inspected at <https://latextemplates.github.io/latex-snippets/>.
+<% if (githubpublish) { switch (documentclass) { case "lncs": -%>
+
+## Examples
+
+- [paper.pdf](https://latextemplates.github.io/lncs-enhanced/paper.pdf) - normal paper.
+- [paper-minted.pdf](https://latextemplates.github.io/lncs-enhanced/paper-minted.pdf) - paper showing minted in action.
+- [paper-newtx.pdf](http://latextemplates.github.io/lncs-enhanced/paper-newtx.pdf) - paper typeset in Times Roman to save some space.
+- [paper-minted-newtx.pdf](http://latextemplates.github.io/lncs-enhanced/paper-minted-newtx.pdf) - paper typeset in Times Roman to save some space.
+<% break; case "ieee": -%>
+
+## Examples
+
+- [paper.pdf](https://latextemplates.github.io/ieee-enhanced/paper.pdf) - regular conference paper.
+- [paper-minted.pdf](https://latextemplates.github.io/ieee-enhanced/paper-minted.pdf) - conference paper showing minted in action.
+<% break; case "acmart": -%>
+
+## Examples
+
+- [paper.pdf](https://latextemplates.github.io/acm-enhanced/paper.pdf) - regular conference paper.
+- [paper-minted.pdf](https://latextemplates.github.io/acm-enhanced/paper-minted.pdf) - conference paper showing minted in action.
+<% break; default: -%>
+<% break; } } -%>
+<% if (isThesis) { -%>
+
+## Writing your thesis
+
+- Read [Student Thesis Projects](https://vdf.ch/product/student-thesis-projects-en.html) by Lichter, Ludewig, Deininger, and Schneider.
+  The open-access book explains how to organize, conduct, write, and present a thesis.
+- Before handing in, work through the [thesis checklist](docs/thesis-checklist.md).
+<% } -%>
 
 ## Usage
 
@@ -163,10 +201,38 @@ On the command line, there are additional features:
 - `latexmk -C` or `make clean` for cleaning up
 - `make format` to reformat the `.tex` files (one sentence per line and indent)
 - `make aspell` for interactive spell checking
-- `make stand`: Creates a new PDF with the current status of the thesis.
+- `make stand`: Creates a new PDF with the current status of the document.
 - `make view`: Opens the configured viewer
 - `make mrproper`: Cleans up and removes also editor backup files.
+<% if (documentclass != "mwe") { -%>
+
+The `textlint` job of the `Check` workflow reports weakening words (e.g., "clearly", "just") in the English `.tex` files as annotations.
+Run it locally with `npx` (needs Node.js; rules come from `.textlintrc.json`):
+
+```bash
+npx --yes --package textlint --package textlint-plugin-latex2e --package textlint-filter-rule-allowlist --package textlint-rule-terminology --package textlint-rule-write-good textlint <%= filenames.main %>.tex
+```
+<% } -%>
+<% if (documentclass == "mwe") { -%>
+
+### Linting your Markdown
+
+Because the prose is a plain Markdown file, the text linters run on it directly — no extraction, and the reported line numbers point straight at `<%= filenames.manuscript %>.md`. Two workflows lint it and post inline annotations: `check-markdown` runs [Vale](https://vale.sh) (spelling, repetition), and `check-textlint` runs [textlint](https://github.com/textlint/textlint) (`write-good` + `terminology`).
+
+Run textlint locally with `npx` (needs Node.js; rules come from `.textlintrc.json`):
+
+```bash
+npx --yes --package textlint --package textlint-rule-terminology --package textlint-rule-write-good textlint <%= filenames.manuscript %>.md
+```
+
+For Vale, install it (`brew install vale` / `choco install vale`, or see <https://vale.sh/docs>) and point it at the file:
+
+```bash
+vale <%= filenames.manuscript %>.md
+```
+<% } -%>
 
+<% if (documentclass != "mwe") { -%>
 ## Benefits
 
 Following features are enabled in this template:
@@ -190,8 +256,8 @@ Following features are enabled in this template:
   See <https://tex.stackexchange.com/a/441701/9075> for details.
 <% } -%>
 - Automatic setting of "Fig." and "Section"/"Sect." according to the LNCS style.
-  Just use `\Cref{sec:xy}` at the beginning of a sentence and `\cref{sec:xy}` in the middle of a sentence.
-  Thanx to [cleveref].
+  Just use `<%- Cref %>{sec:xy}` at the beginning of a sentence and `<%- cref %>{sec:xy}` in the middle of a sentence.
+  Thanx to [<%= crossref %>].
 <% if (font == "default" || githubpublish) { -%>
 - Sharper font (still compatible with Springer's requirements).
 <% } -%>
@@ -215,7 +281,7 @@ Following features are enabled in this template:
 - <% if (githubpublish && !isThesis) { -%>(Optional) <% } %>Support todos as pdf annotations. This is enabled by the [pdfcomment] package.
 <% } -%>
 - [microtypographic extensions](https://www.ctan.org/pkg/microtype) for a better look of the paper.
-- Modern packages such as [microtype], [cleveref]<% if (enquotes == "csquotes" || githubpublish) { %>, [csquotes]<% } %><% if (documentclass != 'lncs') { %>, [paralist]<% } %>, [hyperref], [hypcap], [upquote]<% if (documentclass == 'lncs') { %>, [natbib]<% } %>, [booktabs].
+- Modern packages such as [microtype], [<%= crossref %>]<% if (enquotes == "csquotes" || githubpublish) { %>, [csquotes]<% } %><% if (documentclass != 'lncs') { %>, [paralist]<% } %>, [hyperref], [hypcap], [upquote]<% if (documentclass == 'lncs') { %>, [natbib]<% } %>, [booktabs].
 <% if ((reallatexcompiler.startsWith("lualatex")) || githubpublish) { -%>
 - <% if (githubpublish && !isThesis) { -%>(Optional) <% } %>LaTeX compilation using the modern [lualatex] compiler.
   For older systems, [pdflatex](https://en.wikipedia.org/wiki/PdfTeX) is still supported.
@@ -266,8 +332,9 @@ Congratulations. You chose to use all available features.
 <% } -%>
 
 <% switch (documentclass) { case "lncs": -%>
-There is currently no official biblatex support.
-A first step towards that is done at [biblatex-lncs](https://ctan.org/pkg/biblatex-lncs).
+Besides the default BibTeX setup (natbib + `splncs04nat`), biblatex is supported: generate with `--bibtextool=biblatex` to use the [biblatex-lncs](https://ctan.org/pkg/biblatex-lncs) style (numeric, mimicking Springer's `splncs04` look, processed with biber).
+
+For **author-year citations** (this template's answer to `llncs`'s `citeauthoryear` option, whose Springer `.bst` files are not part of TeX Live), generate with `--authoryear=true`: this switches to biblatex with the `authoryear` style, so `\citep{key}` renders as "(Author, year)" and `\citet{key}` as "Author (year)".
 
 <% break; case "ieee": -%>
 There is currently no official biblatex support.
@@ -275,16 +342,10 @@ A first step towards that is done at the [biblatex-ieee package](https://ctan.or
 
 <% break; default: -%>
 <% break; } -%>
+<% } -%>
 <% if (githubpublish) {
   switch (documentclass) {
     case "lncs": -%>
-## Examples
-
-- [paper.pdf](https://latextemplates.github.io/lncs-enhanced/paper.pdf) - normal paper.
-- [paper-minted.pdf](https://latextemplates.github.io/lncs-enhanced/paper-minted.pdf) - paper showing minted in action.
-- [paper-newtx.pdf](http://latextemplates.github.io/lncs-enhanced/paper-newtx.pdf) - paper typeset in Times Roman to save some space.
-- [paper-minted-newtx.pdf](http://latextemplates.github.io/lncs-enhanced/paper-minted-newtx.pdf) - paper typeset in Times Roman to save some space.
-
 ## Background
 
 The official template is available at <https://www.springer.com/gp/computer-science/lncs/conference-proceedings-guidelines> --> "Templates, samples files & useful links" --> "LaTeX2e Proceedings Templates (zip)"
@@ -304,11 +365,6 @@ This might lead to undesired results such as hyperlinks not working any more or
 In case you think, a package needs to be altered or added, feel free to open an issue.
 
 <% break; case "ieee": -%>
-## Examples
-
-- [paper.pdf](https://latextemplates.github.io/ieee-enhanced/paper.pdf) - regular conference paper.
-- [paper-minted.pdf](https://latextemplates.github.io/ieee-enhanced/paper-minted.pdf) - conference paper showing minted in action.
-
 ## Quick start
 
 - Click on `Download ZIP` or [here](https://github.com/latextemplates/IEEE/archive/main.zip).
@@ -357,6 +413,21 @@ Statement from IEEE:
 <% break; default: -%>
 <% break; }
 } else { -%>
+<% } -%>
+<% if (isPaper) { -%>
+## Final submission
+
+The compiled PDF embeds the `<%= filenames.bib %>.bib` file (via the [embedfile](https://ctan.org/pkg/embedfile) package), so readers can extract the reference data from the PDF, e.g., with JabRef via "Import into library".
+Some publishers' final-submission checks (e.g., IEEE PDF eXpress or PDF/A validation) reject PDFs containing file attachments.
+If your submission system complains, comment out the `\embedfile` line in `<%= filenames.main %>.tex` for the camera-ready version.
+
+### arXiv
+
+The first line of `<%= filenames.main %>.tex` is `\ifdefined\pdfoutput\pdfoutput=1\fi`.
+Keep it when uploading to arXiv: arXiv scans the first lines for `\pdfoutput=1` to decide between `pdflatex` and DVI-producing `latex`.
+Without the line, arXiv falls back to `latex`, which cannot build the modern fonts (they ship without Metafont sources) and aborts with an error such as `! I can't find file 'clmr28t10+20'`.
+See [this question on TeX.SE](https://tex.stackexchange.com/q/584702/9075) for details.
+
 <% } -%>
 ## Tool hints
 
@@ -480,7 +551,7 @@ Alternatively, just copy and paste the contents of the [vscode.settings.json](vs
 
 You can manually trigger compilation by hitting the green button in the extension or using other methods provided by LaTeX Workshop.
 
-Please remove the magic comments (`% !TeX program ...`) at the top of the `main-....tex` file.
+Please remove the magic comments (`% !TeX program ...`) at the top of the `<%= filenames.main %>.tex` file.
 Although [LaTeX-Workshop supports magic comments](https://github.com/James-Yu/LaTeX-Workshop/blob/master/README.md#magic-comments), it currently does not work reliably.
 Without the magic comments, compilation works.
 
@@ -536,6 +607,7 @@ docker build -t ltg .
 
 <% break; default: -%>
 <% break; } -%>
+<% if (documentclass != "mwe") { -%>
 ## Contained Directories and Files
 
 ### Directories
@@ -816,15 +888,13 @@ We are collecting alternatives at the issue [#25](https://github.com/latextempla
 You did not setup the [plantuml package](https://www.ctan.org/pkg/plantuml) correctly.
 Please head to <https://koppor.github.io/plantuml/> for installation instructions.
 
+<% } -%>
 <% } -%>
 ## Further information
 
 <% if (documentclass == 'lncs') { -%>
 - tex.stackexchange.com questions regarding LNCS: <https://tex.stackexchange.com/questions/tagged/lncs>
-<% if (githubpublish) { -%>
-- Original LNCS demonstration (without the improvements): [llncs-dem.pdf](llncs-dem.pdf)
-- Original LNCS documentation (without the improvements): [llncs-doc.pdf](llncs-doc.pdf)
-<% } -%>
+- Original LNCS documentation (without the improvements): [llncsdoc.pdf](https://mirrors.ctan.org/macros/latex/contrib/llncs/llncsdoc.pdf) from the [llncs CTAN package](https://ctan.org/pkg/llncs). The old `llncs.dem` demonstration is no longer part of that package; the official sample paper (`samplepaper.tex`) is contained in Springer's [LaTeX2e Proceedings Templates (zip)](https://www.springer.com/gp/computer-science/lncs/conference-proceedings-guidelines).
 <% } -%>
 - Other templates: <https://latextemplates.github.io/>
 - For German users, go to <https://texfragen.de/>.
@@ -848,7 +918,7 @@ Any derived work can freely be relicensed and can omit original copyright and li
 [biblatex]: http://tex.stackexchange.com/tags/biblatex/info
 [bibtex]: https://www.ctan.org/pkg/bibtex
 [booktabs]: https://ctan.org/pkg/booktabs
-[cleveref]: https://ctan.org/pkg/cleveref
+[<%= crossref %>]: https://ctan.org/pkg/<%= crossref %>
 [csquotes]: https://www.ctan.org/pkg/csquotes
 [hypcap]: https://www.ctan.org/pkg/hypcap
 [hyperref]: https://ctan.org/pkg/hyperref

package/generators/app/templates/Texlivefile

@@ -3,6 +3,9 @@ latexindent
 latexmk
 texlogsieve
 
+<% if (githubpublish || (listings == 'listings')) { -%>
+accsupp<%# gray hook marker on soft-wrapped listings lines %>
+<% } -%>
 <% if (githubpublish || (documentclass == "acmart")) { -%>
 acmart
 <% } -%>
@@ -24,6 +27,9 @@ babel-german
 biber
 biblatex
 <% } -%>
+<% if (githubpublish || ((documentclass == "lncs") && (bibtextool == "biblatex") && !authoryear)) { -%>
+biblatex-lncs
+<% } -%>
 <% if (githubpublish || isThesis) { -%>
 bigfoot<%# provides perpage%>
 <% } -%>
@@ -42,7 +48,9 @@ cfr-lm
 <% if (githubpublish || (documentclass == "ustutt")) { -%>
 charter<%# required by mathdesign-charter%>
 <% } -%>
+<% if (githubpublish || (crossref == "cleveref")) { -%>
 cleveref
+<% } -%>
 cm-super
 <% if (githubpublish || (documentclass == "acmart")) { -%>
 cmap
@@ -63,6 +71,9 @@ datetime2-german
 dehyph-exptl
 <% } -%>
 diagbox
+<% if (githubpublish || (documentclass != "mwe")) { -%>
+embedfile
+<% } -%>
 <% if (githubpublish || isThesis) { -%>
 enumitem
 <% } -%>
@@ -99,7 +110,7 @@ fontspec
 footmisc
 <% } -%>
 gettitlestring
-<% if (githubpublish || (documentclass == 'ustutt') || (documentclass == 'scientific-thesis')) { -%>
+<% if (githubpublish || (documentclass == 'ustutt') || (documentclass == 'scientific-thesis') || (documentclass == 'mwe')) { -%>
 glossaries
 <% if (githubpublish || (lang == "en")) { -%>
 glossaries-english
@@ -131,6 +142,9 @@ ifmtarg<%# required by acmart at least %>
 ifplatform
 <% } -%>
 iftex
+<% if (githubpublish || (isPaper && reallatexcompiler.startsWith("lualatex"))) { -%>
+impnattypo
+<% } -%>
 inconsolata<%# required by ustutt, scientific-thesis, acm%>
 infwarerr
 intcalc
@@ -176,6 +190,13 @@ luaxml<%# required by spelling %>
 ly1<%# required by mathdesign-font %>
 <% } -%>
 marginnote
+<% if (githubpublish || (documentclass == "mwe")) { -%>
+markdown<%# markdown-as-input quick-start (mwe documentclass) %>
+<%# markdown's default LaTeX theme pulls these in (else e.g. "csvsimple.sty not found") %>
+csvsimple
+fancyvrb
+verse<%# used when a Markdown blockquote/verse is present %>
+<% } -%>
 <% if (githubpublish || isThesis) { -%>
 mathdesign
 <% } -%>
@@ -322,3 +343,9 @@ xpatch
 <% } -%>
 xstring<%# this includes stfloats; required by textcomp %>
 zref
+<% if (githubpublish || (documentclass == "mwe") || (crossref == "zref-clever")) { -%>
+zref-clever
+<% } -%>
+<% if (githubpublish || (isThesis && (crossref == "zref-clever"))) { -%>
+zref-vario
+<% } -%>

package/generators/app/templates/biblatex.example.en.tex

@@ -11,4 +11,4 @@ In case one wants to name the author: \textcite{mwe} shows a minimal \LaTeX{} ex
 Note that \texttt{\textbackslash textcite\{mwe\}} prints both the author and the reference to the bibliography entry.
 
 Remember that you have to call \texttt{biber <%= filenames.main %>} to generate the bibliography data for \texttt{<%= reallatexcompiler %>}.
-You will need to run \texttt{<%= reallatexcompiler %>} twice to ensure that the page numbers are updated correctly.
+You will need to run \texttt{<%= reallatexcompiler %>} twice so that the page numbers are up to date.