From 5a510bed0e0c26438e76c8ac7439170decbad0ce Mon Sep 17 00:00:00 2001
From: Kilian Holzinger <kilian.holzinger@gmail.com>
Date: Tue, 6 May 2025 21:09:36 +0200
Subject: [PATCH] Publish PDF

I had to update pinned nixpkgs, as it did not build with TexLive 2022.

Some content annotations are not transformed very well in LaTex output. For example, there is a [bug](https://github.com/executablebooks/sphinx-design/issues/107) in sphinx-design which prints dropdowns just as subsections without any visual highlighting. In general it is readable and better typeset compared to the PDF obtained by printing to PDF.

Also, there is now full texlive which is quite a huge dependency.
---
 default.nix                           |  27 +++++++++++++++-----------
 npins/sources.json                    |   7 +++----
 source/_static/_img/nix.pdf           | Bin 0 -> 5452 bytes
 source/_templates/download-links.html |   1 +
 source/conf.py                        |  16 +++++++++------
 5 files changed, 30 insertions(+), 21 deletions(-)
 create mode 100644 source/_static/_img/nix.pdf
 create mode 100644 source/_templates/download-links.html

diff --git a/default.nix b/default.nix
index 63b37a48d..e6253ffca 100644
--- a/default.nix
+++ b/default.nix
@@ -16,21 +16,24 @@ let
     overlays = [ ];
     inherit system;
   };
-
+  nix-dev-python-pkgs = with pkgs.python310.pkgs; [
+    linkify-it-py
+    myst-parser
+    sphinx
+    sphinx-book-theme
+    sphinx-copybutton
+    sphinx-design
+    sphinx-notfound-page
+    sphinx-sitemap
+    pkgs.perl
+  ];
   nix-dev =
     pkgs.stdenv.mkDerivation {
       name = "nix-dev";
       src = ./.;
-      nativeBuildInputs = with pkgs.python310.pkgs; [
-        linkify-it-py
-        myst-parser
-        sphinx
-        sphinx-book-theme
-        sphinx-copybutton
-        sphinx-design
-        sphinx-notfound-page
-        sphinx-sitemap
-        pkgs.perl
+      nativeBuildInputs = [
+        nix-dev-python-pkgs
+        pkgs.texlive.combined.scheme-full
       ];
       buildPhase =
         let
@@ -42,6 +45,7 @@ let
         ''
           ${lib.optionalString withManuals "cp -f ${substitutedNixManualReference} source/reference/nix-manual.md"}
           make html
+          make latexpdf
         '';
       installPhase =
         let
@@ -68,6 +72,7 @@ let
         ''
           mkdir -p $out/manual/nix
           cp -R build/html/* $out/
+          cp build/latex/nix-dev.pdf $out/
         '' + lib.optionalString withManuals ''
           ${lib.concatStringsSep "\n" (lib.mapAttrsToList release releases.nixReleases)}
           ${lib.concatStringsSep "\n" (lib.mapAttrsToList mutableRedirect releases.mutableNixManualRedirects)}
diff --git a/npins/sources.json b/npins/sources.json
index 15cda801f..f3c3e0315 100644
--- a/npins/sources.json
+++ b/npins/sources.json
@@ -8,9 +8,9 @@
         "repo": "nixpkgs"
       },
       "branch": "nixpkgs-unstable",
-      "revision": "3a05eebede89661660945da1f151959900903b6a",
-      "url": "https://github.com/nixos/nixpkgs/archive/3a05eebede89661660945da1f151959900903b6a.tar.gz",
-      "hash": "0n56l6v5k3lmrr4vjnp6xk1s46shkwdkvai05dzcbcabpl29yb9g"
+      "revision": "ed30f8aba41605e3ab46421e3dcb4510ec560ff8",
+      "url": "https://github.com/nixos/nixpkgs/archive/ed30f8aba41605e3ab46421e3dcb4510ec560ff8.tar.gz",
+      "hash": "0mg2wzzzakbb33z1a1qrlslr8q84j1ci9j53p9dj8nggmm2xv0p6"
     },
     "poetry2nix": {
       "type": "Git",
@@ -27,4 +27,3 @@
   },
   "version": 3
 }
-
diff --git a/source/_static/_img/nix.pdf b/source/_static/_img/nix.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..4c344d851dc62c8a619eba4a9cdfb4ec60694a88
GIT binary patch
literal 5452
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
R5G8;DQ9*){k+qWz;WyFVy`}&F

literal 0
HcmV?d00001

diff --git a/source/_templates/download-links.html b/source/_templates/download-links.html
new file mode 100644
index 000000000..dcfb7de4a
--- /dev/null
+++ b/source/_templates/download-links.html
@@ -0,0 +1 @@
+<p>nix.dev as <a href="nix-dev.pdf">PDF</p>
diff --git a/source/conf.py b/source/conf.py
index bdeb11f42..16dd719f0 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -201,6 +201,7 @@
         "about.html",
         "search-field.html",
         "sbt-sidebar-nav.html",
+        "download-links.html",
     ],
 }
 
@@ -260,9 +261,11 @@
     # The font size ('10pt', '11pt' or '12pt').
     #'pointsize': '10pt',
     # Additional stuff for the LaTeX preamble.
-    'preamble': '\setcounter{tocdepth}{3}',
+    'preamble': r'\setcounter{tocdepth}{2}',
+    'sphinxsetup': r'TitleColor={RGB}{87, 154, 202}',
     # Latex figure (float) alignment
     #'figure_align': 'htbp',
+
 }
 
 # Grouping the document tree into LaTeX files. List of tuples
@@ -271,17 +274,18 @@
 latex_documents = [
     (
         master_doc,
-        "nixpkgs-cookbook.tex",
-        "nixpkgs-cookbook Documentation",
+        "nix-dev.tex",
+        "nix.dev",
         "nix.dev contributors",
         "manual",
+        True, # toctree only
     ),
 ]
 
 latex_engine = "xelatex"
 # The name of an image file (relative to this directory) to place at the top of
 # the title page.
-# latex_logo = None
+latex_logo = "_static/_img/nix.pdf"
 
 # For "manual" documents, if this is true, then toplevel headings are parts,
 # not chapters.
@@ -290,10 +294,10 @@
 latex_use_xindy = False
 
 # If true, show page references after internal links.
-# latex_show_pagerefs = False
+latex_show_pagerefs = True
 
 # If true, show URL addresses after external links.
-# latex_show_urls = False
+latex_show_urls = 'footnote'
 
 # Documents to append as an appendix to all manuals.
 # latex_appendices = []