[Snippets] Improve

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: "[skip ci] Build docs on push"
+          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,35 @@
+name: Update helpers
+on:
+  push:
+    paths:
+      - 'src/**'
+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: "[skip ci] Build helpers on push"
+          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/)

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/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}

vscode-snippets/tex.json

@@ -3,33 +3,97 @@
         "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}",
-            "\\begin{center}\n\n",
-            "\\includegraphics[width=0.6\\linewidth]{~/projects/latex/assets/logo.jpg}",
+            "$2\n\n",
+            "\\end{document}"
+        ],
+        "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\n",
+            "$2\n\n",
+            "\\end{document}"
+        ],
+        "description": "Prepares to write a LaTeX CheatSheet"
+    },
+    "Full Summary LaTeX Setup": {
+        "prefix": "latex-summary",
+        "body": [
+            "\\documentclass{article}\n",
+            "\\input{~/projects/latex/janishutz-helpers.tex}\n",
+            "\\usepackage{lmodern}",
+            "\\setFontType{sans}\n",
+            "\\setup{$1}\n",
+            "\\begin{document}",
+            "\\startDocument\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}",
-            "\\hspace{3cm} - Prof. Dr. Professor Name, YEAR",
+            "\t\\end{Large}\n",
+            "\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]",
-            "\\end{center}",
+            "\t\\end{Large}",
+            "\\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"
     },
     "Fancy table": {
         "prefix": "table",