···

       
68
       
 
       
      optionIdPrefix = "test-opt-";

     

       
69
       
 
       
    };

     

       
70
       
 
       


     

       
71
       
-
       
  sources = runCommand "manual-sources" {

     

       
72
       
-
       
    inputs = lib.sourceFilesBySuffices ./. [ ".xml" ".md" ];

     

       
73
       
-
       
    nativeBuildInputs = [ pkgs.nixos-render-docs ];

     

       
74
       
-
       
  } ''

     

       
75
       
-
       
    mkdir $out

     

       
76
       
-
       
    cd $out

     

       
77
       
-
       
    cp -r --no-preserve=all $inputs/* .

     

       
78
       
-
       


     

       
79
       
-
       
    declare -a convert_args

     

       
80
       
-
       
    while read -r mf; do

     

       
81
       
-
       
      if [[ "$mf" = *.chapter.md ]]; then

     

       
82
       
-
       
        convert_args+=("--chapter")

     

       
83
       
-
       
      else

     

       
84
       
-
       
        convert_args+=("--section")

     

       
85
       
-
       
      fi

     

       
86
       
-
       


     

       
87
       
-
       
      convert_args+=("from_md/''${mf%.md}.xml" "$mf")

     

       
88
       
-
       
    done < <(find . -type f -name '*.md')

     

       
89
       
-
       


     

       
90
       
-
       
    nixos-render-docs manual docbook-fragment \

     

       
91
       
-
       
      --manpage-urls ${manpageUrls} \

     

       
92
       
-
       
      "''${convert_args[@]}"

     

       
93
       
-
       
  '';

     

       
94
       
-
       


     

       
95
       
-
       
  modulesDoc = runCommand "modules.xml" {

     

       
96
       
-
       
    nativeBuildInputs = [ pkgs.nixos-render-docs ];

     

       
97
       
-
       
  } ''

     

       
98
       
-
       
    nixos-render-docs manual docbook-section \

     

       
99
       
-
       
      --manpage-urls ${manpageUrls} \

     

       
100
       
-
       
      "$out" \

     

       
101
       
-
       
      --section \

     

       
102
       
-
       
        --section-id modules \

     

       
103
       
-
       
        --chapters ${lib.concatMapStrings (p: "${p.value} ") config.meta.doc}

     

       
104
       
-
       
  '';

     

       
105
       
-
       


     

       
106
       
-
       
  generatedSources = runCommand "generated-docbook" {} ''

     

       
107
       
-
       
    mkdir $out

     

       
108
       
-
       
    ln -s ${modulesDoc} $out/modules.xml

     

       
109
       
-
       
    ln -s ${optionsDoc.optionsDocBook} $out/options-db.xml

     

       
110
       
-
       
    ln -s ${testOptionsDoc.optionsDocBook} $out/test-options-db.xml

     

       
111
       
-
       
    printf "%s" "${version}" > $out/version

     

       
112
       
-
       
  '';

     

       
113
       
-
       


     

       
114
       
-
       
  copySources =

     

       
115
       
-
       
    ''

     

       
116
       
-
       
      cp -prd $sources/* . # */

     

       
117
       
-
       
      ln -s ${generatedSources} ./generated

     

       
118
       
-
       
      chmod -R u+w .

     

       
119
       
-
       
    '';

     

       
120
       
-
       


     

       
121
       
 
       
  toc = builtins.toFile "toc.xml"

     

       
122
       
 
       
    ''

     

       
123
       
 
       
      <toc role="chunk-toc">

     
···

       
186
       
 
       
  '';

     

       
187
       
 
       


     

       
188
       
 
       
  manual-combined = runCommand "nixos-manual-combined"

     

       
189
       
-
       
    { inherit sources;

     

       
190
       
-
       
      nativeBuildInputs = [ buildPackages.libxml2.bin buildPackages.libxslt.bin ];

     

       
191
       
 
       
      meta.description = "The NixOS manual as plain docbook XML";

     

       
192
       
 
       
    }

     

       
193
       
 
       
    ''

     

       
194
       
-
       
      ${copySources}

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
195
       
 
       


     

       
196
       
 
       
      xmllint --xinclude --output ./manual-combined.xml ./manual.xml

     

       
197
       
 
       


     
···

       
220
       
 
       
    '';

     

       
221
       
 
       


     

       
222
       
 
       
in rec {

     

       
223
       
-
       
  inherit generatedSources;

     

       
224
       
-
       


     

       
225
       
 
       
  inherit (optionsDoc) optionsJSON optionsNix optionsDocBook optionsUsedDocbook;

     

       
226
       
 
       


     

       
227
       
 
       
  # Generate the NixOS manual.

     

       
228
       
 
       
  manualHTML = runCommand "nixos-manual-html"

     

       
229
       
-
       
    { inherit sources;

     

       
230
       
-
       
      nativeBuildInputs = [ buildPackages.libxml2.bin buildPackages.libxslt.bin ];

     

       
231
       
 
       
      meta.description = "The NixOS manual in HTML format";

     

       
232
       
 
       
      allowedReferences = ["out"];

     

       
233
       
 
       
    }

     
···

       
264
       
 
       
  manualHTMLIndex = "${manualHTML}/share/doc/nixos/index.html";

     

       
265
       
 
       


     

       
266
       
 
       
  manualEpub = runCommand "nixos-manual-epub"

     

       
267
       
-
       
    { inherit sources;

     

       
268
       
-
       
      nativeBuildInputs = [ buildPackages.libxml2.bin buildPackages.libxslt.bin buildPackages.zip ];

     

       
269
       
 
       
    }

     

       
270
       
 
       
    ''

     

       
271
       
 
       
      # Generate the epub manual.

     

···

       
68
       
 
       
      optionIdPrefix = "test-opt-";

     

       
69
       
 
       
    };

     

       
