From b6dc9d33488899b73c78675f5357afabf8f8fd29 Mon Sep 17 00:00:00 2001 From: Maxim Cournoyer Date: Thu, 9 Jun 2022 13:43:14 -0400 Subject: doc: Replace texi2html with makeinfo to generate HTML doc. One benefit of using 'makeinfo' instead of 'texi2html' is that the HTML file hierarchy layout produced by 'makeinfo' matches the layout expected for cross-reference URLs. For example, a cross-reference defined via: @pxref{Introduction,,, geiser, Geiser User Manual} would produce the URL: /Introduction.html#Introduction, while Texi2html produces /geiser/geiser_1.html#Introduction instead, breaking for example a cross-reference in the GNU Guix Reference Manual (see: https://issues.guix.gnu.org/55290). * doc/makefile (web): Replace texi2html with makeinfo. * doc/site.conf: Delete file. * doc/web.texi: Likewise. --- doc/makefile | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) (limited to 'doc/makefile') diff --git a/doc/makefile b/doc/makefile index 6f2a779..fd25e55 100644 --- a/doc/makefile +++ b/doc/makefile @@ -18,15 +18,14 @@ clean: web: rm -f $(output_dir)/*.html - texi2html --output=$(output_dir) \ - --split=chapter \ - --noheader \ - --nonumber-section \ - --init-file=$(top_srcdir)/doc/site.conf \ - --top-file=index.html \ - $(top_srcdir)/doc/web.texi - cp $(top_srcdir)/doc/geiser.css ${output_dir} - cp -r $(top_srcdir)/doc/img ${output_dir} + makeinfo --output=$(output_dir) \ + --html \ + --css-include=$(CURDIR)/geiser.css \ + --no-headers \ + --no-number-sections \ + --split=chapter \ + $(CURDIR)/geiser.texi && \ + cp -r $(CURDIR)/img ${output_dir} http: web cd $(output_dir) && python -m http.server $(port) -- cgit v1.2.3