nix.dev/source/reference/glossary.md

# Glossary

```{glossary}
Nix
    Build system and package manager.

    Read /nɪks/ ("Niks").

    :::{seealso}
    - [Nix Reference Manual](./nix-manual.md)
    - [Nix source code](https://github.com/NixOS/nix)
    :::

Nix language
    Programming language to declare packages and configurations for {term}`Nix`.

    :::{seealso}
    - [](reading-nix-language)
    - [Nix language reference](https://nix.dev/manual/nix/2.18/language)
    :::

Nix expression
    Expression written in the {term}`Nix language`.

Nix file
    File (`.nix`) containing a {term}`Nix expression`.

Nixpkgs
    Software distribution built with {term}`Nix`.

    Read /nɪks ˈpækɪʤɪz/ ("Nix packages").

    :::{seealso}
    - [Nixpkgs Reference Manual](https://nixos.org/manual/nixpkgs)
    - [Nixpkgs source code](https://github.com/NixOS/nixpkgs)
    :::

NixOS
    Linux distribution based on {term}`Nix` and {term}`Nixpkgs`.

    Read /nɪks oʊ ɛs/ ("Niks Oh Es").

    :::{seealso}
    - [NixOS Reference Manual](https://nixos.org/manual/nixos)
    - [NixOS source code](https://github.com/NixOS/nixpkgs/tree/master/nixos)
    :::
```
-												Convert glossary.rst to .md

											
										
										
											2021-12-10 06:14:24 -05:00
+								# Glossary
 								```{glossary}
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
+								Nix
 								    Build system and package manager.
-												bring back IPA pronunciation (#431)


											
										
										
											2023-02-07 10:46:29 -05:00
+								    Read /nɪks/ ("Niks").
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    :::{seealso}
-												host Nix reference manual on nix.dev

this is the most cursed setup you will see any time soon.

we're dumping the Nix manual unchanged into the build tree *after*
building. the reason is that we'd want to link to it from our table of
contents, but because Sphinx does not allow adding arbitrary files to
the build output in arbitrary locations (only `_static` works). but we
want to place the manual behind a particular URL, and the alternative of
maintaining URL rewrites (e.g. in nginx) is not accessible here because the
infrastructure is managed somewhere else.

now that the files won't appear in their desired locations at Sphinx
build time, we can't use relative links to reference them, therefore we
have to resort to pointing to the web URL the manual will appear at.
this is terrible and I'm sorry. please fix this if you have a better
idea. once we use URLs though, we have to avoid linkchecking, since
those files may not be there before deploying them.

figuring all of this out took way longer than anyone would wish.

Co-authored-by: Alejandro Sanchez Medina <alejandrosanchzmedina@gmail.com>

											
										
										
											2023-10-18 06:04:34 -04:00
+								    - [Nix Reference Manual](./nix-manual.md)
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    - [Nix source code](https://github.com/NixOS/nix)
 								    :::
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
+								Nix language
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    Programming language to declare packages and configurations for {term}`Nix`.
 								    :::{seealso}
-												rename the Nix language tutorial

this collapses the "don't panic" section into a motivating introduction and gives
the document a more distinctive name.

this also addresses feedback stating that having "basics" in the title
may be misleading about the effort required to work through the
tutorial.

											
										
										
											2023-06-21 08:15:14 -04:00
+								    - [](reading-nix-language)
-												update all links to the Nix manual

											
										
										
											2023-11-01 22:41:54 -04:00
+								    - [Nix language reference](https://nix.dev/manual/nix/2.18/language)
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    :::
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
 								Nix expression
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    Expression written in the {term}`Nix language`.
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
 								Nix file
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    File (`.nix`) containing a {term}`Nix expression`.
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
 								Nixpkgs
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    Software distribution built with {term}`Nix`.
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
 								    Read /nɪks ˈpækɪʤɪz/ ("Nix packages").
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    :::{seealso}
 								    - [Nixpkgs Reference Manual](https://nixos.org/manual/nixpkgs)
 								    - [Nixpkgs source code](https://github.com/NixOS/nixpkgs)
 								    :::
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
+								NixOS
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    Linux distribution based on {term}`Nix` and {term}`Nixpkgs`.
-												Fold terminology section to glossary document

Resolves https://github.com/NixOS/nix.dev/issues/377

											
										
										
											2022-10-28 13:44:24 -04:00
-												bring back IPA pronunciation (#431)


											
										
										
											2023-02-07 10:46:29 -05:00
+								    Read /nɪks oʊ ɛs/ ("Niks Oh Es").
-												glossary: add links to manuals and source code (#550)


											
										
										
											2023-06-07 20:18:51 -04:00
+								    :::{seealso}
 								    - [NixOS Reference Manual](https://nixos.org/manual/nixos)
 								    - [NixOS source code](https://github.com/NixOS/nixpkgs/tree/master/nixos)
 								    :::
-												Convert glossary.rst to .md

											
										
										
											2021-12-10 06:14:24 -05:00
+								```