From a2210a87120ef2f597dccb4fe7ea23b32aa8d5fd Mon Sep 17 00:00:00 2001 From: Noam Yorav-Raphael Date: Mon, 8 Apr 2024 23:57:13 +0300 Subject: [PATCH] Add redirects from original paths to new paths --- book.toml | 23 +++++++++++++++++++ ....md => 01-why-you-should-give-it-a-try.md} | 0 ...d => 02-install-on-your-running-system.md} | 2 +- pills/03-enter-environment.md | 4 ++-- ...d => 09-automatic-runtime-dependencies.md} | 2 +- pills/10-developing-with-nix-shell.md | 2 +- pills/SUMMARY.md | 6 ++--- 7 files changed, 31 insertions(+), 8 deletions(-) rename pills/{01-why-you-should-give-it-try.md => 01-why-you-should-give-it-a-try.md} (100%) rename pills/{02-install-on-your-running.md => 02-install-on-your-running-system.md} (99%) rename pills/{09-automatic-runtime.md => 09-automatic-runtime-dependencies.md} (97%) diff --git a/book.toml b/book.toml index 055f340..357fe66 100644 --- a/book.toml +++ b/book.toml @@ -10,6 +10,29 @@ additional-css = ["custom.css"] edit-url-template = "https://github.com/NixOS/nix-pills/tree/master/{path}" git-repository-url = "https://github.com/NixOS/nix-pills" +[output.html.redirect] +"pr01.html" = "00-preface.html" +"why-you-should-give-it-a-try.html" = "01-why-you-should-give-it-a-try.html" +"install-on-your-running-system.html" = "02-install-on-your-running-system.html" +"enter-environment.html" = "03-enter-environment.html" +"basics-of-language.html" = "04-basics-of-language.html" +"functions-and-imports.html" = "05-functions-and-imports.html" +"our-first-derivation.html" = "06-our-first-derivation.html" +"working-derivation.html" = "07-working-derivation.html" +"generic-builders.html" = "08-generic-builders.html" +"automatic-runtime-dependencies.html" = "09-automatic-runtime-dependencies.html" +"developing-with-nix-shell.html" = "10-developing-with-nix-shell.html" +"garbage-collector.html" = "11-garbage-collector.html" +"inputs-design-pattern.html" = "12-inputs-design-pattern.html" +"callpackage-design-pattern.html" = "13-callpackage-design-pattern.html" +"override-design-pattern.html" = "14-override-design-pattern.html" +"nix-search-paths.html" = "15-nix-search-paths.html" +"nixpkgs-parameters.html" = "16-nixpkgs-parameters.html" +"nixpkgs-overriding-packages.html" = "17-nixpkgs-overriding-packages.html" +"nix-store-paths.html" = "18-nix-store-paths.html" +"fundamentals-of-stdenv.html" = "19-fundamentals-of-stdenv.html" +"basic-dependencies-and-hooks.html" = "20-basic-dependencies-and-hooks.html" + [output.linkcheck] follow-web-links = true diff --git a/pills/01-why-you-should-give-it-try.md b/pills/01-why-you-should-give-it-a-try.md similarity index 100% rename from pills/01-why-you-should-give-it-try.md rename to pills/01-why-you-should-give-it-a-try.md diff --git a/pills/02-install-on-your-running.md b/pills/02-install-on-your-running-system.md similarity index 99% rename from pills/02-install-on-your-running.md rename to pills/02-install-on-your-running-system.md index f1265e4..545cf2b 100644 --- a/pills/02-install-on-your-running.md +++ b/pills/02-install-on-your-running-system.md @@ -1,6 +1,6 @@ # Install on Your Running System -Welcome to the second Nix pill. In the [first](01-why-you-should-give-it-try.md) pill we briefly described Nix. +Welcome to the second Nix pill. In the [first](01-why-you-should-give-it-a-try.md) pill we briefly described Nix. Now we'll install Nix on our running system and understand what changed in our system after the installation. **If you're using NixOS, Nix is already installed; you can skip to the [next](03-enter-environment.md) pill.** diff --git a/pills/03-enter-environment.md b/pills/03-enter-environment.md index 91f20a1..66b140c 100644 --- a/pills/03-enter-environment.md +++ b/pills/03-enter-environment.md @@ -1,6 +1,6 @@ # Enter the Environment {#enter-environment} -Welcome to the third Nix pill. In the [second pill](02-install-on-your-running.md) we installed Nix on our running system. Now we can finally play with it a little, these things also apply to NixOS users. +Welcome to the third Nix pill. In the [second pill](02-install-on-your-running-system.md) we installed Nix on our running system. Now we can finally play with it a little, these things also apply to NixOS users. ## Enter the environment @@ -196,7 +196,7 @@ $ /nix/store/ig31y9gfpp8pf3szdd7d4sf29zr7igbr-nix-2.1.3/bin/nix-env -i /nix/stor ## Channels -So where are we getting packages from? We said something about this already in the [second article](02-install-on-your-running.md). There's a list of channels from which we get packages, although usually we use a single channel. The tool to manage channels is [nix-channel](https://nixos.org/manual/nix/stable/command-ref/nix-channel.html). +So where are we getting packages from? We said something about this already in the [second article](02-install-on-your-running-system.md). There's a list of channels from which we get packages, although usually we use a single channel. The tool to manage channels is [nix-channel](https://nixos.org/manual/nix/stable/command-ref/nix-channel.html). ```console $ nix-channel --list diff --git a/pills/09-automatic-runtime.md b/pills/09-automatic-runtime-dependencies.md similarity index 97% rename from pills/09-automatic-runtime.md rename to pills/09-automatic-runtime-dependencies.md index 8cc4e2e..3641c27 100644 --- a/pills/09-automatic-runtime.md +++ b/pills/09-automatic-runtime-dependencies.md @@ -116,7 +116,7 @@ $ nix-store -q --references result and we see that `glibc` is a runtime dependency. This is exactly what we wanted. -The package is self-contained. This means that we can copy its closure onto another machine and we will be able to run it. Remember, only a very few components under the `/nix/store` are required to [run nix](02-install-on-your-running.md). The `hello` binary will use the exact version of `glibc` library and interpreter referred to in the binary, rather than the system one: +The package is self-contained. This means that we can copy its closure onto another machine and we will be able to run it. Remember, only a very few components under the `/nix/store` are required to [run nix](02-install-on-your-running-system.md). The `hello` binary will use the exact version of `glibc` library and interpreter referred to in the binary, rather than the system one: ```console $ ldd result/bin/hello diff --git a/pills/10-developing-with-nix-shell.md b/pills/10-developing-with-nix-shell.md index c11a991..9164972 100644 --- a/pills/10-developing-with-nix-shell.md +++ b/pills/10-developing-with-nix-shell.md @@ -1,6 +1,6 @@ # Developing with `nix-shell` -Welcome to the 10th Nix pill. In the previous [9th pill](09-automatic-runtime.md) we saw one of the powerful features of Nix: automatic discovery of runtime dependencies. We also finalized the GNU `hello` package. +Welcome to the 10th Nix pill. In the previous [9th pill](09-automatic-runtime-dependencies.md) we saw one of the powerful features of Nix: automatic discovery of runtime dependencies. We also finalized the GNU `hello` package. In this pill, we will introduce the `nix-shell` tool and use it to hack on the GNU `hello` program. We will see how `nix-shell` gives us an isolated environment while we modify the source files of the project, similar to how `nix-build` gave us an isolated environment while building the derivation. diff --git a/pills/SUMMARY.md b/pills/SUMMARY.md index a3e5ec3..b579454 100644 --- a/pills/SUMMARY.md +++ b/pills/SUMMARY.md @@ -2,15 +2,15 @@ [Preface](00-preface.md) -- [Why You Should Give it a Try](01-why-you-should-give-it-try.md) -- [Install on Your Running System](02-install-on-your-running.md) +- [Why You Should Give it a Try](01-why-you-should-give-it-a-try.md) +- [Install on Your Running System](02-install-on-your-running-system.md) - [Enter the Environment](03-enter-environment.md) - [The Basics of the Language](04-basics-of-language.md) - [Functions and Imports](05-functions-and-imports.md) - [Our First Derivation](06-our-first-derivation.md) - [Working Derivation](07-working-derivation.md) - [Generic Builders](08-generic-builders.md) -- [Automatic Runtime Dependencies](09-automatic-runtime.md) +- [Automatic Runtime Dependencies](09-automatic-runtime-dependencies.md) - [Developing with `nix-shell`](10-developing-with-nix-shell.md) - [The Garbage Collector](11-garbage-collector.md) - [Package Repositories and the Inputs Design Pattern](12-inputs-design-pattern.md)