14 Říj
2020
14 Říj
'20
13:52
On 13/10/2020 23.18, Simon South wrote:
Unfortunately, since Sphinx version < 2 is still widespread among
distros, I don't think we can easily make the figures part of the
installation. I don't want the upstream installation to create files
that could potentially conflict with files from foreign packages.
For now, let's stick with installing just the info page [!1079]. It
could probably be improved with some hack-ish scripts to move figures
around for Sphinx < 2, but I neither have time for that, nor do I think
that's worth the effort.
[!1079] - https://gitlab.nic.cz/knot/knot-resolver/-/merge_requests/1079
--
Tomas Krizek
PGP: 4A8B A48C 2AED 933B D495 C509 A1FB A5F7 EF8C 4869
Tomas Krizek <tomas.krizek(a)nic.cz> writes:
Thanks for the pointers. It turns out that Sphinx version < 2 doesn't
create the figures directory.
When I was trying to package the info files, I
noticed older texinfo
doesn't generate knot-resolver-figures directory and places the images
directly in the output directory.
It wouldn't be Texinfo doing that; it's Sphinx itself that creates that
subfolder and places the images there (and the subfolder's name in the
@image tags it outputs). Are the
figures even important for info documentation? Could we install
just knot-resolver.info to simplify things?
Well, maybe, but then the info manual would contain references to images
that don't exist on the system. And the images _do_ display in Emacs
(and perhaps other Info readers), so it would be nice to have them there
for parity with the HTML manual.