Revert "Convert from docbook to mdbook (#233)"

This reverts commit 4033045.

To preserve history.

.gitignore

@@ -1,3 +1,2 @@
 result
 result-*
-/book*

README.md

@@ -9,3 +9,44 @@ You can also build them locally:
 Similarly, for an [EPUB](https://www.w3.org/publishing/epub32/) version, run:
 
     nix-build release.nix -A epub && foliate result/share/doc/nix-pills/nix-pills.epub
+
+## Development
+
+ - [List of DocBook Elements](https://tdg.docbook.org/tdg/5.2/part2.html)
+
+Emacs config for a nice DocBook experience:
+
+ ```nix
+ let
+  pkgs = import <nixpkgs> {};
+  inherit (pkgs) emacsPackagesNg docbook5 writeText;
+
+  schemas = writeText "schemas.xml" ''
+    <locatingRules xmlns="http://thaiopensource.com/ns/locating-rules/1.0">
+      <documentElement localName="section" typeId="DocBook"/>
+      <documentElement localName="chapter" typeId="DocBook"/>
+      <documentElement localName="article" typeId="DocBook"/>
+      <documentElement localName="book" typeId="DocBook"/>
+      <typeId id="DocBook" uri="${docbook5}/xml/rng/docbook/docbookxi.rnc" />
+    </locatingRules>
+  '';
+
+in emacsPackagesNg.emacsWithPackages (epkgs: [
+  (emacsPackagesNg.trivialBuild {
+    pname = "nix-docbook-mode";
+    version = "1970-01-01";
+    src = writeText "default.el" ''
+      (eval-after-load 'rng-loc
+        '(add-to-list 'rng-schema-locating-files "${schemas}"))
+      (global-set-key (kbd "<C-return>") 'nxml-complete)
+    '';
+  })
+])
+```
+
+Then you can use the keys:
+
+
+ - `C-c C-b` to finish & close a tag
+ - `C-c C-f` to close a tag
+ - `C-return` to auto-complete a tag or attribute.

book.xml

@@ -0,0 +1,64 @@
+<book xmlns="http://docbook.org/ns/docbook"
+      xmlns:xlink="http://www.w3.org/1999/xlink"
+      xmlns:xi="http://www.w3.org/2001/XInclude"
+      version="5.0"
+      xml:id="book-nix-pills">
+
+  <info>
+    <title>Nix Pills</title>
+    <subtitle>Version <xi:include href="version" parse="text" /></subtitle>
+  </info>
+
+  <preface>
+    <title>Preface</title>
+
+    <para>
+      This is a ported version of the <emphasis role="strong">Nix
+      Pills</emphasis>, a series of blog posts written by <emphasis
+      role="strong">Luca Bruno</emphasis> (aka Lethalman) and
+      originally published in 2014 and 2015. It provides a tutorial
+      introduction into the Nix package manager and Nixpkgs package
+      collection, in the form of short chapters called 'pills'.
+    </para>
+
+    <para>
+      Since the Nix Pills are considered a classic introduction to
+      Nix, an effort to port them to the current format was led by
+      Graham Christensen (aka grahamc / gchristensen) and other
+      contributors in 2017.
+    </para>
+
+    <para>
+      For an up-to-date version, please visit <link xlink:href="https://nixos.org/guides/nix-pills/" />. An <link xlink:href="https://nixos.org/guides/nix-pills/nix-pills.epub">EPUB version</link> is also available.
+    </para>
+
+    <para>If you encounter problems, please report them on the
+    <link xlink:href="https://github.com/NixOS/nix-pills/issues">nixos/nix-pills</link>
+    issue tracker.</para>
+
+    <note><para>Commands prefixed with <literal>#</literal> have to be run as
+    root, either requiring to login as root user or temporarily switching
+    to it using <literal>sudo</literal> for example.</para></note>
+  </preface>
+
+  <xi:include href="pills/01-why-you-should-give-it-try.xml" />
+  <xi:include href="pills/02-install-on-your-running.xml" />
+  <xi:include href="pills/03-enter-environment.xml" />
+  <xi:include href="pills/04-basics-of-language.xml" />
+  <xi:include href="pills/05-functions-and-imports.xml" />
+  <xi:include href="pills/06-our-first-derivation.xml" />
+  <xi:include href="pills/07-working-derivation.xml" />
+  <xi:include href="pills/08-generic-builders.xml" />
+  <xi:include href="pills/09-automatic-runtime.xml" />
+  <xi:include href="pills/10-developing-with-nix-shell.xml" />
+  <xi:include href="pills/11-garbage-collector.xml" />
+  <xi:include href="pills/12-inputs-design-pattern.xml" />
+  <xi:include href="pills/13-callpackage-design-pattern.xml" />
+  <xi:include href="pills/14-override-design-pattern.xml" />
+  <xi:include href="pills/15-nix-search-paths.xml" />
+  <xi:include href="pills/16-nixpkgs-parameters.xml" />
+  <xi:include href="pills/17-nixpkgs-overriding-packages.xml" />
+  <xi:include href="pills/18-nix-store-paths.xml" />
+  <xi:include href="pills/19-fundamentals-of-stdenv.xml" />
+  <xi:include href="pills/20-basic-dependencies-and-hooks.xml" />
+</book>

default.nix

@@ -1,32 +1,87 @@
-{ pkgs ? import <nixpkgs> {} }:
-
-{
-  html-split = pkgs.stdenvNoCC.mkDerivation {
-    name = "nix-pills";
-    src = ./.;
+{ pkgs ? import <nixpkgs> {}, revCount, shortRev }:
+let
+  lib = pkgs.lib;
+
+  sources = let
+
+      # We want nix examples, but not the top level nix to build things
+      noTopLevelNix = path: type: let
+          relPath = lib.removePrefix (toString ./. + "/") (toString path);
+        in builtins.match "[^/]*\.nix" relPath == null;
+
+      extensions = [ ".xml" ".txt" ".nix" ".bash" ];
+
+    in lib.cleanSourceWith {
+      filter = noTopLevelNix;
+      src = lib.sourceFilesBySuffices ./. extensions;
+    };
+
+  combined = pkgs.runCommand "nix-pills-combined"
+    {
+      buildInputs = [ pkgs.libxml2 ];
+      meta.description = "Nix Pills with as a single docbook file";
+      inherit revCount shortRev;
+    }
+    ''
+      cp -r ${sources} ./sources
+      chmod -R u+w ./sources
+
+      cd sources
+
+      printf "%s-%s" "$revCount" "$shortRev" > version
+      xmllint --xinclude --output "$out" ./book.xml
+    '';
 
-    nativeBuildInputs = with pkgs; [
-      mdbook
-      mdbook-linkcheck
-    ];
+  toc = builtins.toFile "toc.xml"
+    ''
+      <toc role="chunk-toc">
+        <d:tocentry xmlns:d="http://docbook.org/ns/docbook" linkend="book-nix-pills"><?dbhtml filename="index.html"?>
+        </d:tocentry>
+      </toc>
+    '';
 
-    buildPhase = ''
-      runHook preBuild
+  manualXsltprocOptions = toString [
+    "--param section.autolabel 1"
+    "--param section.label.includes.component.label 1"
+    "--stringparam html.stylesheet style.css"
+    "--param xref.with.number.and.title 1"
+    "--param toc.section.depth 3"
+    "--stringparam admon.style ''"
+    "--stringparam callout.graphics.extension .svg"
+    "--stringparam current.docid nix-pills"
+    "--param chunk.section.depth 0"
+    "--param chunk.first.sections 1"
+    "--param use.id.as.filename 1"
+    "--stringparam generate.toc 'book toc appendix toc'"
+    "--stringparam chunk.toc '${toc}'"
+  ];
+
+in {
+  html-split = pkgs.stdenv.mkDerivation {
+    name = "nix-pills";
 
-      # We can't check external links inside the sandbox, but it's good to check them outside the sandbox.
-      substituteInPlace book.toml --replace-fail 'follow-web-links = true' 'follow-web-links = false'
-      mdbook build
+    src = sources;
 
-      runHook postBuild
-    '';
+    buildInputs = with pkgs; [
+      libxslt
+    ];
 
     installPhase = ''
       runHook preInstall
 
-      # The nix pills were originally built into this directory, and consumers of the nix pills expect to find it there. Do not change unless you also change other code that depends on this directory structure.
+      # Generate the HTML manual.
       dst=$out/share/doc/nix-pills
       mkdir -p "$dst"
-      mv book/html/* "$dst"/
+      xsltproc \
+        ${manualXsltprocOptions} \
+        --nonet --output "$dst/" \
+        "${pkgs.docbook-xsl-ns}/xml/xsl/docbook/xhtml/chunk.xsl" \
+        "${combined}"
+
+      mkdir -p "$dst/images/callouts"
+      cp -r "${pkgs.docbook-xsl-ns}/xml/xsl/docbook/images/callouts"/*.svg "$dst/images/callouts"
+
+      cp "${./style.css}" "$dst/style.css"
 
       mkdir -p "$out/nix-support"
       echo "nix-build out $out" >> "$out/nix-support/hydra-build-products"
@@ -36,13 +91,13 @@
     '';
   };
 
-  epub = pkgs.stdenvNoCC.mkDerivation {
+  epub = pkgs.stdenv.mkDerivation {
     name = "nix-pills-epub";
-    src = ./.;
 
-    nativeBuildInputs = with pkgs; [
-      mdbook-epub
-      unzip
+    src = sources;
+
+    buildInputs = with pkgs; [
+      libxslt
       zip
     ];
 
@@ -52,39 +107,29 @@
 
     doInstallCheck = true;
 
-    buildPhase = ''
-      runHook preBuild
-
-      mdbook-epub --standalone${pkgs.lib.optionalString (pkgs.mdbook-epub.version != "unstable-2022-12-25") " true"}
-
-      # Work around bugs in mdbook-epub.
-      mkdir nix-pills.epub-fix
-      ( cd nix-pills.epub-fix
-        unzip -q "../book/epub/Nix Pills.epub"
-        # Fix invalid ids.
-        sed -Ei 's/(id(ref)?=")([0-9])/\1p\3/g' OEBPS/content.opf
-        sed -Ei 's/(id="|href="#)([0-9])/\1fn\2/g' OEBPS/20-basic-dependencies-and-hooks.html
-        # Fix anchors.
-        sed -Ei 's~(<h[1-6])(>.+) \{#([^\}]+)\}(</h[1-6]>)~\1 id="\3"\2\4~g' OEBPS/*.html
-        # Fix broken links in body.
-        sed -Ei 's/("[0-9a-z-]+\.)md(["#])/\1html\2/g' OEBPS/*.html
-        # Remove unnecessary page breaks, the sections are short.
-        substituteInPlace OEBPS/stylesheet.css --replace-fail "page-break-before: always;" ""
-        zip -q "../book/epub/Nix Pills.epub" **/*
-      )
-
-      runHook postBuild
-    '';
-
     installPhase = ''
       runHook preInstall
 
-      # The nix pills were originally built into this directory, and consumers of the nix pills expect to find it there. Do not change unless you also change other code that depends on this directory structure.
+      # Generate the EPUB manual.
       dst=$out/share/doc/nix-pills
       mkdir -p "$dst"
+      xsltproc \
+        ${manualXsltprocOptions} \
+        --nonet --output "$dst/epub/" \
+        "${pkgs.docbook-xsl-ns}/xml/xsl/docbook/epub3/chunk.xsl" \
+        "${combined}"
+
+      mkdir -p "$dst/epub/OEBPS/images/callouts"
+      cp -r "${pkgs.docbook-xsl-ns}/xml/xsl/docbook/images/callouts"/*.svg "$dst/epub/OEBPS/images/callouts"
+      cp "${./style.css}" "$dst/epub/OEBPS/style.css"
 
+      echo "application/epub+zip" > mimetype
       manual="$dst/nix-pills.epub"
-      mv "book/epub/Nix Pills.epub" "$manual"
+      zip -0Xq "$manual" mimetype
+      pushd "$dst/epub" && zip -Xr9D "$manual" *
+      popd
+
+      rm -rf "$dst/epub"
 
       mkdir -p "$out/nix-support"
       echo "nix-build out $out" >> "$out/nix-support/hydra-build-products"