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

Question

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

在Sphinx RST文件中，我有一个"..uml:："语句，当我在本地构建文档时，它会很好地呈现出来。

在conf.py中，我有以下语句：

plantuml = 'java -jar plantuml.jar'

它引用了未提交给我的回购的plantuml.jar的本地副本。

如何为已读文档正确编写语句plantuml = ....？

Answer 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