Mediawiki 斯芬克斯页面vs维基页面

如果您只想创建一个HTML文档，那么作为文档api使用与使用MediaWiki相比有什么好处？

这实际上取决于您以及（如果适用）与您一起工作的人员所使用的工作流。这不仅仅是一个优点，更是一个品味和习惯的问题。对我来说，斯芬克斯文档的感知优势是：

• 在外部编辑器中更轻松地编辑文件
• 使用VCS（svn、fossil或git）对文档进行版本控制
• 我习惯于标记语法

但我认为，对于以上每一点，都有人可能会认为mediawiki有优势，因此我认为这是一个品味和偏好的问题

但是，如果您与非技术人员合作：mediawiki或化石wiki将更容易添加到项目/评论页面并进行更正。出于同样的原因，如果您的文档需要与其他文档（代码或数据）同步，那么同一版本控制系统中的sphinx文档将是我的首选

---

我之所以提到这一点，是因为它提供了这两种选择的组合，而且对于某些项目来说，这两种选择都是最好的。您可以使用传统意义上的wiki页面（通过在线前端）进行编辑，也可以使用.wiki页面进行编辑，就好像它们是源代码一样，不能通过前端进行更改。同样，这对你是否有意义取决于你的用例、写作风格和习惯。

这实际上完全取决于你和（如果适用的话）与你一起工作的人所习惯的工作流程。这不仅仅是一个优点，更是一个品味和习惯的问题。对我来说，斯芬克斯文档的感知优势是：

• 在外部编辑器中更轻松地编辑文件
• 使用VCS（svn、fossil或git）对文档进行版本控制
• 我习惯于标记语法

但我认为，对于以上每一点，都有人可能会认为mediawiki有优势，因此我认为这是一个品味和偏好的问题

但是，如果您与非技术人员合作：mediawiki或化石wiki将更容易添加到项目/评论页面并进行更正。出于同样的原因，如果您的文档需要与其他文档（代码或数据）同步，那么同一版本控制系统中的sphinx文档将是我的首选

我之所以提到这一点，是因为它提供了这两种选择的组合，而且对于某些项目来说，这两种选择都是最好的。您可以使用传统意义上的wiki页面（通过在线前端）进行编辑，也可以使用.wiki页面进行编辑，就好像它们是源代码一样，不能通过前端进行更改。同样，这对您是否有意义取决于您的用例、写作风格和习惯