touying

name	touying
description	Author Typst slide decks with the Touying package. Use when creating or editing .typ presentations: applying or building Touying themes (e.g. metropolis), turning headings or #slide into slides, incremental reveals (#pause, dynamic content), speaker notes via pdfpc, and page layout config. Not for non-Typst decks (HTML, PPT, reveal.js, Marp) or ordinary non-presentation Typst documents.
category	docs-writing-publishing
tags	["typst","touying","slide-deck","animation","theme"]
version	1.0.0
argument-hint	path-to-typ-file
allowed-tools	Read, Write, Glob, Grep

Touying Author

Built-in themes: default, simple, metropolis, dewdrop, university, aqua, stargazer (local docs cover metropolis).

Quick start

1. Import Touying + theme, apply with #show: <theme>.with(...).
2. Use headings for slides; #slide only for custom layout/animation.
3. Centralize config in globals.typ, include content from separate files.

Task routing

Topic	Docs
Getting started	docs/start.md
Multi-file layout	docs/multi-file.md
Slide/headings	docs/sections.md
Global styles	docs/global-settings.md
Page/layout	docs/layout.md
Animations	docs/dynamic/*.md
Speaker notes	docs/external/pdfpc.md
Themes	docs/themes/*.md
Integrations	docs/integration/*.md
Examples	references/EXAMPLES.md
Troubleshooting	references/TROUBLESHOOTING.md

Key rules

• Use config-page/config-common, not set page.
• Set slide-level via config-common(slide-level: n).
• Avoid #pause inside context blocks.
• Wrap custom slides with touying-slide-wrapper.
• Place #show: appendix after main deck.

Templates

Use examples/simple.typ (minimal) or examples/default.typ (full).

Errors

If $ARGUMENTS empty or no .typ file: "Error: Provide a valid .typ file path."