How can I convert the rst files generated by GNATdoc to e.g. odt?
Unfortunately .html seems to only cover the html backend.
I am using the command gnatdoc --output-dir=doc/rst --generate body --backend rst --warnings --style gnat ieee1788.gpr to generate the *.rst file(s), which successfully generates the *.rst files.
The first I tried was to simply use e.g. rst2odt for the conversion, but this lead to errors like ada___ieee1788.rst:4: (ERROR/3) Unknown directive type "ada:set_package"..
From .html I understood, that I need the Ada domain extension, which can be found at /, but seems to be much newer.
I tried both by using sphinx-quickstart --extensions sphinxcontrib.adadomain and then sphinx-build, but with that I get the error:
Sphinx v8.1.3 in Verwendung
Lade Übersetzungen [en]…erledigt
loading intersphinx inventory 'python' from .inv ...
building [mo]: targets for 0 po files that are out of date
writing output...
building [html]: targets for 3 source files that are out of date
updating environment: [new config] 3 added, 0 changed, 0 removed
reading sources... [ 33%] ada___ieee1788
Exception occurred:
File "/home/.../Dokumente/ada/ieee1788/.venv/lib/python3.12/site-packages/sphinxcontrib/adadomain.py", line 178, in handle_subp_sig
subp_spec_unit = lal_context.get_from_buffer(
^^^^^^^^^^^
NameError: name 'lal_context' is not defined
The full traceback has been saved in /tmp/user/1000/sphinx-err-2rg5v5kz.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <;. Thanks!
make: *** [Makefile:20: html] Fehler 2
From .html#building-the-documentation I learned that I have to install contrib/laldoc, which cannot be installed/ found by pip and neither can just laldoc.
I expected to have all this information in the GNATdoc documentation, but apparently it is not there and digging around does not get my further.
How can I build my documentation?