nixpkgs-suyu/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
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
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
default.nix doc: Fix make in nix-shell 2021-06-05 13:25:48 +02:00
functions.xml
Makefile
manual.xml doc/using: convert to markdown 2021-04-23 12:02:07 +02:00
overrides.css
preface.chapter.md doc: prepare for commonmark 2021-06-07 06:34:59 +02:00
README.md
release-notes.xml
shell.nix
style.css

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.