我正在开发文档字符串查看器,因此我想正确地将任何文档字符串转换为漂亮的html。

大多数标准库中的文档字符串都不在reST中,但是对于科学库来说却不是这样,科学库在大多数情况下都采用了numpydoc标准。

因此,我想可靠地检测文档字符串是否在reST中,以便将其传递给不同的渲染器。

最佳答案

由于ReST是一种试图尽可能看起来像可读纯文本的格式,因此没有可靠的方法来检测是否有任何文本在使用ReST,更不用说像文档字符串这样小的文本了。

我要说的是,您应该尝试将其呈现为ReST,并为最终用户提供再次将其关闭的选项。

10-07 15:07