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](executablebooks/sphinx-design#107) in
sphinx-design which prints dropdowns just as subsections without any
visual highlighting. In general it still is readable.

Author: holzingk

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)}

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",
@@ -26,5 +26,4 @@
     }
   },
   "version": 3
-}
-
+}

source/_static/_img/nix.pdf

@@ -0,0 +1 @@
+<p>nix.dev as <a href="nix-dev.pdf">PDF</p>

source/_templates/download-links.html

@@ -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 = []