在 Confluence 中上传 Typedoc 文档的最佳方法是什么？

Question

我必须自动化我的 typedoc 文档，以便我可以直接将它上传到汇合页面。 我已经尝试过 Sphinx 但是 typedoc 不会生成 sphinx 所需的 RST 文件

Answer 1

有这样的选择：

• 使用通用 Wiki 转换器 ( https://valiantys.com/en/blog/agility/universal-wiki-converter-transfer-wiki-content-confluence , https://github.com/AtlassianContribs/universal-wiki-converter ) 它已经预定义了一些 Wiki 的解析和渲染，但是您必须将一些计划任务配置为脚本（例如 bash 或在 python 中）才能执行此操作

• Write the app that will render the Typedoc docs and parse them into JSON or XML and create/update content in Confluence via REST API (also.txt files will do)

• 使用 Confluence Java API 进行 Word 导入（它也支持其他简单格式）来自定义将内容从文档传输到 Cofluence 页面。

• 使用 WebDav 将 .txt (HTML) 格式直接定位到文件系统中的页面位置https://confluence.atlassian.com/doc/configuring-a-webdav-client-for-confluence-148044.html?_ga=2.219。 1915395419.1564984609-1166064513.1559713737 。 请注意，WebDav 存在从 Atlassian 声明的安全问题