kramdown-rfc2629 1.7.4 → 1.7.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c60909608ac8c84853d39c03fdf0da2cdfd179601a63a5b07a52099925a8ce9
-  data.tar.gz: ce8fcfe62f77fc23a8a5514e329ade31864ac099f5a45c6bbce976e3a8210a1e
+  metadata.gz: fa027b12b5ef1dc11718e82a28bc2a126208b7480048a41a03eebfd75fd5f2d7
+  data.tar.gz: fa96be9f490186b8634c52abfcf613e1b5f4b30e329b398879a93394bf0b92f7
 SHA512:
-  metadata.gz: 3b11fe08773c3e5c80aaaaeff16bf6728ab8656ee95ce0186bf786b2da2b99832b65b36fa32e7801e36b3f9c32b4e90830fa4c14f5136d0f7945c2c342ba17d1
-  data.tar.gz: 35a372c29219550c56a2335a497b3117621ac7b998792d596272fad84725a6f464a89bb931c9472a0ef4320eee40b69088e3f595ef8e6a028e7ba0a57e58436f
+  metadata.gz: 2880e284c22e96e281498028f3e2339ff1f91e7326791c547851022505df9a169dbe47a76604b5fd67de5c3a3cfe180153c93f8b9798bae16764314301ec0ddf
+  data.tar.gz: 65d2639fe7c971cf67ab27bd115b18c794a78f7021febd46527b6f61fd8c748f3c515cbd913c14565b650c7bf4c53b699405142a9b6fd04de2c7fd8e3a222c6a

data/README.md

@@ -475,8 +475,8 @@ allow for automatic entry of items as normative/informative.
 (1.0.16:) Markdown footnotes are converted into `cref`s (XML2RFC formal
 comments; note that these are only visible if the pi "comments" is set to yes).
 The anchor is taken from the markdown footnote name. The source, if
-needed, can be supplied by an IAD, as in (first example with
-ALD):
+needed, can be supplied by an [IAL][], as in (first example also uses an
+[ALD][]):
 
 ```markdown
 {:cabo: source="cabo"}
@@ -494,7 +494,7 @@ Note that XML2RFC v2 doesn't allow structure in crefs. If you put any,
 you get the escaped verbatim XML...
 
 (1.0.11:) Allow overriding "style" attribute (via IAL =
-[inline attribute list][kdsyntax-ial]) in lists and spans
+[inline attribute list][IAL]) in lists and spans
 as in:
 
 ```markdown
@@ -549,8 +549,9 @@ note that this creates ugly blank space in some HTML converters).
 
 # Risks and Side-Effects
 
