feat(template): add asserts

feat(style)!: remove reference styling & fix figure numbering for appendices
Use `@some_label[див. фігуру]` to get a "див. фігуру 42" link.
2025-06-11 18:06:39 +03:00 · 2025-05-19 17:24:36 +03:00 · 2025-05-14 10:53:49 +03:00 · 2025-05-12 10:31:53 +03:00
10 changed files with 351 additions and 408 deletions
--- a/.gitignore
+++ b/.gitignore
@ -1 +1,3 @@
 *.pdf
+test
+config
--- a/README.md
+++ b/README.md
@ -1,3 +1,6 @@
+> [!CAUTION]
+> Experimental fork. Successfully **breaking** stuff each commit. Documentation is **not** up to date.
+
 # Typst Template for NURE Works
 ![pz-lb title page](assets/pz-lb_title_page.png)

@ -7,7 +10,7 @@ This project contains two template functions and some utilities for writing NURE

 ### Templates

-#### `pz-lb` - For Practice and Laboratory Works
+#### `general` - For general works
 This template:
 - Sets up document styles;
 - Formats the title page according to NURE/DSTU guidelines.
@ -30,11 +33,11 @@ This template:
 ### As a local typst package
 1. Clone this repository into ~/.local/share/typst/packages/:
 ```bash
-git clone -b 0.1.0 https://gitea.linerds.us/pencelheimer/typst_nure_template.git ~/.local/share/typst/packages/local/nure/0.1.0
+git clone https://github.com/noatu/typst-nure-template.git ~/.local/share/typst/packages/local/nure/0.2.0
 ```
 2. Init your project with Typst:
 ```bash
-typst init @local/nure:0.1.0 project-name
+typst init @local/nure:0.2.0 project-name
 ```

 ### As a standalone file
@ -43,19 +46,19 @@ Copy `lib.typ` to your project's root directory.
 ### In your project
 ```typst
 // Import the template either from a local package...
-#import "@local/nure:0.1.0": *
+#import "@local/nure:0.2.0": *
 // ...or by importing a lib.typ directly
 // #import "/lib.typ": *

 // 1. Setup the document
 // by setting values directly...
-#show: pz-lb.with(
+#show: general.with(
  title: "Some title",
  // etc: "and so on",
  // ...
 )
-// ...or using a config/doc.yaml file
-#show: pz-lb.with(..yaml("config/doc.yaml"))
+// ...or using a doc.yaml file
+#show: general.with(..yaml("doc.yaml"))

 // this template automatically inserts a `=title`

@ -72,10 +75,10 @@ Some text
 // you have to import the package or a lib.typ inside a module.


-// If you ever need appendices in pz-lb template use the show rule
+// If you ever need appendices in general template use the show rule
 // WARNING: when using coursework template use its own argument,
 // so it can put bibliography before appendices
-#show: appendices_style
+#show: appendices-style

 = Quote
 #link("https://youtu.be/bJQj1uKtnus")[
@ -86,16 +89,12 @@ Some text

 ### Notes:
 1. Use `#v(-spacing)` to remove vertical spacing between titles (this cannot be automatically handled by the template). Variable `spacing` used here is imported from the template.
