Typst PPT Template

This is a Typst template specifically designed for presentations, especially suitable for academic reports and experimental displays. The template supports various page types including four-image layout, custom image positioning, and text-only pages.

Main Features

• Four-image layout: Allows up to 4 images per page, automatically divided into quadrants
• Flexible image control: Rich parameters to control image position, size, scaling, etc.
• Grid alignment control: New parameters for overall grid alignment, supporting nine alignment combinations
• Multiple page types: Title page, outline page, four-image page, custom layout page, text-only page
• Floating content box: Add customizable content boxes at any position on the page, supporting notes, tips, warnings, etc.
• Header and footer control: Independently control visibility; images automatically adapt to available space
• Responsive design: Images are center-aligned and scaled proportionally
• Professional appearance: 16:9 presentation ratio with clean headers and footers

Quick Start

1. Basic Configuration

#import "@preview/storytiles:0.0.1": *

#show: doc => ppt-conf(
  title: "My Presentation",
  author: "Author Name", 
  theme: rgb("#1f4e79"),  // Theme color
  font-size: 12pt,
  doc
)

2. Create Title Page

#title-page(
  main-title: "Presentation Title",
  subtitle: "Subtitle",
  author: "Author",
  institution: "Institution Name",
  logo: "logo.png"  // Optional
)

3. Add Outline Page

#outline-page()

Page Types Explained

Four-image Page (four-image-page)

This is the core feature of the template, supporting the display of up to 4 images on one page.

#let img1 = image("img1.png")
#let img2 = image("img2.png")
#let img3 = image("img3.png")
#let img4 = image("img4.png")

#four-image-page(
  title: "Experimental Results",
  images: (img1, img2, img3, img4),
  captions: ("Caption 1", "Caption 2", "Caption 3", "Caption 4"),
  content: [Descriptive text for the page],
  image-height: 35%,
  image-width: 40%,  
  gap: 1em,
  caption-size: 10pt,
  layout: "grid",
  grid-align-x: center,
  grid-align-y: center,
  show-header: true,
  show-footer: true,
)

Parameter Explanation:

• images: Array of images, must be preloaded; supports 1-4 images, automatically leaves space for fewer than 4
• captions: Corresponding captions for each image
• layout:
  • "grid" (default): 2×2 grid layout
  • "linear": Vertical linear arrangement
• image-height/image-width: Control image size, supports percentage and absolute values
• gap: Space between images
• New grid-align-x: Horizontal grid alignment (left, center, right)
• New grid-align-y: Vertical grid alignment (top, center, bottom)
• show-header/show-footer: Control header and footer visibility

Grid Alignment Example:

// Top-left grid alignment
#four-image-page(
  images: (img1, img2, img3, img4),
  grid-align-x: left,
  grid-align-y: top,
)
// Bottom-right grid alignment
#four-image-page(
  images: (img1, img2, img3, img4),
  grid-align-x: right,
  grid-align-y: bottom,
)

Header and Footer Control:

// Full-screen image mode
#four-image-page(
  images: (img1, img2, img3, img4),
  show-header: false,  // Hide header, images enlarge automatically
  show-footer: false,  // Hide footer, images enlarge automatically
)

Custom Layout Page (custom-layout-page)

Use this when you need precise control over image positioning:

#custom-layout-page(
  title: "Custom Layout",
  content: [Text content],
  images: (
    (
      path: "img1.png",
      x: 10%,
      y: 20%,  
      width: 30%,
      height: 25%,
      caption: "Image 1"
    ),
    (
      path: "img2.png", 
      x: 60%, 
      y: 20%, 
      width: 30%,
      caption: "Image 2"
    ),
  )
)

Floating Content Box (floating-box)

Add floating content boxes anywhere on the page, useful for notes, tips, warnings, etc.

#floating-box(
  [
    = Important Notice
    This is a floating content box!
    
    *Features*:
    - Can be placed anywhere
    - Supports semi-transparent background  
    - Optional shadow effect
  ],
  x: 60%,
  y: 20%,
  width: 30%,
  height: auto,
  background: rgb(255, 255, 255, 200),
  border-color: rgb("#e74c3c"),
  border-width: 2pt,
  border-radius: 5pt,
  padding: 8pt,
  shadow: true,
)

Position Parameters:

• x: Horizontal position, 0% = left edge, 50% = center, 100% = right edge
• y: Vertical position, 0% = top edge, 50% = center, 100% = bottom edge
  Other Parameters:
