docs: Generate pdf version of docs for #9095

This implements the changes required to genreate the pdf version
of the documentation. The pdf will be generated as a build artifact
attached to the build. This is the first patch to enable this
a follow on patch to the website repo will publish the pdf to the
NuttX website.

.github/workflows/doc.yml

@@ -10,6 +10,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
+---
 name: "Build Documentation"
 on:
   pull_request:
@@ -30,13 +31,22 @@ jobs:
       - uses: actions/setup-python@v4
         with:
           python-version: '3.8'
+      - name: Install LaTeX packages
+        run: |
+          sudo apt-get update -y
+          sudo apt-get install -y \
+            texlive-latex-recommended texlive-fonts-recommended \
+            texlive-latex-base texlive-latex-extra latexmk texlive-luatex \
+            fonts-freefont-otf xindy
       - name: Generate Documentation
         run: |
           cd Documentation/
           pip3 install pipenv
           pipenv install
-          pipenv run make html
+          pipenv run make html latexpdf
       - uses: actions/upload-artifact@v3
         with:
           name: sphinx-docs
-          path: Documentation/_build/html/
+          path: |
+            Documentation/_build/html/
+            Documentation/_build/latex/*.pdf

Documentation/components/nxgraphics/index.rst

@@ -83,7 +83,7 @@ That NuttX directory organization is discussed in `Appendix
 B <#grapicsdirs>`__ of this document. The logic modules are discussed in
 the following sub-paragraphs.
 
-.. figure:: NXOrganization.gif
+.. figure:: NXOrganization.png
   :align: center
 
 NX Graphics Library (``NXGL``)

Documentation/conf.py

@@ -119,3 +119,5 @@ linkcheck_ignore = [
     "https://github.com/pyenv/pyenv#installation",
     "http://openocd.zylin.com/#/c/4103/",
 ]
+
+latex_engine = "lualatex"

Documentation/platforms/arm/nrf52/boards/nrf52832-mdk/index.rst

@@ -7,7 +7,7 @@ the nRF52832 SoC from Nordic. It features 24 I/Os an on-board RGB led and a chip
 It also includes an embedded DAPlink debugger which allows to flash/debug and monitor UART
 from the USB port.
 
-.. figure:: pinout.webp
+.. figure:: pinout.png
    :align: center
 
    Pinout diagram