Touying Gtec Simple

Local import:

#import "path/to/touying-gtec-simple/src/lib.typ": *

Slide Types Reference

Title Slide

#title-slide(
  header: [Degree in Computer Science \ Data Structures Course]
)

Regular Content Slides

Use level 2 headings (==):

== My Slide Title

Content with:
- Bullet points
- *Bold text*
- _Italic text_
- #highlight[highlighted text]

Section Slides

Use level 1 headings (=):

= Section Title

== First Slide in Section
Content here...

Outline Slides

Basic:

#outline-slide()

Customized:

#outline-slide(
  title: [Contents],
  outline-args: (depth: 1),  // Only level 1 headings
  column: 2                  // Two-column layout
)

With side image:

#outline-image-slide(
  title: [Contents],
  image: image("path/to/image.png", height: 100%, fit: "cover"),
  side: left,             // left, right, top, or bottom
  image-width: 35%,
  outline-args: (depth: 1)
)

Focus Slides

Large centered text for emphasis:

#focus-slide[
  Important Announcement!
  
  This grabs attention.
]

Side Image Slides

Full-height image on one side:

#side-image-slide(
  image: image("path/to/image.png", height: 100%, fit: "cover"),
  title: [My Title],
  subtitle: [Optional subtitle],
  side: left,           // left, right, top, or bottom
  image-width: 35%,
)[
  Your content here
]

Multi-column content:

#side-image-slide(
  composer: (1fr, 1fr, 1fr),
  image: image("image.png", height: 100%, fit: "cover"),
)[
  *First Column*
  Content here
][
  *Second Column*
  More content
][
  *Third Column*
  Even more content
]

Note: Image persists across multiple pages with #pause or overflow.

Shaped Slides

Colored panel with optional decorative edge:

#side-shape-slide(
  shape-body: shape-title([Main Title], subtitle: [Subtitle Text]),
  shape-fill: rgb("#d4c5b0"),
  side: left,
  shape-width: 35%,
  edge: "wave",  // "wave", "zigzag", "round", or none
)[
  Content on the other side
]

Shape Body Options

The shape-body parameter accepts any Typst content.

Using shape-title() helper:

shape-body: shape-title(
  [Main Title],
  subtitle: [Subtitle],
  spacing: 2em,
  align: left + horizon,
  inset: (x: 1.5em, y: 2em),
)

Custom content:

// Just text
shape-body: [Any content here]

// An image
shape-body: image("logo.png", width: 80%)

// A styled block
shape-body: block(
  inset: 2em,
  align(center + horizon)[
    #text(size: 2em, weight: "bold")[Custom Content]
    #v(1em)
    #image("icon.png", width: 50%)
  ]
)

Custom Colors and Strokes

#side-shape-slide(
  shape-body: shape-title([Title]),
  shape-fill: rgb("#326e76"),
  shape-stroke: 3pt + black,
  config: ty.config-page(fill: aqua),
  edge: "wave",
)[
  Content here
]

Advanced Customization

Subtitles

Add subtitles using #slide():

#slide(
  subtitle: [Additional Context],
)[
  == My Slide Title
  
  Content here
]

Custom Alignment

#slide(
  align: left + top,
)[
  == Title
  
  Content aligned to top-left
]

Appendix Slides

Slides after appendix show only current page numbers:

#show: ty.appendix

= Appendix

== Extra Information
This slide shows only its page number, not the total count.

Best Practices

1. Keep titles concise - Short titles are more readable
2. Use subtitles for context - Provide additional information when needed
3. Use edge decorations sparingly - Shaped slides with decorative edges (wave, zigzag, round) are visually striking but can distract if overused. Reserve them for:
   • Key concept slides
   • Special emphasis moments
   • Use plain slides for regular content

Complete Example

See example.md for a full presentation example.