1
0
Fork 1
mirror of https://github.com/NixOS/nixpkgs.git synced 2024-12-25 03:17:13 +00:00
nixpkgs/nixos/doc/manual/from_md
Ryan Mulligan c863de29a7 nixos/doc/md-to-db.sh: handle Docbook inclues in CommonMark
You can do includes like this:

```{=docbook}
<xi:include href="rl-2111.section.xml" />
```
2021-09-07 06:29:21 -07:00
..
administration Merge pull request #128937 from bobby285271/pr8 2021-09-07 06:24:21 +01:00
configuration Merge pull request #129121 from bobby285271/pr13 2021-09-07 06:29:45 +01:00
development nixos/doc/md-to-db.sh: handle Docbook inclues in CommonMark 2021-09-07 06:29:21 -07:00
installation Merge pull request #129154 from bobby285271/pr15 2021-09-07 06:29:19 +01:00
release-notes Merge pull request #136505 from bew/update-rofi-1.7.0 2021-09-04 18:24:45 +02:00
contributing-to-this-manual.chapter.xml
README.md

This directory is temporarily needed while we transition the manual to CommonMark. It stores the output of the ../md-to-db.sh script that converts CommonMark files back to DocBook.

We are choosing to convert the Markdown to DocBook at authoring time instead of manual building time, because we do not want the pandoc toolchain to become part of the NixOS closure.

Do not edit the DocBook files inside this directory or its subdirectories. Instead, edit the corresponding .md file in the normal manual directories, and run ../md-to-db.sh to update the file here.