This is an academic template for dissertations and theses, based on the formatting guidelines provided by the Universidade do Estado de Santa Catarina (UDESC). This is not an official project.

All pre-textual elements have been automated, along with a few style conventions. The goal of this template is to simplify the formatting process for academic writing according to institutional norms, allowing you to focus on content rather than layout. If you’d like to help, feel free to send me an email at: lucas [at] bublitz.art.br.

Warnings

• Typst currently does not allow modification of template code hosted under @preview.
• If you need to edit internal textual elements generated by the bellbird-paper-udesc function, you must include the .typ file locally in your project.
  • The source file is available at: https://github.com/lucas-bublitz/bellbird-udesc-paper
• Arial and Times New Roman fonts are not bundled with the Typst compiler by default — not even in the web version.
  • Therefore, they must be added manually.
  • Due to package guidelines, it’s not allowed to include external font files directly in a template.
• In the Typst web app, local font files are automatically recognized when present in the project.
  • However, if you run Typst locally, the fonts must be installed on your operating system to render correctly (alternatively, it’s possible to specify a path to the font folder using the --font-path flag).
  • On Windows, these fonts are typically pre-installed.

Configuration

The template exports the paper-udesc function with the following named arguments:

Required Arguments

Optional Arguments

These arguments are optional. If omitted, the related section is not shown:

Pre-textual Elements

The following elements are always generated and required for the institutional manual:

Optional

The following sections are only rendered if their arguments are provided or flags enabled:

Style Automations

The paper-udesc Typst template automates some visual and structural formatting aspects, like the followings:

the template will initialize you with a sample call to the paper-udesc function in a show rule, along with some examples and a starter structure file to organize the text (not yet).

#show: paper-udesc.with(
  // ARGUMENTOS OBRIGATÓRIOS 
  campus: [Centro de Ciências Tecnológicas -- CCT],
  department: [Programa de Pós-Graduação em Engenharia Mecânica],
  abstract: lorem(100),
  keywords: ("Primeira", "Segunda", "Terceira"),
  foreignAbstract: lorem(100),
  foreignKeywords: ("First", "Second", "Third"),
  title : [Modelo de Trabalhos Acadêmicos da Udesc],
  subtitle: [em Typst!],
  city: "Joinville",
  date: (
    day: 01,
    month: "janeiro",
    year: 1970
  ),
  author : "Snoop Dog",
  obverse: [Artigo apresentado ao curso de graduação em alguma coisa do campous tal como requisito parcial para obtenção do título de Bacharel naquela coisa.],
  advisor: (
    name: "Manoel Gomes",
    titulation: "Dr.",
    institution: "Universidade do Estado de Santa Catarina"
  ),
  committee: (
    (
      name: "Stephen Timoshenko",
      titulation: "Dr.",
      institution: "Petersburg State Transport University"
    ),
    (
      name: "Willis Carrier",
      titulation: "Dr. h. c.",
      institution: "Cornell University"
    ),
    (
      name: "Leonhard Euler",
      titulation: "Dr.",
      institution: "University of Basel"
    )
  ),
  class: "Dissertação",
  // ARGUMENTOS OPCIONAIS
  // Estes argumentos quando omitidos fazem com que suas respectivas páginas também o sejam.
  dedication: [Aos alunos da Universidade do Estado de Santa Catarina, altissíssimo.], 
  acknowledgments : [Eu quero me agradecer por acreditar em mim mesmo, quero me agradecer por todo esse trabalho duro. Quero me agradecer por não tirar folgas. Quero me agradecer por nunca desistir. Quero me agradecer por ser generoso e sempre dar mais do que recebo. Quero me agradecer por tentar sempre fazer mais o certo do que o errado. Quero me agradecer por ser eu mesmo o tempo inteiro.],
  epigraph : [_Somos por essa causa, essa somente,\ perdidos, mas nossa pena é só esta:\ sem esperança, ansiar eternamente._\ \ (A Divina Comédia, Canto IV, 40-42, Dante Alighieri)],
  index-card: true
)

// Aqui começam os elementos textuais!

Sample figures licensing

All example figures included in this project are licensed under the Creative Commons Attribution 3.0 Unported (CC BY 3.0). Credits and source links for each figure are included in the template’s .bib file.