fix docs pdf build

Author: bckohan

doc/broken_links.py

@@ -105,9 +105,16 @@ clean: clean-docs clean-git-ignored clean-env
 build-docs-html: install-docs
     @just run sphinx-build --fresh-env --builder html --doctree-dir ./doc/build/doctrees ./doc/source ./doc/build/html
 
+[script]
+_open-pdf-docs:
+    import webbrowser
+    webbrowser.open(f"file://{Path('./doc/build/pdf/django-typer.pdf').absolute()}")
+
 # build pdf documentation
 build-docs-pdf: install-docs
-    @just run sphinx-build --fresh-env --builder latexpdf --doctree-dir ./doc/build/doctrees ./doc/source ./doc/build/pdf
+    @just run sphinx-build --fresh-env --builder latex --doctree-dir ./doc/build/doctrees ./doc/source ./doc/build/pdf
+    make -C ./doc/build/pdf
+    @just _open_pdf-docs
 
 # build the docs
 build-docs: build-docs-html

justfile

@@ -196,7 +196,7 @@ docs = [
     "sphinx>=7.4.7",
     "sphinx-autobuild>=2024.10.3",
     "sphinx-tabs>=3.4.7",
-    "sphinxcontrib-typer>=0.5.1",
+    "sphinxcontrib-typer[png]>=0.5.1",
 ]
 psycopg3 = [
     "psycopg>=3.1.8",