add bin/ entrypoint for building PDF

To export the docs as a PDF

.gitignore

@@ -9,3 +9,4 @@ pub
 *.css.map
 deployment-report.json
 build/
+venv/

README.md

@@ -115,3 +115,12 @@ To inspect the contents of the deb archive you can run:
 /usr/share/doc/hndocsnext/README.md
 /usr/share/doc/hndocsnext/changelog.gz
 ```
+
+## Build as PDF
+
+To build the documentation as a single PDF file, run the following command:
+```
+bin/build_pdf
+```
+
+The built PDF will then be in `docs/_build/pdf/`.

bin/build_pdf

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+
+set -e
+
+pushd docs
+make pdf
+echo "pdf located at $(realpath _build/pdf/hypernode_documentation.pdf)"
+popd

docs/conf.py

@@ -21,8 +21,9 @@
 # -- Project information -----------------------------------------------------
 
 project = "Docs"
-copyright = "2023, Hypernode"
+copyright = "2024, Hypernode"
 author = "Hypernode"
+version = "https://docs.hypernode.com/"
 
 # The full version, including alpha/beta/rc tags
 release = "dev"
@@ -47,6 +48,7 @@
     "hypernode.sphinx.extensions.meta_robots",
     "hypernode.sphinx.extensions.github_actions_logging",
     "sphinxcontrib.mermaid",
+    "rst2pdf.pdfbuilder",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -95,6 +97,10 @@
         ]
     )
 
+pdf_documents = [
+    ("index", "hypernode_documentation", "Hypernode Documentation", "by Hypernode"),
+]
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".

requirements/base.txt

@@ -11,6 +11,7 @@ sphinx-notfound-page==0.8.3
 sphinx-sitemap==2.4.0
 GitPython==3.1.30
 sphinxcontrib-mermaid==0.7.1
+rst2pdf==0.99
 
 # hypernode/ requirements
 beautifulsoup4==4.11.1