-2. When importing `@local/nure:0.1.0` and specifying file paths in functions handled by the package, the path will relative to package's root directory, e.g. setting `#show: coursework.with(bib_path: "bibl.yml")` will evaluate to `~/.local/share/typst/packages/local/nure/0.1.0/bibl.yml`, the same is for `#img` function, which makes it quite annoying and forces one to import `lib.typ` file. Please open an issue or contact us in any other way if you have any advice.
+2. When importing `@local/nure:0.2.0` and specifying file paths in functions handled by the package, the path will relative to package's root directory, e.g. setting `#show: coursework.with(bib_path: "bibl.yml")` will evaluate to `~/.local/share/typst/packages/local/nure/0.2.0/bibl.yml`, the same is for `#img` function, which makes it quite annoying and forces one to import `lib.typ` file. Please open an issue or contact us in any other way if you have any advice.

 ### Example Project Structure
 ```
 project/
 ├── main.typ -- for boilerplate code and importing everything 
-├── config/
-│   ├── doc.yaml -- for things that don't change across works, i.e. author and mentor metadata
-│   ├── universities.yaml -- for user-specific configuration, i.e. education programs and disciplines
-│   └── ...
 ├── src/
 │   ├── intro.typ
 │   ├── chapter1.typ
--- a/config/universities.yaml
+++ b/config/universities.yaml
@ -1,46 +0,0 @@
-ХНУРЕ:
-  name: Харківський національний університет радіоелектроніки
-  edu_programs:
-    ПЗПІ:
-      name_long: Інженерія програмного забезпечення
-      department_gen: Програмної інженерії
-      code: 121  # TODO: change to F2?
-    КУІБ:
-      name_long: Управління інформаційною безпекою
-      department_gen: Інфокомунікаційної інженерії ім. В. В. Поповського
-      code: 125
-  subjects:
-    ODS: Основи Dаtа Sсіеnсе # NOTE: Eng O here
-    ІМ: Іноземна мова
-    АКтаК: Архітектура комп'ютера та комп'ютерних мереж
-    АТСД: Алгоритми та структури даних
-    БД: Бази даних
-    БЖД: Безпека життєдіяльності
-    ВДІТБ: Введення до ІТ-бізнесу # NOTE: all in UA
-    ВМ: Вища математика
-    ГТГ: Гіпертекст та гіпермедіа
-    ДМ: Дискретна математика
-    КДМА: Комп'ютерна дискретна математика
-    КМ: Комп`ютерні мережі
-    КЗВШ: Креативність з використанням штучного інтелекту
-    ЛМВ: Людино-машинна взаємодія
-    МОТДО: Методи оптимізаціі та дослідження операцій
-    МС: Моделювання систем
-    ОІМ: Основи IP-мереж
-    ООП: Об'єктно-орієнтоване програмування
-    ОП: Основи права
-    ОПІ: Основи програмноі інженеріі
-    ОПНJ: Основи програмування на Java
-    ОПр: Основи програмування
-    ОС: Операційні системи
-    ОТК: Основи теорії кіл
-    ПНП: Програмування на платформі .NЕТ
-    ПП: Проектний практикум
-    ПРОГ: Програмування
-    СМП: Скриптові мови програмування
-    ТЙтаМ: Теорія ймовірностей та математична # TODO: what?
-    ТКП: Технології комп`ютерного проєктування
-    УФМ: Українське фахове мовлення
-    ФІЗ: Фізика
-    ФІЛ: Філософія
-    ФВС: Фізичне виховання та спорт
--- a/lib.typ
+++ b/lib.typ
@ -1,9 +1,14 @@
+// SPDX-License-Identifier: GPL-3.0
+/*
+ * typst-nure-template/lib.typ
+ *
+ * Typst library for NURE (Kharkiv National University of Radio Electronics) works
+ */

-// Academic aliases {{{1
+#import "style.typ": spacing, dstu-style, appendices-style
+#import "template.typ": *

-#let universities = yaml("config/universities.yaml")
-
-// Template formatting functions {{{1
+// TODO: Template formatting functions {{{

 /// numberless heading
 #let nheading(title) = heading(depth: 1, numbering: none, title)
@ -40,7 +45,11 @@
  "грудня",
 ).at(month - 1)

-// Helper functions {{{1
+// }}}
+
+// TODO: Helper functions {{{
+
+// TODO: those are dependent on path, move to separate file as a separate sublib for local usage.

 /// captioned image with label derived from path:
 /// - "image.png" = @image
@ -66,9 +75,9 @@
  }.replace(" ", "_")

  let caption = if sink.pos().len() == 0 {
-    caption + " (рисунок виконано самостійно)"
-  } else if sink.pos().first() == none {
    caption
+  } else if sink.pos().first() == none {
+    caption + " (рисунок виконано самостійно)"
  } else {
    [#caption (за даними #sink.pos().first())]
  }
@ -79,212 +88,9 @@
    ) #label(label_string)]
 }

-// Styling {{{1
-/// NOTE: may be wrong
-#let ua_alpha_numbering = "абвгдежиклмнпрстуфхцшщюя".split("") // 0 = "", 1 = "а"
+// }}}

-// general outlook {{{2
-// spacing between lines
-#let spacing = 0.95em
-
-// main {{{2
-#let style(it) = {
-  set page(
-    paper: "a4",
-    margin: (top: 20mm, right: 10mm, bottom: 20mm, left: 25mm),
-    number-align: top + right,
-    numbering: (..numbers) => {
-      if numbers.pos().at(0) != 1 {
-        numbering("1", numbers.pos().at(0))
-      }
-    },
-  )
-
-  set text(
-    font: ("Times New Roman", "Liberation Serif"),
-    size: 14pt,
-    hyphenate: false,
-    lang: "uk",
-  )
-  set par(justify: true, first-line-indent: (amount: 1.25cm, all: true))
-  set underline(evade: false)
-
-  // set 1.5 line spacing
-  set block(spacing: spacing)
-  set par(spacing: spacing)
-  set par(leading: spacing)
-
-  // enums and lists {{{3
-  set enum(
-    numbering: i => { ua_alpha_numbering.at(i) + ")" },
-    indent: 1.25cm,
-    body-indent: 0.5cm,
-  )
-  show enum: it => {
-    set enum(indent: 0em, numbering: "1)")
-    it
-  }
-
-  set list(indent: 1.35cm, body-indent: 0.5cm, marker: [--])
-
-  // figures {{{3
-  show figure: it => {
-    v(spacing * 2, weak: true)
-    it
-    v(spacing * 2, weak: true)
-  }
-
-  set figure.caption(separator: [ -- ])
-  show figure.where(kind: table): set figure.caption(position: top)
-  show figure.caption.where(kind: table): set align(left)
-
-  // figure numbering
-  show heading.where(level: 1): it => {
-    counter(math.equation).update(0)
-    counter(figure.where(kind: image)).update(0)
-    counter(figure.where(kind: table)).update(0)
-    counter(figure.where(kind: raw)).update(0)
-    it
-  }
-  set math.equation(
-    numbering: (..num) => numbering(
-      "(1.1)",
-      counter(heading).get().at(0),
-      num.pos().first(),
-    ),
-  )
-  set figure(
-    numbering: (..num) => numbering(
-      "1.1",
-      counter(heading).get().at(0),
-      num.pos().first(),
-    ),
-  )
-
-  // appearance of references to images and tables {{{3
-  set ref(
-    supplement: it => {
-      if it == none or not it.has("kind") {
-        it
-      } else if it.kind == image {
-        "див. рис."
-      } else if it.kind == table {
-        "див. таблицю"
-      } else {
-        it
-      }
-    },
-  )
-  show ref: it => {
-    let el = it.element
-
-    if el == none or not el.has("kind") {
-      return it
-    }
-    if el.kind != image and el.kind != table {
-      return it
-    }
-
-    [(#it)]
-  }
-
-  // headings {{{3
-  set heading(numbering: "1.1")
-
-  show heading.where(level: 1): it => {
-    set align(center)
-    set text(size: 14pt, weight: "semibold")
-
-    pagebreak(weak: true)
-    upper(it)
-    v(spacing * 2, weak: true)
-  }
-  show heading.where(level: 2): it => {
-    set text(size: 14pt, weight: "regular")
-
-    v(spacing * 2, weak: true)
-    block(width: 100%, spacing: 0em)[
-      #h(1.25cm)
-      #counter(heading).display(it.numbering)
-      #it.body
-    ]
-    v(spacing * 2, weak: true)
-  }
-
-  show heading.where(level: 3): it => {
-    set text(size: 14pt, weight: "regular")
-
-    v(spacing * 2, weak: true)
-    block(width: 100%, spacing: 0em)[
-      #h(1.25cm)
-      #counter(heading).display(it.numbering)
-      #it.body
-    ]
-    v(spacing * 2, weak: true)
-  }
-
-  // listings {{{3
-  show raw: it => {
-    let new_spacing = 0.5em
-    set block(spacing: new_spacing)
-    set par(
-      spacing: new_spacing,
-      leading: new_spacing,
-    )
-    set text(
-      size: 11pt,
-      font: ("Courier New", "Liberation Mono"),
-      weight: "semibold",
-    )
-
-    v(spacing * 2.5, weak: true)
-    pad(it, left: 1.25cm)
-    v(spacing * 2.5, weak: true)
-  }
-
-  it
-}
-
-// appendices {{{2
-#let appendices_style(it) = {
-  counter(heading).update(0)
-
-  set heading(
-    numbering: (i, ..nums) => {
-      let char = upper(ua_alpha_numbering.at(i))
-      if nums.pos().len() == 0 { char } else {
-        char + "." + nums.pos().map(str).join(".")
-      }
-    },
-  )
-
-  show heading.where(level: 1): it => {
-    set align(center)
-    set text(size: 14pt, weight: "regular")
-
-    pagebreak(weak: true)
-    bold[ДОДАТОК #counter(heading).display(it.numbering)]
-    linebreak()
-    it.body
-    v(spacing * 2, weak: true)
-  }
-
-  show heading.where(level: 2): it => {
-    set text(size: 14pt, weight: "regular")
-
-    v(spacing * 2, weak: true)
-    block(width: 100%, spacing: 0em)[
-      #h(1.25cm)
-      #counter(heading).display(it.numbering)
-      #it.body
-    ]
-    v(spacing * 2, weak: true)
-  }
-
-  it
-}
-
-// Coursework template {{{1
+// TODO: Coursework template {{{

 /// DSTU 3008:2015 Template for NURE
 /// -> content
@ -315,7 +121,7 @@
 ) = {
  set document(title: title, author: author.name)

-  show: style
+  show: dstu-style.with(skip: 1)

  let bib-count = state("citation-counter", ())
  show cite: it => {
@ -554,7 +360,8 @@
              not is_cyrillic(keywords.at(j)) and is_cyrillic(keywords.at(j + 1))
            )
              or (
-                is_cyrillic(keywords.at(j)) == is_cyrillic(keywords.at(j + 1)) and keywords.at(j) > keywords.at(j + 1)
+                is_cyrillic(keywords.at(j)) == is_cyrillic(keywords.at(j + 1))
+                  and keywords.at(j) > keywords.at(j + 1)
              )
          ) {
            (keywords.at(j), keywords.at(j + 1)) = (
@ -631,7 +438,10 @@
    }

    context {
-      for (i, citation) in query(ref.where(element: none)).map(r => str(r.target)).dedup().enumerate() {
+      for (i, citation) in query(ref.where(element: none))
+        .map(r => str(r.target))
+        .dedup()
+        .enumerate() {
        enum.item(
          i + 1,
          format-entry(bib_data.at(citation)),
@ -640,111 +450,7 @@
    }
  }

-  appendices_style(appendices)
-}
-
-// Practice and Laboratory works template {{{1
-
-/// DSTU 3008:2015 Template for NURE
-/// -> content
-/// - doc (content): Content to apply the template to.
-/// - doctype ("ЛБ" | "ПЗ"): Document type.
-/// - edu_program (str): Education program shorthand.
-/// - title (str): Title of the document.
-/// - subject (str): Subject shorthand.
-/// - authors ((name: str, full_name_gen: str, group: str, gender: str, variant: int or none),): List of authors.
-/// - mentors ((name: str, degree: str, gender: str or none),): List of mentors.
-/// - worknumber (int or none): Number of the work. Optional.
-#let pz-lb(
-  doc,
-  doctype: none,
-  university: "ХНУРЕ",
-  edu_program: none,
-  title: none,
-  subject: none,
-  worknumber: none,
-  authors: (),
-  mentors: (),
-) = {
-  set document(title: title, author: authors.at(0).name)
-
-  show: style
-
-  let uni = universities.at(university)
-  let edu_prog = uni.edu_programs.at(edu_program)
-  // page 1 {{{2
-  align(center)[
-    МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ \
-    #upper(uni.name)
-
-    \ \
-    Кафедра #edu_prog.department_gen
-
-    \ \ \
-    Звіт \
-    з
-    #if doctype == "ЛБ" [лабораторної роботи] else [практичної роботи]
-    #if worknumber != none {
-      context counter(heading).update(worknumber - if title == none {0} else {1})
-      [№#worknumber]
-    }
-
-    з дисципліни: "#uni.subjects.at(subject, default: "UNKNOWN SUBJECT, PLEASE OPEN AN ISSUE")"
-
-    #if title != none [з теми: "#title"]
-
-    \ \ \ \
-
-    #columns(2)[
-      #set align(left)
-      #set par(first-line-indent: 0pt)
-      #if authors.len() == 1 {
-        let author = authors.at(0)
-        if author.gender == "m" [Виконав:\ ] else [Виконала:\ ]
-        [
-          ст. гр. #edu_program\-#author.group\
-          #author.name\
-        ]
-        if "variant" in author.keys() and author.variant != none [Варіант: №#author.variant]
-      } else [
-        Виконали:\
-        ст. гр. #edu_program\-#authors.at(0).group\
-        #for author in authors [#author.name\ ]
-      ]
-
-      #colbreak()
-      #set align(right)
-
-      #if mentors.len() == 1 {
-        let mentor = mentors.at(0)
-        if mentor.gender == none [Перевірили:\ ] else if (
-          mentor.gender == "m"
-        ) [Перевірив:\ ] else [Перевірилa:\ ]
-        [
-          #if mentor.degree != none [#mentor.degree\ ]
-          #mentor.name\
-        ]
-      } else [
-        Перевірили:\
-        #for mentor in mentors {
-          [
-            #mentor.degree\
-            #mentor.name\
-          ]
-        }
-      ]
-    ]
-
-    #v(1fr)
-
-    Харків -- #datetime.today().display("[year]")
-  ]
-
-  pagebreak(weak: true)
-
-  if title != none [#heading(title)]
-
-  doc
-}
+  appendices-style(appendices)
+} // }}}

 // vim:sts=2:sw=2:fdl=0:fdm=marker:cms=/*%s*/
--- a/style.typ
+++ b/style.typ
@ -0,0 +1,160 @@
+// SPDX-License-Identifier: GPL-3.0
+/*
+ * style.typ: Styles beneficial beyond the typst-nure-template
+ */
+
+#let spacing = 0.95em // spacing between lines
+#let num-to-alpha = "абвгдежиклмнпрстуфхцшщюя".split("") // 0 = "", 1 = "а"
+
+/// DSTU 3008:2015 Style
+/// -> content
+/// - it (content): Content to apply the style to.
+/// - skip (int): Do not show page number for this number of pages.
+/// - offset (int): Adjust all page numbers by this amount.
+#let dstu-style(
+  it,
+  skip: 0,
+  offset: 0,
+) = {
+  // General Styling {{{1
+  set page(
+    paper: "a4",
+    number-align: top + right,
+    margin: (top: 20mm, right: 10mm, bottom: 20mm, left: 25mm),
+    numbering: (i, ..) => if i > skip { numbering("1", i + offset) },
+  )
+
+  set text(
+    lang: "uk",
+    size: 14pt,
+    hyphenate: false,
+    font: ("Times New Roman", "Liberation Serif"),
+  )
+
+  set par(
+    justify: true,
+    spacing: spacing,
+    leading: spacing,
+    first-line-indent: (amount: 1.25cm, all: true),
+  )
+
+  set block(spacing: spacing)
+  set underline(evade: false)
+
+  // Enums & Lists {{{1
+  // First level
+  set enum(
+    indent: 1.25cm,
+    body-indent: 0.5cm,
+    numbering: i => { num-to-alpha.at(i) + ")" },
+  )
+
+  // Second level and further nesting
+  show enum: it => {
+    set enum(indent: 0em, numbering: "1)")
+    it
+  }
+
+  // Lists are not intended for multiple levels, use `enum`
+  set list(indent: 1.35cm, body-indent: 0.5cm, marker: [--])
+
+  // Figures {{{1
+  show figure: it => {
+    v(spacing * 2, weak: true)
+    it
+    v(spacing * 2, weak: true)
+  }
+
+  set figure.caption(separator: [ -- ])
+  show figure.where(kind: table): set figure.caption(position: top)
+  show figure.caption.where(kind: table): set align(left)
+
+  // Numbering {{{1
+  show heading.where(level: 1): it => {
+    counter(math.equation).update(0)
+    counter(figure.where(kind: raw)).update(0)
+    counter(figure.where(kind: image)).update(0)
+    counter(figure.where(kind: table)).update(0)
+    it
+  }
+  set figure(numbering: i => numbering("1.1", counter(heading).get().at(0), i))
+  set math.equation(numbering: i => numbering("(1.1)", counter(heading).get().at(0), i))
+
+  // Headings {{{1
+  set heading(numbering: "1.1")
+
+  show heading: it => if it.level == 1 {
+    set align(center)
+    set text(size: 14pt, weight: "semibold")
+
+    pagebreak(weak: true)
+    upper(it)
+    v(spacing * 2, weak: true)
+  } else {
+    set text(size: 14pt, weight: "regular")
+
+    v(spacing * 2, weak: true)
+    block(width: 100%, spacing: 0em)[
+      #h(1.25cm)
+      #counter(heading).display(auto)
+      #it.body
+    ]
+    v(spacing * 2, weak: true)
+  }
+
+  // Listings {{{1
+  show raw: it => {
+    let raw-spacing = 0.5em
+    set block(spacing: raw-spacing)
+    set par(spacing: raw-spacing, leading: raw-spacing)
+    set text(
+      size: 11pt,
+      weight: "semibold",
+      font: ("Courier New", "Liberation Mono"),
+    )
+
+    v(spacing * 2.5, weak: true)
+    pad(it, left: 1.25cm)
+    v(spacing * 2.5, weak: true)
+  }
+
+  it
+  // }}}
+}
+
+/// DSTU 3008:2015 Appendices Style
+/// -> content
+/// - it (content): Content to apply the style to.
+#let appendices-style(it) = /* {{{ */ {
+  // Numbering
+  counter(heading).update(0)
+  set heading(numbering: (i, ..n) => upper(num-to-alpha.at(i)) + numbering(".1.1", ..n))
+  set figure(numbering: i => [#upper(num-to-alpha.at(counter(heading).get().at(0))).#i])
+  set math.equation(numbering: i => [(#upper(num-to-alpha.at(counter(heading).get().at(0))).#i)])
+
+  // Headings
+  show heading: it => if it.level == 1 {
+    set align(center)
+    set text(size: 14pt, weight: "regular")
+
+    pagebreak(weak: true)
+    text(weight: "bold")[ДОДАТОК #counter(heading).display(auto)]
+    linebreak()
+    it.body
+    v(spacing * 2, weak: true)
+  } else {
+    set text(size: 14pt, weight: "regular")
+
+    v(spacing * 2, weak: true)
+    block(width: 100%, spacing: 0em)[
+      #h(1.25cm)
+      #counter(heading).display(auto)
+      #it.body
+    ]
+    v(spacing * 2, weak: true)
+  }
+
+  it
+} // }}}
+
+// vim:sts=2:sw=2:fdl=0:fdm=marker:cms=/*%s*/
--- a/template.typ
+++ b/template.typ
@ -0,0 +1,129 @@
+// SPDX-License-Identifier: GPL-3.0
+/*
+ * typst-nure-template/template.typ
+ *
+ * Typst templates for NURE (Kharkiv National University of Radio Electronics) works
+ */
+
+#import "style.typ": spacing, dstu-style, appendices-style
+
+// Practice and Laboratory works template {{{
+
+/// DSTU 3008:2015 Template for NURE
+/// -> content
+/// - it (content): Content to apply the template to.
+/// - department (str): Education program name.
+/// - work_type (str): Work type, i.e. "з лабораторної роботи".
+/// - number (int | none): Number of the work. Optional.
+/// - subject (str): Subject name.
+/// - title (str | none): Title of the work and the document. Optional.
+/// - variant (int | none): Variant of the work. Optional.
+/// - author ((name: str, group: (str | none), gender: ("m" | "f" | none)),):
+///   A dictionary of one author or an array of authors. Other types will be just displayed.
+/// - mentor ((name: str, degree: (str | none), gender: ("m" | "f" | none)),):
+///   A dictionary of one mentor or an array of mentors. Other types will be just displayed.
+#let general(
+  it,
+  department: none,
+  work_type: none,
+  number: none,
+  subject: none,
+  title: none,
+  variant: none,
+  author: none,
+  mentor: none,
+  year: datetime.today().display("[year]"),
+) = {
+  assert.ne(department, none, message: "Missing argument: \"department\"")
+  assert.ne(work_type, none, message: "Missing argument: \"work_type\"")
+  assert.ne(subject, none, message: "Missing argument: \"subject\"")
+
+  if type(author) == array and author.len() == 1 { author = author.at(0) }
+  if type(mentor) == array and mentor.len() == 1 { mentor = mentor.at(0) }
+
+  set document(
+    title: title,
+    author: if type(author) == array {
+      author.map(a => a.name)
+    } else if type(author) == dictionary { author.name } else { "" },
+  )
+
+  show: dstu-style.with(skip: 1)
+
+  align(center)[
+    МІНІСТЕРСТВО ОСВІТИ І НАУКИ УКРАЇНИ
+
+    ХАРКІВСЬКИЙ НАЦІОНАЛЬНИЙ УНІВЕРСИТЕТ РАДІОЕЛЕКТРОНІКИ
+    \ \ \
+
+    Кафедра #department
+    \ \ \ \
+
+    Звіт
+
+    #work_type #if number != none [
+      №#number
+      #counter(heading).update(number - if title != none { 1 } else { 0 })
+    ]
+
+    з дисципліни: "#subject"
+
+    #if title != none [з теми: "#title"]
+
+    \ \ \ \
+
+    #columns(2)[
+      #set par(first-line-indent: 0pt)
+      //
+      #set align(left)
+      //
+      #if type(author) == dictionary [
+        #if "gender" in author and author.gender != none {
+          if author.gender == "m" [Виконав:] else [Виконала:]
+        } else [Виконали:]
+
+        #if "group" in author [ст. гр. #author.group\ ]
+        #author.name\
+        #if variant != none [Варіант: №#variant]
+      ] else if type(author) == array [
+        Виконали:
+
+        #for a in author [
+          #if "group" in a [ст. гр. #a.group\ ]
+          #a.name\
+        ]
+        #if variant != none [Варіант: №#variant]
+      ] else { author } // custom formatting
+      //
+      #colbreak()
+      //
+      #set align(right)
+      //
+      #if type(mentor) == dictionary [
+        #if "gender" in mentor and mentor.gender != none {
+          if mentor.gender == "m" [Перевірив:] else [Перевірила:]
+        } else [Перевірили:]
+
+        #if "degree" in mentor and mentor.degree != none [#mentor.degree\ ]
+        #mentor.name
+      ] else if type(mentor) == array [
+        Перевірили:
+
+        #for m in mentor [
+          #if "degree" in m [#m.degree\ ]
+          #m.name\
+        ]
+      ] else { mentor } // custom formatting
+    ]
+    #v(1fr)
+    Харків -- #year
+  ]
+
+  pagebreak(weak: true)
+
+  if title != none { heading(title) }
+
+  it
+} // }}}
+
+// vim:sts=2:sw=2:fdl=0:fdm=marker:cms=/*%s*/
--- a/template/config/doc.yaml
+++ b/template/config/doc.yaml
@ -1,22 +0,0 @@
-title: Потiк керування та алгоритмічні структури Bash
-subject: СМП
-doctype: ЛБ
-worknumber: 2
-mentors:
-  - name: Шевченко Т. Г.
-    degree: Доцент кафедри ПІ
-    gender: m
-  - name: Франко І. Я.
-    degree: Асистент кафедри ПІ
-    gender: m
-edu_program: &EDU ПЗПІ
-university: ХНУРЕ
-authors:
-  - name: Косач Л. П.
-    full_name_gen: Косач Лариси Петрівни
-    course: 2
-    edu: *EDU
-    gender: f
-    group: 23-2
-    semester: 4
-    variant: 8
--- a/template/coursework.typ
+++ b/template/coursework.typ
@ -1,4 +1,4 @@
-#import "@local/nure:0.1.0": *
+#import "@local/nure:0.2.0": *

 #let author = (
  name: "Ситник Є. С.",
--- a/template/lab.typ
+++ b/template/lab.typ
@ -1,6 +1,21 @@
-#import "@local/nure:0.1.0": *
+#import "@local/nure:0.2.0": *

-#show: pz-lb.with(..yaml("config/doc.yaml"))
+#show: general.with(
+  department: "Програмної інженерії",
+  work_type: "з лабораторної роботи",
+  number: 3,
+  subject: "Операційні системи",
+  title: "Керування зовнішніми пристроями. Нестандартні пристрої",
+  author: (
+    (name: "Шевчентко Т. Г.", group: "ПЗПІ-23-0"),
+    (name: "Косач Л. П."),
+  ),
+  mentor: (
+    gender: "m",
+    name: "Франко І. Я.",
+    degree: "доц. каф. ПІ",
+  ),
+)

 #v(-spacing)

@ -30,7 +45,7 @@
 - #lorem(42);
 - #lorem(27).

-#show: appendices_style
+#show: appendices-style

 = Quote
 #link("https://youtu.be/bJQj1uKtnus")[
--- a/typst.toml
+++ b/typst.toml
@ -1,6 +1,6 @@
 [package]
 name = "nure"
-version = "0.1.0"
+version = "0.2.0"
 entrypoint = "lib.typ"
 authors = ["linerds"]
 license = "GPL-3.0"
Author	SHA1	Message	Date
Anton Bilous	151f1c9128	feat(template): add asserts	2025-06-11 18:06:39 +03:00
Anton Bilous	6207d2d82a	feat(style)!: remove reference styling & fix figure numbering for appendices Use `@some_label[див. фігуру]` to get a "див. фігуру 42" link.	2025-05-19 17:24:36 +03:00
Anton Bilous	c2755772e1	feat(template)!: "pz-lb" template rewrite as a "general" one	2025-05-14 10:53:49 +03:00
Anton Bilous	f4a5ebc7fe	feat(style)!: extract styling to style.typ, bump version to 0.2.0	2025-05-12 10:31:53 +03:00