• First parameter is the content of the box (position parameters)
• width, height: Size of the box, height defaults to auto to fit content
• background: Background color, supports transparency (4th parameter in rgb)
• border-*: Border style control
• padding: Spacing between content and border
• shadow: Whether to show shadow effect
  Usage Scenarios:
• 📝 Annotation Box: Add explanations for specific content
• ⚠️ Warning Box: Highlight important information or precautions
• 💡 Tip Box: Provide additional help information and suggestions
• 🎨 Decorative Box: Enhance visual effects and layering on the page

Text-only Page (text-page)

#text-page(
  title: "Theoretical Background",
  content: [
    = Level 1 Heading
    Paragraph content...
    
    == Level 2 Heading
    More content...
  ],
  column-count: 2  // Optional: display in columns
)

Floating Content Box (floating-box)

Add floating content boxes to the page, supporting various styles and precise positioning.

#floating-box(
  x: 70%,
  y: 15%,
  width: 25%,
  height: auto,
  content: [📌 Important Tip],
  fill: rgb("#e8f4fd"),
  stroke: rgb("#1f4e79"),
  radius: 8pt,
  inset: 8pt,
)

Position Parameters:

• x, y: Absolute positioning relative to the top-left corner of the page (supports percentage and absolute values)
• width, height: Size of the box, height: auto will adjust based on content
  Style Parameters:
• fill: Background color
• stroke: Border color and style
• radius: Corner radius
• inset: Spacing between content and border
  Preset Style Example:

// Warning Box
#floating-box(
  x: 5%, y: 60%,
  width: 35%, 
  fill: rgb("#fff2cc"),
  stroke: rgb("#d6b656"),
  content: [⚠️ Important Notes...]
)
// Tip Box
#floating-box(
  x: 60%, y: 60%, 
  width: 35%,
  fill: rgb("#e8f5e8"),
  stroke: rgb("#4caf50"), 
  content: [💡 Useful Tips...]
)
// Decorative Box
#floating-box(
  x: 70%, y: 5%,
  width: 25%,
  fill: rgb("#f3e5f5"),
  stroke: rgb("#9c27b0"),
  content: [🎨 Design Highlights...]
)

Multiple Box Combination:

// Add multiple floating boxes on the same page
#floating-box(x: 5%, y: 20%, width: 40%, content: [Main Explanation])
#floating-box(x: 55%, y: 20%, width: 40%, content: [Supplementary Information])
#floating-box(x: 5%, y: 70%, width: 90%, content: [Summary Overview])

Image Handling Features

Automatic Scaling and Alignment

• All images are automatically center-aligned
• Maintain proportional scaling for both dimensions
• Vertically fill the specified area
• Use fit: "contain" to ensure images are fully displayed

Supported Image Formats

• PNG, JPG, SVG and other common formats
• Vector graphics (SVG) provide the best display quality

Responsive Layout

• Image sizes automatically adapt to page dimensions
• Supports mixing percentage and absolute units

Style Customization

Theme Color Configuration

#show: doc => ppt-conf(
  theme: rgb("#1f4e79"),  // Deep blue
  // or
  theme: rgb("#8B0000"),  // Deep red
  doc
)

Font Configuration

The template defaults to using Times New Roman + SimSun combination, ensuring good display for both Chinese and English text.

Page Layout

• 16:9 presentation ratio
• Automatic headers and footers
• Page number display

Complete Example

Refer to the example.typ file for a complete usage example, including:

• Title page setup and presentation information
• Automatic outline generation
• Four-image page display (comparison of grid and linear layouts)
• Grid alignment control demonstration (nine alignment combinations)
• Header and footer control demonstration (full-screen mode)
• Custom layout page design
• Floating content box applications (annotation, warning, tip, decorative styles)
• Multiple floating box combination effects
• Text-only page layout (single and double columns)
• Best practices for image preloading demonstration

Technical Support

For issues or suggestions, please refer to the Typst official documentation or submit an issue.

Typst PPT 模板

（绝大多数内容都是ai写的，主要是为了应付组会上可能出现的大量图片展示）
这是一个专为演示文稿设计的 Typst 模板，特别适合学术报告和实验展示。模板支持四图片布局、自定义图片位置、文字页面等多种页面类型。

主要特性

