chore: bump release version to v0.6.3

Generated-By: servostar

.gitea/workflows/ci.yml

@@ -2,11 +2,12 @@ name: Build'n check
 run-name: Performing Typst compilation
 on:
   pull_request:
-      types:
-        - opened
-        - synchronize
       branches:
         - main
+  push:
+    branches-ignore:
+      - main
+
 jobs:
   run-ci-linux:
     runs-on: ubuntu-latest
@@ -14,7 +15,8 @@ jobs:
     # push with commit containing "Run-Checks"
     if: >
       (contains(github.event.head_commit.message, 'Run-Checks') &&
-      github.event_name == 'push')
+      github.event_name == 'push') ||
+      github.event_name == 'pull_request'
     steps:
       - name: Check out repository code
         uses: actions/checkout@v3

.gitea/workflows/prepare.yml

@@ -12,27 +12,44 @@ jobs:
     env:
       USERNAME: servostar
       EMAIL: sven.vogel123@web.de
+      GIT_AUTH_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+      COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
     steps:
       - name: Check out repository code
         uses: actions/checkout@v3
         with:
           ref: 'main'
           token:  ${{ secrets.RELEASE_TOKEN }}
-      - name: Tag Release Commit
-        env:
-          COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
-          GIT_AUTH_TOKEN: ${{ secrets.RELEASE_TOKEN }}
+      - name: Install dependencies for Nix setup action
+        run: |
+          apt update -y
+          apt install sudo -y
+      - name: Setup Nix
+        uses: cachix/install-nix-action@v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+      - name: Setup Git
         run: |
-          export VERSION=$(echo "${COMMIT_MESSAGE}" | grep -Po '(?<=Release-As: )v\d+\.\d+\.\d+')
           git config --global user.name "${USERNAME}"
           git config --global user.email "${EMAIL}"
-          echo "==> Update typst.toml version"
+      - name: Update Typst.toml
+        run: |
+          export VERSION=$(echo "${COMMIT_MESSAGE}" | grep -Po '(?<=Release-As: )v\d+\.\d+\.\d+')
           sed -i "/version/c\version = \"${VERSION#v}\"" typst.toml
           git add typst.toml
-          git commit -m "chore: bump release version to $VERSION"
+          git commit -m "chore: bump release version to $VERSION" -m "Generated-By: ${{ gitea.actor }}"
+      - name: Generate Example Document
+        run: nix-shell --run ./run-ci.sh
+      - name: Generate Assets
+        if: contains(github.event.head_commit.message, 'Generate-Assets')
+        run: |
+          ./run-bake-assets.sh
+          git add assets/banner.png
+          git add assets/page-preview.png
+          git commit -m "chore: update assets" -m "Generated-By: ${{ gitea.actor }}"
+      - name: Tag and Push Changes
+        run: |
           git push origin main
-          echo "::endgroup::"
-          echo "::group::{Tag commit}"
+          export VERSION=$(echo "${COMMIT_MESSAGE}" | grep -Po '(?<=Release-As: )v\d+\.\d+\.\d+')
           git tag -m "Release" "${VERSION}"
           git push origin "${VERSION}"
-          echo "::endgroup::"

.github/workflows/release.yml

@@ -1,10 +1,10 @@
 name: Build'n check
-
 on:
   push:
     branches:
       - main
-
+    tags:
+      - 'v[0-9]+.[0-9]+.[0-9]+'
 jobs:
   build:
     name: Check Template and Build example

.gitignore

@@ -1,2 +1,3 @@
 *.pdf
 *.log
+images/

CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# Contributing
+
+Development of this template happens at
+[git.montehaselino.de](https://git.montehaselino.de/DHBW/dhbw-abb-typst-template).
+For this reason pull request opened at any mirror such as on GitHub, will not be
+merged as this would compromise the push mirror.
+
+Pull requests shall be opened exclusively in the official
+[repository](https://git.montehaselino.de/DHBW/dhbw-abb-typst-template).
+Issues may be created at GitHub or the official repository.
+Beware, that linked pull requests and issues in commits messages refer to those
+in the official instance and may be broken or invalid on mirrors such as GitHub.
+
+Direct pushes to the `main` branch are discouraged. In order to make a change
+create a new pull request and wait for a maintainer to merge it. Note that in
+order to be able to merge, the continuous integration pipeline must run
+successfully.

README.md

@@ -2,7 +2,7 @@
 <div align="center">
     <h1>DHBW-ABB template for Typst</h1>
     <img src="https://img.shields.io/gitea/last-commit/dhbw/dhbw-abb-typst-template?gitea_url=https%3A%2F%2Fgit.montehaselino.de">
-    <img src="https://img.shields.io/github/actions/workflow/status/Servostar/dhbw-abb-typst-template/ci.yml?label=build">
+    <img src="https://img.shields.io/github/actions/workflow/status/Servostar/dhbw-abb-typst-template/release.yml?label=build">
     <img src="https://img.shields.io/gitea/v/release/dhbw/dhbw-abb-typst-template?gitea_url=https%3A%2F%2Fgit.montehaselino.de&display_name=release">
     <img src="https://img.shields.io/badge/license-MIT-ff0000">
     <img src="https://img.shields.io/badge/Typst-2B9CB0">

baker/banner.typ

@@ -0,0 +1,59 @@
+#import "@preview/shadowed:0.1.2": shadowed
+
+#let LE = 10cm
+#let shadow = 0.25cm
+
+#set page(margin: 0pt, width: 2 * LE, height: LE, fill: rgb(0, 0, 0, 0))
+
+#place(
+  dx: 3cm,
+  dy: 1.1cm,
+  rotate(
+    -9deg,
+    shadowed(
+      radius: 0pt,
+      inset: 0pt,
+      blur: shadow,
+      image("./images/21.svg", height: LE * 0.6))))
+
+#place(
+  dx: 1cm,
+  dy: 3.25cm,
+  rotate(
+    -20deg,
+    shadowed(
+      radius: 0pt,
+      inset: 0pt,
+      blur: shadow,
+      image("./images/51.svg", height: LE * 0.55))))
+
+#place(
+  dx: 14cm,
+  dy: 1.5cm,
+  rotate(
+    6deg,
+    shadowed(
+      radius: 0pt,
+      inset: 0pt,
+      blur: shadow,
+      image("./images/41.svg", height: LE * 0.65))))
+
+#place(
+  dx: 11cm,
+  dy: 2cm,
+  rotate(
+    25deg,
+    shadowed(
+      radius: 0pt,
+      inset: 0pt,
+      blur: shadow,
+      image("./images/31.svg", height: LE * 0.6))))
+
+#place(
+  dx: 7cm,
+  dy: 0.75cm,
+  shadowed(
+    radius: 0pt,
+    inset: 0pt,
+    blur: shadow,
+    image("./images/11.svg", height: LE * 0.75)))

baker/preview.typ

@@ -0,0 +1,34 @@
+
+#let gap = 0.5cm
+
+#set page(margin: 0pt, width: 210mm * 3 + 2 * gap, height: 297mm * 2 + gap, fill: rgb(0, 0, 0, 0))
+
+#place(
+  dx: 0mm,
+  dy: 0mm,
+    image("./images/11.svg", height: 297mm))
+
+#place(
+  dx: 210mm + gap,
+  dy: 0mm,
+    image("./images/21.svg", height: 297mm))
+
+#place(
+  dx: (210mm + gap) * 2,
+  dy: 0mm,
+    image("./images/31.svg", height: 297mm))
+
+#place(
+  dx: 210mm * 0,
+  dy: 297mm + gap,
+    image("./images/71.svg", height: 297mm))
+
+#place(
+  dx: (210mm + gap) * 1,
+  dy: 297mm + gap,
+    image("./images/41.svg", height: 297mm))
+
+#place(
+  dx: (210mm + gap) * 2,
+  dy: 297mm + gap,
+    image("./images/51.svg", height: 297mm))

