Merge pull request #108147 from ryantm/doc-cleanup

doc: explicit Markdown anchors for top-level headings; remove metadata

authored by Ryan Mulligan and committed by GitHub dd6c0efa 5c631ae0

+19 -76
+1 -1
doc/builders/packages/cataclysm-dda.section.md
··· 1 - # Cataclysm: Dark Days Ahead 2 3 ## How to install Cataclysm DDA 4
··· 1 + # Cataclysm: Dark Days Ahead {#cataclysm-dark-days-ahead} 2 3 ## How to install Cataclysm DDA 4
+1 -1
doc/builders/trivial-builders.chapter.md
··· 37 38 Variant of `runCommand` that forces the derivation to be built locally, it is not substituted. This is intended for very cheap commands (<1s execution time). It saves on the network roundrip and can speed up a build. 39 40 - ::: {.note} 41 This sets [`allowSubstitutes` to `false`](https://nixos.org/nix/manual/#adv-attr-allowSubstitutes), so only use `runCommandLocal` if you are certain the user will always have a builder for the `system` of the derivation. This should be true for most trivial use cases (e.g. just copying some files to a different location or adding symlinks), because there the `system` is usually the same as `builtins.currentSystem`. 42 ::: 43
··· 37 38 Variant of `runCommand` that forces the derivation to be built locally, it is not substituted. This is intended for very cheap commands (<1s execution time). It saves on the network roundrip and can speed up a build. 39 40 + ::: note 41 This sets [`allowSubstitutes` to `false`](https://nixos.org/nix/manual/#adv-attr-allowSubstitutes), so only use `runCommandLocal` if you are certain the user will always have a builder for the `system` of the derivation. This should be true for most trivial use cases (e.g. just copying some files to a different location or adding symlinks), because there the `system` is usually the same as `builtins.currentSystem`. 42 ::: 43
+1 -6
doc/languages-frameworks/agda.section.md
··· 1 - --- 2 - title: Agda 3 - author: Alex Rice (alexarice) 4 - date: 2020-01-06 5 - --- 6 - # Agda 7 8 ## How to use Agda 9
··· 1 + # Agda {#agda} 2 3 ## How to use Agda 4
+1 -6
doc/languages-frameworks/android.section.md
··· 1 - --- 2 - title: Android 3 - author: Sander van der Burg 4 - date: 2018-11-18 5 - --- 6 - # Android 7 8 The Android build environment provides three major features and a number of 9 supporting features.
··· 1 + # Android {#android} 2 3 The Android build environment provides three major features and a number of 4 supporting features.
+1 -1
doc/languages-frameworks/crystal.section.md
··· 1 - # Crystal 2 3 ## Building a Crystal package 4
··· 1 + # Crystal {#crystal} 2 3 ## Building a Crystal package 4
+1 -1
doc/languages-frameworks/emscripten.section.md
··· 1 - # Emscripten 2 3 [Emscripten](https://github.com/kripken/emscripten): An LLVM-to-JavaScript Compiler 4
··· 1 + # Emscripten {#emscripten} 2 3 [Emscripten](https://github.com/kripken/emscripten): An LLVM-to-JavaScript Compiler 4
+1 -7
doc/languages-frameworks/haskell.section.md
··· 1 - --- 2 - title: User's Guide for Haskell in Nixpkgs 3 - author: Peter Simons 4 - date: 2015-06-01 5 - --- 6 - 7 - # Haskell 8 9 The documentation for the Haskell infrastructure is published at 10 <https://haskell4nix.readthedocs.io/>. The source code for that
··· 1 + # Haskell {#haskell} 2 3 The documentation for the Haskell infrastructure is published at 4 <https://haskell4nix.readthedocs.io/>. The source code for that
+1 -1
doc/languages-frameworks/idris.section.md
··· 1 - # Idris 2 3 ## Installing Idris 4
··· 1 + # Idris {#idris} 2 3 ## Installing Idris 4
+1 -6
doc/languages-frameworks/ios.section.md
··· 1 - --- 2 - title: iOS 3 - author: Sander van der Burg 4 - date: 2019-11-10 5 - --- 6 - # iOS 7 8 This component is basically a wrapper/workaround that makes it possible to 9 expose an Xcode installation as a Nix package by means of symlinking to the
··· 1 + # iOS {#ios} 2 3 This component is basically a wrapper/workaround that makes it possible to 4 expose an Xcode installation as a Nix package by means of symlinking to the
+1 -7
doc/languages-frameworks/lua.section.md
··· 1 - --- 2 - title: Lua 3 - author: Matthieu Coudron 4 - date: 2019-02-05 5 - --- 6 - 7 - # User's Guide to Lua Infrastructure 8 9 ## Using Lua 10
··· 1 + # User's Guide to Lua Infrastructure {#users-guide-to-lua-infrastructure} 2 3 ## Using Lua 4
+1 -7
doc/languages-frameworks/maven.section.md
··· 1 - --- 2 - title: Maven 3 - author: Farid Zakaria 4 - date: 2020-10-15 5 - --- 6 - 7 - # Maven 8 9 Maven is a well-known build tool for the Java ecosystem however it has some challenges when integrating into the Nix build system. 10
··· 1 + # Maven {#maven} 2 3 Maven is a well-known build tool for the Java ecosystem however it has some challenges when integrating into the Nix build system. 4
+2 -2
doc/languages-frameworks/node.section.md
··· 1 - Node.js 2 - ======= 3 The `pkgs/development/node-packages` folder contains a generated collection of 4 [NPM packages](https://npmjs.com/) that can be installed with the Nix package 5 manager.
··· 1 + # Node.js {#node.js} 2 + 3 The `pkgs/development/node-packages` folder contains a generated collection of 4 [NPM packages](https://npmjs.com/) that can be installed with the Nix package 5 manager.
+1 -1
doc/languages-frameworks/python.section.md
··· 1 - # Python 2 3 ## User Guide 4
··· 1 + # Python {#python} 2 3 ## User Guide 4
+1 -2
doc/languages-frameworks/r.section.md
··· 1 - R 2 - = 3 4 ## Installation 5
··· 1 + # R {#r} 2 3 ## Installation 4
+1 -7
doc/languages-frameworks/rust.section.md
··· 1 - --- 2 - title: Rust 3 - author: Matthias Beyer 4 - date: 2017-03-05 5 - --- 6 - 7 - # Rust 8 9 To install the rust compiler and cargo put 10
··· 1 + # Rust {#rust} 2 3 To install the rust compiler and cargo put 4
-1
doc/languages-frameworks/texlive.section.md
··· 1 - 2 # TeX Live {#sec-language-texlive} 3 4 Since release 15.09 there is a new TeX Live packaging that lives entirely under attribute `texlive`.
··· 1 # TeX Live {#sec-language-texlive} 2 3 Since release 15.09 there is a new TeX Live packaging that lives entirely under attribute `texlive`.
+1 -6
doc/languages-frameworks/titanium.section.md
··· 1 - --- 2 - title: Titanium 3 - author: Sander van der Burg 4 - date: 2018-11-18 5 - --- 6 - # Titanium 7 8 The Nixpkgs repository contains facilities to deploy a variety of versions of 9 the [Titanium SDK](https://www.appcelerator.com) versions, a cross-platform
··· 1 + # Titanium {#titanium} 2 3 The Nixpkgs repository contains facilities to deploy a variety of versions of 4 the [Titanium SDK](https://www.appcelerator.com) versions, a cross-platform
+1 -6
doc/languages-frameworks/vim.section.md
··· 1 - --- 2 - title: User's Guide for Vim in Nixpkgs 3 - author: Marc Weber 4 - date: 2016-06-25 5 - --- 6 - # Vim 7 8 Both Neovim and Vim can be configured to include your favorite plugins 9 and additional libraries.
··· 1 + # Vim {#vim} 2 3 Both Neovim and Vim can be configured to include your favorite plugins 4 and additional libraries.
+1 -7
doc/preface.chapter.md
··· 1 - --- 2 - title: Preface 3 - author: Frederik Rietdijk 4 - date: 2015-11-25 5 - --- 6 - 7 - # Preface 8 9 The Nix Packages collection (Nixpkgs) is a set of thousands of packages for the 10 [Nix package manager](https://nixos.org/nix/), released under a
··· 1 + # Preface {#preface} 2 3 The Nix Packages collection (Nixpkgs) is a set of thousands of packages for the 4 [Nix package manager](https://nixos.org/nix/), released under a