From ec99be033229e3c5a9653d8a9896b65f3c5605ab Mon Sep 17 00:00:00 2001
From: Simon Large <simon@skirridsystems.co.uk>
Date: Fri, 24 Jul 2020 18:54:06 +0100
Subject: [PATCH] Create separate scripts for building HTML and PDF documents

The PDF build command line is getting very long, and it needs another option. Create separate build scripts for HTML and PDF and just pass in the name of the markdown file.

Adds -V subparagraph to fix a LaTeX error.

Adds fallback font selection to the PDF script.
---
 .gitignore        |  4 ++--
 man/build-html.sh |  3 +++
 man/build-pdf.sh  | 32 ++++++++++++++++++++++++++++++++
 man/buildman.sh   | 10 +++++-----
 4 files changed, 42 insertions(+), 7 deletions(-)
 create mode 100644 man/build-html.sh
 create mode 100644 man/build-pdf.sh

diff --git a/.gitignore b/.gitignore
index 5ee9140bc..35be206dc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -103,10 +103,10 @@ snap/.snapcraft
 # Manual folder
 man/manual.log
 man/manual.tex
+man/*.pdf
+man/*.html
 
 # CLion
 .idea
 /.metadata/
 cmake-*
-man/manual.pdf
-man/manual.html
diff --git a/man/build-html.sh b/man/build-html.sh
new file mode 100644
index 000000000..d9c4aa1c9
--- /dev/null
+++ b/man/build-html.sh
@@ -0,0 +1,3 @@
+#!/bin/sh
+echo Building $1.html
+pandoc $1.md -o $1.html -s --number-sections --toc --css manual.css
diff --git a/man/build-pdf.sh b/man/build-pdf.sh
new file mode 100644
index 000000000..f9930ef01
--- /dev/null
+++ b/man/build-pdf.sh
@@ -0,0 +1,32 @@
+#!/bin/sh
+# This uses installed fonts, which vary between systems
+# Segoe UI and Consolas are standard in Windows 10, DejaVu is more common on Linux
+echo Building $1.pdf
+
+MainFont="Segoe UI"
+MonoFont="Consolas"
+
+is_font_installed() {
+    fontname=$1
+    fc-list | grep -i "$fontname" >/dev/null
+}
+
+if ! is_font_installed "$MainFont"; then
+    MainFont="DejaVu Sans"
+fi
+if ! is_font_installed "$MonoFont"; then
+    MonoFont="DejaVu Sans Mono"
+fi
+
+# echo Using $MainFont / $MonoFont
+
+pandoc $1.md -o $1.pdf -s --number-sections --toc \
+    --pdf-engine=xelatex \
+    --listings \
+    -f markdown \
+    -V mainfont="$MainFont" \
+    -V monofont="$Consolas" \
+    -V geometry:a4paper \
+    -V geometry:margin=2.4cm \
+    -V subparagraph \
+    -H manual-style.tex
diff --git a/man/buildman.sh b/man/buildman.sh
index 4c91e0ed6..cd198071f 100755
--- a/man/buildman.sh
+++ b/man/buildman.sh
@@ -1,10 +1,10 @@
 #!/bin/sh
 # To install required tools in debian:
 # sudo apt-get install pandoc texlive-latex-base texlive-fonts-recommended texlive-latex-extra
+# For Windows you can use the MiKTeX installer https://miktex.org/download
 
-pandoc manual.md -o manual.pdf -s --number-sections --toc -f markdown --pdf-engine=xelatex --listings -V mainfont="Segoe UI" -V monofont="Consolas" -V geometry:a4paper -V geometry:margin=2.4cm -H manual-style.tex
+./build-pdf.sh manual
+./build-html.sh manual
 
-pandoc manual.md -o manual.html -s --number-sections --toc --css manual.css
-
-pandoc reference-cfg-format.md -o reference-cfg-format.pdf -s --number-sections --toc
-pandoc reference-cfg-format.md -o reference-cfg-format.html -s --number-sections --toc
+./build-pdf.sh reference-cfg-format
+./build-html.sh reference-cfg-format