book.xml

<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
      orginally 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>