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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2f8cb9a6cb2e25458bb5cb6ccf210d7633c2b204695b25f4ee8d6293153f8edd
4
- data.tar.gz: 214f0679505abceb77c0930949be92983c4388af7ecc03884818370c5e2e5c55
3
+ metadata.gz: 04fd898116e48263444f530446a4099229d32151da9937ed2524ce51004cb79a
4
+ data.tar.gz: 17e58309364f9f812b8daa409d781a0b078615bda69ab0c92b9bb2f868f09d16
5
5
  SHA512:
6
- metadata.gz: a394ac99adbe0430c8577256b11da8ef3fc786aece5535b00d9c87cc40abd55743a9d3caa2577edd609aadb699eb8ca895bd08b6495f82b6451d33a918eb32d8
7
- data.tar.gz: a0c155b799fae53a21b451085b903bf1c7c5de400ecfc5130418dde096d47e3104ef5a412a755ecfe8d635ca42c10aa67f3dabd2d347246a0b63ed6c053cc25e
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`: `rfc3`
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 both v3 and v2 formats:
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
- This README documents the AsciiRFC markup in full detail. For further
50
- information about AsciiRFC, please refer to the
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 rfc3 a.adoc # output RFC XML v3
62
- $ metanorma --type rfc3 --extensions xmlrfc a.adoc # output RFC XML v3
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.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
- <attribute name="type">
196
- <ref name="ReferenceFormat"/>
197
- </attribute>
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>
@@ -1,5 +1,5 @@
1
1
  module Metanorma
2
2
  module Ietf
3
- VERSION = "3.1.8".freeze
3
+ VERSION = "3.2.0".freeze
4
4
  end
5
5
  end
@@ -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.4.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.1.8
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-06-06 00:00:00.000000000 Z
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.4.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.4.2
54
+ version: 2.5.0
55
55
  - !ruby/object:Gem::Dependency
56
56
  name: debug
57
57
  requirement: !ruby/object:Gem::Requirement