Merge pull request #1718 from LinuxCNC/2.8-pdf-index

SebKuzminsky · web-flow · commit 652e88c22bd4 · 2022-04-25T17:23:52.000-06:00
make a pretty index.html for the PDF docs
diff --git a/docs/.gitignore b/docs/.gitignore
@@ -0,0 +1,2 @@
+# generated when building pdf docs
+index.html
diff --git a/docs/src/Submakefile b/docs/src/Submakefile
@@ -434,7 +434,10 @@ ifeq ($(BUILD_DOCS_HTML),yes)
 docs: htmldocs
 install-doc: install-doc-html
 endif
+
 pdfdocs: $(PDF_TARGETS)
+	../scripts/make-docs-pdf-index
+
 htmldocs: .htmldoc-stamp checkref
 
 .htmldoc-stamp: copy_asciidoc_files $(HTML_TARGETS) .html-images-stamp
diff --git a/scripts/make-docs-pdf-index b/scripts/make-docs-pdf-index
@@ -0,0 +1,27 @@
+#!/bin/bash
+#
+# Make a pretty(?) index page of the PDF docs.
+#
+
+set -e
+
+# Assume we're running in src/, we can't call `git rev-parse
+# --show-toplevel` because when building from dsc we don't have a
+# git repo.
+TOPLEVEL=${PWD}/..
+cd ${TOPLEVEL}/docs
+
+TITLE="LinuxCNC PDF docs ($(cat ${TOPLEVEL}/VERSION))"
+
+rm -f index.html
+
+echo "<html>" >> index.html
+echo "<head><title>${TITLE}</title></head>" >> index.html
+echo "<body><h1>${TITLE}</h1><p>" >> index.html
+
+for F in $(ls -1 *.pdf | sort); do
+    echo "    <a href=\"${F}\">$F</a><br>" >> index.html
+done
+
+echo "</body>" >> index.html
+echo "</html>" >> index.html
diff --git a/src/configure.ac b/src/configure.ac
@@ -1444,7 +1444,8 @@ then
 	    AC_MSG_RESULT([found])
 	else
 	    AC_MSG_RESULT(no)
-	    AC_MSG_ERROR([Python pango and cairo modules not found!\ninstall with "sudo apt-get install python3-gi"])
+	    AC_MSG_WARN([Python pango and cairo modules not found!])
+	    AC_MSG_ERROR([install with "sudo apt-get install python3-gi"])
 	fi
 
 else
@@ -1453,7 +1454,8 @@ else
 	    AC_MSG_RESULT([found])
 	else
 	    AC_MSG_RESULT(no)
-	    AC_MSG_ERROR([Python pango and cairo modules not found!\ninstall with "sudo apt-get install python-gtk2"])
+	    AC_MSG_WARN([Python pango and cairo modules not found!])
+	    AC_MSG_ERROR([install with "sudo apt-get install python-gtk2"])
 	fi
 	fi
 fi

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+# generated when building pdf docs`
	`2`	`+index.html`