当fail_on_warning设置为true且构建失败时，获取ReadTheDocs以显示实际警告消息

问题描述

我在ReadTheDocs上遇到了一个问题，该警告是导致我的构建失败的警告，但我无法查看该警告。

我当前的.readthedocs.yml如下：

version: 2

sphinx:
  configuration: docs/conf.py

sphinx:
  fail_on_warning: true

python:
  version: 3.6
  install:
    - requirements: docs/rtd-requirements.txt

当我运行make html时，构建会在本地传递而不会发出任何警告。但是，当ReadTheDocs尝试构建时，它说捕获了1条警告，但未显示实际警告。

这是从ReadTheDocs构建生成的输出的结尾，列出了警告，但警告之后没有内容：

writing additional pages...  searchdone
copying static files... ... done
copying readthedocs static files... done
copying searchtools... done
copying extra files... done
dumping search index in English (code: en)... done
dumping object inventory... done
build finished with problems,1 warning.

以防万一，这是我的Makefile：

# Minimal makefile for Sphinx documentation
#

# You can set these variables from the command line,and also
# from the environment for the first two.
SphinxOPTS    = -W --keep-going -a -E
SphinxBUILD   = sphinx-build
SOURCEDIR     = .
BUILDDIR      = _build

# Put it first so that "make" without argument is like "make help".
help:
    @$(SphinxBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SphinxOPTS) $(O)

.PHONY: help Makefile

# Catch-all target: route all unkNown targets to Sphinx using the new
# "make mode" option.  $(O) is meant as a shortcut for $(SphinxOPTS).
%: Makefile
    @$(SphinxBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SphinxOPTS) $(O)

有没有办法让ReadTheDocs打印实际警告？

解决方法

暂无找到可以解决该程序问题的有效方法，小编努力寻找整理中！

如果你已经找到好的解决方法，欢迎将解决方案带上本链接一起发送给小编。

小编邮箱:dio#foxmail.com (将#修改为@）

python python-sphinx read-the-docs