构建 Prosefly

构建 Prosefly

💡 原文英文,约500词,阅读约需2分钟。
📝

内容提要

Typlog 作者推出新项目 Prosefly,支持在 GitHub 仓库中管理文档,并提供可视化编辑器写作。静态网站契合 AI 时代,Markdown 内容便于 AI 直接编辑,但仍需友好的写作界面。Prosefly 根据项目 frontmatter 自动生成编辑界面,字段灵活可自定义。作者先开发编辑器和 Astro 模板,再搭建平台。初期误用 Cloudflare Workers for Platforms 导致架构复杂,后改用 Durable Objects 隔离数据,平台大幅简化。

🔎

延伸解读

静态站点与AI协作的契合点

文章指出,当内容以Markdown和MDX文件与网站代码共存时,AI可以直接读取和编辑,并同时处理文章与页面。这解释了为何作者认为当前是静态网站的好时机。但作者也强调,存储数据与写作是两回事,仍需要友好的可视化编辑器来处理格式和插图,避免每次修改源文件。

frontmatter驱动编辑界面的灵活性

Prosefly根据项目文本文件中定义的frontmatter schema自动生成编辑界面。作者举例,书评可以添加作者和评分字段。与Typlog中字段由平台预定义且用户难以更改不同,这种设计让用户在创建模板时无需先确认平台是否支持所需字段,降低了自定义门槛。

先做编辑器与模板的开发顺序

作者没有直接开发完整平台,而是先投入大量时间设计可视化编辑器,随后创建GitHub组织、制作多个Astro主题和模板,最后才搭建Prosefly平台。这样做的好处是,在平台开发前已有实际网站用于组织内容、定义frontmatter并验证编辑器的适配性,降低了后续返工风险。

架构选型失误与简化

作者最初选用Cloudflare Workers for Platforms来隔离各组织数据,导致项目复杂度大增,甚至一度考虑放弃。后来发现Durable Objects也能满足数据隔离需求,每个组织的数据可存放在独立的Durable Object中,仍是一个应用,无需部署和管理独立Worker。改用该方案后平台大幅简化,项目得以继续。

❓

Q&A

Prosefly 是什么?它和 Typlog 有什么关系?

Prosefly 是 Typlog 作者推出的新项目,支持在 GitHub 仓库中管理文档和文章,并提供可视化编辑器进行写作。

为什么作者认为静态网站适合 AI 时代?

因为内容以 Markdown 和 MDX 文件形式与网站代码放在一起,AI 可以直接读取和编辑,并能同时处理文章和页面。

Prosefly 如何根据项目自动生成编辑界面?

Prosefly 读取项目文本文件中定义的 frontmatter schema,并据此生成编辑界面。

Prosefly 的开发顺序是怎样的?

作者先花长时间设计可视化编辑器,然后创建 GitHub 组织、制作 Astro 主题和模板,最后才开始搭建 Prosefly 平台。

作者在构建 Prosefly 时犯了什么错误?如何解决的?

作者最初选用 Cloudflare Workers for Platforms 来隔离数据,导致架构复杂,甚至考虑放弃。后来改用 Durable Objects,每个组织的数据放在独立的 Durable Object 中,平台因此大幅简化。

Prosefly 的 frontmatter 字段可以自定义吗?

可以。Prosefly 根据项目文本文件中定义的 frontmatter schema 生成编辑界面,字段灵活可自定义,例如书评可以添加作者和评分字段。

🏷️

标签

➡️

继续阅读