baker/run-bake-banner.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+echo "==> generate images"
+mkdir images || true
+
+# extract images from document created by action
+mutool convert -o images/1.svg "$1" 1
+mutool convert -o images/2.svg "$1" 2
+mutool convert -o images/2.svg "$1" 2
+mutool convert -o images/3.svg "$1" 5
+mutool convert -o images/7.svg "$1" 7
+mutool convert -o images/4.svg "$1" 15
+mutool convert -o images/5.svg "$1" 16
+
+echo "==> generate banner"
+typst compile banner.typ --ppi 360 ../assets/banner.png
+echo "==> generate preview"
+typst compile preview.typ --ppi 360 ../assets/page-preview.png

baker/shell.nix

@@ -0,0 +1,14 @@
+let
+  nixpkgs = fetchTarball "https://github.com/NixOS/nixpkgs/tarball/nixos-unstable";
+  pkgs = import nixpkgs { config = {}; overlays = []; };
+in
+
+pkgs.mkShellNoCC {
+  packages = with pkgs; [
+    python312
+    python312Packages.pyyaml
+    typst
+    typstyle
+    mupdf-headless
+  ];
+}

run-bake-assets.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+cd baker
+
+echo "==> generate assets"
+nix-shell --run "./run-bake-banner.sh ../example.pdf"

run-fmt.sh

@@ -17,7 +17,7 @@ function format() {
         exit 1
     fi
 
-    local imports=$(rg "#import \"([a-z0-9/\-]+\.typ)\"" -Nor '$1' "$1")
+    local imports=$(rg "#import \"([a-z0-9/\-.]+\.typ)\"" -Nor '$1' "$1")
 
     # format all included files
     while IFS= read -r line; do
@@ -26,6 +26,16 @@ function format() {
         fi
         format "$wd/$line" "$2"
     done <<< "$imports"
+
+    local includes=$(rg "#import \"([a-z0-9/\-.]+\.typ)\"" -Nor '$1' "$1")
+
+    # format all included files
+    while IFS= read -r line; do
+        if [ -z "$line" ]; then
+            continue
+        fi
+        format "$wd/$line" "$2"
+    done <<< "$includes"
 }
 
 case $1 in

shell.nix

@@ -1,5 +1,5 @@
 let
-  nixpkgs = fetchTarball "https://github.com/NixOS/nixpkgs/tarball/nixos-24.11";
+  nixpkgs = fetchTarball "https://github.com/NixOS/nixpkgs/tarball/nixos-unstable";
   pkgs = import nixpkgs { config = {}; overlays = []; };
 in
 

src/branding.typ

@@ -3,16 +3,16 @@
 //  https://brand.abb/portal/en/branding-principles/basic-brand-elements/color
 
 // ABB branding colors
-#let ABB-RED = cmyk(0%, 100%, 95%, 0%)
-#let ABB-BLACK = cmyk(0%, 0%, 0%, 100%)
-#let ABB-GRAY-01 = cmyk(0%, 0%, 0%, 90%)
-#let ABB-GRAY-02 = cmyk(0%, 0%, 0%, 75%)
-#let ABB-GRAY-03 = cmyk(0%, 0%, 0%, 55%)
-#let ABB-GRAY-04 = cmyk(0%, 0%, 0%, 35%)
-#let ABB-GRAY-05 = cmyk(0%, 0%, 0%, 15%)
-#let ABB-GRAY-06 = cmyk(0%, 0%, 0%, 5%)
-#let ABB-WHITE = cmyk(0%, 0%, 0%, 0%)
+#let ABB-RED = rgb(255, 0, 13)
+#let ABB-BLACK = rgb(0, 0, 0)
+#let ABB-GRAY-01 = rgb(25, 25, 25)
+#let ABB-GRAY-02 = rgb(64, 64, 64)
+#let ABB-GRAY-03 = rgb(115, 115, 115)
+#let ABB-GRAY-04 = rgb(166, 166, 166)
+#let ABB-GRAY-05 = rgb(217, 217, 217)
+#let ABB-GRAY-06 = rgb(242, 242, 242)
+#let ABB-WHITE = rgb(255, 255, 255)
 // ABB branding functinal colors
-#let ABB-BLUE = cmyk(100%, 53%, 2%, 16%)
-#let ABB-GREEN = cmyk(91%, 4%, 100%, 25%)
-#let ABB-YELLOW = cmyk(0%, 9%, 100%, 0%)
+#let ABB-BLUE = rgb(0, 101, 210)
+#let ABB-GREEN = rgb(17, 184, 0)
+#let ABB-YELLOW = rgb(255, 232, 0)

src/conf.typ

@@ -22,24 +22,10 @@
     program: "Informationtechnology",
     faculty: "Technik",
     name: "dualen Hochschule Baden-Württemberg",
-      campus: "Eppelheim"
-    ),
-    authors: (
-      (
-        name: "Sven Vogel",
-        course: "TINF19IT1",
-        company: "ABB AG",
-        supervisor: "Benny Goodman",
-        matriculation-number: 123456789
-      ),
-      (
-        name: "Kurt Jammer",
-        course: "TINF24AI2",
-        company: "Siemens",
-        supervisor: "Henry Badman",
-        matriculation-number: 478568763
-      ),
+    campus: "Eppelheim",
   ),
