Script updating gh-pages from 21a9eb3. [ci skip]

This commit is contained in:
ID Bot 2025-01-23 06:40:59 +00:00
parent 9068f00617
commit 4aead87c3c
3 changed files with 64 additions and 56 deletions

View File

@ -13,9 +13,12 @@ XML, and as do many of its semantics. You can use KDL both as a configuration
language, and a data exchange or storage format, if you so choose. language, and a data exchange or storage format, if you so choose.
This is the formal specification for KDL, including the intended data model and This is the formal specification for KDL, including the intended data model and
the grammar. the grammar.
This document describes KDL version KDL 2.0.0. It was released on 2024-12-21. It This document describes an unreleased minor change to KDL. For the latest
is the latest stable version of the language, and will only be edited for minor oficial version of the language, see https://kdl.dev/spec.
copyedits or major errata.
" name="description"> " name="description">
<meta content="xml2rfc 3.25.0" name="generator"> <meta content="xml2rfc 3.25.0" name="generator">
<meta content="Document-Language" name="keyword"> <meta content="Document-Language" name="keyword">
@ -1090,9 +1093,8 @@ XML, and as do many of its semantics. You can use KDL both as a configuration
language, and a data exchange or storage format, if you so choose.<a href="#section-abstract-1" class="pilcrow"></a></p> language, and a data exchange or storage format, if you so choose.<a href="#section-abstract-1" class="pilcrow"></a></p>
<p id="section-abstract-2">This is the formal specification for KDL, including the intended data model and <p id="section-abstract-2">This is the formal specification for KDL, including the intended data model and
the grammar.<a href="#section-abstract-2" class="pilcrow"></a></p> the grammar.<a href="#section-abstract-2" class="pilcrow"></a></p>
<p id="section-abstract-3">This document describes KDL version KDL 2.0.0. It was released on 2024-12-21. It <p id="section-abstract-3">This document describes an unreleased minor change to KDL. For the latest
is the latest stable version of the language, and will only be edited for minor oficial version of the language, see https://kdl.dev/spec.<a href="#section-abstract-3" class="pilcrow"></a></p>
copyedits or major errata.<a href="#section-abstract-3" class="pilcrow"></a></p>
</section> </section>
<section class="note rfcEditorRemove" id="section-note.1"> <section class="note rfcEditorRemove" id="section-note.1">
<h2 id="name-about-this-document"> <h2 id="name-about-this-document">
@ -1345,7 +1347,7 @@ depending on the characters used.<a href="#section-2-4" class="pilcrow">¶</a></
<a href="#section-3.1" class="section-number selfRef">3.1. </a><a href="#name-document" class="section-name selfRef">Document</a> <a href="#section-3.1" class="section-number selfRef">3.1. </a><a href="#name-document" class="section-name selfRef">Document</a>
</h3> </h3>
<p id="section-3.1-1">The toplevel concept of KDL is a Document. A Document is composed of zero or <p id="section-3.1-1">The toplevel concept of KDL is a Document. A Document is composed of zero or
more Nodes (<a href="#node" class="auto internal xref">Section 3.2</a>), separated by newlines and whitespace, and eventually more Nodes (<a href="#node" class="auto internal xref">Section 3.2</a>), separated by newlines, semicolons, and whitespace, and eventually
terminated by an EOF.<a href="#section-3.1-1" class="pilcrow"></a></p> terminated by an EOF.<a href="#section-3.1-1" class="pilcrow"></a></p>
<p id="section-3.1-2">All KDL documents MUST be encoded in UTF-8 and conform to the specifications in <p id="section-3.1-2">All KDL documents MUST be encoded in UTF-8 and conform to the specifications in
this document.<a href="#section-3.1-2" class="pilcrow"></a></p> this document.<a href="#section-3.1-2" class="pilcrow"></a></p>
@ -1399,7 +1401,8 @@ preserving key order.<a href="#section-3.2-6" class="pilcrow">¶</a></p>
the entire node, including its properties, arguments, and children, and make the entire node, including its properties, arguments, and children, and make
it act as plain whitespace, even if it spreads across multiple lines.<a href="#section-3.2-7" class="pilcrow"></a></p> it act as plain whitespace, even if it spreads across multiple lines.<a href="#section-3.2-7" class="pilcrow"></a></p>
<p id="section-3.2-8">Finally, a node is terminated by either a Newline (<a href="#newline" class="auto internal xref">Section 3.18</a>), a semicolon <p id="section-3.2-8">Finally, a node is terminated by either a Newline (<a href="#newline" class="auto internal xref">Section 3.18</a>), a semicolon
(<code>;</code>), the end of a child block (<code>}</code>) or the end of the file/stream (an <code>EOF</code>).<a href="#section-3.2-8" class="pilcrow"></a></p> (<code>;</code>), the end of its parent's child block (<code>}</code>) or the end of the file/stream
(an <code>EOF</code>).<a href="#section-3.2-8" class="pilcrow"></a></p>
<div id="example-1"> <div id="example-1">
<section id="section-3.2.1"> <section id="section-3.2.1">
<h4 id="name-example-2"> <h4 id="name-example-2">
@ -1515,7 +1518,7 @@ parent {
child2 child2
} }
parent { child1; child2; } parent { child1; child2 }
</pre><a href="#section-3.6.1-1" class="pilcrow"></a> </pre><a href="#section-3.6.1-1" class="pilcrow"></a>
</div> </div>
</section> </section>
@ -1705,6 +1708,9 @@ and, if used, SHOULD interpret these types as follows:<a href="#section-3.8-4" c
</li> </li>
<li class="normal" id="section-3.8.3-1.23"> <li class="normal" id="section-3.8.3-1.23">
<p id="section-3.8.3-1.23.1"><code>base64</code>: A Base64-encoded string, denoting arbitrary binary data.<a href="#section-3.8.3-1.23.1" class="pilcrow"></a></p> <p id="section-3.8.3-1.23.1"><code>base64</code>: A Base64-encoded string, denoting arbitrary binary data.<a href="#section-3.8.3-1.23.1" class="pilcrow"></a></p>
</li>
<li class="normal" id="section-3.8.3-1.24">
<p id="section-3.8.3-1.24.1"><code>base85</code>: An <a href="https://en.wikipedia.org/wiki/Ascii85">Ascii85</a>-encoded string, denoting arbitrary binary data.<a href="#section-3.8.3-1.24.1" class="pilcrow"></a></p>
</li> </li>
</ul> </ul>
</section> </section>
@ -1747,7 +1753,7 @@ minimum of syntax<a href="#section-3.9-2.1.1" class="pilcrow">¶</a></p>
</li> </li>
<li class="normal" id="section-3.9-2.3"> <li class="normal" id="section-3.9-2.3">
<p id="section-3.9-2.3.1">Multi-Line Strings let you write strings across multiple lines <p id="section-3.9-2.3.1">Multi-Line Strings let you write strings across multiple lines
and with indentation that's not part of the string value.<a href="#section-3.9-2.3.1" class="pilcrow"></a></p> and with indentation that's not part of the string value.<a href="#section-3.9-2.3.1" class="pilcrow"></a></p>
</li> </li>
<li class="normal" id="section-3.9-2.4"> <li class="normal" id="section-3.9-2.4">
<p id="section-3.9-2.4.1">Raw Strings don't allow any escapes, <p id="section-3.9-2.4.1">Raw Strings don't allow any escapes,
@ -1777,8 +1783,8 @@ characters (<a href="#non-identifier-characters" class="auto internal xref">Sect
<ul class="normal"> <ul class="normal">
<li class="normal" id="section-3.10-3.1"> <li class="normal" id="section-3.10-3.1">
<p id="section-3.10-3.1.1">idents that appear to start with a Number (<a href="#number" class="auto internal xref">Section 3.14</a>) (like <code>1.0v2</code> or <p id="section-3.10-3.1.1">idents that appear to start with a Number (<a href="#number" class="auto internal xref">Section 3.14</a>) (like <code>1.0v2</code> or
<code>-1em</code>) or the "almost a number" pattern of a decimal point without a <code>-1em</code>) or the "almost a number" pattern of a decimal point without a
leading digit (like <code>.1</code>).<a href="#section-3.10-3.1.1" class="pilcrow"></a></p> leading digit (like <code>.1</code>).<a href="#section-3.10-3.1.1" class="pilcrow"></a></p>
</li> </li>
<li class="normal" id="section-3.10-3.2"> <li class="normal" id="section-3.10-3.2">
<p id="section-3.10-3.2.1">idents that are the language keywords (<code>inf</code>, <code>-inf</code>, <code>nan</code>, <code>true</code>, <p id="section-3.10-3.2.1">idents that are the language keywords (<code>inf</code>, <code>-inf</code>, <code>nan</code>, <code>true</code>,
@ -2714,7 +2720,7 @@ They may be represented in Strings (but not Raw Strings) using Unicode Escapes (
except for non Unicode Scalar Value, which can't be represented even as escapes).<a href="#section-3.19-1" class="pilcrow"></a></p> except for non Unicode Scalar Value, which can't be represented even as escapes).<a href="#section-3.19-1" class="pilcrow"></a></p>
<ul class="normal"> <ul class="normal">
<li class="normal" id="section-3.19-2.1"> <li class="normal" id="section-3.19-2.1">
<p id="section-3.19-2.1.1">The codepoints <code>U+0000-0008</code> or the codepoints <code>U+000E-001F</code> (various <p id="section-3.19-2.1.1">The codepoints <code>U+0000-0008</code> or the codepoints <code>U+000E-001F</code> (various
control characters).<a href="#section-3.19-2.1.1" class="pilcrow"></a></p> control characters).<a href="#section-3.19-2.1.1" class="pilcrow"></a></p>
</li> </li>
<li class="normal" id="section-3.19-2.2"> <li class="normal" id="section-3.19-2.2">
@ -2803,12 +2809,12 @@ string-character :=
[^\\"] - disallowed-literal-code-points [^\\"] - disallowed-literal-code-points
ws-escape := '\\' (unicode-space | newline)+ ws-escape := '\\' (unicode-space | newline)+
hex-digit := [0-9a-fA-F] hex-digit := [0-9a-fA-F]
hex-unicode := hex-digit{1, 6} - surrogate - above-max-scalar // Unicode Scalar Value in hex₁₆, leading 0s allowed within length ≤ 6 hex-unicode := hex-digit{1, 6} - surrogate - above-max-scalar
surrogate := [0]{0, 2} [dD] [8-9a-fA-F] hex-digit{2} surrogate := [0]{0, 2} [dD] [8-9a-fA-F] hex-digit{2}
// U+D800-DFFF: D 8 00 // U+D800-DFFF: D 8 00
// D F FF // D F FF
above-max-scalar = [2-9a-fA-F] hex-digit{5} | [1] [1-9a-fA-F] hex-digit{4} above-max-scalar = [2-9a-fA-F] hex-digit{5} |
// &gt;U+10FFFF: &gt;1 _____ 1 &gt;0 ____ [1] [1-9a-fA-F] hex-digit{4}
raw-string := '#' raw-string-quotes '#' | '#' raw-string '#' raw-string := '#' raw-string-quotes '#' | '#' raw-string '#'

View File

@ -21,9 +21,8 @@ Abstract
This is the formal specification for KDL, including the intended data This is the formal specification for KDL, including the intended data
model and the grammar. model and the grammar.
This document describes KDL version KDL 2.0.0. It was released on This document describes an unreleased minor change to KDL. For the
2024-12-21. It is the latest stable version of the language, and latest oficial version of the language, see https://kdl.dev/spec.
will only be edited for minor copyedits or major errata.
About This Document About This Document
@ -134,8 +133,8 @@ Table of Contents
3.1. Document 3.1. Document
The toplevel concept of KDL is a Document. A Document is composed of The toplevel concept of KDL is a Document. A Document is composed of
zero or more Nodes (Section 3.2), separated by newlines and zero or more Nodes (Section 3.2), separated by newlines, semicolons,
whitespace, and eventually terminated by an EOF. and whitespace, and eventually terminated by an EOF.
All KDL documents MUST be encoded in UTF-8 and conform to the All KDL documents MUST be encoded in UTF-8 and conform to the
specifications in this document. specifications in this document.
@ -188,8 +187,8 @@ Table of Contents
across multiple lines. across multiple lines.
Finally, a node is terminated by either a Newline (Section 3.18), a Finally, a node is terminated by either a Newline (Section 3.18), a
semicolon (;), the end of a child block (}) or the end of the file/ semicolon (;), the end of its parent's child block (}) or the end of
stream (an EOF). the file/stream (an EOF).
3.2.1. Example 3.2.1. Example
@ -275,7 +274,7 @@ Table of Contents
child2 child2
} }
parent { child1; child2; } parent { child1; child2 }
3.7. Value 3.7. Value
@ -405,6 +404,9 @@ Table of Contents
* base64: A Base64-encoded string, denoting arbitrary binary data. * base64: A Base64-encoded string, denoting arbitrary binary data.
* base85: An Ascii85 (https://en.wikipedia.org/wiki/Ascii85)-encoded
string, denoting arbitrary binary data.
3.8.4. Examples 3.8.4. Examples
node (u8)123 node (u8)123
@ -1111,12 +1113,12 @@ Table of Contents
[^\\"] - disallowed-literal-code-points [^\\"] - disallowed-literal-code-points
ws-escape := '\\' (unicode-space | newline)+ ws-escape := '\\' (unicode-space | newline)+
hex-digit := [0-9a-fA-F] hex-digit := [0-9a-fA-F]
hex-unicode := hex-digit{1, 6} - surrogate - above-max-scalar // Unicode Scalar Value in hex₁₆, leading 0s allowed within length ≤ 6 hex-unicode := hex-digit{1, 6} - surrogate - above-max-scalar
surrogate := [0]{0, 2} [dD] [8-9a-fA-F] hex-digit{2} surrogate := [0]{0, 2} [dD] [8-9a-fA-F] hex-digit{2}
// U+D800-DFFF: D 8 00 // U+D800-DFFF: D 8 00
// D F FF // D F FF
above-max-scalar = [2-9a-fA-F] hex-digit{5} | [1] [1-9a-fA-F] hex-digit{4} above-max-scalar = [2-9a-fA-F] hex-digit{5} |
// >U+10FFFF: >1 _____ 1 >0 ____ [1] [1-9a-fA-F] hex-digit{4}
raw-string := '#' raw-string-quotes '#' | '#' raw-string '#' raw-string := '#' raw-string-quotes '#' | '#' raw-string '#'

View File

@ -24,7 +24,36 @@
<td></td> <td></td>
</tr> </tr>
</table> </table>
<h2>Preview for branch <a href="tests">tests</a></h2>
<h2>Preview for branch <a href="tests/benchmarks">tests/benchmarks</a></h2>
<h2>Preview for branch <a href="tests/test_cases">tests/test_cases</a></h2>
<h2>Preview for branch <a href="tests/test_cases/expected_kdl">tests/test_cases/expected_kdl</a></h2>
<h2>Preview for branch <a href="tests/test_cases/input">tests/test_cases/input</a></h2>
<h2>Preview for branch <a href="zkat">zkat</a></h2> <h2>Preview for branch <a href="zkat">zkat</a></h2>
<h2>Preview for branch <a href="zkat/minor-tweaks">zkat/minor-tweaks</a></h2>
<table id="branch-zkat/minor-tweaks">
<tr>
<td><a href="zkat/minor-tweaks/draft-marchan-kdl2.html" class="html draft-marchan-kdl2" title="The KDL Document Language (HTML)">KDL</a></td>
<td><a href="zkat/minor-tweaks/draft-marchan-kdl2.txt" class="txt draft-marchan-kdl2" title="The KDL Document Language (Text)">plain text</a></td>
<td><a href="https://author-tools.ietf.org/api/iddiff?url_1=https://kdl-org.github.io/kdl/draft-marchan-kdl2.txt&amp;url_2=https://kdl-org.github.io/kdl/zkat/minor-tweaks/draft-marchan-kdl2.txt" class="diff draft-marchan-kdl2">diff with main</a></td>
</tr>
</table>
<h2>Preview for branch <a href="zkat/fix-stuff">zkat/fix-stuff</a></h2>
<table id="branch-zkat/fix-stuff">
<tr>
<td><a href="zkat/fix-stuff/draft-marchan-kdl2.html" class="html draft-marchan-kdl2" title="The KDL Document Language (HTML)">KDL</a></td>
<td><a href="zkat/fix-stuff/draft-marchan-kdl2.txt" class="txt draft-marchan-kdl2" title="The KDL Document Language (Text)">plain text</a></td>
<td>same as main</td>
</tr>
</table>
<h2>Preview for branch <a href="zkat/schema-v2">zkat/schema-v2</a></h2>
<table id="branch-zkat/schema-v2">
<tr>
<td><a href="zkat/schema-v2/draft-marchan-kdl2.html" class="html draft-marchan-kdl2" title="The KDL Document Language (HTML)">KDL</a></td>
<td><a href="zkat/schema-v2/draft-marchan-kdl2.txt" class="txt draft-marchan-kdl2" title="The KDL Document Language (Text)">plain text</a></td>
<td><a href="https://author-tools.ietf.org/api/iddiff?url_1=https://kdl-org.github.io/kdl/draft-marchan-kdl2.txt&amp;url_2=https://kdl-org.github.io/kdl/zkat/schema-v2/draft-marchan-kdl2.txt" class="diff draft-marchan-kdl2">diff with main</a></td>
</tr>
</table>
<h2>Preview for branch <a href="zkat/utf-8-must">zkat/utf-8-must</a></h2> <h2>Preview for branch <a href="zkat/utf-8-must">zkat/utf-8-must</a></h2>
<table id="branch-zkat/utf-8-must"> <table id="branch-zkat/utf-8-must">
<tr> <tr>
@ -33,35 +62,6 @@
<td><a href="https://author-tools.ietf.org/api/iddiff?url_1=https://kdl-org.github.io/kdl/draft-marchan-kdl2.txt&amp;url_2=https://kdl-org.github.io/kdl/zkat/utf-8-must/draft-marchan-kdl2.txt" class="diff draft-marchan-kdl2">diff with main</a></td> <td><a href="https://author-tools.ietf.org/api/iddiff?url_1=https://kdl-org.github.io/kdl/draft-marchan-kdl2.txt&amp;url_2=https://kdl-org.github.io/kdl/zkat/utf-8-must/draft-marchan-kdl2.txt" class="diff draft-marchan-kdl2">diff with main</a></td>
</tr> </tr>
</table> </table>
<h2>Preview for branch <a href="zkat/schema-v2">zkat/schema-v2</a></h2>
<table id="branch-zkat/schema-v2">
<tr>
<td><a href="zkat/schema-v2/draft-marchan-kdl2.html" class="html draft-marchan-kdl2" title="The KDL Document Language (HTML)">KDL</a></td>
<td><a href="zkat/schema-v2/draft-marchan-kdl2.txt" class="txt draft-marchan-kdl2" title="The KDL Document Language (Text)">plain text</a></td>
<td>same as main</td>
</tr>
</table>
<h2>Preview for branch <a href="zkat/fix-stuff">zkat/fix-stuff</a></h2>
<table id="branch-zkat/fix-stuff">
<tr>
<td><a href="zkat/fix-stuff/draft-marchan-kdl2.html" class="html draft-marchan-kdl2" title="The KDL Document Language (HTML)">KDL</a></td>
<td><a href="zkat/fix-stuff/draft-marchan-kdl2.txt" class="txt draft-marchan-kdl2" title="The KDL Document Language (Text)">plain text</a></td>
<td><a href="https://author-tools.ietf.org/api/iddiff?url_1=https://kdl-org.github.io/kdl/draft-marchan-kdl2.txt&amp;url_2=https://kdl-org.github.io/kdl/zkat/fix-stuff/draft-marchan-kdl2.txt" class="diff draft-marchan-kdl2">diff with main</a></td>
</tr>
</table>
<h2>Preview for branch <a href="zkat/minor-tweaks">zkat/minor-tweaks</a></h2>
<table id="branch-zkat/minor-tweaks">
<tr>
<td><a href="zkat/minor-tweaks/draft-marchan-kdl2.html" class="html draft-marchan-kdl2" title="The KDL Document Language (HTML)">KDL</a></td>
<td><a href="zkat/minor-tweaks/draft-marchan-kdl2.txt" class="txt draft-marchan-kdl2" title="The KDL Document Language (Text)">plain text</a></td>
<td>same as main</td>
</tr>
</table>
<h2>Preview for branch <a href="tests">tests</a></h2>
<h2>Preview for branch <a href="tests/test_cases">tests/test_cases</a></h2>
<h2>Preview for branch <a href="tests/test_cases/expected_kdl">tests/test_cases/expected_kdl</a></h2>
<h2>Preview for branch <a href="tests/test_cases/input">tests/test_cases/input</a></h2>
<h2>Preview for branch <a href="tests/benchmarks">tests/benchmarks</a></h2>
<script> <script>
window.onload = function() { window.onload = function() {
var referrer_branch = 'main'; var referrer_branch = 'main';