python - 让 PyDoc 进入 Jira Confluence 的任何方式

Question

我正在使用 PyDoc 从我的 Python 代码生成文档，我正在使用 Jira 的 Confluence 插件来管理文档。有什么方法可以生成 PyDoc 文档并将其放入 Confluence 中？

谷歌搜索没有产生太多结果。

感谢大家

Answer 1

你可以尝试这样的事情：

from pydoc import *
import io

d = HTMLDoc()
content = d.docmodule(sys.modules["mymodule"])

f = io.open('./out.html', 'w')
f.write(unicode(content))
f.close()

您现在有一个包含 pydoc 信息的 HTML 文件。下一个技巧是将其放入 Confluence 中，使其看起来不错。到目前为止，我尝试将它作为 .rtf 文件导入 Microsoft Word，然后剪切并粘贴到 Confluence 中。

Answer 2

pydoc 生成一种文件格式，html。因此，您面临的挑战是将一个自包含的 HTML4 页面导入 Confluence。

Confluence wiki说您可以使用HTML宏。

我想理想情况下你会想让 pydoc 生成 Confluence Markup，但你需要一个不同的工具。