【发布时间】:2021-05-24 23:02:11
【问题描述】:
Weblate 对“Translating documentation using Sphinx.”有详细解释,目前我在使用wiki.js 和 Github。 Localise 与 Wiki.js 集成得很好,但我更喜欢 Weblate,它是一个开源和自托管的应用程序。
我喜欢 Wiki.js 构建文件和文件夹的方式。 Wiki.js 有一个不错的内置编辑器,而且它们以 md 格式存储文件。
虽然 Sphinx 与 Weblate 无缝集成,但我想知道 Sphinx 是否可以使用 md 文件而不是 rst 文件格式。
我们也可以将 Sphinx 用于内部文档或保存草稿吗?
Sphinx 有用户、组和权限功能吗?
我对 Wiki.js 的其他替代方案持开放态度,但它应该具有 git 集成。
【问题讨论】:
-
是的,Sphinx 可以使用 Markdown:stackoverflow.com/q/2471804/407651
-
“我愿意接受其他选择……”。请注意,要求软件推荐是题外话。如有此类问题,请转至softwarerecs.stackexchange.com。
-
见MyST。 Sphinx 没有任何身份验证或授权。它只呈现静态文件。您必须携带自己的身份验证。
标签: python-sphinx weblate wiki.js