将 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 标记，但您需要一个不同的工具。