improve bibliography a bit

add citation tests
document other arguments
2025-10-01 22:34:31 +02:00 · 2025-10-01 22:25:35 +02:00 · 2025-10-01 21:31:57 +02:00 · 2025-10-01 21:31:34 +02:00 · 2025-10-01 19:19:17 +02:00 · 2025-10-01 13:11:50 +02:00
13 changed files with 737 additions and 164 deletions
--- a/example.typ
+++ b/example.typ
@@ -1,18 +1,7 @@
 #import "template/template.typ": *

 #show: tultemplate2.with(
-  title_cs: "Návod na použití Typst TUL šablony",
-  abstract_cs: [
-    V tomto dokumentu se naučíte základy použití TUL Typst šablony a i nějaké lehké základy Typstu.
-    Šablonu vyvíjíme pro *všechny fakulty* TUL a snažíme se postupně přidávat všechny typy
-    vysokoškolských prací.
-
-    Tento dokument by měl být vhodný pro všechny čtenáře
-    (ze všech fakult a s různými úrovněmi dovedností). Pokud je něco popsáno nejasně
-    (nebo něco chybí), prosíme, dejte nám vědět. Snažíme se šablonu i dokumentaci průběžně
-    zlepšovat.
-  ],
-  keywords_cs: ("šablona", "TUL", "Typst"),
+  title: (cs: "Návod na použití Typst TUL šablony"),
  author: "Ondřej Mekina, Matěj Žucha",
  supervisor: "Ondřej Mekina",
 )
