For a collection of Texinfo manuals that reference each other but no
other manuals, `-c HTMLXREF_MODE=none` could be used for `texi2any
--html` to force links in the generated HTML manuals to point to the
local---thus same-version---HTML files rather than to a (canonical)
website from a (built-in) htmlxref.cnf (that possibly serves a different
version of the manuals).
Using this approach, Texinfo >= 7.2 now shows warnings of the form
warning: no HTML cross-references entry found for `...'
which I can mute by an additional `-c CHECK_HTMLXREF=0`.
Should that be the default for `HTMLXREF_MODE=none` ?
Now for --epub output, cross-references cannot be to local files so do
need URLs from a htmlxref.cnf. Is there a recommended approach for
generating both HTML and EPUB versions of a collection of manuals, where
the former points to local files and the latter uses full URLs? Is the
approach described above (using the customization variables for the
--html case) reasonable and stable?
Obviously HTMLXREF_MODE=none wouldn't work if the manuals also contained
truly external cross-references (e.g., to other GNU manuals). How to
proceed in that case? Create and switch (as needed) two htmlxref.cnf
files for the within-project manuals such as
manualA mono ${BASEURL}/manualA.html
manualB mono ${BASEURL}/manualB.html
and set `BASEURL = .` for the --html run or is there a more elegant
solution?
Thanks!
--
Sebastian Meyer
Friedrich-Alexander-Universität Erlangen-Nürnberg (FAU)
Institute of Medical Informatics, Biometry, and Epidemiology (IMBE)
https://www.imbe.med.fau.de/person/sebastian-meyer/