+  supervisor-signature: false,
+  authors: ((), ()),
   // information about thesis
   thesis: (
     title: "Unofficial ABB/DHBW Typst template",
@@ -51,38 +37,49 @@
     summary: none,
     abstract: none,
     preface: none,
-      keywords: ( "IT", "other stuff" ),
-      bibliography: none /* bibliography("refs.bib") */,
+    keywords: ("IT", "other stuff"),
+    bibliography: none, /* bibliography("refs.bib") */
     glossary: none,
-      appendices: none),
+    appendices: none,
+  ),
   style: (
     header: (
       content-padding: 1.5em,
       underline-top-padding: 0pt,
       logo-height: 5em,
-        logo-image: "res/ABB.svg"),
+      logo-image: "res/ABB.svg",
+    ),
     footer: (
-        content-padding: 1.5em),
+      content-padding: 1.5em,
+    ),
     page: (
       format: "a4",
       margin: (
         left: 3cm,
         right: 2.5cm,
         top: 2.5cm,
-          bottom: 2.5cm)),
+        bottom: 2.5cm,
+      ),
+    ),
     text: (
       size: 12pt,
-        font: "Fira Sans"),
+      font: "Fira Sans",
+    ),
     heading: (
-      font: "Fira Sans"),
+      font: "Fira Sans",
+    ),
     code: (
       theme: "res/abb.tmTheme",
       font: "FiraCode Nerd Font",
       lines: false,
       size: 10pt,
-        tab-size: 4),
+      tab-size: 4,
+    ),
     link: (
-        color: ABB-GRAY-02)))
+      color: ABB-GRAY-02,
+    ),
+  ),
+)
 
 // Insert a dictionary `update` into `base` but only the entries of update that also exist in base
 // Runs recursively on all sub dictionaries
@@ -101,6 +98,7 @@
 
       if type(val) == array {
         // ignore checking arraay
+        base.insert(key, update_val)
       } else if type(val) == dictionary and type(update_val) == dictionary {
         base.insert(key, deep-insert-checked(val, update_val))
       } else if val == none or type(val) == type(update_val) {

src/glossary.typ

@@ -8,7 +8,6 @@
 // License: MIT
 
 #let glossary(entries, config) = {
-
   assert(
     type(entries) == dictionary,
     message: "The glossary is not a dictionary",

src/lib.typ

@@ -122,17 +122,27 @@
 
     #metadata("content terminate") <end-of-content>
 
-    #end_styled(config)[
+    #end_styled(
+      config,
+      context [
         // add bibliography if set
         #if "bibliography" in config.thesis and config.thesis.bibliography != none {
           pagebreak(weak: true)
           counter(page).update(1)
-        set bibliography(style: "ieee")
+          set bibliography(
+            style: "ieee",
+            title: if (text.lang == "de") {
+              "Literaturverzeichnis"
+            } else if text.lang == "en" {
+              "Bibliography"
+            },
+          )
           config.thesis.bibliography
         }
 
         // appendix
         #show-appendix(config: config)
-    ]
+      ],
+    )
   ]
 ]

