Fix title page to single page, add version to filename and front page

- Set release = __version__ so \py@release renders the version on the title page
- Use \includegraphics[width=0.35\linewidth] instead of \sphinxlogo to constrain
  the logo size; \sphinxlogo has no width limit and caused the title page to spill
  across 3 pages when the PNG natural resolution was large
- Replace double \vfill with \vspace*{\fill} so the two rules and centered block
  sit correctly within the single titlepage environment
- Include version in latex_documents filename: dfetch-<version>.pdf
- Update docs.yml artifact/release paths to dfetch-*.pdf glob

https://claude.ai/code/session_014hVQ5UrK1B4N9ar4UfYpm4

Author: claude

.github/workflows/docs.yml

@@ -101,14 +101,14 @@ jobs:
         uses: actions/upload-artifact@bbbca2ddaa5d8feaa63e36b76fdaad77386f024f # v7.0.0
         with:
           name: dfetch-pdf-documentation
-          path: doc/_build/latex/dfetch.pdf
+          path: doc/_build/latex/dfetch-*.pdf
 
       - name: Upload PDF to release
         if: ${{ inputs.release_id }}
         uses: softprops/action-gh-release@153bb8e04406b158c6c84fc1615b65b24149a1fe # v2.5.0
         with:
           tag_name: ${{ inputs.release_id }}
-          files: doc/_build/latex/dfetch.pdf
+          files: doc/_build/latex/dfetch-*.pdf
           draft: true
           preserve_order: true
         env:

doc/conf.py

@@ -80,7 +80,7 @@
 # The short X.Y version.
 version = __version__
 # The full version, including alpha/beta/rc tags.
-release = ""
+release = __version__
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -220,23 +220,26 @@
     # Custom title page with amber header bar, logo, and accent footer.
     # \makeatletter/\makeatother are required to access \py@release (@ is a
     # letter in LaTeX package code but not in regular document mode).
+    # \sphinxlogo is NOT used here because it has no size constraint; instead
+    # we include the logo directly with an explicit width to keep the page count
+    # at exactly one regardless of the image's natural resolution.
     "maketitle": r"""
 \makeatletter
 \begin{titlepage}
   \noindent{\color{dfprimary}\rule{\linewidth}{6pt}}\par
-  \vfill
+  \vspace*{\fill}
   \begin{center}
-    \sphinxlogo\par
-    \vspace{1.8cm}
+    \includegraphics[width=0.35\linewidth]{dfetch_logo.png}\par
+    \vspace{1.2cm}
     {\fontsize{40}{44}\selectfont\bfseries\color{dfprimary}Dfetch\par}
-    \vspace{0.4cm}
+    \vspace{0.3cm}
     {\LARGE\color{dfnearblack}Documentation\par}
-    \vspace{0.8cm}
+    \vspace{0.6cm}
     {\large\color{dftextmuted}\textit{vendor dependencies without the pain}\par}
-    \vspace{2.5cm}
+    \vspace{1.5cm}
     {\large\color{dftextmuted}\py@release\par}
   \end{center}
-  \vfill
+  \vspace*{\fill}
   \noindent{\color{dfaccent}\rule{\linewidth}{4pt}}\par
 \end{titlepage}
 \makeatother
@@ -247,7 +250,7 @@
 # (source start file, target name, title,
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
-    (master_doc, "dfetch.tex", "Dfetch Documentation", "Dfetch", "manual"),
+    (master_doc, f"dfetch-{__version__}.tex", "Dfetch Documentation", "Dfetch", "manual"),
 ]