Open Ts-OV opened 4 years ago
I'm faced with the same issue, however the problem may even be bigger than this. I doubt that this is the real repository of the sphinx extension, nor the right place to report issues there. It seems that the PyPI user ypguo (behind sphinxcontrib-ditaa) had a bad habit to link his work to the website of the original software that his plugins wraps instead of the website that hosts his own code. Doing this, there is no way to trace where the code really comes from, and apparently this is not from here. We hit here a major issue of PyPI...
I tried to find where the PyPI package comes from, and here are some traces:
sdelisle25/sphinxcontrib-ditaa on GitHub, last updated 7 Jul 2017, forked from baloo/sphinx-ditaa
, and has this at the top:
sphinx.ext.ditaa
~~~~~~~~~~~~~~~~~~~~~~~~~
Allow ditaa-formatted graphs to by included in Sphinx-generated
documents inline.
:copyright: Copyright 2011 by Arthur Gautier
:copyright: Copyright 2011 by Zenexity
:license: BSD, see LICENSE for details.
sphinx.ext.ditaa
~~~~~~~~~~~~~~~~~~~~~~~~~
Allow ditaa-formatted graphs to by included in Sphinx-generated
documents inline.
:copyright: Copyright 2011 by Arthur Gautier
:copyright: Copyright 2011 by Zenexity
:license: BSD, see LICENSE for details.
the ditaa.py
file in the sphinxcontrib-ditaa PyPI package has this at the top:
sphinxcontrib.ditaa
~~~~~~~~~~~~~~~~~~~~~
Allow ditaa commands be rendered as nice looking images
See the README file for details.
:author: Vadim Gubergrits <vadim.gubergrits@gmail.com>
:license: BSD, see LICENSE for details
Inspired by ``sphinxcontrib-aafig`` by Leandro Lucarella.
I created #77 for continuing the effort of sorting out the Sphinx extension mess. Let's continue that discussion there.
If there is
.. ditaa::
directive used in .rst documentation collection (that is tried to be built into html one) and something goes wrong with finding Ditaa java executable, the whole Sphinx build process crashes with unhandled exception:It is more or less clearly described how to set it up manually, but installing the extension (
pip install sphinxcontrib-ditaa
) doesn't automatically lead to working environment with the settings offered:and for a person, who has no idea what could have gone wrong there, this kind of error message for the issue is totally undescriptive (in addition to the fact that such the exception should not be left unhandled)
Also, the official Ditaa source page [http://ditaa.sourceforge.net/] mentions links to hosted latest ver.0.9 of ditaa0_9.jar from here. From where this 0.10-th ver.
/usr/local/Cellar/ditaa/0.10/libexec/ditaa0_10.jar
does come from? There are no valid links on the extension page that would lead to it.