搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

apple/creator-studio-doc-format

开发工具

一个用于读取、创建和编辑 Keynote .keyx 演示文稿的 Python 库,适合需要程序化生成或处理演示文件的开发者。

146
5
Python
Apache-2.0
创建于 3 天前

项目介绍

这是 Apple 维护的 Python 库,用于处理 Keynote Interchange Format(.keyx)文件。它可以读取从 Keynote 导出的演示文稿中的幻灯片、文本、图片、表格、图表和样式,也可以从零或基于主题的版式与样式创建演示文稿,并在保存前按格式规则校验编辑结果。库自身负责解析和写入该格式,因此不需要 Keynote、Apple 设备或网络连接,适合在自动化流程中批量生成或处理演示文件。

快速使用

需要 Python 3.13 或更高版本,从 PyPI 安装:

pip install creator-studio-doc-format

README 的快速示例会创建一个包含文本框的 Presentation,包进 KeyxDocument 后保存为 hello.keyx(见快速开始):

from creator_studio_doc_format.core import *

title = Textbox(
    geometry=Geometry(position=Position(x=160, y=440), size=Size(width=1600, height=200)),
    stroke=Stroke(empty=True),
    layout_properties=LayoutProperties(vertical_alignment="center"),
    paragraph_properties=ParagraphProperties(
        alignment="center",
        character_properties=CharacterProperties(font_size=96),
    ),
    text=Text(string="Hello, Keynote"),
)
slide = Slide(contents=[SlideObject(object=CanvasObject(textbox=title))])

doc = KeyxDocument(
    Presentation(
        theme=KeynoteTheme(name="White", locale="en_US"),
        slide_size=Size(width=1920, height=1080),
        slides=[slide],
    )
)
doc.save("hello.keyx")

生成的文件可在 Keynote 中打开。每种幻灯片内容都有对应的可运行脚本,放在示例目录。从创建第一份演示文稿到校验、遍历文档的完整流程见指南,所有公开符号的说明见 API 参考。

使用约束

  • 必须使用 Python 3.13 及以上版本。
  • 输入输出都是 .keyx 文件;预览需要 Apple 设备上的 Keynote,在其他平台转成 PDF 等格式要依赖单独的 Creator Studio Document Exporting API,而不是这个库。
  • 目前只接受问题反馈,不开源代码或文档贡献。
  • 采用 Apache 2.0 许可证。

Agent skill

仓库附带一个 creator-studio-doc-format skill,教编程 Agent 使用这个库,可从最新 Release 安装:gh skill install apple/creator-studio-doc-format creator-studio-doc-format。任何能读取 SKILL.md 目录的 Agent 也可以直接使用skill 目录,前提是先装好库本身。

HotRepo 点评

项目在 2026-11-19 登上 HotRepo 新项目榜,这是它被记录的第一天,一小时的观察窗口内新增 16 Star,累计 117 Star。观察窗口很短,仓库也刚建立,这反映的是早期关注度而非持续热度。实际价值在于它绕开了 Keynote 设备和网络,在服务端 Python 环境里处理 Apple 掌控的文档格式,让自动生成演示文稿变得可行;目前尚无全部语言日榜的最好名次记录,这与项目刚进入统计期相符。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。