metanorma-ietf 3.1.8 → 3.2.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.adoc +8 -29
- data/lib/metanorma/ietf/converter.rb +2 -2
- data/lib/metanorma/ietf/isodoc.rng +26 -4
- data/lib/metanorma/ietf/relaton-ietf.rng +15 -0
- data/lib/metanorma/ietf/version.rb +1 -1
- data/metanorma-ietf.gemspec +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 04fd898116e48263444f530446a4099229d32151da9937ed2524ce51004cb79a
|
4
|
+
data.tar.gz: 17e58309364f9f812b8daa409d781a0b078615bda69ab0c92b9bb2f868f09d16
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 0f2e66094b3dc68c6bdf07bea94be7a1e84297af218d40ac1e0566179595c3261d0768eea9f11c4faa0337927111f28c80487111d47d3d9595df265d046f6759
|
7
|
+
data.tar.gz: 90a2b51f517cc109b918b7fdab717c0376d11294be3bdc518d79f934edb2e92b06bddb31ccb1c9d89c91f173f4ef70352110a955c9cff4981152d1ae7936bd93
|
data/README.adoc
CHANGED
@@ -23,12 +23,8 @@ gem, and aligns closely to it.
|
|
23
23
|
|
24
24
|
The following outputs are generated:
|
25
25
|
|
26
|
-
* RFC XML v2
|
27
|
-
** Metanorma `doctype`: `rfc2`
|
28
|
-
** Metanorma file extension: `xmlrfc` (not `xml`!)
|
29
|
-
|
30
26
|
* RFC XML v3
|
31
|
-
** Metanorma `doctype`: `
|
27
|
+
** Metanorma `doctype`: `ietf`
|
32
28
|
** Metanorma file extension: `xmlrfc` (not `xml`!)
|
33
29
|
|
34
30
|
The "`xml2rfc`" Vocabulary (hereinafter "`RFC XML`") is an XML-based language
|
@@ -37,18 +33,16 @@ https://www.ietf.org/id-info/guidelines.html[Internet-Drafts]
|
|
37
33
|
and https://tools.ietf.org/html/rfc7322[RFCs (RFC7322)].
|
38
34
|
|
39
35
|
This gem allows you to author these types of documents in AsciiDoc, and outputs
|
40
|
-
RFC XML output in
|
36
|
+
RFC XML output in v3 format:
|
41
37
|
|
42
38
|
* v3 RFC XML (https://tools.ietf.org/html/rfc7991[RFC 7991])
|
43
|
-
* v2 RFC XML (https://tools.ietf.org/html/rfc7749[RFC 7749])
|
44
39
|
|
45
40
|
Its syntax is designed to be "`native-asciidoctor`" as much as possible, with
|
46
41
|
some templated use of attributes to convey added information for RFC XML
|
47
42
|
output.
|
48
43
|
|
49
|
-
|
50
|
-
|
51
|
-
https://datatracker.ietf.org/doc/draft-ribose-asciirfc/[AsciiRFC IETF Internet-Draft].
|
44
|
+
For further information about the markup used, please refer to the
|
45
|
+
https://www.metanorma.org/author/ietf/[Writing IETF I-Ds and RFCs using AsciiDoc & Metanorma].
|
52
46
|
|
53
47
|
|
54
48
|
|
@@ -58,13 +52,12 @@ The preferred way to invoke this gem is via the `metanorma` command:
|
|
58
52
|
|
59
53
|
[source,console]
|
60
54
|
----
|
61
|
-
$ metanorma --type
|
62
|
-
$ metanorma --type
|
55
|
+
$ metanorma --type ietf a.adoc # output RFC XML v3, text, HTML
|
56
|
+
$ metanorma --type ietf --extensions xmlrfc a.adoc # output RFC XML v3
|
63
57
|
----
|
64
58
|
|
65
|
-
The gem translates the document into IETF XML RFC format.
|
66
|
-
|
67
|
-
Text and HTML versions should be generated using the `xml2rfc` tool.
|
59
|
+
The gem translates the document into IETF XML RFC format. By default, the gem
|
60
|
+
then runs the `xml2rfc` tool to generate text and HTML versions as well.
|
68
61
|
|
69
62
|
|
70
63
|
== Installation
|
@@ -141,18 +134,6 @@ include::spec/examples/example-v3.adoc[]
|
|
141
134
|
----
|
142
135
|
endif::[]
|
143
136
|
|
144
|
-
=== RFC XML v2 Example
|
145
|
-
|
146
|
-
ifdef::env-github[]
|
147
|
-
include::spec/examples/example-v2.adoc[]
|
148
|
-
endif::[]
|
149
|
-
ifndef::env-github[]
|
150
|
-
[source,asciidoc]
|
151
|
-
----
|
152
|
-
include::spec/examples/example-v2.adoc[]
|
153
|
-
----
|
154
|
-
endif::[]
|
155
|
-
|
156
137
|
|
157
138
|
== Development
|
158
139
|
|
@@ -210,9 +191,7 @@ This gem is developed, maintained and funded by https://www.ribose.com[Ribose In
|
|
210
191
|
|
211
192
|
== Examples
|
212
193
|
|
213
|
-
////
|
214
194
|
* Example documents are avalable at the https://github.com/metanorma/mn-samples-ietf[mn-samples-ietf] repository.
|
215
|
-
////
|
216
195
|
|
217
196
|
* Document templates are available at the https://github.com/metanorma/mn-templates-ietf[mn-templates-ietf] repository.
|
218
197
|
|
@@ -53,8 +53,8 @@ module Metanorma
|
|
53
53
|
when :single then xml << "'#{node.text}'"
|
54
54
|
when :superscript then xml.sup { |s| s << node.text }
|
55
55
|
when :subscript then xml.sub { |s| s << node.text }
|
56
|
-
when :asciimath then stem_parse(node.text, xml, :asciimath)
|
57
|
-
when :latexmath then stem_parse(node.text, xml, :latexmath)
|
56
|
+
when :asciimath then stem_parse(node.text, xml, :asciimath, false)
|
57
|
+
when :latexmath then stem_parse(node.text, xml, :latexmath, false)
|
58
58
|
else
|
59
59
|
case node.role
|
60
60
|
when "bcp14" then xml.bcp14 { |s| s << node.text.upcase }
|
@@ -17,7 +17,7 @@
|
|
17
17
|
these elements; we just want one namespace for any child grammars
|
18
18
|
of this.
|
19
19
|
-->
|
20
|
-
<!-- VERSION v1.2.
|
20
|
+
<!-- VERSION v1.2.3 -->
|
21
21
|
<grammar xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0" xmlns="http://relaxng.org/ns/structure/1.0" datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes">
|
22
22
|
<include href="reqt.rng"/>
|
23
23
|
<include href="basicdoc.rng">
|
@@ -192,9 +192,11 @@
|
|
192
192
|
</attribute>
|
193
193
|
</optional>
|
194
194
|
<attribute name="citeas"/>
|
195
|
-
<
|
196
|
-
<
|
197
|
-
|
195
|
+
<optional>
|
196
|
+
<attribute name="type">
|
197
|
+
<ref name="ReferenceFormat"/>
|
198
|
+
</attribute>
|
199
|
+
</optional>
|
198
200
|
<optional>
|
199
201
|
<attribute name="alt"/>
|
200
202
|
</optional>
|
@@ -836,6 +838,26 @@
|
|
836
838
|
<ref name="paragraph"/>
|
837
839
|
</element>
|
838
840
|
</define>
|
841
|
+
<define name="stem">
|
842
|
+
<element name="stem">
|
843
|
+
<attribute name="type">
|
844
|
+
<choice>
|
845
|
+
<value>MathML</value>
|
846
|
+
<value>AsciiMath</value>
|
847
|
+
<value>LatexMath</value>
|
848
|
+
</choice>
|
849
|
+
</attribute>
|
850
|
+
<attribute name="block">
|
851
|
+
<data type="boolean"/>
|
852
|
+
</attribute>
|
853
|
+
<oneOrMore>
|
854
|
+
<choice>
|
855
|
+
<text/>
|
856
|
+
<ref name="AnyElement"/>
|
857
|
+
</choice>
|
858
|
+
</oneOrMore>
|
859
|
+
</element>
|
860
|
+
</define>
|
839
861
|
<define name="em">
|
840
862
|
<element name="em">
|
841
863
|
<zeroOrMore>
|
@@ -26,6 +26,9 @@
|
|
26
26
|
<zeroOrMore>
|
27
27
|
<ref name="area"/>
|
28
28
|
</zeroOrMore>
|
29
|
+
<optional>
|
30
|
+
<ref name="stream"/>
|
31
|
+
</optional>
|
29
32
|
<optional>
|
30
33
|
<ref name="ipr"/>
|
31
34
|
</optional>
|
@@ -315,4 +318,16 @@
|
|
315
318
|
</optional>
|
316
319
|
</element>
|
317
320
|
</define>
|
321
|
+
<define name="stream">
|
322
|
+
<element name="stream">
|
323
|
+
<choice>
|
324
|
+
<value>IAB</value>
|
325
|
+
<value>IETF</value>
|
326
|
+
<value>Independent</value>
|
327
|
+
<value>IRTF</value>
|
328
|
+
<value>Legacy</value>
|
329
|
+
<value>Editorial</value>
|
330
|
+
</choice>
|
331
|
+
</element>
|
332
|
+
</define>
|
318
333
|
</grammar>
|
data/metanorma-ietf.gemspec
CHANGED
@@ -38,7 +38,7 @@ Gem::Specification.new do |spec|
|
|
38
38
|
|
39
39
|
spec.add_dependency "mathml2asciimath"
|
40
40
|
spec.add_dependency "metanorma-ietf-data"
|
41
|
-
spec.add_dependency "metanorma-standoc", "~> 2.
|
41
|
+
spec.add_dependency "metanorma-standoc", "~> 2.5.0"
|
42
42
|
|
43
43
|
spec.add_development_dependency "debug"
|
44
44
|
spec.add_development_dependency "equivalent-xml", "~> 0.6"
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: metanorma-ietf
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 3.
|
4
|
+
version: 3.2.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Ribose Inc.
|
8
8
|
autorequire:
|
9
9
|
bindir: exe
|
10
10
|
cert_chain: []
|
11
|
-
date: 2023-
|
11
|
+
date: 2023-08-07 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: mathml2asciimath
|
@@ -44,14 +44,14 @@ dependencies:
|
|
44
44
|
requirements:
|
45
45
|
- - "~>"
|
46
46
|
- !ruby/object:Gem::Version
|
47
|
-
version: 2.
|
47
|
+
version: 2.5.0
|
48
48
|
type: :runtime
|
49
49
|
prerelease: false
|
50
50
|
version_requirements: !ruby/object:Gem::Requirement
|
51
51
|
requirements:
|
52
52
|
- - "~>"
|
53
53
|
- !ruby/object:Gem::Version
|
54
|
-
version: 2.
|
54
|
+
version: 2.5.0
|
55
55
|
- !ruby/object:Gem::Dependency
|
56
56
|
name: debug
|
57
57
|
requirement: !ruby/object:Gem::Requirement
|