nixpkgs/doc
Jan Tojnar 6ecc641d08
doc: prepare for commonmark
We are still using Pandoc’s Markdown parser, which differs from CommonMark spec slightly.

Notably:
- Line breaks in lists behave differently.
- Admonitions do not support the simpler syntax https://github.com/jgm/commonmark-hs/issues/75
- The auto_identifiers uses a different algorithm – I made the previous ones explicit.
- Languages (classes) of code blocks cannot contain whitespace so we have to use “pycon” alias instead of Python “console” as GitHub’s linguist

While at it, I also fixed the following issues:
- ShellSesssion was used
- Removed some pointless docbook tags.
2021-06-07 06:34:59 +02:00
..
builders doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
contributing doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
doc-support Revert "make-tarball.nix: Restore the 'commit' field in packages.json" 2020-03-29 20:57:50 +02:00
functions nixpkgs-manual: lib.attrsets.mapAttrsToList returns a list (#122179) 2021-05-08 13:55:11 +02:00
languages-frameworks doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
old doc/*: editorconfig fixes 2020-07-31 15:06:53 +10:00
stdenv doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
using doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
.gitignore doc: format the documentation (#57102) 2019-03-08 21:07:11 -08:00
default.nix doc: Fix make in nix-shell 2021-06-05 13:25:48 +02:00
functions.xml doc: move fhs and mkShell under builders/special 2019-10-21 11:39:46 +02:00
Makefile doc/README.md: init 2021-03-04 18:10:39 +01:00
manual.xml doc/using: convert to markdown 2021-04-23 12:02:07 +02:00
overrides.css doc: Make callout marks in code unselectable 2020-01-14 15:24:57 +01:00
preface.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
README.md doc/README.md: Add more links 2021-03-06 12:35:33 +01:00
release-notes.xml treewide: use https for nixos.org and hydra.nixos.org 2020-05-03 22:14:21 -07:00
shell.nix doc: fix shell.nix (#109816) 2021-01-19 12:46:51 -05:00
style.css manual: limit text width 2019-01-08 15:08:42 +00:00

Nixpkgs/doc

This directory houses the sources files for the Nixpkgs manual.

You can find the rendered documentation for Nixpkgs unstable on nixos.org.

Docs for Nixpkgs stable are also available.

If you want to contribute to the documentation, here's how to do it.

If you're only getting started with Nix, go to nixos.org/learn.