在 RTD 服务器上发布时使用 Plantuml答案

【问题标题】：Using Plantuml when publishing on RTD server在 RTD 服务器上发布时使用 Plantuml
【发布时间】：2020-04-17 10:07:18
【问题描述】：

我刚刚设法在 RTD 服务器上显示了我的文档。 (https://uracoli-rsensor.readthedocs.io/)。

在 Sphinx-RST 文件中，我有一个“.. uml::”语句，当我在本地构建文档时，它可以很好地呈现。

在conf.py我有声明：

plantuml = 'java -jar plantuml.jar'

它引用了plantuml.jar 的本地副本，该副本未提交到我的仓库。

如何正确地为 readthedocs 编写语句 plantuml = ....？

【问题讨论】：

我会从这里开始：docs.readthedocs.io/en/latest/guides/…
感谢史蒂夫，但解决方案并不是那么容易选择。

标签： python-sphinx read-the-docs plantuml

【解决方案1】：

最初的解决方案在这里找到： https://github.com/readthedocs/readthedocs.org/issues/3885

在conf.py 中添加以下行：

if os.environ.get("READTHEDOCS") != None:
    plantuml = 'java -Djava.awt.headless=true -jar /usr/share/plantuml/plantuml.jar'
else:
    plantuml = 'java -jar plantuml.jar'

这里也有记录：

https://sphinxcontrib-needs.readthedocs.io/en/latest/installation.html#install-plantuml

【讨论】：