unofficial-hso-thesis

Typst template for Bachelor's, Master's theses and seminar reports at Hochschule Offenburg (University of Applied Sciences Offenburg). Supports multiple faculties and follows the official academic writing guidelines.

Supported Faculties

Key	Faculty
faculty.EMI	Elektrotechnik, Medizintechnik und Informatik
faculty.MV	Maschinenbau & Verfahrenstechnik
faculty.W	Wirtschaft

Quick Start

Initialize a new project:

typst init @preview/unofficial-hso-thesis:0.1.0

This copies the template files into your project. Edit main.typ to fill in your metadata and start writing.

Usage

#import "@preview/unofficial-hso-thesis:0.1.0": company, faculty, styles, supervisor, thesis, thesis-info, thesis-type

#let info = thesis-info(
  lang: "de",
  thesis-type: thesis-type.BACHELOR,
  title: "Haupttitel der Bachelorthesis",
  subtitle: "Untertitel",
  author: "Max Mustermann",
  degree: "Informatik",
  faculty: faculty.EMI,
  period: [01.01.2026 -- 30.06.2026],
  supervisors: (
    supervisor(name: "Prof. Dr. Max Mustermann", institution: "Hochschule Offenburg", gender: "m"),
    supervisor(name: "Maxi Musterfrau", institution: "Musterfirma"),
  ),
  companies: (
    company(name: "Musterfirma GmbH"),
  ),
  location: "Offenburg",
  copyright: true,
  ai-usage: 1, // 1: listed in appendix, 2: marked in text, 3: prohibited, none: disabled
  glossary: yaml("glossary.yaml"),
  bibliography: read("Bibliography.yaml", encoding: none),
  bibliography-style: read("ieee.csl", encoding: none),
)

#show: thesis.with(
  info: info,
  style: styles.emi,
  abstract: include "abstract.typ",
  appendix: include "appendix.typ"
)

#include "chapters/01_introduction.typ"

Parameters

thesis-info

Central metadata object for the thesis.

Parameter	Type	Description
lang	str	"de" or "en"
thesis-type	thesis-type.*	BACHELOR, MASTER, or SEMINAR
title	str	Main title
subtitle	str	Subtitle (optional)
author	str	Author's full name
degree	str	Degree programme
faculty	faculty.*	EMI, MV, or W
period	content	Processing period, e.g. [01.01.2026 -- 30.06.2026]
supervisors	array	Array of supervisor() objects
companies	array	Array of company() objects
location	str	City for the declaration signature
copyright	bool	Grant HSO right to use the work for teaching
ai-usage	int or none	AI usage declaration: 1 (list in appendix), 2 (marked in text), 3 (prohibited), none (disabled)
glossary	dict	Loaded YAML data for the glossary
bibliography	bytes	Bibliography file content via read(..., encoding: none)
bibliography-style	bytes	CSL file content via read(..., encoding: none)

thesis (main function)

Parameter	Type	Description
info	dict	The thesis-info object
style	func	Faculty style: styles.emi, styles.mv, or styles.w
abstract	content	Abstract content (optional)
appendix	content	Appendix content (optional)
body	content	Main document content

Helper functions

• supervisor(name, institution, gender) — creates a supervisor entry; gender is "m" or "f".
• company(name, logo) — creates a company entry; logo is an optional image().

Fonts

This template uses Arial (body text) and Courier New (code/listings). Both are standard system fonts on Windows and macOS. On Linux, install the Microsoft core fonts:

# Debian/Ubuntu
sudo apt install ttf-mscorefonts-installer

# Arch
yay -S ttf-ms-fonts

Alternatively, compile with --font-path /path/to/fonts pointing to a directory containing arial.ttf and cour.ttf.

License

• src/ — MIT License. Package source code.
• template/ — MIT-0 (No Attribution). You can freely publish your thesis without including any copyright notice.
• assets/hso-logo.svg — property of Hochschule Offenburg, included with their permission. Not covered by the MIT/MIT-0 licenses.