OpenPress

Skill

openpress-create-slide

建立 OpenPress 簡報，包含投影片 Press Tree 生成、DeckSlide、投影片版面配置、可重複使用的 UI 元素、簡報結構，以及初始佈景主題。

Skill Impl

# openpress-create-slide

建立 OpenPress 簡報與投影片結構。

skills/openpress-create-slide/SKILL.md

本文件說明如何使用 openpress-create-slide skill 來建立簡報專案。

步驟 1：環境檢查

請確認您的環境已安裝 Node.js 20 或更新版本，以及 npm 與 npx。

步驟 2：初始化 Workspace

如果您尚未建立專案外殼，請先執行以下指令：

npm create @open-press@latest <專案名稱> -- --type slides

步驟 3：產生簡報結構

使用 Agent 觸發 openpress-create-slide 工作流程，並提供：

  • 簡報標題與目標受眾
  • 視覺方向與動畫需求
  • 投影片數量與內容密度

此程序會自動幫您建立 DeckSlide、layouts/ 與 ui/ 資料夾，並配置對應的 Tailwind op-* 樣式。

產生的簡報入口檔案看起來如下：

<Press slug="slide" title="Deck Title" type="slides" page="slide-16-9">
  <TitleSlide id="cover" title="Deck Title">
    <TitleSlide.Title objectId="title">Deck Title</TitleSlide.Title>
    <TitleSlide.Description objectId="description">
      One-line audience promise.
    </TitleSlide.Description>
  </TitleSlide>
</Press>

步驟 4：配置頁碼 (Page folio)

在您的投影片版面配置中，請確保使用 PageFolio 元件而非直接寫死數字。這樣能確保在預覽、PDF 以及圖片匯出時都能正確顯示：

<PageFolio currentFormat="2-digit" />

步驟 5：驗證簡報建置

完成結構與投影片的新增後，執行以下指令驗證專案是否可以正確編譯：

npm run build

請注意，此工作流程僅適用於簡報產物；不負責建立頁面文件（如報告）或執行部署任務。