A Typst template for Indonesian university reports.

See the example.pdf file to see how it looks.

Usage

You can use this template in the Typst web app by clicking “Start from template” on the dashboard and searching for jilid.

Alternatively, you can use the CLI to kick this project off using the command

typst init @preview/jilid

Typst will create a new directory with all the files needed to get you started.

The template initializes your project with a sample call to the jilid function in a show rule. If you want to change an existing project to use this template, add a show rule like this at the top of your file:

#import "@preview/jilid:0.1.0": jilid, frontmatter, appendices

#show: jilid.with(
  title: [Judul Dokumen],
  kind: [Jenis Dokumen],
  course: "Nama Mata Kuliah",
  lecturers: (name: "Nama Dosen", id: "10000000000000000"),
  students: (
    (name: "Nama Mahasiswa", id: "1000000001"),
  ),
  program: "Teknik Informatika",
  faculty: "Teknik",
  university: "Universitas Negeri",
  year: "2026",
  // logo: image("logo.png"),
  // cover-details: (([Mitra Kolaborator:], [Nama Mitra]),),
  // typography: (font-family: "Times New Roman"),
  bibliography: bibliography("refs.bib", style: "apa"),
)

#frontmatter(title: [Kata Pengantar])[ ... ]

= Pendahuluan
...

#appendices[
  = Dokumentasi Kegiatan
  ...
]

Fonts

The body font is Typst’s bundled Libertinus Serif, so the template compiles without font warnings. Most campus guidelines ask for Times New Roman, which Typst cannot ship. To use it, install it or upload the font files to your web app project, then set:

#show: jilid.with(typography: (font-family: "Times New Roman"))

Packages used

• zebraw: code blocks with line numbers (turn off with code: (zebraw: false)). Re-exported, so #import "@preview/jilid:0.1.0": zebraw gives you its full API.

Document structure

jilid displays your document in this order:

1. Cover, when title is set
2. Front matter, from #frontmatter(title: [..])[..]
3. Daftar Isi, then Daftar Tabel, Gambar, Kode and Lampiran when the document has any
4. Chapters, from = Heading",
5. Bibliography, from the bibliography option
6. Appendices, from #appendices[= Heading ..]

Configuration

This template exports the jilid function with the named arguments below. It also takes a single positional argument: the body of your document, which #show: jilid.with(..) passes for you.

Option groups such as cover or footer take a dictionary, and only the keys you give change, e.g. footer: (left: [Laporan Akhir]).

Document information

• title
  type: content or str
  default: ""
  description: Document title, on the cover and in the PDF metadata.

• kind
  type: content or none
  default: none
  description: Document kind on the cover, e.g. [Laporan Praktikum].

• subtitle
  type: content or str
  default: ""
  description: Second title line on the cover.

• cover-details
  type: array
  default: ()
  description: Extra (label, value) rows under the title, e.g. (([Mitra Kolaborator:], [Nama Mitra]),).

• course
  type: content or str
  default: ""
  description: Course name, after “Mata Kuliah :”.

• lecturers
  type: dictionary or array
  default: ()
  description: One (name: .., id: ..) dictionary or an array of them. id is optional.

• students
  type: dictionary or array
  default: ()
  description: One (name: .., id: ..) dictionary or an array of them. id is optional, and name may be content.

• program, department, faculty
  type: content or str
  default: ""
  description: Printed with their label, e.g. faculty: "Teknik" gives “FAKULTAS TEKNIK”. A value that already starts with the label, such as "Fakultas Teknik", is not prefixed twice.

• university, year
  type: content or str
  default: ""
  description: Bottom of the cover.

• logo
  type: content or none
  default: none
  description: The logo on the cover, e.g. image("logo.png").

• bibliography
  type: content or none
  default: none
  description: The result of a call to the bibliography function, e.g. bibliography("refs.bib", style: "apa").

• lang
  type: str
  default: "id"
  description: "id" or "en". Other languages go through labels.

• paper
  type: str
  default: "a4"
  description: A paper size string.

• margin
  type: str, length or dictionary
  default: "print"
  description: "print" has 4 cm on the left and 3 cm elsewhere, for bound copies. "digital" has 1 inch all round. Any page margin value also works.

• include-cover
  type: bool or auto
  default: auto
  description: auto shows the cover when title is set.

cover

• top
  type: length
  default: 2cm
  description: Space above the title.

• logo-width
  type: length
  default: 8cm
  description: Logo width, unless the image sets its own.

• kind-pos
  type: str
  default: "bottom"
  description: "top" puts kind above the title, "bottom" below it.

• gap
  type: length
  default: 0.2cm
  description: Space between the course, lecturer and student blocks.

• gap-institution
  type: length
  default: 1cm
  description: Space kept above the university block.

• gap-logo
  type: length
  default: 0.5cm
  description: Space kept above and below the logo.

