使用指南

将此站点作为 EmDash 文档、迁移内容、插件、模板与产品更新的发布系统。

这个网站应该承担什么角色

emdashcmseverything.com 不应只是一个通用落地页。它应当作为 EmDash 生态的公开知识层与分发层。

这意味着要在同一套一致的系统里完成多类内容任务:

  • 解释 EmDash 是什么
  • 教会用户它如何工作
  • 说明它适用的场景
  • 发布插件与模板
  • 指导 WordPress 迁移
  • 发布产品进展与版本更新

推荐的信息架构

当前结构就是围绕这一模型设计的:

  • docs/docs:长期有效的文档内容
  • docs/use-cases:按场景组织的采用内容
  • docs/plugins:插件目录条目
  • docs/templates:模板目录条目
  • docs/faq:更新、教程与编辑型内容

这种方式比把所有内容塞进单一营销首页,或把产品信息隐藏在框架组件里,更适合作为生态站点。

各分区如何使用

Docs

此分区用于承载长期有效、意图明确的内容:

  • 入门指南
  • 功能说明
  • 部署说明
  • 架构概览
  • FAQ

这些页面应回答用户在评估前和评估过程中的关键问题。

Use Cases(使用场景)

这个分区用于把产品能力转换为决策者语境。将 EmDash 放到以下场景中时更容易被理解:

  • 编辑出版
  • 文档与知识库
  • 插件生态
  • 模板业务

这个分区要把产品形态与真实结果连接起来。

Plugins

插件页面应像小型产品页,而不只是发布说明。每个页面都应说明:

  • 插件做什么
  • 面向谁
  • 当前状态
  • 价格或可用性
  • 下载路径
  • 安装与兼容性

Templates

模板页面应让用户容易比较不同的站点起步包。优质条目通常包含:

  • 目标用户
  • 截图
  • 技术栈细节
  • 版本与发布日期
  • 演示链接
  • 下载链接或仓库链接

Blog and Updates(博客与更新)

这个分区应持续体现产品与生态的动态变化:

  • 发布说明
  • 迁移指南
  • 产品解读
  • 教程
  • 案例分析

这正是让站点保持活跃、持续积累价值的关键。

发布工作流

对这个项目来说,最简单且稳定的工作流是:

  1. docs/ 中新增或修改内容
  2. 检查 Git diff
  3. 本地预览
  4. 将构建后的静态站点部署到 Cloudflare Pages

当 AI 参与草拟、编辑、重构与一致性校对时,这套流程会特别高效。

为什么这种结构适合 AI 协作

当站点围绕以下原则构建时,AI 编辑可靠性会显著提升:

  • 小而清晰的 MDX 文件
  • 明确的 frontmatter
  • 可复用页面组件
  • 稳定的路由模式
  • 内容与 UI 代码分离

这也是当前站点有意采用内容优先结构的原因。

这与 EmDash 本身的关系

EmDash 官方资料强调运行时集合、后台编辑、插件体系、媒体存储与云可移植性。这些都是产品优势,但面向公众的生态站点并不需要一开始就全部引入。

静态站点是对外展示层。

当你出现以下需求时,再引入完整 EmDash 运行时作为下一层:

  • 非技术编辑者在浏览器中工作
  • 需要认证的贡献流程
  • 运行时媒体管理
  • 更复杂的自动化或插件提交流程

编辑工作的经验法则

每个页面都应清晰回答以下至少一个问题:

  • EmDash 是什么?
  • 为什么不是 WordPress?
  • 这个插件或模板做什么?
  • 我该如何迁移?
  • 我该如何部署?
  • 为什么现在值得采用?

如果页面无法把其中一个问题讲透,通常说明它的范围需要进一步收敛。