70
       
 
       


     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
71
       
 
       
  toc = builtins.toFile "toc.xml"

     

       
72
       
 
       
    ''

     

       
73
       
 
       
      <toc role="chunk-toc">

     
···

       
136
       
 
       
  '';

     

       
137
       
 
       


     

       
138
       
 
       
  manual-combined = runCommand "nixos-manual-combined"

     

       
139
       
+
       
    { inputs = lib.sourceFilesBySuffices ./. [ ".xml" ".md" ];

     

       
140
       
+
       
      nativeBuildInputs = [ pkgs.nixos-render-docs pkgs.libxml2.bin pkgs.libxslt.bin ];

     

       
141
       
 
       
      meta.description = "The NixOS manual as plain docbook XML";

     

       
142
       
 
       
    }

     

       
143
       
 
       
    ''

     

       
144
       
+
       
      cp -r --no-preserve=all $inputs/* .

     

       
145
       
+
       


     

       
146
       
+
       
      declare -a convert_args

     

       
147
       
+
       
      while read -r mf; do

     

       
148
       
+
       
        if [[ "$mf" = *.chapter.md ]]; then

     

       
149
       
+
       
          convert_args+=("--chapter")

     

       
150
       
+
       
        else

     

       
151
       
+
       
          convert_args+=("--section")

     

       
152
       
+
       
        fi

     

       
153
       
+
       


     

       
154
       
+
       
        convert_args+=("from_md/''${mf%.md}.xml" "$mf")

     

       
155
       
+
       
      done < <(find . -type f -name '*.md')

     

       
156
       
+
       


     

       
157
       
+
       
      nixos-render-docs manual docbook-fragment \

     

       
158
       
+
       
        --manpage-urls ${manpageUrls} \

     

       
159
       
+
       
        "''${convert_args[@]}"

     

       
160
       
+
       


     

       
161
       
+
       
      mkdir ./generated

     

       
162
       
+
       
      ln -s ${optionsDoc.optionsDocBook} ./generated/options-db.xml

     

       
163
       
+
       
      ln -s ${testOptionsDoc.optionsDocBook} ./generated/test-options-db.xml

     

       
164
       
+
       
      printf "%s" "${version}" > ./generated/version

     

       
165
       
+
       
      chmod -R u+w .

     

       
166
       
+
       


     

       
167
       
+
       
      nixos-render-docs manual docbook-section \

     

       
168
       
+
       
        --manpage-urls ${manpageUrls} \

     

       
169
       
+
       
        ./generated/modules.xml \

     

       
170
       
+
       
        --section \

     

       
171
       
+
       
          --section-id modules \

     

       
172
       
+
       
          --chapters ${lib.concatMapStrings (p: "${p.value} ") config.meta.doc}

     

       
173
       
 
       


     

       
174
       
 
       
      xmllint --xinclude --output ./manual-combined.xml ./manual.xml

     

       
175
       
 
       


     
···

       
198
       
 
       
    '';

     

       
199
       
 
       


     

       
200
       
 
       
in rec {

     

       
0
       
 
       

     

       
0
       
 
       

     

       
201
       
 
       
  inherit (optionsDoc) optionsJSON optionsNix optionsDocBook optionsUsedDocbook;

     

       
202
       
 
       


     

       
203
       
 
       
  # Generate the NixOS manual.

     

       
204
       
 
       
  manualHTML = runCommand "nixos-manual-html"

     

       
205
       
+
       
    { nativeBuildInputs = [ buildPackages.libxml2.bin buildPackages.libxslt.bin ];

     

       
0
       
 
       

     

       
206
       
 
       
      meta.description = "The NixOS manual in HTML format";

     

       
207
       
 
       
      allowedReferences = ["out"];

     

       
208
       
 
       
    }

     
···

       
239
       
 
       
  manualHTMLIndex = "${manualHTML}/share/doc/nixos/index.html";

     

       
240
       
 
       


     

       
241
       
 
       
  manualEpub = runCommand "nixos-manual-epub"

     

       
242
       
+
       
    { nativeBuildInputs = [ buildPackages.libxml2.bin buildPackages.libxslt.bin buildPackages.zip ];

     

       
0
       
 
       

     

       
243
       
 
       
    }

     

       
244
       
 
       
    ''

     

       
245
       
 
       
      # Generate the epub manual.

     

···

       
144
       
 
       
  manual = manualHTML; # TODO(@oxij): remove eventually

     

       
145
       
 
       
  manualEpub = (buildFromConfig ({ ... }: { }) (config: config.system.build.manual.manualEpub));

     

       
146
       
 
       
  manpages = buildFromConfig ({ ... }: { }) (config: config.system.build.manual.manpages);

     

       
147
       
-
       
  manualGeneratedSources = buildFromConfig ({ ... }: { }) (config: config.system.build.manual.generatedSources);

     

       
148
       
 
       
  options = (buildFromConfig ({ ... }: { }) (config: config.system.build.manual.optionsJSON)).x86_64-linux;

     

       
149
       
 
       


     

       
150
       
 
       


     

···

       
144
       
 
       
  manual = manualHTML; # TODO(@oxij): remove eventually

     

       
145
       
 
       
  manualEpub = (buildFromConfig ({ ... }: { }) (config: config.system.build.manual.manualEpub));

     

       
146
       
 
       
  manpages = buildFromConfig ({ ... }: { }) (config: config.system.build.manual.manpages);

     

       
0
       
 
       

     

       
147
       
 
       
  options = (buildFromConfig ({ ... }: { }) (config: config.system.build.manual.optionsJSON)).x86_64-linux;

     

       
148
       
 
       


     

       
149