summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorJan Tojnar <jtojnar@gmail.com>2021-06-18 00:07:00 +0200
committerJan Tojnar <jtojnar@gmail.com>2021-06-18 00:07:00 +0200
commitf07dcbef6462c3858c74aabb565892f4608ca06c (patch)
tree93b950482cbe9189876d65074e766add14721ae1 /doc
parentb26545db7e07e26f2ebacf449400f5aa04ee7f29 (diff)
downloadnixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.tar
nixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.tar.gz
nixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.tar.bz2
nixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.tar.lz
nixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.tar.xz
nixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.tar.zst
nixpkgs-f07dcbef6462c3858c74aabb565892f4608ca06c.zip
nixos/doc: Synchronize the Markdown generator with Nixpkgs
Switch to CommonMark with our extensions.
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile5
1 files changed, 3 insertions, 2 deletions
diff --git a/doc/Makefile b/doc/Makefile
index d4f1250c4d7..1d3a0e7ccbd 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -3,6 +3,7 @@ MD_TARGETS=$(addsuffix .xml, $(basename $(shell find . -type f -regex '.*\.md$$'
 PANDOC ?= pandoc
 
 pandoc_media_dir = media
+# NOTE: Keep in sync with NixOS manual (/nixos/doc/manual/md-to-db.sh).
 # TODO: Remove raw-attribute when we can get rid of DocBook altogether.
 pandoc_commonmark_enabled_extensions = +attributes+fenced_divs+footnotes+bracketed_spans+definition_lists+pipe_tables+raw_attribute
 pandoc_flags = --extract-media=$(pandoc_media_dir) \
@@ -101,10 +102,10 @@ functions/library/generated: doc-support/result
 %.section.xml: %.section.md
 	$(PANDOC) $^ -t docbook \
 		$(pandoc_flags) \
-	| cat  > $@
+		-o $@
 
 %.chapter.xml: %.chapter.md
 	$(PANDOC) $^ -t docbook \
 		--top-level-division=chapter \
 		$(pandoc_flags) \
-	| cat  > $@
+		-o $@