-The code is not very polished, but now quite stable; it has been successfully used for a
-number of non-trivial Internet-Drafts and RFCs.  You probably still need to
+The code is not very polished, but now quite stable; it has been
+successfully used for hundreds of non-trivial Internet-Drafts and RFCs.
+You probably still need to
 skim [v3][] if you want to write an Internet-Draft, but you
 don't really need to understand XML very much.  Knowing the basics of
 YAML helps with the metadata (but you'll understand it from the
@@ -563,12 +564,29 @@ This can for instance be used to obtain unnumbered appendices:
 ```markdown
 Acknowledgements
 ================
-{: numbered="no"}
+{: numbered="false"}
+
+John Mattsson was nice enough to point out the need for this being documented.
+```
+
+
+Note that this specific example is covered by a predefined
+kramdown-rfc ["attribute list definition" (ALD)][ALD]:
+
+```markdown
+{:unnumbered: numbered="false"}
+```
+
+so the conventional way to write this example would be the somewhat simpler:
+
+```markdown
+Acknowledgements
+================
+{:unnumbered}
 
 John Mattsson was nice enough to point out the need for this being documented.
 ```
 
-[IAL]: https://kramdown.gettalong.org/syntax.html#inline-attribute-lists
 
 # Upconversion
 
@@ -638,7 +656,8 @@ made it possible to license kramdown-rfc under the same license.
 
 [kramdown]: https://kramdown.gettalong.org
 [kdsyntax]: http://kramdown.gettalong.org/syntax.html
-[kdsyntax-ial]: http://kramdown.gettalong.org/syntax.html#inline-attribute-lists
+[IAL]: https://kramdown.gettalong.org/syntax.html#inline-attribute-lists
+[ALD]: https://kramdown.gettalong.org/syntax.html#attribute-list-definitions
 [stupid]: http://tools.ietf.org/id/draft-hartke-xmpp-stupid-00
 [RFC 2629]: https://www.rfc-editor.org/rfc/rfc2629.html
 [RFC 7749]: https://www.rfc-editor.org/rfc/rfc7749.html

data/bin/kdrfc

@@ -45,15 +45,21 @@ BANNER
   opts.on("-h", "--[no-]html", "Convert to html as well") do |v|
     kdrfc.options.html = v
   end
-  opts.on("-t", "--[no-]txt", "Convert to txt as well") do |v|
+  opts.on("-t", "--[no-]txt", "Convert to txt as well (default)") do |v|
     kdrfc.options.txt = v
   end
+  opts.on("-n", "Do not convert to txt (--no-txt)") do |v|
+    kdrfc.options.txt = !v
+  end
   opts.on("-3", "--[no-]v3", "Use RFCXML v3 processing rules") do |v|
     kdrfc.options.v3 = v
   end
   opts.on("-2", "--[no-]v2", "Use RFCXML v2 processing rules") do |v|
     kdrfc.options.v2 = v
   end
+  opts.on("-dNN", "--docrev=NN", /[0-9][0-9]/, "Replace -latest by -NN in docname") do |v|
+    ENV["KRAMDOWN_RFC_DOCREV"] = v
+  end
 end
 op.parse!
 

data/kramdown-rfc2629.gemspec

@@ -1,6 +1,6 @@
 spec = Gem::Specification.new do |s|
   s.name = 'kramdown-rfc2629'
-  s.version = '1.7.4'
+  s.version = '1.7.6'
   s.summary = "Kramdown extension for generating RFCXML (RFC 799x)."
   s.description = %{An RFCXML (RFC 799x) generating backend for Thomas Leitner's
 "kramdown" markdown parser.  Mostly useful for RFC writers.}

data/lib/kramdown-rfc/command.rb

@@ -288,6 +288,13 @@ def xml_from_sections(input)
     end
   end
 
+  if r = ENV["KRAMDOWN_RFC_DOCREV"]
+    warn "** building document revision -#{r}"
+    unless n = ps.has(:docname) and n.sub!(/-latest\z/, "-#{r}")
+      warn "** -d#{r}: docname #{n.inspect} doesn't have a '-latest' suffix"
+    end
+  end
+
   if o = ps[:'autolink-iref-cleanup']
     $options.autolink_iref_cleanup = o
   end

data/lib/kramdown-rfc/parameterset.rb

@@ -40,11 +40,19 @@ module KramdownRFC
     def attr(pn)
       val, an = van(pn)
       @av[an.intern] = val
-      %{#{an}="#{escattr(val)}"}    if val
+      %{#{an}="#{escattr(val)}"}    if val # see attrtf below
     end
     def attrs(*pns)
       pns.map{ |pn| attr(pn) if pn }.compact.join(" ")
     end
+    def attrtf(pn)              # can do an overriding false value
+      val, an = van(pn)
+      @av[an.intern] = val
+      %{#{an}="#{escattr(val)}"}    unless val.nil?
+    end
+    def attrstf(*pns)
+      pns.map{ |pn| attrtf(pn) if pn }.compact.join(" ")
+    end
     def ele(pn, attr=nil, defcontent=nil, markdown=false)
       val, an = van(pn)
       val ||= defcontent

data/lib/kramdown-rfc/refxml.rb

@@ -17,7 +17,8 @@ module KramdownRFC
   def self.ref_to_xml(k, v)
     vps = KramdownRFC::ParameterSet.new(v)
     erb = ERB.trim_new <<-REFERB, '-'
-<reference anchor="<%= escattr(k) %>" <%= vps.attr("target") %>>
+<reference anchor="<%= escattr(k) %>" <%=
+        vps.attrstf("target", "quoteTitle=quote-title=quotetitle=qt") %>>
   <front>
     <%= vps.ele("title") -%>
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kramdown-rfc2629
 version: !ruby/object:Gem::Version
-  version: 1.7.4
+  version: 1.7.6
 platform: ruby
 authors:
 - Carsten Bormann
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-12-03 00:00:00.000000000 Z
+date: 2024-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: kramdown