Weblate 与 Wiki.js 和 git 的集成情况如何？

Posted 2023-03-15

【中文标题】Weblate 与 Wiki.js 和 git 的集成情况如何？

【英文标题】：How well does Weblate integrate with Wiki.js and git?

【发布时间】：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：***.com/q/2471804/407651

“我愿意接受其他选择……”。请注意，要求软件推荐是题外话。如有此类问题，请转至softwarerecs.stackexchange.com。

见MyST。 Sphinx 没有任何身份验证或授权。它只呈现静态文件。您必须携带自己的身份验证。

【参考方案1】：

Weblate 没有对 wiki.js 的原生支持。它实际上也没有对 Sphinx 的原生支持——Sphinx 使用标准的 gettext PO 文件进行本地化，所以只需要文档说明如何设置它。如果 wiki.js 内置了本地化支持，它可能会类似地工作（我不知道 wiki.js 的知识）。

Markdown 支持是 Weblate 中长期计划的内容（请参阅 https://github.com/WeblateOrg/weblate/issues/3106）。 AFAIR 甚至为此提供了一些赠款资金，但我不知道这方面是否还有一些进展。

是的，Sphinx 也可以使用 Markdown 文件，但是将 Sphinx 作为渲染器同时仍然使用 wiki.js 作为编辑器可能会很有挑战性。