diff options
author | Robert Hensing <robert@roberthensing.nl> | 2022-06-27 17:27:24 +0200 |
---|---|---|
committer | Robert Hensing <robert@roberthensing.nl> | 2022-06-27 17:41:32 +0200 |
commit | aff2dbbc82c63fa8ad389aad5d78a2fc2461fc36 (patch) | |
tree | 1a87f04b333920cd05c7f0f0b73c5519d504d8da /nixos | |
parent | 4a8bc4fd079b0ea3adf610d2b5ab6a8ceb10d4ce (diff) |
make-options-doc: Make variablelist id configurable
I've tried XInclude set-xml-id first, but our tooling did not pick up on it.
Diffstat (limited to 'nixos')
-rw-r--r-- | nixos/lib/make-options-doc/default.nix | 5 | ||||
-rw-r--r-- | nixos/lib/make-options-doc/options-to-docbook.xsl | 4 |
2 files changed, 8 insertions, 1 deletions
diff --git a/nixos/lib/make-options-doc/default.nix b/nixos/lib/make-options-doc/default.nix index 282b3e7397c43..6649fc41d41aa 100644 --- a/nixos/lib/make-options-doc/default.nix +++ b/nixos/lib/make-options-doc/default.nix @@ -22,6 +22,10 @@ , transformOptions ? lib.id # function for additional tranformations of the options , documentType ? "appendix" # TODO deprecate "appendix" in favor of "none" # and/or rename function to moduleOptionDoc for clean slate + + # If you include more than one option list into a document, you need to + # provide different ids. +, variablelistId ? "configuration-variable-list" , revision ? "" # Specify revision for the options # a set of options the docs we are generating will be merged into, as if by recursiveUpdate. # used to split the options doc build into a static part (nixos/modules) and a dynamic part @@ -177,6 +181,7 @@ in rec { ${pkgs.libxslt.bin}/bin/xsltproc \ --stringparam documentType '${documentType}' \ --stringparam revision '${revision}' \ + --stringparam variablelistId '${variablelistId}' \ -o intermediate.xml ${./options-to-docbook.xsl} sorted.xml ${pkgs.libxslt.bin}/bin/xsltproc \ -o "$out" ${./postprocess-option-descriptions.xsl} intermediate.xml diff --git a/nixos/lib/make-options-doc/options-to-docbook.xsl b/nixos/lib/make-options-doc/options-to-docbook.xsl index 07d69649523f6..978d5e2468a83 100644 --- a/nixos/lib/make-options-doc/options-to-docbook.xsl +++ b/nixos/lib/make-options-doc/options-to-docbook.xsl @@ -14,6 +14,7 @@ <xsl:param name="revision" /> <xsl:param name="documentType" /> <xsl:param name="program" /> + <xsl:param name="variablelistId" /> <xsl:template match="/expr/list"> @@ -31,7 +32,8 @@ </xsl:template> <xsl:template name="variable-list"> - <variablelist xml:id="configuration-variable-list"> + <variablelist> + <xsl:attribute name="id" namespace="http://www.w3.org/XML/1998/namespace"><xsl:value-of select="$variablelistId"/></xsl:attribute> <xsl:for-each select="attrs"> <xsl:variable name="id" select=" concat('opt-', |