• student-columns
  type: int or auto
  default: auto
  description: Columns of the student list. auto uses the fewest columns up to 3 that fit the page.

• student-id-pos
  type: str
  default: "right"
  description: "right" puts the student id beside the name, "below" under it.

• title, kind, subtitle, details, label, course, lecturer-name, student-name, id, institution
  type: dictionary
  default: see below
  description: Text style of each cover text. A style takes any text argument, such as size, weight, style, fill or tracking, plus upper and underline.

  • title: (size: 18pt, weight: "bold", upper: true)
  • kind: (size: 14pt, weight: "bold", upper: true)
  • subtitle: (size: 18pt, weight: "bold", upper: true)
  • details: (size: 14pt, weight: "bold"), the cover-details rows
  • label: (:), “Mata Kuliah :”, “Dosen Pengampu :”, “Disusun oleh :”
  • course: (weight: "bold")
  • lecturer-name: (weight: "bold", style: "italic", underline: true)
  • student-name: (:)
  • id: (:), the “NIP …” and “NIM …” lines
  • institution: (weight: "bold", upper: true), university, faculty, department, program and year

• render
  type: function or auto
  default: auto
  description: Draws the whole cover yourself. The function gets one dictionary with title, kind, subtitle, details, course, lecturers, students, logo, university, faculty, department, program (the last three already prefixed, e.g. “FAKULTAS Teknik”), year and labels. The styles and layout options above no longer apply.

If the cover runs onto a second page, lower logo-width, the details size or the gap-* options, set student-columns, or use margin: "digital".

for example:

#show: jilid.with(
  kind: [Laporan],
  cover: (
    kind: (style: "italic"),
    student-name: (style: "normal", upper: true),
  ),
  labels: (students: [Oleh]),
)

typography

• font-family
  type: str, array or auto
  default: auto
  description: Body font, or a list of fonts to try in order. auto uses Typst’s bundled Libertinus Serif.

• font-size
  type: length
  default: 12pt
  description: Body text size.

• caption-size
  type: length
  default: 10pt
  description: Figure and table caption size.

• caption-gap
  type: length
  default: 1em
  description: Space between a figure and its caption.

• table-size
  type: length
  default: 10pt
  description: Text size inside tables.

