From 485f06789875e5a5985e365942d90bacb5fa07e7 Mon Sep 17 00:00:00 2001
From: William Emfinger <waemfinger@gmail.com>
Date: Fri, 31 May 2024 13:09:26 -0500
Subject: [PATCH] Fix pdf build (#249)

* install full texlive

* update build to checkoutv4

* run documentation on pandoc latex container to install less

* ignore command failure

* update to setup-python v5

* remove sudo

* remove apt-get install

* remove use of pandoc container

* try pandoc ubuntu...

* test

* test fix again...

* update to v4
---
 .github/workflows/build.yml                  |  2 +-
 .github/workflows/build_and_publish_docs.yml | 14 +++++++-------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index c8015655b..4054faef9 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -126,7 +126,7 @@ jobs:
 
     steps:
     - name: Checkout repo
-      uses: actions/checkout@v2
+      uses: actions/checkout@v4
       with:
         submodules: 'recursive'
 
diff --git a/.github/workflows/build_and_publish_docs.yml b/.github/workflows/build_and_publish_docs.yml
index de5bdba84..970060304 100644
--- a/.github/workflows/build_and_publish_docs.yml
+++ b/.github/workflows/build_and_publish_docs.yml
@@ -19,14 +19,14 @@ jobs:
           fetch-tags: true
 
       - name: Set up Python
-        uses: actions/setup-python@v3
+        uses: actions/setup-python@v5
         with:
           python-version: "3.11"
 
       - name: Install Dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install doxygen texlive
+          sudo apt-get install doxygen graphviz texlive-full pandoc
           pip install -r doc/requirements.txt
 
       - name: Build Documentation
@@ -38,15 +38,15 @@ jobs:
           cp -r _build/en/esp32/html/* ../docs/.
           # go to the latex output
           cd _build/en/esp32/latex/
-          # build once
-          pdflatex -interaction=batchmode refman
-          # build again to make sure page numbers and refs and such work
-          pdflatex -interaction=batchmode refman
+          # build once (ignore if command fails)
+          pdflatex -interaction=batchmode refman || true
+          # build again to make sure page numbers and refs and such work (ignore if command fails)
+          pdflatex -interaction=batchmode refman || true
           # rename refman to espp_documentation.pdf
           mv refman.pdf espp_documentation.pdf
 
       - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v3
+        uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./docs