在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