src/pages/abstract.typ

@@ -8,7 +8,6 @@
 
 #let new_abstract(config) = (
   context {
-
     set align(center + horizon)
 
     // only include summary when a language other than english is used

src/pages/confidentiality-statement.typ

@@ -8,7 +8,6 @@
 
 #let new_confidentiality_statement_page(config) = (
   context {
-
     pagebreak(weak: true)
 
     let thesis = config.thesis

src/pages/declaration-of-authorship.typ

@@ -8,7 +8,6 @@
 
 #let new_declaration_of_authorship(config) = (
   context {
-
     pagebreak(weak: true)
 
     let thesis = config.thesis

src/pages/outline.typ

@@ -12,7 +12,6 @@
 // NOTE: will not render in case the listing is empty
 #let render_filtered_outline(title: str, kind: selector) = (
   context {
-
     let elems = query(figure.where(kind: kind))
     let count = elems.len()
 

src/pages/prerelease-note.typ

@@ -8,7 +8,6 @@
 
 #let new_prerelease_note(config) = (
   context {
-
     pagebreak(weak: true)
 
     let thesis = config.thesis
@@ -47,7 +46,7 @@
     if text.lang == "de" [
       handelt es sich _nicht_ um die fertige Fassung. Das Dokument kann Inhaltliche-, Grammatikalische- sowie Format-Fehler enthalten. Das Dokument ist im Rahmen der Aufgabenstellung von Seiten der #university.name nicht zur Bewertung freigegeben und ein anderer Verwendungszweck als eine Vorschau ist nicht gestattet.
     ] else if text.lang == "en" [
-      is not the final version. The document may contain errors in content, grammar and formatting. The document may not be released for evaluation to #university.name as part of the assignment, and any use other than a preview is not permitted.
+      is not the final version. The document may contain errors in content, grammar and formatting. The document may not be released for evaluation to #config.university.name as part of the assignment, and any use other than a preview is not permitted.
     ]
   }
 )

src/pages/titlepage.typ

@@ -49,9 +49,17 @@
     // faculty
     #pad()[
       #if text.lang == "de" [
-        aus dem Studiengang #config.university.program | #config.university.faculty
+        aus dem Studiengang #config.university.program
       ] else if text.lang == "en" [
-        from the course of studies #config.university.program | #config.university.faculty
+        from the course of studies #config.university.program
+      ] else [
+        #context panic("no translation for language: ", text.lang)
+      ]
+
+      #if text.lang == "de" [
+        an der Fakultät #config.university.faculty
+      ] else if text.lang == "en" [
+        at the faculty of #config.university.faculty
       ] else [
         #context panic("no translation for language: ", text.lang)
       ]
@@ -68,14 +76,19 @@
       ]
       #config.university.name
       #linebreak()
+      #if text.lang == "de" [
+        in
+      ] else if text.lang == "en" [
+        in
+      ] else [
+        #context panic("no translation for language: ", text.lang)
+      ]
       #config.university.campus
     ]
 
-    #pad(top: 1em)[
+    #pad(top: 1.5em)[
       #let names = ()
-      #for author in config.authors {
-        names.push(author.name)
-      }
+
       #if text.lang == "de" [
         von
       ] else if text.lang == "en" [
@@ -83,71 +96,43 @@
       ] else [
         #context panic("no translation for language: ", text.lang)
       ]
