From: Stefan Seefeld (stefan_at_[hidden])
Date: 2019-07-11 22:43:49
Hi Mateusz,
On 2019-07-11 6:24 p.m., Mateusz Loskot wrote:
> Hi,
>
> The doxygen outputs files to doc/html/reference
> The sphinx-build outputs to _build/html
> The doc/index.rst expects the reference folder in _build/html/
> but I can't find who copies the doc/html/reference into the _build/html
> Where does it happen?
> Or, does it not happen and simply deployment of re-generated API
> reference has been overlooked?
Good questions !
Originally doxygen and sphinx were two tools that were used
side-by-side, and the only cross-links were hard-coded (relative) URLs
from the sphinx sources to the generated doxygen docs. It was manually
tuned to fit the final layout. (As far as I can see from the
doc/Makefile, _build isn't used at all for the "html" target, other than
for the temporary doctrees.)
I'm not quite sure what the current workflow looks like, but I'll try to
look into it tonight.
Best,
Stefan
--
...ich hab' noch einen Koffer in Berlin...