Cover image

.gitignore

@@ -1,3 +1,4 @@
 .pio
 .venv
 .vscode
+docs/latex-logo.pdf

docs/Makefile

@@ -10,6 +10,10 @@ BUILDDIR      = _build
 help:
 	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
+.PHONY: latex-logo
+latex-logo:
+	rsvg-convert --format=pdf --output=latex-logo.pdf _static/images/boards/arduino-uno.svg
+
 # Catch-all target: route all unknown targets to Sphinx
 # $(O) is a shortcut for $(SPHINXOPTS)
 .PHONY: Makefile

docs/conf.py

@@ -1,6 +1,18 @@
 import sphinx_rtd_theme
+import subprocess
+import sys
 
 
+def make_latex_logo():
+
+    command = subprocess.run(["make", "latex-logo"], capture_output=True)
+
+    sys.stdout.buffer.write(command.stdout)
+    sys.stderr.buffer.write(command.stderr)
+
+
+make_latex_logo()
+
 project = "Beginning Arduino with PlatformIO"
 copyright = "2021, Seth Fischer"
 author = "Seth Fischer"
@@ -19,3 +31,5 @@
 
 html_theme = "sphinx_rtd_theme"
 html_static_path = ["_static"]
+
+latex_logo = "latex-logo.pdf"

docs/index.rst

@@ -2,6 +2,12 @@
 Beginning Arduino with PlatformIO
 =================================
 
+.. only:: not latex
+
+    .. image:: _static/images/boards/arduino-uno.svg
+        :alt: Arduino Uno board
+
+
 .. toctree::
     :maxdepth: 2
     :caption: Contents:

docs/license.rst

@@ -15,6 +15,12 @@ Trademarks
 *PlatformIO* is a trademark of PlatformIO Labs OÜ.
 
 
+Acknowledgements
+----------------
+
+Cover image: Adaptded from PhilippHenkel, CC BY-SA 4.0, via Wikimedia Commons.
+
+
 .. _`Beginning Arduino with PlatformIO`: https://github.com/sethfischer/arduino-beginner
 .. _`Seth Fischer`: https://github.com/sethfischer/
 .. _`CC BY-SA 4.0`: https://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1