[中文]

A Yanshan University slide theme for Touying and Typst. Version 0.2.0 follows the layout of a doctoral defense deck: a navy palette, a breadcrumb headline that carries the slide’s conclusion, chapter openers, a footer chapter navigation, and a component library for problem–method–conclusion pages. Speaker notes can be compiled into separate notes pages for presenter tools.

Cover	Chapter opener	Content slide

Requirements

• Typst 0.15.0 or later
• @preview/touying:0.8.0 (imported by the package)

Quick start

typst init @preview/simply-ysu-touying:0.2.0 my-slides
cd my-slides
typst compile main.typ

A minimal deck:

#import "@preview/simply-ysu-touying:0.2.0": *

#show: ysu-theme.with(
  aspect-ratio: "16-9",                 // or "4-3"
  nav-labels: ("Background", "Method", "Summary"),
  config-info(
    title: [Presentation Title],
    author: [Your Name],
    supervisor: [Supervisor],
    subject: [Discipline],
    school: [School],
    date: datetime.today(),
    stage: [学术汇报],
    stage-en: [Academic Presentation],
  ),
)

#title-slide()
#outline-slide()

= Background
#chapter-opener(question: [What is the core question of this chapter?], keywords: ([one], [two]))

== 1.1 Motivation
#sub[1.1.1 Optional subsection]
#takeaway[One sentence with the conclusion of this slide; it becomes the headline]

Slide content.

#ending-slide()

To work from a cloned repository, import the theme file instead:

#import "@preview/touying:0.8.0": *
#import "themes/ysu-beamer.typ": *

The bundled demo shows every component:

typst compile --root . examples/beamer-ysu.typ
typst compile --root . --input ratio=4-3 examples/beamer-ysu.typ   # 4:3 pages

Structure pages

ysu-theme parameters: aspect-ratio ("16-9" or "4-3"), align (vertical alignment of slide bodies), nav-labels and nav-full-labels (footer and opener chapter labels; default: the level-1 headings), font: (latin:, cjk:), notes (notes pages, see below).

Components

Colors and gradients (ysu-navy, ysu-red, ysu-tint, grad-key, …), seal(), wordmark() and logo() are exported as well.

Speaker notes

Write #note[...] anywhere in a slide; several notes on one slide join as paragraphs. The cover, contents and closing page take a note: argument; a chapter opener’s note goes right after = Chapter.

#show: ysu-theme.with(
  notes: sys.inputs.at("notes", default: "off") == "on",
  config-info(
    title: [Presentation Title],
    author: [Your Name],
  ),
)

#title-slide(note: [Good morning, my topic is …])

== 1.1 Motivation
#note[First paragraph of the script.

Second paragraph.]

typst compile --root . slides.typ                              # projector version
typst compile --root . --input notes=on slides.typ notes.pdf   # one notes page after each slide

Notes pages are as wide as the slide (16 cm × 13.5 cm for 16:9), dark, 18 pt. PDF page labels are N for slides and notes:N for notes pages, which FerroStage and pympress use to pair them; examples/check-page-labels.py notes.pdf --expect-notes checks them. Notes also go to pdfpc. Export the script as JSON with typst query --root . slides.typ "<ysu-note>" --field value. Pages split with #pause get their notes page after the last subpage only.

Fonts

Slides use sans-serif. CJK fallback: Source Han Sans → Noto Sans SC → Microsoft YaHei. Latin and digits: Arial. Change it with font: (latin: (...), cjk: (...)). If Source Sans 3 is installed, put it first in latin.

Migrating from 0.1.x

0.2.0 is a breaking release.

• Removed ysu-theme parameters: progress-bar, watermark, footer-columns, footer-a … footer-d. The footer now shows author · stage, the chapter navigation (nav-labels) and the page number.
• Pages are 16 cm × 9 cm (12 cm × 9 cm for 4:3) instead of presentation-16-9; the default body alignment is horizon.
• config-info gains supervisor, subject, school, stage and stage-en; the cover uses them, and institution, subtitle and short-title are no longer shown.
• title-slide(extra:) is replaced by research-line:; ending-slide takes title:, kicker: and recap: instead of a body-only page.
• New page markers sub[...] and takeaway[...], new chapter-opener(...), and the component library above; tblock remains as an alias of title-box.
• The palette changes from YSU blue (#2B69C1) to navy #1F296A with red #B42318 accents; fonts change from KaiTi / Times New Roman to Source Han Sans / Arial.
• @preview/cuti is no longer used: the theme relies on real bold weights instead of fake bold.

Included files

• lib.typ: package entrypoint
• themes/ysu-beamer.typ: theme, structure pages and notes
• themes/components.typ: component library
• themes/tokens.typ: colors, gradients, fonts and logos
• themes/assets/: YSU visual assets
• template/main.typ: template used by typst init

Licensing and Assets

• Theme and library source files are released under the MIT License.
• LICENSE preserves both the upstream QuadnucYard notice and the current Geekyhang notice because this repository adapts upstream work while shipping new YSU-specific source files under the same MIT terms.
• The starter content in template/main.typ is additionally available under MIT No Attribution; see LICENSE-MIT-0.txt.
• University-branded assets in themes/assets/ysu-* are not covered by the SPDX license expression in typst.toml; see ASSETS.md for the file inventory, source links, transformation notes, and reviewer guidance.

License

Licensed under the MIT License.