···

       
1
       
1
       
-
       
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="sec-writing-documentation">

     

       
1
       
1
       
+
       
<chapter xmlns="http://docbook.org/ns/docbook"  xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="sec-writing-documentation">

     

       
2
       
2
       
 
       
  <title>Writing NixOS Documentation</title>

     

       
3
       
3
       
 
       
  <para>

     

       
4
       
4
       
 
       
    As NixOS grows, so too does the need for a catalogue and explanation

     

···

       
24
       
24
       
 
       
for mf in ${MD_FILES[*]}; do

     

       
25
       
25
       
 
       
  if [ "${mf: -11}" == ".section.md" ]; then

     

       
26
       
26
       
 
       
    mkdir -p $(dirname "$OUT/$mf")

     

       
27
       
27
       
+
       
    OUTFILE="$OUT/${mf%".section.md"}.section.xml"

     

       
27
       
28
       
 
       
    pandoc "$mf" "${pandoc_flags[@]}" \

     

       
28
       
28
       
-
       
      -o "$OUT/${mf%".section.md"}.section.xml"

     

       
29
       
29
       
+
       
      -o "$OUTFILE"

     

       
30
       
30
       
+
       
    grep -q -m 1 "xi:include" "$OUTFILE" && sed -i 's|xmlns:xlink="http://www.w3.org/1999/xlink"| xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"|' "$OUTFILE"

     

       
29
       
31
       
 
       
  fi

     

       
30
       
32
       
 
       


     

       
31
       
33
       
 
       
  if [ "${mf: -11}" == ".chapter.md" ]; then

     

       
32
       
34
       
 
       
    mkdir -p $(dirname "$OUT/$mf")

     

       
35
       
35
       
+
       
    OUTFILE="$OUT/${mf%".chapter.md"}.chapter.xml"

     

       
33
       
36
       
 
       
    pandoc "$mf" "${pandoc_flags[@]}" \

     

       
34
       
37
       
 
       
      --top-level-division=chapter \

     

       
35
       
35
       
-
       
      -o "$OUT/${mf%".chapter.md"}.chapter.xml"

     

       
38
       
38
       
+
       
      -o "$OUTFILE"

     

       
39
       
39
       
+
       
    grep -q -m 1 "xi:include" "$OUTFILE" && sed -i 's|xmlns:xlink="http://www.w3.org/1999/xlink"| xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude"|' "$OUTFILE"

     

       
36
       
40
       
 
       
  fi

     

       
37
       
41
       
 
       
done

     

       
38
       
42