generator-latex-template 2026.6.26 → 2026.6.30

package/README.md

@@ -201,14 +201,23 @@ ejslint.cmd c:\git-repositories\latextemplates\generator-latex-template\generato
 
 ### Releasing a new version
 
-1. Once the `refine-ltg` PR is green, **squash-merge** it into `main`; check `main` out and pull.
-2. Update `CHANGELOG.md` (change `h2` heading etc.)
-3. Update `package.json`, publish to [npmjs](https://www.npmjs.com/package/generator-latex-template), create GitHub release.
+> **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`
    - `npx github-release-from-changelog`
-4. On `main`, run `scripts/end-new-cycle.sh`, then **squash-merge** each template's "Update LTG" PR once it is green.
+5. On `main`, run `scripts/end-new-cycle.sh`, then **squash-merge** each template's "Update LTG" PR once it is green.
 
 ## License
 

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

@@ -776,15 +776,16 @@ Just answer "(a) allow for this document" and it will work.
 4. Use [pdfscissors](https://sites.google.com/site/pdfscissors) to crop the borders and title (maybe you have to allow <https://sites.google.com> in the Java security center in the control panel).
 5. Include the PDF in LaTeX via `\includegraphics{chart_cropped.pdf}`.
 
-<%#
-### Q: Overleaf complains about missing `.sty` files.
-
-Google for the name of the `sty` and upload it to overleaf.
-As of 2018-02-17, these are:
+<% if (uml == "tikz-uml") { -%>
+### Q: Overleaf complains about a missing `tikz-uml.sty`.
 
-- `lccaps.sty` - can be downloaded from <https://latextemplates.github.io/stys-for-overleaf/>.
-- `scientific-thesis-cover.sty` - can be downloaded from <https://raw.githubusercontent.com/latextemplates/scientific-thesis-cover/master/scientific-thesis-cover.sty>.
+`tikz-uml` is not part of TeX Live; locally it is provided as a git submodule placed on the `TEXINPUTS` search path (see "UML diagram example" above).
+Overleaf does not fetch git submodules, so `tikz-uml.sty` is unavailable there.
+Download `tikz-uml.sty` from the [tikz-uml repository](https://plmlab.math.cnrs.fr/tikzuml/tikzuml) and upload it into your Overleaf project, next to your main `.tex` file; the UML example then compiles.
+Without it, the example is skipped automatically and the rest of the document still builds.
 
+<% } -%>
+<%#
 ### Q: My Paderborn title page is strange. The boxes seem to be located arbitrarily.
 
 Just run pdflatex again.

package/generators/app/templates/Texlivefile

@@ -3,15 +3,15 @@ latexindent
 latexmk
 texlogsieve
 
-amsmath
 <% if (githubpublish || (documentclass == "acmart")) { -%>
 acmart
 <% } -%>
 <% if (githubpublish || isThesis) { -%>
-algorithms
 algorithmicx<%# required by algpseudocodex%>
+algorithms
 algpseudocodex
 <% } -%>
+amsmath
 <% if (githubpublish || (lang == "de")) { -%>
 autotype
 <% } -%>
@@ -21,8 +21,8 @@ babel-english
 <%# german needed for some TeX source code input hacks -%>
 babel-german
 <% if (githubpublish || (bibtextool == "biblatex")) { -%>
-biblatex
 biber
+biblatex
 <% } -%>
 <% if (githubpublish || isThesis) { -%>
 bigfoot<%# provides perpage%>
@@ -51,14 +51,14 @@ comment<%# required by at least acm%>
 csquotes
 ctablestack
 currfile
+<% if (githubpublish || isThesis) { -%>
+datatool
+<% } -%>
 datetime2
+datetime2-english
 <% if (githubpublish || (lang == "de")) { -%>
 datetime2-german
 <% } -%>
-datetime2-english
-<% if (githubpublish || isThesis) { -%>
-datatool
-<% } -%>
 <% if (githubpublish || (lang == "de")) { -%>
 dehyph-exptl
 <% } -%>
@@ -101,20 +101,18 @@ footmisc
 gettitlestring
 <% if (githubpublish || (documentclass == 'ustutt') || (documentclass == 'scientific-thesis')) { -%>
 glossaries
-<% if (githubpublish || (lang == "de")) { -%>
-glossaries-german
-<% } -%>
 <% if (githubpublish || (lang == "en")) { -%>
 glossaries-english
 <% } -%>
 glossaries-extra
+<% if (githubpublish || (lang == "de")) { -%>
+glossaries-german
+<% } -%>
 <% } -%>
 graphics
 <% if (githubpublish || isThesis) { -%>
 helvetic
 <% } -%>
-hyphenex
-inconsolata<%# required by ustutt, scientific-thesis, acm%>
 hycolor
 hypcap
 hyperref
@@ -124,6 +122,7 @@ hyphen-english
 <% if (githubpublish || (lang == "de")) { -%>
 hyphen-german
 <% } -%>
+hyphenex
 <% if (documentclass == 'ieee') { -%>
 ieeetran
 <% } -%>
@@ -132,6 +131,7 @@ ifmtarg<%# required by acmart at least %>
 ifplatform
 <% } -%>
 iftex
+inconsolata<%# required by ustutt, scientific-thesis, acm%>
 infwarerr
 intcalc
 <% if (githubpublish || isThesis) { -%>
@@ -144,6 +144,7 @@ kvsetkeys
 latex-bin-dev
 latex-bin-dev.x86_64-linux
 <% } -%>
+lccaps
 letltxmacro
 <% if (githubpublish || (documentclass == "acmart")) { -%>
 libertine
@@ -158,10 +159,10 @@ aliascnt<%# llncs.cls requires it from TeX Live 2026 on; not a separate package
 <% } -%>
 llncs
 <% } -%>
-ltxcmds
 <% if (githubpublish || isThesis) { -%>
 lscapeenhanced
 <% } -%>
+ltxcmds
 <% if (githubpublish || (reallatexcompiler.startsWith("lualatex"))) { -%>
 luacode
 lualatex-math
@@ -208,31 +209,29 @@ newtx
 newtxtt
 nfssext-cfr
 <% } -%>
+nowidow
 <% if (githubpublish || isThesis) { -%>
 ntheorem
 <% } -%>
-nowidow
 paralist
 pdfcomment
 pdfescape
 <% if (githubpublish || isThesis) { -%>
 pdflscape
-<% } -%>
-pdftexcmds
-<% if (githubpublish || isThesis) { -%>
 pdfpages
 <% } -%>
+pdftexcmds
 <% if (githubpublish || examples) { -%>
 pgf
 pgfplots<%# used by the pgfplots example; also provides pgfplotstable %>
 <% } -%>
-<% if (githubpublish || (uml == "plantuml")) { -%>
-plantuml<%# plantuml.sty for the PlantUML UML example; the diagram also needs an external PlantUML install %>
-<% } -%>
 pict2e
 <% if (githubpublish || (documentclass == "ustutt")) { -%>
 placeins
 <% } -%>
+<% if (githubpublish || (uml == "plantuml")) { -%>
+plantuml<%# plantuml.sty for the PlantUML UML example; the diagram also needs an external PlantUML install %>
+<% } -%>
 <% if ((documentclass == 'acmart') || (documentclass == 'ieee')) { -%>
 preprint<%# this includes balance%>
 <% } -%>
@@ -277,9 +276,10 @@ svn-prov<%# at least required by acmart, ustutt, scientific-thesis%>
 tabto-ltx
 <% } -%>
 tcolorbox
+tex-gyre<%# at least required by acm, ieee, font config "times"; provides ts1-qtmr %>
 texcount
 texlogsieve
-tex-gyre<%# at least required by acm, ieee, font config "times"; provides ts1-qtmr %>
+textcase<%# required by lccaps %>
 <% if (githubpublish || isThesis) { -%>
 tikzmark
 <% } -%>
@@ -313,8 +313,8 @@ xcharter
 <% } -%>
 xcolor
 <% if (githubpublish || isThesis) { -%>
-xifthen
 xfor
+xifthen
 <% } -%>
 xkeyval
 <% if (githubpublish || (documentclass == "ieee") || (font == "times")) { -%>

package/generators/app/templates/dot.aspell.de.pws

@@ -1,4 +1,4 @@
-personal_ws-1.1 en 122 utf-8
+personal_ws-1.1 de 122 utf-8
 ACM
 Atlantic
 BPEL

package/generators/app/templates/lccaps.preamble.en.tex

@@ -0,0 +1,3 @@
+% lccaps provides \textlcc (lowercase caps), used by \initialism in commands.tex.
+% Doc: https://ctan.org/pkg/lccaps
+\usepackage{lccaps}

package/generators/app/templates/main.de.tex

@@ -325,6 +325,7 @@
   AROMA TOSCA BPMN OASIS OMG DMTF IT DevOps
 }
 
+<%- include('lccaps.preamble.en.tex', this); -%>
 \input{commands}
 <% switch (documentclass) { case "acmart": -%>
 

package/generators/app/templates/main.en.tex

@@ -303,6 +303,7 @@
   AROMA TOSCA BPMN OASIS OMG DMTF IT DevOps
 }
 
+<%- include('lccaps.preamble.en.tex', this); -%>
 \input{commands}
 <% switch (documentclass) { case "acmart": -%>
 

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

@@ -15,3 +15,10 @@ Brackets work as designed:
 <test>
 One can also input backticks in verbatim text: \verb|`test`|.
 <%- eexample %>
+
+Acronyms can be typeset in running text with \verb+\initialism+, which sets them as small caps that blend into the surrounding lowercase text. It is the lightweight alternative to the full acronym and glossary management (\verb+\gls+, with an automatic list of abbreviations) provided by the thesis variants: \verb+\initialism+ only typesets the acronym and does not add it to any list. The macro and a few ready-made acronyms (\verb+\OMG+, \verb+\BPEL+, \verb+\BPMN+, \verb+\UML+) are defined in \texttt{commands.tex}, where you can add your own.
+
+<%- bexample %>
+The \UML is maintained by the \OMG; related standards include \BPEL and \BPMN.
+Any acronym can be set inline with \initialism{REST} or \initialism{HTTP}.
+<%- eexample %>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-latex-template",
-  "version": "2026.6.26",
+  "version": "2026.6.30",
   "description": "Generates a latex template to be used as start for writing scientific works (papers, articles, theses)",
   "homepage": "https://github.com/latextemplates/generator-latex-template",
   "author": {