ci: Build helpers on push [skip ci]

This reverts commit e16e4b3e7b.

.gitea/workflows/update-docs.yml

@@ -0,0 +1,35 @@
+name: Update docs
+on:
+  push:
+    paths:
+      - 'docs/**'
+jobs:
+  build_docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Git repository
+        uses: actions/checkout@v6
+      - name: Sign into gitea registry
+        uses: https://github.com/docker/login-action@v3
+        with:
+          username: ${{ vars.REGISTRY_USER_USERNAME }}
+          password: ${{ secrets.REGISTRY_USER_PASSWORD }}
+          registry: ${{ vars.REGISTRY_BASE_URL }}
+      - name: Run format of docs
+        uses: actions/latex-format@main
+        with:
+          workdir: docs
+      - name: Run build
+        uses: actions/latex-full@main
+        with:
+          workdir: docs
+          # include_helpers: true
+      - name: Upload compiled docs
+        uses: actions/git-auto-commit-action@v7
+        with:
+          commit_message: "ci: Build docs on push [skip ci]"
+          file_pattern: '*.pdf'
+          commit_user_name: LaTeX compiler [bot]
+          commit_user_email: actions@janishutz.com
+          commit_author: LaTeX compiler [bot] <actions@janishutz.com>
+          push_options: "--force"

.gitea/workflows/update-helpers.yml

@@ -0,0 +1,36 @@
+name: Update helpers
+on:
+  push:
+    paths:
+      - 'src/**'
+      - 'config/**'
+jobs:
+  build_helpers:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Git repository
+        uses: actions/checkout@v6
+      - name: Sign into gitea registry
+        uses: https://github.com/docker/login-action@v3
+        with:
+          username: ${{ vars.REGISTRY_USER_USERNAME }}
+          password: ${{ secrets.REGISTRY_USER_PASSWORD }}
+          registry: ${{ vars.REGISTRY_BASE_URL }}
+      - name: Run format of main
+        uses: actions/latex-format@main
+        with:
+          workdir: main
+      - name: Run format of extra
+        uses: actions/latex-format@main
+        with:
+          workdir: extra
+      - name: Run build
+        run: ./build.sh
+      - name: Upload compiled helpers
+        uses: actions/git-auto-commit-action@v7
+        with:
+          commit_message: "ci: Build helpers on push [skip ci]"
+          commit_user_name: Helpers compiler [bot]
+          commit_user_email: actions@janishutz.com
+          commit_author: Helpers compiler [bot] <actions@janishutz.com>
+          push_options: "--force"

README.md

@@ -3,15 +3,14 @@
     <h1>LaTeX Helper files</h1>
 </div>
 