• 四图片布局: 支持每页添加最多4个图片，自动四等分页面
• 灵活的图片控制: 提供丰富的参数来控制图片位置、大小、缩放等
• 网格对齐控制: 新增网格整体对齐参数，支持九种对齐方式组合
• 多种页面类型: 标题页、目录页、四图片页、自定义布局页、纯文字页
• 浮动内容框: 在页面任意位置添加可自定义的内容框，支持注释、提示、警告等
• 页眉页脚控制: 可独立控制页眉页脚显示，图片大小自动适应可用空间
• 响应式设计: 图片自动中心对齐，横纵等比例缩放
• 专业外观: 16:9 演示比例，美观的页眉页脚

快速开始

1. 基本配置

#import "@preview/storytiles:0.0.1": *

#show: doc => ppt-conf(
  title: "我的演示文稿",
  author: "作者姓名", 
  theme: rgb("#1f4e79"),  // 主题色
  font-size: 12pt,
  doc
)

2. 创建标题页

#title-page(
  main-title: "演示文稿标题",
  subtitle: "副标题",
  author: "作者",
  institution: "机构名称",
  logo: "logo.png"  // 可选
)

3. 添加目录页

#outline-page()

页面类型详解

四图片页面 (four-image-page)

这是模板的核心功能，支持在一页中展示最多4张图片。

// 在主文件中预加载图片
#let img1 = image("img1.png")
#let img2 = image("img2.png")
#let img3 = image("img3.png")
#let img4 = image("img4.png")

#four-image-page(
  title: "实验结果",
  images: (img1, img2, img3, img4),
  captions: ("图1说明", "图2说明", "图3说明", "图4说明"),
  content: [页面的文字说明内容],
  // 可选参数
  image-height: 35%,        // 图片高度比例
  image-width: 40%,         // 图片宽度比例  
  gap: 1em,                 // 图片间距
  caption-size: 10pt,       // 说明文字大小
  layout: "grid",           // "grid" 或 "linear"
  grid-align-x: center,     // 网格水平对齐：left, center, right
  grid-align-y: center,     // 网格垂直对齐：top, center, bottom
  show-header: true,        // 是否显示页眉
  show-footer: true,        // 是否显示页脚
)

参数说明:

• images: 图片数组，必须是预加载的图片内容，支持1-4张图片，不足4张时自动留空
• captions: 对应每张图片的说明文字
• layout:
  • "grid" (默认): 2×2网格布局
  • "linear": 垂直线性排列
• image-height/image-width: 控制图片大小，支持百分比和绝对值
• gap: 图片之间的间距
• 新增 grid-align-x: 网格水平对齐 (left, center, right)
• 新增 grid-align-y: 网格垂直对齐 (top, center, bottom)
• show-header/show-footer: 控制页眉页脚显示

网格对齐示例:

// 网格左上角对齐
#four-image-page(
  images: (img1, img2, img3, img4),
  grid-align-x: left,
  grid-align-y: top,
)

// 网格右下角对齐  
#four-image-page(
  images: (img1, img2, img3, img4),
  grid-align-x: right,
  grid-align-y: bottom,
)

页眉页脚控制:

// 全屏图片模式
#four-image-page(
  images: (img1, img2, img3, img4),
  show-header: false,  // 隐藏页眉，图片自动放大
  show-footer: false,  // 隐藏页脚，图片自动放大
)

自定义布局页面 (custom-layout-page)

当你需要精确控制图片位置时使用：

#custom-layout-page(
  title: "自定义布局",
  content: [文字内容],
  images: (
    (
      path: "img1.png",
      x: 10%,           // x坐标
      y: 20%,           // y坐标  
      width: 30%,       // 宽度
      height: 25%,      // 高度
      caption: "图1"    // 说明文字
    ),
    (
      path: "img2.png", 
      x: 60%, 
      y: 20%, 
      width: 30%,
      caption: "图2"
    ),
  )
)

浮动内容框 (floating-box)

在页面的任意位置添加浮动的内容框，可以用于注释、提示、警告等：

#floating-box(
  [
    = 重要提示
    这是一个浮动的内容框！
    
    *特点*:
    - 可以放在任意位置
    - 支持半透明背景  
    - 可选阴影效果
  ],
  x: 60%,                               // 水平位置：距页面左边60%
  y: 20%,                               // 垂直位置：距页面顶部20%
  width: 30%,                           // 框宽度
  height: auto,                         // 框高度（auto自适应）
  background: rgb(255, 255, 255, 200),  // 背景色（含透明度）
  border-color: rgb("#e74c3c"),         // 边框颜色
  border-width: 2pt,                    // 边框宽度
  border-radius: 5pt,                   // 圆角半径
  padding: 8pt,                         // 内边距
  shadow: true,                         // 是否显示阴影
)

