doc/info: create and install figures

diff --git a/doc/meson.build b/doc/meson.build
index a911f92389cb78815113842b3d6da304be677189..f06b6e30bbcd870ef3d6e34d906d31be1d5646fe 100644 (file)
--- a/doc/meson.build
+++ b/doc/meson.build
@@ -58,9 +58,6 @@ if get_option('doc') == 'enabled'
 
   if makeinfo.found()
     # install info docs
-    # FIXME: Sphinx < 2 doesn't create a separate directory for figures, while
-    #        a newer one does. To simplify packaging, figures for info pages are
-    #        compleltely omitted for now.
     install_subdir(
       join_paths(meson.current_source_dir(), 'texinfo', '.install'),
       strip_directory: true,

diff --git a/scripts/make-doc.sh b/scripts/make-doc.sh
index 5cc18302ef3b501cfd4fe2d7dbbc86a4cc0cc771..d41e234c938d159530f4b7058af8cf07cf1a21a5 100755 (executable)
--- a/scripts/make-doc.sh
+++ b/scripts/make-doc.sh
@@ -18,8 +18,25 @@ ${SPHINX} ${@} -b html -d doc/.doctrees doc doc/html
 
 if command -v makeinfo &>/dev/null; then
     rm -rf doc/texinfo
-    ${SPHINX} ${@} -b texinfo -d doc/.doctrees doc doc/texinfo && \
-        make -C doc/texinfo info
+    ${SPHINX} ${@} -b texinfo -d doc/.doctrees doc doc/texinfo
+
+    # Sphinx < 2 doesn't create a separate directory for figures, so if
+    # necessary move them to the correct location and update the references in
+    # the generated Texinfo file
+    if [ ! -d doc/texinfo/knot-resolver-figures ]; then
+        cd doc/texinfo
+        mkdir knot-resolver-figures
+        mv *.png *.svg knot-resolver-figures/
+        sed -e 's/\(@image{\)/\1knot-resolver-figures\//' \
+            knot-resolver.texi > knot-resolver.texi.tmp
+        mv knot-resolver.texi.tmp knot-resolver.texi
+        cd ../..
+    fi
+
+    make -C doc/texinfo info
+
     mkdir doc/texinfo/.install
-    mv doc/texinfo/knot-resolver.info doc/texinfo/.install/
+    mv doc/texinfo/knot-resolver.info \
+       doc/texinfo/knot-resolver-figures \
+       doc/texinfo/.install/
 fi