+![Docs build](https://git.janishutz.com/janishutz/latex/actions/workflows/build-docs.yml/badge.svg?branch=main&event=push)
+![Dist build](https://git.janishutz.com/janishutz/latex/actions/workflows/build-helpers.yml/badge.svg?branch=main&event=push)
+
 This repository contains a collection of LaTeX files, helping you get started with LaTeX quickly.
 
 
-# New import scheme
-I have done some tweaks to support a new import scheme, making imports much more flexible
-
-
 # Getting started
-See the docs [here](https://git.janishutz.com/janishutz/latex/src/branch/main/docs/docs.pdf) to get started.
+See the docs [here](https://git.janishutz.com/janishutz/latex/raw/branch/main/docs/docs.pdf) to get started.
 
 
 # Recommended LaTeX editors
@@ -26,4 +25,4 @@ The editors are ordered in terms of ease of use and my personal preference list
     <a href="https://store.janishutz.com/donate" target="_blank"><img src="https://store-cdn.janishutz.com/static/support-me.jpg" width="150px"></a>
 </div>
 
-[LaTeX helper files](https://git.janishutz.com/janishutz/latex) © 2025 by [Janis Hutz](https://janishutz.com) is licensed under [Creative Commons Attribution-NonCommercial 4.0 International](https://creativecommons.org/licenses/by-nc/4.0/)
+[LaTeX helper files](https://git.janishutz.com/janishutz/latex) © 2026 by [Janis Hutz](https://janishutz.com) is licensed under [Creative Commons Attribution-NonCommercial 4.0 International](https://creativecommons.org/licenses/by-nc/4.0/)

build/build.py

@@ -1,5 +1,4 @@
 import os
-from typing import List
 import labels
 import datetime
 import sys
@@ -25,7 +24,7 @@ except:
     pass
 
 
-def load_all_files_of_array(dirname: str, files: List[str]):
+def load_all_files_of_array(dirname: str, files: list[str]):
     data = ""
     for filename in files:
         with open(dirname + "/" + filename, "r") as file:

build/labels.py

@@ -49,7 +49,7 @@ def generate_labels():
                 fill={label}color!75!black
             ] at (frame.north east)
             {{
-                \\large \\tr{{\\{label}NamingEN}}{{\\{label}NamingDE}}\\printLabel{{{label}}}
+                \\large \\tcbDescriptorTemplate{{{label}}}{{\\printLabel{{{label}}}}}
             }};
         }}, #1
     }}\n\n"""

config/main.sty

@@ -9,16 +9,22 @@
 % ┌                                                ┐
 % │                   Rendering                    │
 % └                                                ┘
+% This is used to render the optional name argument in the descriptors
+% Updating this function only has an effect if you are using the
+% unmodified templates below or have updated them, but still use this function
+\newcommand{\descriptorNameDisplay}[1]{\textit{(#1)}}
+
 % Specify how the inline and short descriptors (e.g. Lemma, etc) are rendered. 
 % - #1 is the name of the descriptor
 % - #2 is the number (correctly rendered according to settings and preceded with space if not disabled)
 % - #3 is the name passed (non-empty asserted)
-\newcommand{\shortDescriptorTemplate}[3]{\bg{#1color}{\shortNamingTranslate{#1} #2} \textit{(#3)}}
+\newcommand{\shortDescriptorTemplate}[3]{\bg{#1color}{\shortNamingTranslate{#1} #2} \descriptorNameDisplay{#3}}
-\newcommand{\inlineDescriptorTemplate}[3]{\bg{#1color}{\namingTranslate{#1} #2}: \textit{(#3)}}
+\newcommand{\inlineDescriptorTemplate}[3]{\bg{#1color}{\namingTranslate{#1} #2} \descriptorNameDisplay{#3}}
 
 % These are used if no name is provided and argument #4 from above is the missing argument
 \newcommand{\anonymousShortDescriptorTemplate}[2]{\bg{#1color}{\shortNamingTranslate{#1} #2}\ }
 \newcommand{\anonymousInlineDescriptorTemplate}[2]{\bg{#1color}{\namingTranslate{#1} #2}\ }
+\newcommand{\tcbDescriptorTemplate}[2]{\namingTranslate{#1} #2}
 
 % background command config (draws a small box around the content)
 \newcommand{\backgroundPadding}{2pt}

config/naming.sty

@@ -1,6 +1,11 @@
 % ┌                                                ┐
 % │                     Naming                     │
 % └                                                ┘
+\newcommand{\atExamNamingEN}{At exam}
+\newcommand{\atExamNamingDE}{An Prüfung}
+\newcommand{\howtotextEN}{How To:}
+\newcommand{\howtotextDE}{How To:}
+
 % Here you may specify how each descriptor is named
 \newcommand{\definitionNamingEN}{Definition}
 \newcommand{\theoremNamingEN}{Theorem}

docs/docs.tex

@@ -7,6 +7,7 @@
 \begin{document}
 \startDocument
 
+
 % ── Title page ──────────────────────────────────────────────────────
 
 \vspace{2cm}
@@ -36,6 +37,7 @@
 % └                                                ┘
 \input{./parts/intro.tex}
 \input{./parts/usage.tex}
+\input{./parts/beamer.tex}
 \input{./parts/migration.tex}
 
 

docs/parts/beamer.tex

@@ -0,0 +1,7 @@
+\section{Beamer}
+\LaTeX Beamer can be used to create presentations. The official user guide can be found \hlhref{https://mirrors.ctan.org/macros/latex/contrib/beamer/doc/beameruserguide.pdf}{here}
+and a simple introduction by overleaf can be found \hlhref{https://www.overleaf.com/learn/latex/Beamer}{here}.
+
+These helpers should mostly work in conjunction with beamer, you should however \bi{absolutely not} use the setup commands, as they are specifically meant for the \textit{article} class.
+
+If you use the snippets, a basic setup for beamer is provided that also includes the helpers.

docs/parts/intro.tex

@@ -20,4 +20,3 @@ The docs contain a section (section \ref{sec:migration}) on migrating from V1.X
 You can install these helper files by downloading this repo and storing it to any location on your PC, remembering where that location is.
 
 You may also install the VSCode snippets found in the vscode-snippets folder. These snippets provide autocompletion for many of the commands that this helper file provides.
-

docs/parts/reference/loading.tex

@@ -51,6 +51,7 @@
 	\item \verb|\startDocument| Initialize the document. Has to be called after \verb|\begin{document}|
 	\item \verb|\translate|\{\textit{string}\}\{\textit{string}\} First \textit{string} is English, second \textit{string} is German. Switches automatically based on language selected
 	\item \verb|\tr|\{\textit{string}\}\{\textit{string}\} Shorthand for \verb|\translate|
+	\item \verb|\safetr|\{\textit{string}\}\{\textit{string}\} Shorthand for \verb|\translate|, safe to use in section titles
 	\item \verb|\numberingOn| Turn on the numbering (if previously turned off using \verb|\numberingOff| or set in the config)
 	\item \verb|\numberingOff| Turn off the numbering (useful to temporarily turn off numbering)
 \end{itemize}

docs/parts/troubleshooting.tex

@@ -20,5 +20,11 @@ You have set the \textit{scope} to \texttt{full}, which loads the \texttt{minted
 \subsubsection{You must have pygmentize installed}
 Your host system is lacking the \texttt{pygmentize} package or you have not added the \texttt{pip} path to your \$PATH. This is also the reason as to why the \texttt{-shell-escape} flag has to be set, as minted needs to access external libraries (namely \texttt{pygmentize}) to do the syntax highlighting.
 
+\subsection{Undefined command equal}
+If you see an error like this, you likely are using either \verb|\translate| or \verb|\tr| in a \verb|\section| or similar command.
+Due to the way \LaTeX\ code is evaluated, you should prefer using \verb|\safetr| instead,
+which uses \texttt{etoolbox}'s \verb|\protecting| command to stop this issue from occurring
+
 \subsection{Any other error}
 Ensure that you are not missing any closing brackets or a math environment is still open. If nothing helps, contact support at \url{https://support.janishutz.com}
+

docs/parts/usage.tex

@@ -31,7 +31,8 @@ Each of the options can also be overridden directly on a per-document
 
 
 \subsection{Letters}
-Letters require a different setup compared to a normal \LaTeX document:
+Letters require a different setup compared to a normal \LaTeX document.
+Be also aware that the usual commands featured by the helpers are \textit{not} available when using the letter helpers.
 
 \begin{minted}{latex}
 \documentclass[12pt,a4paper]{scrlttr2}

src/core.sty

@@ -27,12 +27,17 @@
 \RequirePackage{etoolbox}
 \RequirePackage{makecell}
 \RequirePackage{parskip}
+\RequirePackage{titlesec}
+\RequirePackage{centernot}
+\RequirePackage{todonotes}
+\RequirePackage{epigraph}
+\RequirePackage{bm}
 
 \newcounter{descriptorShadeStrength}
 \newcounter{shadeStrength}
 \newcommand{\currentLanguage}{en}
 
-\setcounter{secnumdepth}{4}
+\setcounter{secnumdepth}{5}
 
 \newcommand{\printTranslationOptionEN}[1]{\csname #1NamingEN\endcsname}
 \newcommand{\printTranslationOptionDE}[1]{\csname #1NamingDE\endcsname}
@@ -46,3 +51,6 @@
     \usepackage[ngerman]{babel}
     \renewcommand{\currentLanguage}{de}
 }
+
+\newlist{todolist}{itemize}{2}
+\setlist[todolist]{label=$\square$}

src/core/cs.sty

@@ -14,9 +14,9 @@
 
 \newcommand{\Indent}{\hspace{\algorithmicindent}}
 
-\newcommand{\tct}[1]{\Theta\left(#1\right)}
+\newcommand{\tct}[1]{\ensuremath{\Theta\left(#1\right)}}
-\newcommand{\tco}[1]{\mathcal{O}\left(#1\right)}
+\newcommand{\tco}[1]{\ensuremath{\mathcal{O}\left(#1\right)}}
-\newcommand{\tcl}[1]{\Omega\left(#1\right)}
+\newcommand{\tcl}[1]{\ensuremath{\Omega\left(#1\right)}}
 \newcommand{\wordbool}{(\Sigma_{\text{bool}})^*}
 \newcommand{\words}[1]{(\Sigma_{\text{#1}})^*}
 \newcommand{\word}{\Sigma^*}

src/core/glossary.sty

@@ -6,6 +6,20 @@
 	\makenoidxglossaries
 }
 
+\newcommand{\highlightglossaryref}[1]{\textbf{#1}}
+\newcommand{\setGlossaryMarkup}{
+    \let\glsraw\gls
+    \let\glsplraw\glspl
+    \let\Glsraw\Gls
+    \let\Glsplraw\Glspl
+    \let\acrshortraw\acrshort
+	\expandafter\renewcommand{\gls}[1]{\highlightglossaryref{\glsraw{##1}}}
+	\expandafter\renewcommand{\glspl}[1]{\highlightglossaryref{\glsplraw{##1}}}
+	\expandafter\renewcommand{\Gls}[1]{\highlightglossaryref{\Glsraw{##1}}}
+	\expandafter\renewcommand{\Glspl}[1]{\highlightglossaryref{\Glsplraw{##1}}}
+	\expandafter\renewcommand{\acrshort}[1]{\highlightglossaryref{\acrshortraw{##1}}}
+}
+
 \newcommand{\printGlossary}{
 	\glsaddall
 	\printnoidxglossaries

src/core/math.sty

@@ -3,60 +3,60 @@
 % └                                                ┘
 
 % BB shortcuts (for number spaces, etc)
-\newcommand{\A}{\mathbb{A}}
+\newcommand{\A}{\ensuremath{\mathbb{A}}}
-\newcommand{\B}{\mathbb{B}}
+\newcommand{\B}{\ensuremath{\mathbb{B}}}
-\newcommand{\C}{\mathbb{C}}
+\newcommand{\C}{\ensuremath{\mathbb{C}}}
-\newcommand{\D}{\mathbb{D}}
+\newcommand{\D}{\ensuremath{\mathbb{D}}}
-\newcommand{\E}{\mathbb{E}}
+\newcommand{\E}{\ensuremath{\mathbb{E}}}
-\newcommand{\F}{\mathbb{F}}
+\newcommand{\F}{\ensuremath{\mathbb{F}}}
-\newcommand{\G}{\mathbb{G}}
+\newcommand{\G}{\ensuremath{\mathbb{G}}}
-\renewcommand{\H}{\mathbb{H}}
+\renewcommand{\H}{\ensuremath{\mathbb{H}}}
-\newcommand{\I}{\mathbb{I}}
+\newcommand{\I}{\ensuremath{\mathbb{I}}}
-\newcommand{\J}{\mathbb{J}}
+\newcommand{\J}{\ensuremath{\mathbb{J}}}
-\newcommand{\K}{\mathbb{K}}
+\newcommand{\K}{\ensuremath{\mathbb{K}}}
-\renewcommand{\L}{\mathbb{L}}
+\renewcommand{\L}{\ensuremath{\mathbb{L}}}
-\newcommand{\M}{\mathbb{M}}
+\newcommand{\M}{\ensuremath{\mathbb{M}}}
-\newcommand{\N}{\mathbb{N}}
+\newcommand{\N}{\ensuremath{\mathbb{N}}}
-\renewcommand{\O}{\mathbb{O}}
+\renewcommand{\O}{\ensuremath{\mathbb{O}}}
-\renewcommand{\P}{\mathbb{P}}
+\renewcommand{\P}{\ensuremath{\mathbb{P}}}
-\newcommand{\Q}{\mathbb{Q}}
+\newcommand{\Q}{\ensuremath{\mathbb{Q}}}
-\newcommand{\R}{\mathbb{R}}
+\newcommand{\R}{\ensuremath{\mathbb{R}}}
-\renewcommand{\S}{\mathbb{S}}
+\renewcommand{\S}{\ensuremath{\mathbb{S}}}
-\newcommand{\T}{\mathbb{T}}
+\newcommand{\T}{\ensuremath{\mathbb{T}}}
-\newcommand{\U}{\mathbb{U}}
+\newcommand{\U}{\ensuremath{\mathbb{U}}}
-\newcommand{\V}{\mathbb{V}}
+\newcommand{\V}{\ensuremath{\mathbb{V}}}
-\newcommand{\W}{\mathbb{W}}
+\newcommand{\W}{\ensuremath{\mathbb{W}}}
-\newcommand{\X}{\mathbb{X}}
+\newcommand{\X}{\ensuremath{\mathbb{X}}}
-\newcommand{\Y}{\mathbb{Y}}
+\newcommand{\Y}{\ensuremath{\mathbb{Y}}}
-\newcommand{\Z}{\mathbb{Z}}
+\newcommand{\Z}{\ensuremath{\mathbb{Z}}}
 
 % Caligraphic
-\newcommand{\cA}{\mathcal{A}}
+\newcommand{\cA}{\ensuremath{\mathcal{A}}}
-\newcommand{\cB}{\mathcal{B}}
+\newcommand{\cB}{\ensuremath{\mathcal{B}}}
-\newcommand{\cC}{\mathcal{C}}
+\newcommand{\cC}{\ensuremath{\mathcal{C}}}
-\newcommand{\cD}{\mathcal{D}}
+\newcommand{\cD}{\ensuremath{\mathcal{D}}}
-\newcommand{\cE}{\mathcal{E}}
+\newcommand{\cE}{\ensuremath{\mathcal{E}}}
-\newcommand{\cF}{\mathcal{F}}
+\newcommand{\cF}{\ensuremath{\mathcal{F}}}
-\newcommand{\cG}{\mathcal{G}}
+\newcommand{\cG}{\ensuremath{\mathcal{G}}}
-\newcommand{\cH}{\mathcal{H}}
+\newcommand{\cH}{\ensuremath{\mathcal{H}}}
-\newcommand{\cI}{\mathcal{I}}
+\newcommand{\cI}{\ensuremath{\mathcal{I}}}
-\newcommand{\cJ}{\mathcal{J}}
+\newcommand{\cJ}{\ensuremath{\mathcal{J}}}
-\newcommand{\cK}{\mathcal{K}}
+\newcommand{\cK}{\ensuremath{\mathcal{K}}}
-\newcommand{\cL}{\mathcal{L}}
+\newcommand{\cL}{\ensuremath{\mathcal{L}}}
-\newcommand{\cM}{\mathcal{M}}
+\newcommand{\cM}{\ensuremath{\mathcal{M}}}
-\newcommand{\cN}{\mathcal{N}}
+\newcommand{\cN}{\ensuremath{\mathcal{N}}}
-\newcommand{\cO}{\mathcal{O}}
+\newcommand{\cO}{\ensuremath{\mathcal{O}}}
-\newcommand{\cP}{\mathcal{P}}
+\newcommand{\cP}{\ensuremath{\mathcal{P}}}
-\newcommand{\cQ}{\mathcal{Q}}
+\newcommand{\cQ}{\ensuremath{\mathcal{Q}}}
-\newcommand{\cR}{\mathcal{R}}
+\newcommand{\cR}{\ensuremath{\mathcal{R}}}
-\newcommand{\cS}{\mathcal{S}}
+\newcommand{\cS}{\ensuremath{\mathcal{S}}}
-\newcommand{\cT}{\mathcal{T}}
+\newcommand{\cT}{\ensuremath{\mathcal{T}}}
-\newcommand{\cU}{\mathcal{U}}
+\newcommand{\cU}{\ensuremath{\mathcal{U}}}
-\newcommand{\cV}{\mathcal{V}}
+\newcommand{\cV}{\ensuremath{\mathcal{V}}}
-\newcommand{\cW}{\mathcal{W}}
+\newcommand{\cW}{\ensuremath{\mathcal{W}}}
-\newcommand{\cX}{\mathcal{X}}
+\newcommand{\cX}{\ensuremath{\mathcal{X}}}
-\newcommand{\cY}{\mathcal{Y}}
+\newcommand{\cY}{\ensuremath{\mathcal{Y}}}
-\newcommand{\cZ}{\mathcal{Z}}
+\newcommand{\cZ}{\ensuremath{\mathcal{Z}}}
 
 % other useful shortcuts
 \newcommand{\elementstack}[2]{\genfrac{}{}{0pt}{}{#1}{#2}}
@@ -86,8 +86,8 @@
 \newcommand{\limhz}{\limit{h}{0}}
 \newcommand{\liminfni}{\liminf_{n \rightarrow \infty}}
 \newcommand{\limsupni}{\limsup_{n \rightarrow \infty}}
-\newcommand{\sequence}[1]{(#1_n)_{n \geq 1}}
+\newcommand{\sequence}[1]{\ensuremath{(#1_n)_{n \geq 1}}}
-\newcommand{\series}[2]{\sum_{k = 1}^{#2} #1_k}
+\newcommand{\series}[2]{\ensuremath{\sum_{k = 1}^{#2} #1_k}}
 
 \DeclareMathOperator\arctanh{arctanh}
 \DeclareMathOperator\arccosh{arccosh}

src/core/setup.sty

@@ -34,15 +34,15 @@
 
 
 % Set up the latex document for exam summaries (Extra wide body, small margins, no header)
-\newcommand{\setupCheatSheet}[2][true]{
+\newcommand{\setupCheatSheet}[2][1cm]{
-    \ifthenelse{\equal{#1}{true}}{
+    \ifthenelse{\equal{#1}{false}}{
+        \RequirePackage[a4paper,textwidth=28.5cm,textheight=20cm]{geometry}
+    }{
         \RequirePackage[a4paper,textwidth=28.5cm,textheight=20cm,landscape]{geometry}
         \RequirePackage{flowfram}
         \ffvadjustfalse
-        \setlength{\columnsep}{1cm}
+        \setlength{\columnsep}{#1}
         \Ncolumn{3}
-    }{
-        \RequirePackage[a4paper,textwidth=28.5cm,textheight=20cm]{geometry}
     }
     \title{\Huge \textbf{#2}}
     \author{\authorTitle}

src/core/translation.sty

@@ -5,6 +5,7 @@
     \ifthenelse{\equal{\currentLanguage}{en}}{#1}{#2}%
 }
 \newcommand{\tr}[2]{\translate{#1}{#2}}
+\newcommand{\safetr}[2]{\protecting{\translate{#1}{#2}}}
 \newcommand{\namingTranslate}[1]{\translate{\printTranslationOptionEN{#1}}{\printTranslationOptionDE{#1}}}
 \newcommand{\shortNamingTranslate}[1]{\translate{\printShortTranslationOptionEN{#1}}{\printShortTranslationOptionDE{#1}}}
 

src/counters/generator.sty

@@ -3,7 +3,9 @@
 \newcommand{\printCounter}[1]{\refstepcounter{#1}\csname the#1\endcsname}
 
 \newcommand{\printLabel}[1]{%
-    \ifthenelse{\boolean{numberingDisabled}}{}{%
+    \ifthenelse{\boolean{numberingDisabled}}{%
+%
+    }{%
         \ifcsdef{#1numbering}{% Extra config present
             \ifthenelse{\equal{\printNumberingConfigForDescriptor{#1}}{default}}{%
                 \labelPrintBackendRoutine{#1}%
@@ -13,7 +15,9 @@
                 }{%
                     \ifthenelse{\equal{\printNumberingConfigForDescriptor{#1}}{combined}}{%
                         \printCounter{combined\subsectionnumbering}%
-                    }{}%
+                    }{%
+%
+                    }%
                 }%
             }%
         }{%
@@ -25,9 +29,11 @@
 \newcommand{\labelPrintBackendRoutine}[1]{%
     \ifthenelse{\equal{\numberingpreset}{combined}}{%
         \printCounter{combined\subsectionnumbering}%
-    }{
+    }{%
         \ifthenelse{\equal{\numberingpreset}{separate}}{%
             \printCounter{#1\subsectionnumbering}%
-        }{}%
+        }{%
+%
+        }%
     }%
 }

src/style.sty

@@ -30,6 +30,11 @@
 \newcommand{\bi}[1]{\textbf{\textit{#1}}}
 \renewcommand{\quote}[1]{``\textit{#1}''}
 
+% Epigraph (quotes)
+\setlength\epigraphwidth{0.5\columnwidth}
+\renewcommand{\epigraphflush}{center}
+\newcommand{\fancyquote}[2]{\epigraph{``#1''}{\textit{\textendash\ #2}}}
+
 % Add a color shade (similar to \fhlc, but nicer boxes)
 \newcommand{\background}[3]{%
     \tcbox[on line,
@@ -80,3 +85,34 @@
 
 % Same for urls (just one arg tho)
 \newcommand{\hlurl}[1]{\color{MidnightBlue}\fbox{\url{#1}}\color{black}}
+
+\makeatletter
+\renewcommand\paragraph{%
+    \@startsection{paragraph}{4}{0mm}%
+    {-0.5\parskip}%
+    {0.25\parskip}%
+    {\normalfont\normalsize\bfseries}}
+\makeatother
+
+\makeatletter
+\renewcommand\subparagraph{%
+    \@startsection{subparagraph}{5}{0mm}%
+    {-0.2\parskip}%
+    {0.1\parskip}%
+    {\normalfont\small\bfseries}}
+\makeatother
+
+% Small color boxes
+\newcommand\coloredbox[3]{%
+    \par\smallskip\noindent
+    \colorbox{#1!20}{%
+        \begin{minipage}{\dimexpr\linewidth-3\fboxsep-1pt\relax}%
+            \textbf{#2}\par\smallskip #3%
+        \end{minipage}
+    }%
+    \par\smallskip
+}
+
+\newcommand\howto[2]{%
+    \coloredbox{gray}{\tr{\howtotextEN}{\howtotextDE}\ #1}{#2}%
+}

src/style/environments-descriptors.sty

@@ -46,6 +46,8 @@
 
 \newcommand{\inlineproof}[1][NONAME]{\unnumberedInline[#1]{proof}}
 \newcommand{\inlineterm}[1][NONAME]{\unnumberedInline[#1]{term}}
+\newcommand{\inlinenotation}[1][NONAME]{\unnumberedInline[#1]{notation}}
 
 \newcommand{\shortproof}[1][NONAME]{\unnumberedShort[#1]{proof}}
 \newcommand{\shortterm}[1][NONAME]{\unnumberedShort[#1]{term}}
+\newcommand{\shortnotation}[1][NONAME]{\unnumberedShort[#1]{notation}}

src/style/spacing.sty

@@ -1,4 +1,8 @@
 \newcommand{\noverticalspacing}{
+    \titlespacing*{\section}{0pt}{2pt plus 2pt minus 1pt}{2pt plus 2pt minus 2pt}
+    \titlespacing*{\subsection}{0pt}{1pt plus 2pt minus 1pt}{1pt plus 2pt minus 1pt}
+    \titlespacing*{\subsubsection}{0pt}{1pt plus 1pt minus 1pt}{1pt plus 1pt minus 1pt}
+    \titlespacing*{\paragraph}{0pt}{0pt plus 1pt minus 0pt}{1pt plus 0pt minus 1pt}
     \abovedisplayskip 1pt plus 2pt minus 1pt
     \belowdisplayskip 1pt plus 2pt minus 1pt
     \abovedisplayshortskip -10pt
@@ -6,10 +10,15 @@
     \floatsep 1pt plus 2pt minus 1pt
     \intextsep 1pt plus 2pt minus 1pt
     \textfloatsep 1pt plus 2pt minus 1pt
+    \multicolsep 1pt plus 2pt minus 1pt
     \abovecaptionskip 2pt
     \setlist{noitemsep,topsep=1pt,partopsep=0pt}
 }
 \newcommand{\smallverticalspacing}{
+    \titlespacing*{\section}{0pt}{4pt plus 3pt minus 2pt}{3pt plus 2pt minus 1pt}
+    \titlespacing*{\subsection}{0pt}{3pt plus 2pt minus 1pt}{2pt plus 2pt minus 0pt}
+    \titlespacing*{\subsubsection}{0pt}{2pt plus 2pt minus 1pt}{2pt plus 1pt minus 0pt}
+    \titlespacing*{\paragraph}{0pt}{1pt plus 1pt minus 1pt}{1pt plus 0pt minus 0pt}
     \abovedisplayskip 4pt plus 3pt minus 2pt
     \belowdisplayskip 5pt plus 5pt minus 2pt
     \abovedisplayshortskip -5pt
@@ -17,10 +26,15 @@
     \floatsep 4pt plus 3pt minus 2pt
     \intextsep 4pt plus 3pt minus 2pt
     \textfloatsep 4pt plus 3pt minus 2pt
+    \multicolsep 4pt plus 3pt minus 2pt
     \abovecaptionskip 4pt
-    \setlist{itemsep=2pt,topsep=2pt,partopsep=1pt}
+    \setlist{itemsep=-5pt,topsep=2pt,partopsep=1pt}
 }
 \newcommand{\mediumverticalspacing}{
+    \titlespacing*{\section}{0pt}{6pt plus 2pt minus 2pt}{4pt plus 2pt minus 2pt}
+    \titlespacing*{\subsection}{0pt}{4pt plus 2pt minus 2pt}{3pt plus 2pt minus 1pt}
+    \titlespacing*{\subsubsection}{0pt}{3pt plus 1pt minus 1pt}{2pt plus 1pt minus 0pt}
+    \titlespacing*{\paragraph}{0pt}{2pt plus 1pt minus 1pt}{1pt plus 0pt minus 0pt}
     \abovedisplayskip 7pt plus 4pt minus 3pt
     \belowdisplayskip 9pt plus 6pt minus 3pt
     \abovedisplayshortskip 0pt
@@ -28,10 +42,15 @@
     \floatsep 7pt plus 4pt minus 3pt
     \intextsep 7pt plus 4pt minus 3pt
     \textfloatsep 7pt plus 4pt minus 3pt
+    \multicolsep 7pt plus 4pt minus 3pt
     \abovecaptionskip 7pt
-    \setlist{itemsep=4pt,topsep=4pt,partopsep=2pt}
+    \setlist{itemsep=-2pt,topsep=3pt,partopsep=2pt}
 }
 \newcommand{\largeverticalspacing}{
+    \titlespacing*{\section}{0pt}{8pt plus 2pt minus 4pt}{5pt plus 2pt minus 3pt}
+    \titlespacing*{\subsection}{0pt}{6pt plus 2pt minus 3pt}{4pt plus 2pt minus 2pt}
+    \titlespacing*{\subsubsection}{0pt}{4pt plus 1pt minus 2pt}{3pt plus 1pt minus 1pt}
+    \titlespacing*{\paragraph}{0pt}{3pt plus 1pt minus 1pt}{2pt plus 1pt minus 1pt}
     \abovedisplayskip 13pt plus 5pt minus 4pt
     \belowdisplayskip 15pt plus 9pt minus 6pt
     \abovedisplayshortskip 5pt plus 2pt minus 3pt
@@ -39,6 +58,19 @@
     \floatsep 12pt plus 5pt minus 4pt
     \intextsep 12pt plus 5pt minus 4pt
     \textfloatsep 12pt plus 5pt minus 4pt
+    \multicolsep 12pt plus 5pt minus 4pt
     \abovecaptionskip 10pt
-    \setlist{itemsep=6pt,topsep=6pt,partopsep=2pt}
+    \setlist{itemsep=0pt,topsep=4pt,partopsep=2pt}
+}
+\newcommand{\summaryspacing}{
+    \abovedisplayskip 3pt plus 2pt minus 1pt
+    \belowdisplayskip 2pt plus 2pt minus 1pt
+    \abovedisplayshortskip -5pt
+    \belowdisplayshortskip 3pt plus 2pt minus 1pt
+    \floatsep 3pt plus 2pt minus 1pt
+    \intextsep 2pt plus 2pt minus 1pt
+    \textfloatsep 2pt plus 2pt minus 1pt
+    \multicolsep 2pt plus 2pt minus 1pt
+    \abovecaptionskip 4pt
+    \setlist{noitemsep,topsep=2pt,partopsep=0pt}
 }

src/style/tcb.sty

@@ -3,41 +3,43 @@
 % └                                                ┘
 
 \newtcolorbox{recall}[2][]{mainboxstyle,colback=recallcolor!5!white,colframe=recallcolor!75!black,colbacktitle=recallcolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=recallcolor!75!black,fill=recallcolor!75!black] at (frame.north east) {\large \translate{Recall }{Repetition }};},#1}
+    overlay={\node[overlaystyle,draw=recallcolor!75!black,fill=recallcolor!75!black] at (frame.north east) {\large \namingTranslate{recall}};},#1}
 
 \newtcolorbox{properties}[2][]{mainboxstyle,colback=propertiescolor!5!white,colframe=propertiescolor!75!black,colbacktitle=propertiescolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=propertiescolor!75!black,fill=propertiescolor!75!black] at (frame.north east) {\large \translate{Properties }{Eigenschaften }};},#1}
+    overlay={\node[overlaystyle,draw=propertiescolor!75!black,fill=propertiescolor!75!black] at (frame.north east) {\large \namingTranslate{properties}};},#1}
 
 \newtcolorbox{restrictions}[2][]{mainboxstyle,colback=propertiescolor!5!white,colframe=propertiescolor!75!black,colbacktitle=propertiescolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=propertiescolor!75!black,fill=propertiescolor!75!black] at (frame.north east) {\large \translate{Restrictions }{Einschränkungen }};},#1}
+    overlay={\node[overlaystyle,draw=propertiescolor!75!black,fill=propertiescolor!75!black] at (frame.north east) {\large \namingTranslate{restrictions}};},#1}
 
 \newtcolorbox{limitations}[2][]{mainboxstyle,colback=propertiescolor!5!white,colframe=propertiescolor!75!black,colbacktitle=propertiescolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=propertiescolor!75!black,fill=propertiescolor!75!black] at (frame.north east) {\large \translate{Limitations }{Limitierungen }};},#1}
+    overlay={\node[overlaystyle,draw=propertiescolor!75!black,fill=propertiescolor!75!black] at (frame.north east) {\large \namingTranslate{limitations}};},#1}
 
 \newtcolorbox{intuition}[2][]{mainboxstyle,colback=intuitioncolor!5!white,colframe=intuitioncolor!75!black,colbacktitle=intuitioncolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=intuitioncolor!75!black,fill=intuitioncolor!75!black] at (frame.north east) {\large Intuition};},#1}
+    overlay={\node[overlaystyle,draw=intuitioncolor!75!black,fill=intuitioncolor!75!black] at (frame.north east) {\large \namingTranslate{intuition}};},#1}
 
 \newcommand{\inlineintuition}{\bg{intuitioncolor}{Intuition:}}
 
 
 % Terms and notation
 \newtcolorbox{terms}[2][]{mainboxstyle,colback=termcolor!5!white,colframe=termcolor!75!black,colbacktitle=termcolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=termcolor!75!black,fill=termcolor!75!black] at (frame.north east) {\large \translate{Terms }{Begriffe }};},#1}
+    overlay={\node[overlaystyle,draw=termcolor!75!black,fill=termcolor!75!black] at (frame.north east) {\large \namingTranslate{terms}};},#1}
 
 \newtcolorbox{notation}[2][]{mainboxstyle,colback=notationcolor!5!white,colframe=notationcolor!75!black,colbacktitle=notationcolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=notationcolor!75!black,fill=notationcolor!75!black] at (frame.north east) {\large Notation};},#1}
+    overlay={\node[overlaystyle,draw=notationcolor!75!black,fill=notationcolor!75!black] at (frame.north east) {\large \namingTranslate{notation}};},#1}
 
 
 \newtcolorbox{usage}[2][]{mainboxstyle,colback=usagecolor!5!white,colframe=usagecolor!75!black,colbacktitle=usagecolor!75!black,title={\large #2},
-    overlay={\node[overlaystyle,draw=usagecolor!75!black,fill=usagecolor!75!black] at (frame.north east) {\large \translate{Usage }{Nutzung }};},#1}
+    overlay={\node[overlaystyle,draw=usagecolor!75!black,fill=usagecolor!75!black] at (frame.north east) {\large \namingTranslate{usage}};},#1}
 
 
 % Task
-\newtcolorbox{task}[2][]{mainboxstyle,colback=taskcolor!5!white,colframe=taskcolor!75!black,colbacktitle=taskcolor!75!black,title={\large #2},overlay={\node[overlaystyle,draw=taskcolor!75!black,fill=taskcolor!75!black] at (frame.north east) {\large \translate{Task}{Aufgabe}};},#1}
+\newtcolorbox{task}[2][]{mainboxstyle,colback=taskcolor!5!white,colframe=taskcolor!75!black,colbacktitle=taskcolor!75!black,title={\large #2},
+    overlay={\node[overlaystyle,draw=taskcolor!75!black,fill=taskcolor!75!black] at (frame.north east) {\large \namingTranslate{task}};},#1}
 
 
 % Proof
-\newtcolorbox{proof}[2][]{mainboxstyle,colback=proofcolor!5!white,colframe=proofcolor!75!black,colbacktitle=proofcolor!75!black,title={\large #2},overlay={\node[overlaystyle,draw=proofcolor!75!black,fill=proofcolor!75!black] at (frame.north east) {\large \translate{Proof}{Beweis}};},#1}
+\newtcolorbox{proof}[2][]{mainboxstyle,colback=proofcolor!5!white,colframe=proofcolor!75!black,colbacktitle=proofcolor!75!black,title={\large #2},
+    overlay={\node[overlaystyle,draw=proofcolor!75!black,fill=proofcolor!75!black] at (frame.north east) {\large \namingTranslate{proof}};},#1}
 
 
 % General
@@ -46,3 +48,14 @@
 
 % Simple
 \newtcolorbox{simplebox}[2][]{colback=#2!5!white,colframe=#2!75!black,#1}
+
+% Exam details
+\newtcolorbox{examdetailsbox}[1][]{colback=BurntOrange!20!white,
+    width=0.5\linewidth,boxrule=0.1mm,arc=0.5mm,boxsep=1mm,left=0mm,right=0mm,top=0mm,bottom=0mm,#1}
+
+\newenvironment{examdetails}{%
+    \begin{examdetailsbox}[]
+        \textbf{\translate{\atExamNamingEN}{\atExamNamingDE}:}%
+        }{%
+    \end{examdetailsbox}%
+}

vscode-snippets/tex.json

@@ -3,33 +3,114 @@
         "prefix": "latex-prepare",
         "body": [
             "\\documentclass{article}\n",
-            "\\newcommand{\\input}{~/projects/latex/janishutz-helpers.tex}\n",
+            "\\input{~/projects/latex/janishutz-helpers.tex}\n",
             "\\usepackage{lmodern}",
             "\\setFontType{sans}\n",
             "\\setup{$1}\n",
             "\\begin{document}",
             "\\startDocument\n\n",
-            "\\vspace{2cm}",
+            "$2\n\n",
-            "\\begin{center}\n\n",
+            "\\end{document}"
-            "\\includegraphics[width=0.6\\linewidth]{~/projects/latex/assets/logo.jpg}",
+        ],
+        "description": "Prepares a simple LaTeX Document"
+    },
+    "LaTeX CheatSheet Setup": {
+        "prefix": "latex-cheatsheet",
+        "body": [
+            "\\documentclass{article}\n",
+            "\\input{~/projects/latex/janishutz-helpers.tex}\n",
+            "\\usepackage{lmodern}",
+            "\\setFontType{sans}\n",
+            "\\setupCheatSheet{$1}\n",
+            "\\begin{document}",
+            "\\startDocument\n",
+            "\\noverticalspacing\n\n",
+            "$2\n\n",
+            "\\end{document}"
+        ],
+        "description": "Prepares to write a LaTeX CheatSheet"
+    },
+    "Full Summary LaTeX Setup": {
+        "prefix": "latex-summary",
+        "body": [
+            "\\documentclass{article}\n",
+            "\\PassOptionsToPackage{skip=2pt}{parskip}\n",
+            "\\input{~/projects/latex/janishutz-helpers.tex}\n",
+            "\\usepackage{lmodern}",
+            "\\setFontType{sans}\n",
+            "\\setup{$1}\n",
+            "\\begin{document}",
+            "\\startDocument\n",
+            "\\summaryspacing\n",
+            "\\vspace{1cm}",
+            "\\begin{center}",
+            "\t\\includegraphics[width=0.5\\linewidth]{~/projects/latex/assets/logo.jpg}",
             "\\end{center}\n\n",
-            "\\vspace{3cm}",
+            "\\vspace{2cm}",
             "\\begin{center}",
             "\t\\begin{Large}",
             "\t\t\\quote{A funny quote by a professor}",
-            "\t\\end{Large}",
+            "\t\\end{Large}\n",
-            "\\hspace{3cm} - Prof. Dr. Professor Name, YEAR",
+            "\t\\hspace{3cm} - Prof. Dr. Professor Name, YEAR",
             "\\end{center}\n",
-            "\\vspace{2cm}",
+            "\\vspace{1.5cm}",
             "\\begin{center}",
-            "\tSEMESTER, ETHZ\\\\[0.2cm]",
+            "\tSEMESTER, ETHZ\n",
             "\t\\begin{Large}",
             "\t\tSummary of the Script and Lectures",
-            "\t\\end{Large}\\\\[0.2cm]",
+            "\t\\end{Large}",
-            "\\end{center}",
+            "\\end{center}\n\n",
+            "\\newpage",
+            "\\printtoc{Aquamarine}\n\n",
+            "$2\n\n",
             "\\end{document}"
         ],
-        "description": "Prepares a full LaTeX Document for use and compiling"
+        "description": "Prepares a full LaTeX Summary"
+    },
+    "LaTeX Beamer Setup": {
+        "prefix": "latex-beamer",
+        "body": [
+            "\\documentclass{beamer}\n",
+            "\\input{~/projects/latex/janishutz-helpers.tex}\n",
+            "\\usepackage{lmodern}",
+            "\\setFontType{sans}\n",
+            "\\title{$1}",
+            "\\author{\\authorTitle}\n",
+            "\\usetheme{default}",
+            "\\usecolortheme{beaver}\n",
+            "\\AtBeginSection[]{",
+            "\t\\begin{frame}",
+            "\t\\frametitle{Table of Contents}",
+            "\t\\tableofcontents[currentsection]",
+            "\t\\end{frame}",
+            "}\n",
+            "\\begin{document}\n",
+            "\\frame{\\titlepage}\n\n",
+            "\\begin{frame}\n",
+            "\t\\frametitle{Table of Contents}",
+            "\t\\tableofcontents",
+            "\\end{frame}\n\n",
+            "\\begin{frame}\n",
+            "\t\\frametitle{$2}",
+            "\t$3",
+            "\\end{frame}\n\n",
+            "\\end{document}"
+        ],
+        "description": "Prepares to write a LaTeX CheatSheet"
+    },
+    "glossary-entry": {
+        "prefix": "glossary-entry",
+        "body": [
+            "\\newglossaryentry{$1}{",
+            "\tname={$2},",
+            "\tdescription={$3}\n}"
+        ]
+    },
+    "acronym": {
+        "prefix": "acronym",
+        "body": [
+            "\\newacronym{$1:id}{$2:abb}{$3:expanded}"
+        ]
     },
     "Fancy table": {
         "prefix": "table",
@@ -268,6 +349,12 @@
             "\\langle $1 \\rangle"
         ]
     },
+    "dblbrackets": {
+        "prefix": "dblbrackets",
+        "body": [
+            "\\llbracket $1 \\rrbracket"
+        ]
+    },
     "fill-width": {
         "prefix": "#fill",
         "body": [