位置参数说明:

• x: 水平位置，0% = 页面左边，50% = 页面中央，100% = 页面右边
• y: 垂直位置，0% = 页面顶部，50% = 页面中央，100% = 页面底部

其他参数:

• 第一个参数为框内内容（位置参数）
• width, height: 框的尺寸，height默认为auto自适应内容
• background: 背景色，支持透明度（rgb第4个参数）
• border-*: 边框样式控制
• padding: 内容与边框的间距
• shadow: 是否显示阴影效果

使用场景:

• 📝 注释框: 为特定内容添加解释说明
• ⚠️ 警告框: 突出显示重要信息或注意事项
• 💡 提示框: 提供额外的帮助信息和建议
• 🎨 装饰框: 增强页面视觉效果和层次感

纯文字页面 (text-page)

#text-page(
  title: "理论背景",
  content: [
    = 一级标题
    段落内容...
    
    == 二级标题
    更多内容...
  ],
  column-count: 2  // 可选：分栏显示
)

浮动内容框 (floating-box)

为页面添加浮动的内容框，支持多种样式和精确定位。

#floating-box(
  x: 70%,           // 距离页面左边距离
  y: 15%,           // 距离页面顶部距离
  width: 25%,       // 框宽度
  height: auto,     // 框高度，auto为自动
  content: [📌 重要提示内容],
  // 样式参数
  fill: rgb("#e8f4fd"),           // 背景色
  stroke: rgb("#1f4e79"),         // 边框色
  radius: 8pt,                    // 圆角
  inset: 8pt,                     // 内边距
)

定位参数:

• x, y: 绝对定位，相对于页面左上角的距离（支持百分比和绝对值）
• width, height: 框的尺寸，height: auto 会根据内容自动调整

样式参数:

• fill: 背景颜色
• stroke: 边框颜色和样式
• radius: 圆角半径
• inset: 内容与边框的间距

预设样式示例:

// 警告框
#floating-box(
  x: 5%, y: 60%,
  width: 35%, 
  fill: rgb("#fff2cc"),
  stroke: rgb("#d6b656"),
  content: [⚠️ 注意事项...]
)

// 提示框
#floating-box(
  x: 60%, y: 60%, 
  width: 35%,
  fill: rgb("#e8f5e8"),
  stroke: rgb("#4caf50"), 
  content: [💡 实用技巧...]
)

// 装饰框
#floating-box(
  x: 70%, y: 5%,
  width: 25%,
  fill: rgb("#f3e5f5"),
  stroke: rgb("#9c27b0"),
  content: [🎨 设计亮点...]
)

多框组合:

// 在同一页面中添加多个浮动框
#floating-box(x: 5%, y: 20%, width: 40%, content: [主要说明])
#floating-box(x: 55%, y: 20%, width: 40%, content: [补充信息])
#floating-box(x: 5%, y: 70%, width: 90%, content: [总结概述])

图片处理特性

自动缩放和对齐

• 所有图片自动中心对齐
• 保持横纵等比例缩放
• 纵向填满指定区域
• 使用 fit: "contain" 确保图片完整显示

支持的图片格式

• PNG, JPG, SVG 等常见格式
• 矢量图 (SVG) 获得最佳显示效果

响应式布局

• 图片大小自动适应页面尺寸
• 支持百分比和绝对单位混用

样式自定义

主题色配置

#show: doc => ppt-conf(
  theme: rgb("#1f4e79"),  // 深蓝色
  // 或者
  theme: rgb("#8B0000"),  // 深红色
  doc
)

字体配置

模板默认使用 Times New Roman + SimSun 组合，确保中英文显示效果。

页面布局

• 16:9 演示比例
• 自动页眉页脚
• 页码显示

完整示例

参考 example.typ 文件查看完整的使用示例，包含：

• 标题页设置与演示文稿信息
• 自动目录生成
• 四图片页面展示（网格和线性布局对比）
• 网格对齐控制演示（九种对齐方式）
• 页眉页脚控制演示（全屏模式）
• 自定义布局页面设计
• 浮动内容框应用（注释、警告、提示、装饰四种样式）
• 多浮动框组合效果展示
• 纯文字页面排版（单列和双列）
• 图片预加载最佳实践演示

技术支持

如有问题或建议，请参考 Typst 官方文档或提交 issue。