• caption
  type: function or auto
  default: auto
  description: Draws each caption yourself. The function gets one dictionary with supplement (“Gambar”), number (“3.1”, “L1.1” in appendices), body and kind. caption-size still applies. for example, caption: it => strong[#it.supplement #it.number. #it.body].

paragraph

• justify
  type: bool
  default: true
  description: Justify paragraphs.

• indent
  type: length
  default: 0.63cm
  description: First-line indent.

• leading
  type: length
  default: 0.575em
  description: Space between lines.

• spacing
  type: length
  default: 1.15em
  description: Space between paragraphs.

• list-indent
  type: length
  default: 0cm
  description: Space before numbered and bullet markers.

• marker-width
  type: length
  default: 0.75cm
  description: Width of the marker column. List text starts after it.

numbering

• front
  type: str
  default: "i"
  description: Page number style before the first chapter.

• back
  type: str
  default: "body"
  description: Appendix page numbers. "body" continues the chapter page numbers, "front" continues the front matter ones.

• position
  type: str
  default: "bottom"
  description: "top" puts chapter and appendix page numbers at the top right, except on pages that open a chapter. Front matter stays at the bottom.

• chapter
  type: str
  default: "I"
  description: Chapter number style. "I" gives BAB I, "1" gives BAB 1.

• appendix
  type: str
  default: "1"
  description: Appendix number style. "1" gives Lampiran 1, "A" gives Lampiran A.

• heading
  type: str
  default: "1.1."
  description: Section number style inside a chapter.

• appendix-prefix
  type: bool
  default: true
  description: Put “Lampiran 1.” before each appendix title.

headings

• h1
  type: dictionary
  default: (size: 12pt, above: 24pt, below: 18pt, pagebreak: true, uppercase: true)
  description: Chapter and front matter titles. pagebreak starts each chapter on a new page. uppercase writes the title in capitals, on the page and in DAFTAR ISI.

• h2
  type: dictionary
  default: (size: 12pt, above: 24pt, below: 18pt, indent: 0cm)
  description: Level-2 headings.

• h3
  type: dictionary
  default: (size: 12pt, above: 14pt, below: 18pt, indent: 0cm)
  description: Level-3 headings.

• h4
  type: dictionary
  default: (size: 12pt, above: 12pt, below: 18pt, indent: 0cm)
  description: Level-4 headings and deeper.

• appendix
  type: dictionary
  default: (uppercase: false)
  description: Numbered appendix titles, e.g. “Lampiran 1. Hasil Wawancara”.

outlines

• toc
  type: bool
  default: true
  description: Show DAFTAR ISI.

• depth
  type: int
  default: 3
  description: Heading levels in DAFTAR ISI.

• tables, figures, codes
  type: bool
  default: true
  description: Show DAFTAR TABEL, GAMBAR and KODE when the document has any.

• appendices
  type: bool
  default: true
  description: Show DAFTAR LAMPIRAN when there are appendices.

• toc-appendices
  type: bool
  default: false
  description: List each appendix in DAFTAR ISI too. false lists only the LAMPIRAN title, as most campus guidelines do.

• h1
  type: dictionary
  default: (weight: "bold")
  description: Text style of chapter rows in DAFTAR ISI, like the cover styles.

• leader
  type: str, content or none
  default: "."
  description: Text repeated between an entry and its page number. none removes it.

footer

• enabled
  type: bool
  default: true
  description: Show a footer on every page except the cover.

• left
  type: content or none
  default: none
  description: Footer text, above the page number.

• show-page-number
  type: bool
  default: true
  description: Show the page number.

• page-number-align
  type: alignment
  default: center
  description: Page number alignment.

• text
  type: dictionary
  default: (size: 9pt, weight: "bold")
  description: Text style of left, like the cover styles.

• render
  type: function or auto
  default: auto
  description: Draws the footer yourself. The function gets one dictionary with number (the page number, or none where it is not shown), left (the current footer text) and part ("front", "main" or "back"). The other footer options, except enabled and show-page-number, no longer apply.

for example, “Halaman 3” on the right:

footer: (
  left: [Laporan Praktikum],
  render: it => grid(
    columns: (1fr, auto),
    emph(it.left), if it.number != none [Halaman #it.number],
  ),
)

code

• zebraw
  type: bool or dictionary
  default: true
  description: Code blocks with line numbers via zebraw. false gives a plain shaded block. A dictionary passes options to zebraw, e.g. (lang: false).

• fill
  type: color
  default: luma(240)
  description: Code block background.

• font
  type: str or auto
  default: auto
  description: Code font. auto keeps Typst’s bundled monospace font.

• size
  type: length
  default: 10pt
  description: Code text size.

labels

type: dictionary
default: (:)
description: Every word jilid puts on the page. lang picks the defaults, and labels replaces single words with your own content or str.

for example:

labels: (
  students: [Disusun oleh : \ Kelompok 3],  // cover, with the group below
  student-id: none,         // cover: the student number without "NIM"
  figure: "Gbr.",           // captions and refs: "Gbr. 2.1"
  toc: [ISI],               // "DAFTAR ISI"
)

Keys, with their id and en defaults:

• course, lecturer, students: Mata Kuliah :, Dosen Pengampu :, Disusun oleh : / Course :, Lecturer :, Prepared by :
• student-id, lecturer-id: NIM, NIP / NIM, NIP
• program, faculty, department: PROGRAM STUDI, FAKULTAS, JURUSAN / STUDY PROGRAM OF, FACULTY OF, DEPARTMENT OF
• toc, lof, lot, loc, appendix-list: DAFTAR ISI, GAMBAR, TABEL, KODE, LAMPIRAN / TABLE OF CONTENTS, LIST OF FIGURES, TABLES, CODES, APPENDICES
• bibliography, appendices, appendix, chapter: DAFTAR PUSTAKA, LAMPIRAN-LAMPIRAN, Lampiran, BAB / BIBLIOGRAPHY, APPENDICES, Appendix, CHAPTER
• appendix-short: L / A, before figure numbers in appendices, e.g. “Gambar L1.2”
• figure, table, code, equation, section: Gambar, Tabel, Kode, Persamaan, Bagian / Figure, Table, Code, Equation, Section
• page: halaman / page

For a language other than id or en, set lang and provide every key; the error message lists the missing ones.

Functions

• frontmatter(title: none, numbering: auto, start-page: auto, outlined: true)[..]
  description: Front matter pages. The title is styled like a chapter title. numbering changes the page number style for these pages only, e.g. "I".

• appendices[..]
  description: Appendices. Level-1 headings inside become “Lampiran 1”, …

• signature(role: none, name: none, id: none, id-label: "NIP", space: 2cm, underline-name: false, alignment: center)
  description: One signature with role, space to sign, bold name and id. Never split across pages.

• signatures(..signature, header: none, columns: 2, gutter: 1cm)
  description: Signatures under a full-width header, such as place, date and “Mengetahui,”. columns per row, names lined up, and a shorter last row in the center.

• set-footer-text(content)
  description: Change the footer text from this page on. none restores footer.left.

• zebraw
  description: Re-exported from the zebraw package, for highlighted lines and comments.

Contributing

Bug reports and requests for campus rules jilid does not support yet are welcome as GitHub issues. See CONTRIBUTING.md for development.

License

MIT, see LICENSE. The files in template/, which become your own document, are MIT-0: use them without attribution.