@@ -93,7 +82,7 @@ hlášek (nebo se můžete podívat do zdrojového souboru pro toto PDF `example
 Nyní pojďme přidat nějaký obsah na titulní stránku. Jednoduše do volání šablony přidáme další
 parametry.
 ```typst
-#show: tultemplate.with(..., title: "Můj úžasný dokument", author: "Já")
+#show: tultemplate.with(..., title: (cs: "Můj úžasný dokument"), author: "Já")
 ```
 Všechny možné parametry by vám měl našeptávat váš editor (nebo LSP) -- poslouchejte takové nápovědy,
 opravdu hodně vám to usnadní práci.
@@ -268,6 +257,77 @@ co nejvíce využívala základních funkcí Typstu -- například:

 V této kapitole se naučíme vymaxovat využití této šablony za pomocí dalších funkcí a syntaxe.

+#pagebreak(weak: true)
+== Parametry této šablony
+
+Šablonu standardně použijete takto:
+```typst
+#show: tultemplate2.with(
+  <název_parametru>: <hodnota_parametru>,
+  <nazev_dalšího_parametru>: "<hodnota_dalšího_parametru>",
+  ...
+)
+```
+
+Funkce `tultemplate2` přijímá následující parametry.
+Zvýrazněné hodnoty jsou základní -- pokud vynecháte parametr, pak bude použita tato hodnota.
+
+#line()
+- `style` (vizuální styl dokumentu)
+  - *`"classic"`* - Klasický vizuální styl. Tento styl je neblíže klasické formální
+    podobě dokumentů. _(doporučeno pro nováčky této šablony)_
+#line()
+- `faculty` (zkratka fakulty)
+  - *`"tul"`* - barvy a logomarky univerzity
+  - `"fs"` - fakulta strojní
+  - `"ft"` - fakulta textilní
+  - `"fp"` - fakulta přírodovědně-humanitní a pedagogická
+  - `"ef"` - ekonomická fakulta
+  - `"fua"` - fakulta umění a architektury
+  - `"fm"` - fakulta mechatroniky, informatiky a mezioborových studií
+  - `"fzs"` - fakulta zdravotnických studií
+  - `"cxi"` - ústav pro nanomateriály, pokročilé technologie a inovace
+#line()
+- `lang` (základní jazyk dokumentu)
+  - *`"cs"`* - čeština
+  - `"en"`
+#line()
+- `document` (typ dokumentu)
+  - *`"other"`* - nespecifikovaný (neformální) typ dokumentu
+  - `bp` - Bakalářská práce
+#line()
+- `title` (nadpis dokumentu)
+  - Ve formátu `(<zkratka_jazyka>: "<nadpis>")`, například `(cs: "Můj nadpis")`
+#line()
+- `author` (autor/autoři dokumentu)
+  - Příklad: `"Pavel Novák"` nebo `"Petra Velká, Jindřich Peterka"` (oddělujte jména `", "`)
+#line()
+- `author_gender` (rod autora v českém jazyce - není potřeba pro angličtinu)
+  - `"male"` - Mužský rod
+  - `"female"` - Ženský rod
+#line()
+- `supervisor` (vedoucí práce)
+  - Příklad: `"prof. Jindřich Jindřich"`
+#line()
+- `programme` (studijní program autora)
+  - Příklad: `"4242 - Odborná tvorba a zpracování krásných šablon"`
+#line()
+- `abstract` (abstrakt)
+  - Ve formátu `(<zkratka_jazyka>: [<abstrakt>])`, například `(cs: [Můj *krásný* abstrakt.])`
+#line()
+- `keywords` (klíčová slova zobrazovaná pod abstraktem)
+  - Ve formátu `("slovo1", "slovo2", ...)`
+#line()
+- `assignment` (PDF soubor se zadáním)
+  - Ve formě cesty k souboru, například: `"zadani.pdf"`. Pokud je tento argument vynechán, bude
+    vložena hláška "vložte zadání" na příslušné místo v dokumentu -- tu stranu můžete pak nahradit
+    originálem zadání.
+#line()
+- `citations` (BibTex soubor s citacemi)
+  - Ve formě cesty k souboru, například: `"citace.bib"`. Pokud není specifikován, bude použit
+    výchozí (`"citations.bib"`).
+
+#pagebreak(weak: true)
 == Zkratky

 LaTeX TUL šablona má k začátku dokumentu seznam zkratek. Proto jsme ho přidali i do této šablony.
--- a/template/classic/bp.typ
+++ b/template/classic/bp.typ
@@ -0,0 +1,45 @@
+#import "../lang.typ": get_lang_item
+#import "common.typ": (
+  mainpage,
+  default_styling,
+  assignment,
+  disclaimer,
+  abstract,
+  toc,
+  abbrlist,
+  bibliogr
+)
+#import "../utils.typ": is_none, assert_dict_has, assert_not_none
+
+#let bp(
+  // general settings
+  faculty_id, faculty_color, language, assignment_document, citation_file,
+
+  // document info
+  title, author, author_gender, supervisor, study_programme, abstract_content, keywords,
+
+  content
+) = {
+  let force_langs = ("cs", "en");
+  assert_dict_has(force_langs, title, "title");
+  assert_not_none(abstract_content, "abstract");
+  assert_dict_has(force_langs, abstract_content, "abstract");
+  if not is_none(keywords) {
+    assert_dict_has(force_langs, keywords, "keywords");
+  }
+  if language == "cs" {
+    assert_not_none(author_gender, "author gender");
+  }
+
+  mainpage(faculty_id, language, none, title, author, supervisor, study_programme);
+  assignment(language, assignment_document);
+  default_styling(false, faculty_color, {
+    disclaimer(language, faculty_id, "bp", author, author_gender);
+    abstract("cs", title, abstract_content, keywords);
+    abstract("en", title, abstract_content, keywords);
+    toc(language);
+    abbrlist(language);
+    content
+    bibliogr(citation_file);
+  });
+}
--- a/template/classic/classic.typ
+++ b/template/classic/classic.typ
@@ -0,0 +1,41 @@
+// tools & utils
+#import "../theme.typ": faculty_logotype, tul_logomark, faculty_color
+#import "../lang.typ": lang_id, get_lang_item
+#import "../utils.typ": assert_in_dict, assert_in_arr, map_none
+
+// thesis types
+#import "bp.typ": bp
+#import "other.typ": other
+
+#let template_classic(
+  // general settings
+  language, faculty_id, document_type, citation_file, assignment_document,
+
+  // document info
+  title, author, author_gender, supervisor, study_programme, abstract, keywords,
+
+  // content
+  content,
+) = {
+  let document_types = (
+    "bp": bp,
+    "other": other,
+  )
+  assert_in_dict(document_type, document_types, "document type");
+
+  document_types.at(document_type)(
+    faculty_id,
+    faculty_color(faculty_id),
+    language,
+    assignment_document,
+    map_none(citation_file, (v) => "../../" + v),
+    title,
+    author,
+    author_gender,
+    supervisor,
+    study_programme,
+    abstract,
+    keywords,
+    content,
+  );
+}
--- a/template/template_classic.typ
+++ b/template/template_classic.typ
@@ -1,13 +1,66 @@
-#import "theme.typ": faculty_logotype, tul_logomark, faculty_color
-#import "lang.typ": lang_id, get_lang_item
-#import "utils.typ": assert_in_dict, assert_in_arr
+#import "../theme.typ": faculty_logotype, tul_logomark, faculty_color
+#import "../lang.typ": get_lang_item
+#import "../utils.typ": is_none

 #let base_font = "Inter";
 #let mono_font = "Noto Sans Mono";
 #let serif_font = "Merriweather";
 #let tul_logomark_size = 6.5em;

-#let classic_header(faculty_id, language) = {
+// TYPST ELEMENT STYLING
+
+#let default_styling(flip_bonding, faculty_color, content) = {
+  // page
+  set page(
+    margin: if flip_bonding {
+      (inside: 4cm, top: 3cm, bottom: 3cm)
+    } else {
+      (left: 4cm, top: 3cm, bottom: 3cm)
+    },
+    numbering: "1", footer: {
+    context {
+      let page = counter(page).get().at(0);
+      if flip_bonding {
+        align(str(page), if calc.rem(page, 2) == 1 { right } else { left });
+      } else {
+        align(str(page), right);
+      }
+    }
+  });
+
+  // text
+  set text(font: serif_font);
+  set par(justify: true);
+
+  // heading
+  set heading(numbering: "1.1.1 ");
+  show heading: it => {
+    set par(justify: false);
+    block(
+      above: 2em,
+      below: 2em,
+      text(it, faculty_color, font: "TUL Mono", size: 1.2em)
+    );
+  };
+  show heading.where(level: 1): it => {
+    pagebreak(weak: true);
+    v(2cm);
+    it
+  };
+
+  // other
+  show raw: set text(font: mono_font);
+  show raw.where(block: true): it => {
+    block(it, fill: rgb("#eee"), inset: 1em)
+  };
+  set highlight(fill: faculty_color.lighten(90%));
+  set image(width: 80%);
+
+  content
+}
+
+
+#let header(faculty_id, language) = {
  let logotype = faculty_logotype(faculty_id, language);
  grid(
    block(logotype, width: 100%),
@@ -16,7 +69,9 @@
  );
 }

-#let classic_info(
+//  DOCUMENT INFO
+
+#let info(
  faculty_id,
  language,
  document_type,
@@ -27,8 +82,6 @@

  // document type
  if type(document_type) != type(none) {
-    let document_types = ("bp", "dp", "dis", "hab", "teze", "autoref", "proj", "sp");
-    assert_in_arr(document_type, document_types, "document type abbreviation");
    text(get_lang_item(language, document_type), weight: "bold", font: base_font);
    v(0em);
  }
@@ -44,7 +97,7 @@
  // [field_name, field_value, bold]
  let info_fields = (
    ("study_programme", study_programme, false),
-    ("author", author, true),
+    (if author.contains(", ") { "authors" } else { "author" }, author, true),
    ("supervisor", supervisor, false),
  )
  context {
@@ -74,13 +127,15 @@
  }
 }

-#let classic_mainpage(
+// MAINPAGE
+
+#let mainpage(
  faculty_id,
  language,
  document_type,
  title, author, supervisor, study_programme,
 ) = {
-  import "utils.typ": has_all_none
+  import "../utils.typ": has_all_none
  let nonetype = type(none);
  page({
    if has_all_none((
@@ -88,9 +143,9 @@
    )) {
      place(center + horizon, align(left, faculty_logotype(faculty_id, language)));
    } else {
-      classic_header(faculty_id, language);
+      header(faculty_id, language);
      align({
-        classic_info(
+        info(
          faculty_id, language, document_type, title.at(language),
          author, supervisor, study_programme,
        );
@@ -100,31 +155,50 @@
  }, margin: 2cm);
 }

-#let disclaimer(language, faculty_id, disclaimer_type, author) = {
-  let disclaimers_for = ("bp");
-  if type(disclaimer_type) == type(none) or disclaimer_type not in disclaimers_for {
+// ASSIGNMENT PAGE
+
+#let assignment(language, document) = {
+  if type(document) == type(none) {
+    page(
+      place(center + horizon, text(
+        get_lang_item(language, "place_assignment"),
+        fill: red,
+        size: 3em,
+        font: base_font,
+        weight: "bold",
+      )),
+      margin: 0em,
+      footer: none,
+    );
    return;
  }
+  import "@preview/muchpdf:0.1.1": muchpdf
+  set page(margin: 0em);
+  muchpdf(read(document, encoding: none));
+}
+
+// DISCLAIMER PAGE
+
+#let disclaimer(language, faculty_id, disclaimer_type, author, author_gender) = {
+  import "../lang.typ": disclaimer
  heading(get_lang_item(language, "disclaimer"), numbering: none, outlined: false);
  par(
-    text(get_lang_item(language, "disclaimer_" + disclaimer_type))
+    text(disclaimer(language, disclaimer_type, author_gender))
  );
  v(5em);
  grid(
    columns: 2,
    gutter: 1em,
-    block(text(datetime.today().display(get_lang_item(language, "date")), lang: "cs"), width: 100%),
+    block(
+      text(datetime.today().display(get_lang_item(language, "date")), lang: "cs"), width: 100%
+    ),
    text(author),
  );
 }

+// ABSTRACT
+
 #let abstract(language, title, content, keywords) = {
-  if type(content.at(language)) == type(none) {
-    return;
-  }
-  if type(title.at(language)) == type(none) {
-    panic("no title found for language `" + language + "` (required for abstract)");
-  }
  heading(text(title.at(language), font: base_font), numbering: none, outlined: false);
  v(2em);
  heading(
@@ -134,7 +208,7 @@
    outlined: false,
  );
  text(content.at(language));
-  if type(keywords.at(language)) != type(none) {
+  if not is_none(keywords) and type(keywords.at(language)) != type(none) {
    linebreak();
    linebreak();
    text(get_lang_item(language, "keywords") + ": ", weight: "bold", font: base_font);
@@ -142,15 +216,17 @@
  }
 }

+// ABBREVIATION LIST
+
 #let abbrlist(language) = {
-  import "abbreviations.typ": abbrlist
+  import "../abbreviations.typ": abbrlist
  context {
    let abbrs = abbrlist();
    let max_abbr_width = if abbrs.len() > 0 {
      calc.max(abbrs.keys().map((v) => measure(v).width)).at(0)
    } else { return };
    pagebreak(weak: true);
-    heading(("Seznam zkratek", "List of abbreviations").at(language), numbering: none);
+    heading(get_lang_item(language, "abbrs"), numbering: none);
    align(center, grid(
      columns: 2,
      gutter: 1em,
@@ -164,107 +240,24 @@
  }
 }

-#let template_classic(
-  faculty_id,
-  language,
-  document_type,
-  title_cs, author, supervisor, study_programme, abstract_cs, keywords_cs,
-  title_en, abstract_en, keywords_en,
-  citation_file,
-  content,
-) = {
-  let flip_bonding = if document_type == "bp" {
-    false
-  } else {
-    true
-  };
+// TABLE OF CONTENTS

-  let title = (
-    "cs": title_cs,
-    "en": title_en,
-  );
-
-  // main page
-  classic_mainpage(faculty_id, language, document_type, title, author, supervisor, study_programme);
-
-  // styling
-  let faculty_color = faculty_color(faculty_id);
-  set par(justify: true);
-  set heading(numbering: "1.1.1 ");
-  set page(
-    margin: if flip_bonding {
-      (inside: 4cm, top: 3cm, bottom: 3cm)
-    } else {
-      (left: 4cm, top: 3cm, bottom: 3cm)
-    },
-    numbering: "1", footer: {
-    context {
-      let page = counter(page).get().at(0);
-      if flip_bonding {
-        align(str(page), if calc.rem(page, 2) == 1 { right } else { left });
-      } else {
-        align(str(page), right);
-      }
-    }
-  });
-  set text(font: serif_font);
-  show heading: it => {
-    set par(justify: false);
-    block(
-      above: 2em,
-      below: 2em,
-      text(it, faculty_color, font: "TUL Mono", size: 1.2em)
-    );
-  };
-  show heading.where(level: 1): it => {
-    pagebreak();
-    v(2cm);
-    it
-  };
-  show raw: set text(font: mono_font);
-  show raw.where(block: true): it => {
-    block(it, fill: rgb("#eee"), inset: 1em)
-  };
-  set highlight(fill: faculty_color.lighten(90%));
-  set image(width: 80%);
-
-  // disclaimer
-  disclaimer(language, faculty_id, document_type, author);
-
-  // abstract
-  let abstract_content = (
-    "cs": abstract_cs,
-    "en": abstract_en,
-  );
-  let keywords = (
-    "cs": keywords_cs,
-    "en": keywords_en,
-  );
-  if language == "cs" {
-    abstract("cs", title, abstract_content, keywords);
-    abstract("en", title, abstract_content, keywords);
-  } else {
-    abstract(language, title, abstract_content, keywords);
-  }
-
-  let language = lang_id(language);
-
-  // toc
+#let toc(language) = {
  show outline.entry.where(level: 1): it => {
    show repeat: none;
    block(text(it, weight: "bold", size: 1.2em), above: 1.5em);
  };
-  outline(title: ("Obsah", "Contents").at(language));
-
-  // abbreviation list
-  abbrlist(language);
-
-  // content
-  if flip_bonding {
-    pagebreak(to: "even", weak: true);
-  }
-  content
-
-  // bibliography
-  bibliography(citation_file, style: "./tul_citace.csl")
+  outline(title: get_lang_item(language, "toc"));
+}
+
+// BIBLIOGRAPHY
+
+#let bibliogr(language, citations_file) = {
+  if language == "cs" {
+    bibliography(citations_file, style: "../tul_citace.csl");
+  } else if language == "en" {
+    bibliography(citations_file, style: "iso-690-numeric");
+  } else {
+    panic("unknown language for bibliography '" + language + "'");
+  }
 }
--- a/template/classic/other.typ
+++ b/template/classic/other.typ
@@ -0,0 +1,25 @@
+#import "../lang.typ": get_lang_item
+#import "common.typ": mainpage, default_styling, assignment, disclaimer, abstract, toc, abbrlist
+#import "../utils.typ": is_none
+
+#let other(
+  // general settings
+  faculty_id, faculty_color, language, assignment_document, citation_file,
+
+  // document info
+  title, author, _, supervisor, study_programme, abstract_content, keywords,
+
+  content
+) = {
+  mainpage(faculty_id, language, none, title, author, supervisor, study_programme);
+  default_styling(true, faculty_color, {
+    toc(language);
+    abbrlist(language);
+
+    pagebreak(to: "even", weak: true);
+    content
+
+    // bibliography
+    bibliography(citation_file, style: "../tul_citace.csl");
+  });
+}
--- a/template/lang.json
+++ b/template/lang.json
@@ -1,6 +1,7 @@
 {
 	"cs": {
 		"author": "Autor",
+		"authors": "Autoři",
 		"supervisor": "Vedoucí práce",
 		"study_programme": "Studijní program",

@@ -10,17 +11,37 @@

 		"city": "Liberec",

+		"toc": "Obsah",
+
 		"disclaimer": "Prohlášení",
-		"disclaimer_bp": "Prohlašuji, že svou bakalářskou práci jsem vypracoval samostatně jako původní dílo s použitím uvedené literatury a na základě konzultací s vedoucím mé bakalářské práce a konzultantem.\n\nJsem si vědom toho, že na mou bakalářskou práci se plně vztahuje zákon č. 121/2000 Sb., o právu autorském, zejména § 60 – školní dílo.\n\nBeru na vědomí, že Technická univerzita v Liberci nezasahuje do mých autorských práv užitím mé bakalářské práce pro vnitřní potřebu Technické univerzity v Liberci.\n\nUžiji-li bakalářskou práci nebo poskytnu-li licenci k jejímu využití, jsem si vědom povinnosti informovat o této skutečnosti Technic-kou univerzitu v Liberci; v tomto případě má Technická univerzita v Liberci právo ode mne požadovat úhradu nákladů, které vynaložila na vytvoření díla, až do jejich skutečné výše.\n\nSoučasně čestně prohlašuji, že text elektronické podoby práce vložený do IS/STAG se shoduje s textem tištěné podoby práce.\n\nBeru na vědomí, že má bakalářská práce bude zveřejněna Tech- nickou univerzitou v Liberci v souladu s § 47b zákona č. 111/1998 Sb., o vysokých školách a o změně a doplnění dalších zákonů (zá- kon o vysokých školách), ve znění pozdějších předpisů.\n\nJsem si vědom následků, které podle zákona o vysokých školách mohou vyplývat z porušení tohoto prohlášení.",
+		"disclaimer_content": "Prohlašuji, že {svůj} {práce:tu} jsem vypracoval{a} samostatně jako původní dílo s použitím uvedené literatury a na základě konzultací s vedoucím mé bakalářské práce a konzultantem.\n\nJsem si vědom{a} toho, že na {moji} {práce:tu} se plně vztahuje zákon č. 121/2000 Sb., o právu autorském, zejména § 60 – školní dílo.\n\nBeru na vědomí, že Technická univerzita v Liberci nezasahuje do mých autorských práv užitím {mé} {práce:té} pro vnitřní potřebu Technické univerzity v Liberci.\n\nUžiji-li {práce:tu} nebo poskytnu-li licenci k {jejímu} využití, jsem si vědom{a} povinnosti informovat o této skutečnosti Technickou univerzitu v Liberci; v tomto případě má Technická univerzita v Liberci právo ode mne požadovat úhradu nákladů, které vynaložila na vytvoření díla, až do jejich skutečné výše.\n\nSoučasně čestně prohlašuji, že text elektronické podoby práce vložený do IS/STAG se shoduje s textem tištěné podoby práce.\n\nBeru na vědomí, že {můj} {práce:ta} bude {zveřejněn} Technickou univerzitou v Liberci v souladu s § 47b zákona č. 111/1998 Sb., o vysokých školách a o změně a doplnění dalších zákonů (zákon o vysokých školách), ve znění pozdějších předpisů.\n\nJsem si vědom{a} následků, které podle zákona o vysokých školách mohou vyplývat z porušení tohoto prohlášení.",
+
+		"disclaimer_replace": {
+			"bp": {
+				"práce:ta": "bakalářská práce",
+				"práce:tu": "bakalářskou práci",
+				"práce:té": "bakalářské práce",
+				"moji": "moji",
+				"mé": "mé",
+				"můj": "moje",
+				"svůj": "svoji",
+				"jejímu": "jejímu",
+				"zveřejněn": "zveřejněna"
+			}
+		},

 		"date": "[day]. [month]. [year]",

 		"abstract": "Abstrakt",
-		"keywords": "Klíčová slova"
+		"keywords": "Klíčová slova",
+		"abbrs": "Seznam zkratek",
+
+		"place_assignment": "Sem vložte zadání"
 	},

 	"en": {
 		"author": "Author",
+		"authors": "Authors",
 		"supervisor": "Supervisor",
 		"study_programme": "Study programme",

@@ -30,12 +51,23 @@

 		"city": "Liberec",

+		"toc": "Contents",
+
 		"disclaimer": "Declaration",
-		"disclaimer_bp": "I hereby certify, I, myself, have written my bachelor thesis as an original and primary work using the literature listed below and consulting it with my thesis supervisor and my thesis counsellor.\n\nI acknowledge that my bachelor thesis is fully governed by Act No. 121/2000 Coll., the Copyright Act, in particular Article 60 – School Work.\n\nI acknowledge that the Technical University of Liberec does not infringe my copyrights by using my bachelor thesis for internal purposes of the Technical University of Liberec.\n\nI am aware of my obligation to inform the Technical University of Liberec on having used or granted license to use the results of my bachelor thesis; in such a case the Technical University of Liberec may require reimbursement of the costs incurred for creating the result up to their actual amount.\n\nAt the same time, I honestly declare that the text of the printed version of my bachelor thesis is identical with the text of the electronic version uploaded into the IS STAG.\n\nI acknowledge that the Technical University of Liberec will make my bachelor thesis public in accordance with paragraph 47b of Act No. 111/1998 Coll., on Higher Education Institutions and on Amendment to Other Acts (the Higher Education Act), as amended.\n\nI am aware of the consequences which may under the Higher Education Act result from a breach of this declaration.",
+		"disclaimer_content": "I hereby certify, I, myself, have written my {thesis} as an original and primary work using the literature listed below and consulting it with my thesis supervisor and my thesis counsellor.\n\nI acknowledge that my {thesis} is fully governed by Act No. 121/2000 Coll., the Copyright Act, in particular Article 60 – School Work.\n\nI acknowledge that the Technical University of Liberec does not infringe my copyrights by using my {thesis} for internal purposes of the Technical University of Liberec.\n\nI am aware of my obligation to inform the Technical University of Liberec on having used or granted license to use the results of my {thesis}; in such a case the Technical University of Liberec may require reimbursement of the costs incurred for creating the result up to their actual amount.\n\nAt the same time, I honestly declare that the text of the printed version of my {thesis} is identical with the text of the electronic version uploaded into the IS STAG.\n\nI acknowledge that the Technical University of Liberec will make my {thesis} public in accordance with paragraph 47b of Act No. 111/1998 Coll., on Higher Education Institutions and on Amendment to Other Acts (the Higher Education Act), as amended.\n\nI am aware of the consequences which may under the Higher Education Act result from a breach of this declaration.",
+
+		"disclaimer_replace": {
+			"bp": {
+				"thesis": "bachelor thesis"
+			}
+		},

 		"date": "[year]-[month]-[day]",

 		"abstract": "Abstract",
-		"keywords": "Keywords"
+		"keywords": "Keywords",
+		"abbrs": "List of abbreviations",
+
+		"place_assignment": "Insert your assignment here"
 	}
 }
--- a/template/lang.typ
+++ b/template/lang.typ
@@ -20,3 +20,23 @@
  let lang_items = fetch_lang_items();
  return lang_items.at(lang_abbr).at(item_name);
 }
+
+#let disclaimer(language, document_type, author_gender) = {
+  let disclaimer = get_lang_item(language, "disclaimer_content");
+  let replacements = get_lang_item(language, "disclaimer_replace").at(document_type);
+  if language == "cs" {
+    let gender_transforms = (
+      male: "",
+      female: "a",
+    );
+    assert_in_dict(author_gender, gender_transforms, "author gender");
+    disclaimer = disclaimer.replace("{a}", gender_transforms.at(author_gender));
+  }
+  for (key, value) in replacements.pairs() {
+    disclaimer = disclaimer.replace("{" + key + "}", value);
+  }
+  if disclaimer.contains("{") or disclaimer.contains("}") {
+    panic("invalid language file");
+  }
+  disclaimer
+}
--- a/template/template.typ
+++ b/template/template.typ
@@ -22,42 +22,68 @@
 // - style (str): Visual style to use. This can be "classic".
 // - faculty (str): Factulty abbreviation. One of "fs", "ft", "fp", "ef", "fua", "fm", "fzs", "cxi".
 // - lang (str): Language code. This can be "cs" or "en".
-// - document (str): Type of document. This can be "bp", "dp", "ds".
+// - document (str): Type of document. This can be "bp" or "other".
 // - title (str): The title of the document.
 // - author (str): The name of the document's author.
+// - author_gender (str): The gender of the document's author. Needed only for the `cs` language.
 // - supervisor (str): The name of the document's supervisor.
 // - programme (str): Study programme.
+// - abstract (content): The abstract.
+// - keywords (array): The abstract keywords.
+// - assignment (str): Filepath of the assignment document/page.
 // - citations (str): The location of the citation file.
 // - content (content): The content of the document
 //
 //-> none
 #let tultemplate2(
-  style: "classic",
-  faculty: "tul",
-  lang: "cs",
-  document: none,
-  title_cs: none, author: none, supervisor: none, programme: none, abstract_cs: none,
-  keywords_cs: none,
-  title_en: none, abstract_en: none, keywords_en: none,
-  citations: "citations.bib",
+  // general settings
+  style: "classic", faculty: "tul", lang: "cs", document: "other",
+
+  // document info
+  title: none, keywords: none, abstract: none, author: none, author_gender: none,
+  supervisor: none, programme: none,
+
+  // links
+  assignment: none, citations: "citations.bib",
+
+  // content
  content,
 ) = {
-  import "template_classic.typ": template_classic
-  import "utils.typ": assert_in_dict
+  import "utils.typ": assert_in_dict, assert_type_signature
+
+  // argument checking
+  assert_type_signature(style, "string", "visual style argument");
+  assert_type_signature(faculty, "string", "faculty id argument");
+  assert_type_signature(lang, "string", "language abbreviation argument");
+  assert_type_signature(document, "string | none", "document kind argument");
+  assert_type_signature(title, "dictionary[string : string] | none", "title argument");
+  assert_type_signature(keywords, "dictionary[string : array[string]] | none", "keywords argument");
+  assert_type_signature(abstract, "dictionary[string : string] | none", "abstract argument");
+  assert_type_signature(author, "string | none", "author argument");
+  assert_type_signature(author_gender, "string | none", "author gender argument");
+  assert_type_signature(supervisor, "string | none", "supervisor argument");
+  assert_type_signature(
+    programme, "dictionary[string : string] | none", "study programme argument"
+  );
+  assert_type_signature(assignment, "string | none", "assignment document argument");
+  assert_type_signature(citations, "string", "citations file argument");
+
+  // templates
+  import "classic/classic.typ": template_classic
  let templates = (
    classic: template_classic,
  );
  assert_in_dict(style, templates, "template name");

-  // global set-up
+  // language set-up
  import "lang.typ": lang_ids
  assert_in_dict(lang, lang_ids, "language abbreviation");
  set text(lang: lang);
+
+  // template call
  templates.at(style)(
-    faculty, lang, document,
-    title_cs, author, supervisor, programme, abstract_cs, keywords_cs,
-    title_en, abstract_en, keywords_en,
-    "../" + citations,
+    lang, faculty, document, citations, assignment,
+    title, author, author_gender, supervisor, programme, abstract, keywords,
    content
  );

--- a/template/tul_citace.csl
+++ b/template/tul_citace.csl
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <style xmlns="http://purl.org/net/xbiblio/csl" class="in-text" version="1.0" demote-non-dropping-particle="never" default-locale="en-US">
  <info>
-    <title>ISO-690 (numeric, Czech)</title>
+    <title>TUL ISO-690</title>
    <id>-----</id>
    <link href="" rel="self"/>
    <link href="" rel="documentation"/>
@@ -264,7 +264,7 @@
            <group>
              <text term="retrieved" suffix=" " text-case="capitalize-first"/>
              <text term="from" suffix=": "/>
-              <text variable="URL"/>
+              <text variable="URL" suffix=" "/>
            </group>
          </if>
        </choose>
--- a/template/utils.typ
+++ b/template/utils.typ
@@ -1,9 +1,198 @@
+#let join(a, b) = {
+  let res = ();
+  if type(a) == array {
+    for a in a {
+      res.push(a);
+    }
+  } else {
+    res.push(a);
+  }
+  if type(b) == array {
+    for b in b {
+      res.push(b);
+    }
+  } else {
+    res.push(b);
+  }
+  res
+}
+
+#let serialize_array(arr) = {
+  arr.map((v) => { "'" + str(v) + "'" }).join(", ")
+}
+
+// Assumes a valid type signature
+#let decompose_type_signature(signature) = {
+  let parse_variants(raw) = {
+    let tmp = "";
+    let res = ();
+    for char in raw {
+      if char == ":" {
+        let trimmed = tmp.trim();
+        tmp = "";
+        if trimmed.len() != 0 {
+          res.push(trimmed);
+        }
+        res.push(":");
+      } else if char == "|" {
+        let trimmed = tmp.trim();
+        tmp = "";
+        if trimmed.len() != 0 {
+          res.push(trimmed);
+        }
+      } else {
+        tmp += char;
+      }
+    }
+    if tmp.len() != 0 {
+      res.push(tmp.trim());
+    }
+    res
+  };
+  let parse_groups(raw) = {
+    let tmp = "";
+    let groups = ();
+    let found_nested = false;
+    let nested = 0;
+    for char in raw {
+      if nested == 2 {
+        found_nested = true;
+      }
+      if char == "[" {
+        if nested > 0 {
+          tmp += char;
+        } else {
+          groups = join(groups, parse_variants(tmp));
+          tmp = "";
+          found_nested = false;
+        }
+        nested += 1;
+      } else if char == "]" {
+        if nested > 1 {
+          tmp += char;
+        } else {
+          groups.push(if found_nested { parse_groups(tmp) } else { parse_variants(tmp) });
+          tmp = "";
+          found_nested = false;
+        }
+        nested -= 1;
+      } else {
+        tmp += char;
+      }
+    }
+    if tmp.len() != 0 {
+      groups = join(groups, parse_variants(tmp));
+    }
+    groups
+  };
+  let parse_nested(grouped) = {
+    if type(grouped) != array or grouped.len() == 0 {
+      return grouped;
+    }
+    let first = grouped.at(0);
+    if type(first) == str and first == "dictionary" {
+      let body = grouped.at(1);
+      let key = ();
+      for group in body {
+        if group == ":" {
+          break;
+        }
+        key.push(group);
+      }
+      let val = body.slice(key.len() + 1);
+      join((("dictionary", parse_nested(key), parse_nested(val)),), parse_nested(grouped.slice(2)))
+    } else if type(first) == str and first == "array" {
+      join((("array", parse_nested(grouped.at(1))),), parse_nested(grouped.slice(2)))
+    } else {
+      join(parse_nested(first), parse_nested(grouped.slice(1)))
+    }
+  };
+  let grouped = parse_groups(signature);
+  parse_nested(grouped)
+}
+
+#let serialize_type_signature(value) = {
+  let serialize_type(value, array_serializer, dict_serializer) = {
+    if type(value) == dictionary {
+      dict_serializer(value, array_serializer)
+    } else if type(value) == array {
+      array_serializer(value)
+    } else {
+      str(type(value))
+    }
+  }
+
+  let serialize_multi_type(values, array_serializer, dict_serializer) = {
+    let signatures = ().to-dict();
+    for value in values {
+      signatures.insert(serialize_type(value, array_serializer, dict_serializer), none);
+    }
+    signatures.keys().join(" | ")
+  }
+
+  let serialize_dict_type(dict, array_serializer) = {
+    (
+      "dictionary[" +
+      serialize_multi_type(dict.keys(), array_serializer, serialize_dict_type) +
+      " : " +
+      serialize_multi_type(dict.values(), array_serializer, serialize_dict_type) +
+      "]"
+    )
+  }
+
+  let serialize_array_type(arr) = {
+    "array[" + serialize_multi_type(arr, serialize_array_type, serialize_dict_type) + "]"
+  }
+
+  serialize_type(value, serialize_array_type, serialize_dict_type);
+}
+
+#let is_subset_of(subset, of) = {
+  let has_value(value, target, matcher) = {
+    for target in target {
+      if matcher(value, target) {
+        return true;
+      }
+    }
+    false
+  };
+  let is_subset(subset, of, matcher) = {
+    for item in subset {
+      if not has_value(item, of, matcher) {
+        return false;
+      }
+    }
+    true
+  };
+  let matches(a, b) = {
+    if type(a) == array {
+      if a.at(0) != b.at(0) {
+        return false;
+      }
+      let a_type = a.at(0);
+      if a_type == "dictionary" {
+        is_subset(a.at(1), b.at(1), matches) and is_subset(a.at(2), b.at(2), matches)
+      } else if a_type == "array" {
+        is_subset(a.at(1), b.at(1), matches)
+      } else {
+        panic("invalid signature");
+      }
+    } else if type(a) != array and type(b) != array {
+      a == b
+    } else {
+      false
+    }
+  };
+  is_subset(subset, of, matches)
+}
+
+
 #let assert_in_arr(needle, arr, item_name) = {
  if str(needle) not in arr {
-    panic(
-      "unknown " + item_name + " '" + str(needle) +
-      "', expected one of: " + arr.map((k) => { "'" + str(k) + "'" }).join(", ")
+    let panic_message = (
+      "unknown " + item_name + " '" + str(needle) + "', expected one of: " + serialize_array(arr)
    );
+    panic(panic_message);
  }
 }

@@ -11,6 +200,77 @@
  assert_in_arr(needle, dict.keys(), item_name);
 }

+#let assert_dict_has(needles, dict, item_name) = {
+  for needle in needles {
+    if not needle in dict {
+      let panic_message = item_name + " does not contain an entry for '" + needle + "'";
+      panic(panic_message);
+    }
+  }
+}
+
+#let matches_type(value, expected_types) = {
+  return type(value) in expected_types;
+}
+
+#let assert_type(value, expected_types, value_name) = {
+  if not matches_type(value, expected_types) {
+    let panic_message = (
+      "unexpected type for " + value_name + " '" + str(type(value)) + "', expected one of: " +
+      serialize_array(expected_types)
+    );
+    panic(panic_message);
+  }
+}
+
+#let matches_array_type(arr, expected_item_types) = {
+  for item in arr {
+    if not matches_type(item, expected_item_types) { return false; }
+  }
+  true
+}
+
+#let assert_array_type(arr, expected_types, array_name) = {
+  assert_type(arr, (array), array_name);
+  for item in arr {
+    assert_type(item, expected_types, array_name + " item");
+  }
+}
+
+#let matches_dict_type(dict, expected_key_types, expected_value_types) = {
+  if type(dict) != dictionary {
+    return false;
+  }
+  for (key, value) in dict.pairs() {
+    if not (matches_type(key, expected_key_types) and matches_type(value, expected_value_types)) {
+      return false;
+    }
+  }
+  true
+}
+
+#let assert_dict_type(dict, expected_key_types, expected_value_types, dict_name) = {
+  assert_type(dict, (dictionary), dict_name);
+  for (key, value) in dict.items() {
+    assert_type(key, expected_key_types, dict_name + " key");
+    assert_type(value, expected_value_types, dict_name + " value");
+  }
+}
+
+#let assert_type_signature(value, expected_type_signature, value_name) = {
+  let type_signature = serialize_type_signature(value);
+  if not is_subset_of(
+    decompose_type_signature(type_signature),
+    decompose_type_signature(expected_type_signature)
+  ) {
+    let panic_message = (
+      "unexpected " + value_name + " type '" + type_signature +
+      "' expected at least a subset of '" + expected_type_signature + "'"
+    );
+    panic(panic_message);
+  }
+}
+
 #let is_none(thing) = {
  if type(thing) == type(none) {
    true
@@ -19,6 +279,21 @@
  }
 }

+#let assert_not_none(thing, item_name) = {
+  if is_none(thing) {
+    let panic_message = "missing " + item_name;
+    panic(panic_message);
+  }
+}
+
+#let ok_or(thing, fallback) = {
+  if is_none(thing) {
+    fallback
+  } else {
+    thing
+  }
+}
+
 #let has_all_none(arr) = {
  for item in arr {
    if not is_none(item) {
@@ -27,3 +302,10 @@
  }
  true
 }
+
+#let map_none(value, mapper) = {
+  if is_none(value) {
+    return none;
+  }
+  mapper(value)
+}
--- a/tests/citations.bib
+++ b/tests/citations.bib
@@ -0,0 +1,40 @@
+@article{Wang2025,
+  author = {Wang, Erming and Yu, Kaiwen and Cao, Jiqing and Wang, Minghui and Katsel, Pavel and Song, Won-min and Wang, Zhen and Li, Yuxin and Wang, Xusheng and Wang, Qian and Xu, Peng and Yu, Gefei and Zhu, Li and Geng, Jia and Habibi, Parnian and Qian, Lu and Tuck, Tony and Li, Aiqun and TCW, Julia and Roussos, Panos and Brennand, Kristen J. and Haroutunian, Vahram and Johnson, Erik C.B. and Seyfried, Nicholas T. and Levey, Allan I. and Bennett, David A. and Peng, Junmin and Cai, Dongming and Zhang, Bin},
+  title = {Multiscale proteomic modeling reveals protein networks driving Alzheimer’s disease pathogenesis},
+  journal = {Cell},
+  year = {2025},
+  volume = {},
+  number = {},
+  pages = {},
+  publisher = {Elsevier},
+  doi = {10.1016/j.cell.2025.08.038},
+  url = {https://doi.org/10.1016/j.cell.2025.08.038},
+  issn = {0092-8674}
+}
+
+@misc{csl,
+  title = {Citation Style Language},
+  year = {2025},
+  medium = {online},
+  accessed = {2025-06-10},
+  URL = {https://citationstyles.org/},
+}
+
+@misc{linux,
+  journal = {Blog | Linux Foundation},
+  title = {Classic SysAdmin: Vim 101: A Beginner’s Guide to Vim},
+  year = {2025},
+  medium = {online},
+  accessed = {2025-06-10},
+  URL = {https://www.linuxfoundation.org/blog/blog/classic-sysadmin-vim-101-a-beginners-guide-to-vim},
+}
+
+@book{Satrapa2011,
+  author = {Pavel Satrapa},
+  title = {IPv6},
+  publisher = {Edice CZ.NIC},
+  year = {2011},
+  edition = {3. vydání},
+  ISBN = {978-80-904248-4-9},
+  URL = {https://www.bookport.cz/kniha/ipv6-treti-vydani-5999/},
+}
--- a/tests/citations_cs.typ
+++ b/tests/citations_cs.typ
@@ -1,4 +1,7 @@
-// todo: add citations
+@Wang2025
+@csl
+@linux
+@Satrapa2011

-#pagebreak(weak: true)
+#set text(lang: "cs")
 #bibliography("citations.bib", title: "Bibliography - CZ", style: "../template/tul_citace.csl")
--- a/tests/citations_en.typ
+++ b/tests/citations_en.typ
@@ -0,0 +1,6 @@
+@Wang2025
+@csl
+@linux
+@Satrapa2011
+
+#bibliography("citations.bib", title: "Bibliography - EN", style: "iso-690-author-date")
Author	SHA1	Message	Date
Ondřej Mekina	26d861b72a	improve bibliography a bit	2025-10-01 22:34:31 +02:00
Ondřej Mekina	6bebe41d6e	add citation tests	2025-10-01 22:25:35 +02:00
Ondřej Mekina	4e634e6ff9	document other arguments	2025-10-01 21:31:57 +02:00
Ondřej Mekina	b03978a2c0	add disclaimer base and bachelor to english	2025-10-01 21:31:34 +02:00
Ondřej Mekina	c41ac4bc77	prepare for more thesis types	2025-10-01 19:19:17 +02:00
Ondřej Mekina	1f75a74f61	disable not yet supported document types	2025-10-01 13:11:50 +02:00
Ondřej Mekina	5d17fa8fe3	add assignment page	2025-10-01 13:08:55 +02:00