如何抑制或禁用 reSTructuredText 中的警告？

Question

我正在用Python开发一个CMS，它使用reStructuredText（通过docutils）来格式化内容。我的很多内容都是从其他来源导入的，通常以未格式化的文本文档的形式出现。 reST 对此非常有用，因为默认情况下它使一切看起来都很正常。

然而，我遇到的一个问题是，我收到的警告转储到我的网络服务器上的 stderr 并注入到我的页面内容中。例如，我在网页上收到如下警告：

系统消息：WARNING/2（第 296 行）；反向链接

是：如何抑制、禁用或以其他方式重定向这些警告？

理想情况下，我希望将这些警告写入日志文件，但是如果有人可以告诉我如何关闭警告注入到我的内容中，那就完美了。

负责将 reST 解析为 HTML 的代码：

from docutils import core
import reSTpygments

def reST2HTML( str ):
    parts = core.publish_parts(
                          source = str,
                          writer_name = 'html')
    return parts['body_pre_docinfo'] + parts['fragment']

Answer 1

def reST2HTML( str ):
    parts = core.publish_parts(
    source = str,
    writer_name = 'html',
    settings_overrides={'report_level':'quiet'},
    )
    return parts['body_pre_docinfo'] + parts['fragment']

Answer 2

看来 report_level 接受字符串是旧版本。现在，以下内容对我有用。

import docutils.core
import docutils.utils
from pathlib import Path

shut_up_level = docutils.utils.Reporter.SEVERE_LEVEL + 1
docutils.core.publish_file(
    source_path=Path(...), destination_path=Path(...),
    settings_overrides={'report_level': shut_up_level},
    writer_name='html')

关于level

# docutils.utils.__init__.py
class Reporter(object):
    # system message level constants:
    (DEBUG_LEVEL,
     INFO_LEVEL,
     WARNING_LEVEL,
     ERROR_LEVEL,
     SEVERE_LEVEL) = range(5)

    ...

    def system_message(self, level, message, *children, **kwargs):
        ...
        if self.stream and (level >= self.report_level  # self.report_level was set by you. (for example, shut_up_level)
                    or self.debug_flag and level == self.DEBUG_LEVEL
                    or level >= self.halt_level):
            self.stream.write(msg.astext() + '\n')
        ...
        return msg

根据上面的代码，你知道可以分配self.report_level（即settings_overrides={'report_level': ...}）让警告不展示。

我将其设置为SERVER_LEVEL+1，因此它不会显示任何错误。 （您可以根据您的需求进行设置。）