++

Author: Dmitry Ovsyanko

.github/workflows/build-book.yml

@@ -14,9 +14,14 @@ jobs:
     - name: Checkout (gh-pages)
       uses: actions/checkout@v4
       with:
-        ref: gh-pages
+        ref: main
         fetch-depth: 0
 
+    - name: Fetch and extract gh-pages into workspace
+      run: |
+        git fetch origin gh-pages:gh-pages
+        git archive gh-pages | tar -x -C .
+
     - name: Setup Node.js
       uses: actions/setup-node@v4
       with:
@@ -28,8 +33,7 @@ jobs:
         sudo apt-get install -y pandoc wkhtmltopdf zip
 
     - name: Install npm deps for scripts
-      run: |
-        npm ci --prefix tools || npm install --prefix tools
+      run: npm install --prefix tools
 
     - name: Build site sources (split markdown + emit toc)
       run: |
@@ -47,9 +51,16 @@ jobs:
       run: |
         pandoc docs/index.md -s --metadata title="The node-xml-toolkit User's Guide" --css=tools/templates/site.css --template=tools/templates/book.html --toc -o build/book.html
 
-    - name: Generate PDF with bookmarks
+    - name: Install XeLaTeX and fonts
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y texlive-xetex fonts-dejavu-core fonts-noto-core
+
+    - name: Generate PDF via pandoc + xelatex with a Unicode font
       run: |
-        wkhtmltopdf --print-media-type --outline build/book.html build/book.pdf
+        pandoc docs/index.md -s --toc -V geometry:margin=1in \
+          -V mainfont="DejaVu Serif" \
+          --pdf-engine=xelatex -o build/book.pdf
 
     - name: Package site HTML
       run: |

docs/index.md

@@ -2397,4 +2397,4 @@ app.post('/soap', async (req, res) => {
     })
   }
 })
-```
+```

tools/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "node-xml-toolkit-tools",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "split": "node split-by-h2.js"
+  },
+  "dependencies": {}
+}