如何为Sphinx创建wiki界面?

问题描述 投票:0回答:1

如果我从 Markdown 构建文档(例如使用 Sphinx 并存储在公共 git 存储库中),是否可以自定义页面模板以包含页内编辑(所见即所得或 Markdown)工具来准备 PR,而无需用户离开(或者甚至通过联合身份验证将编辑推送到 GitHub API)并浏览页面历史记录/差异?

许多项目使用 CI/CD 来发布从最新源预先生成的静态文档网站(例如使用 ReadTheDocs、GitHub Pages 或带有公共 S3 存储桶的简单 CI 管道)。这种模式管理起来非常简单(访问控制和变更审核都由 git 托管提供商处理;静态网站便宜、简单并且暴露的安全隐患最小;配置 CI 并不复杂,以便用户自动看到最当前信息)。 Wiki 风格的 CMI(例如 WikiMedia)对于编辑者来说更加用户友好,但它们的部署和操作通常要复杂得多。我想知道将两者的优点结合起来是否可行,或者是否存在技术障碍。

devops content-management-system python-sphinx wiki
1个回答
0
投票

Decap CMS(或 fork Static CMS)等一些项目已经提供了这种用户体验。

© www.soinside.com 2019 - 2024. All rights reserved.