-      #set text(size: 16pt)
-      #grid(columns: 1, row-gutter: 1em, ..names)
+
+      #v(1.5em)
+
+      #let rows = int(config.authors.len() / 3 + 0.5)
+
+      #for i in range(0, rows) {
+        let cols = calc.min(config.authors.len() - i * 3, 3)
+
+        grid(columns: cols, column-gutter: 1.5em, ..config
+            .authors
+            .slice(i * 3, i * 3 + cols)
+            .map(author => par([
+            #if author.at("name", default: none) != none {
+              text(size: 1.25em, author.name)
+              linebreak()
+            }
+            #if author.at("company", default: none) != none {
+              text(size: 1em, author.company)
+              linebreak()
+            }
+            #if author.at("contact", default: none) != none {
+              text(size: 1em, author.contact)
+              linebreak()
+            }
+            #str(author.matriculation-number), #author.course
+          ])))
+      }
     ]
 
-    #pad(top: 1em)[
+    #set align(bottom)
+
+    #pad(top: 1.5em)[
       #thesis.timeframe
     ]
 
-    #set align(bottom + left)
-
-    #if text.lang == "de" [
-      #grid(
-        columns: 2,
-        column-gutter: 1cm,
-        row-gutter: 0.5cm,
-        align: top + left,
-        stroke: none,
-        [Matrikelnummer, Kurs:],
-        par(
-          leading: 0.5em,
-          for author in config.authors {
-            str(author.matriculation-number) + ", " + author.course
-            linebreak()
-          },
-        ),
-
-        [Betrieb, Betreuer:],
-        par(
-          leading: 0.5em,
-          for author in config.authors {
-            author.company + ", " + author.supervisor
-            linebreak()
-          },
-        ),
-      )
-    ] else if text.lang == "en" [
-      #grid(
-        columns: 2,
-        column-gutter: 1cm,
-        row-gutter: 0.5cm,
-        align: top + left,
-        stroke: none,
-        [Student ID, Course:],
-        par(
-          leading: 0.5em,
-          for author in config.authors {
-            str(author.matriculation-number) + ", " + author.course
-            linebreak()
-          },
-        ),
-
-        [Company, Supervisor:],
-        par(
-          leading: 0.5em,
-          for author in config.authors {
-            author.company + ", " + author.supervisor
-            linebreak()
-          },
-        ),
-      )
-    ] else [
-      #context panic("no translation for language: ", text.lang)
-    ]
-
-    #align(
+    #if config.supervisor-signature {
+      align(
         bottom,
         grid(
         // set width of columns
@@ -163,6 +148,7 @@
         ),
         align(right, {line(length: 6cm)})),
       )
+    }
 
     #counter(page).update(0)
   ]

src/style.typ

@@ -241,6 +241,7 @@
   set page(
     paper: style.page.format,
     foreground: watermark(config),
+    background: [#rect(width: 100%, height: 100%, fill: white)],
     header-ascent: style.header.content-padding,
     footer-descent: style.header.content-padding,
     margin: (
@@ -295,7 +296,6 @@
 
       if current-page == 1 {
         // logo moved to content
-
       } else if query(<end-of-content>)
         .first()
         .location()

template/main.typ

@@ -6,16 +6,23 @@
   lang: "de",
   region: "de",
   draft: false,
-  author: (
+  authors: (
+      (
+        name: "Sven Vogel",
+        course: "TINF19IT1",
+        company: none,
+        supervisor: "Benny Goodman",
+        matriculation-number: 123456789,
+        contact: "sven.vogel123@web.de"
+      ),
+      (
         name: "Sven Vogel",
-    semester: 4,
-    program: "Informationtechnology",
         course: "TINF19IT1",
-    faculty: "Technik",
-    university: "DHBW Mannheim",
         company: "ABB AG",
         supervisor: "Benny Goodman",
         matriculation-number: 123456789,
+        contact: "sven.vogel123@web.de"
+      )
   ),
   thesis: (
     title: "Unofficial ABB/DHBW Typst template",

typst.toml

@@ -1,6 +1,6 @@
 [package]
 name = "dhbw-abb-typst-template"
-version = "0.5.3"
+version = "0.6.3"
 entrypoint = "src/template.typ"
 authors = ["Sven Vogel <sven.vogel1@de.abb.com>"]
 license = "MIT"