metanorma-standoc 1.0.6 → 1.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4827ca730cad759d95fc6d9a2cde854fc4579bb0554cdf3c4cbb8b6139d67d5
-  data.tar.gz: 3b591c74d89dc060f0f88e98ef7de25a38e558a66b8dfa31561931ba5ecf1e99
+  metadata.gz: 56d1dfa7cef4ffc384854d78494c559fb24c426dd31d2429ad11de246e858b92
+  data.tar.gz: 3069d3e34e8ae8663655073ae67666964312b169bd42a056538d748f2dc8dae0
 SHA512:
-  metadata.gz: 88ec93016754b952a3cc289f49a38d45734dfc628ed320d8de080b790323d752b86e8d2902754ee713984bd247a07f3a0cc624b4e4320421ebdcdbb58f596924
-  data.tar.gz: 2ecae2ef176588738cc0f95306cd9868c52a3699e6a192bfea16cb307abfbe98d6d6c5ec6392c167ac07eab724545e35ee7cc98a68d42ed4636458eb15ec5ad6
+  metadata.gz: 59cb8b7330a1605369d6216014bfceff8e60345985853a9c424be9bb99105b176e4ec5f3af9131d159f4616c7d2d93a2bfb4e7692b5028dc04bcbaeb2e6db5bf
+  data.tar.gz: b8cc513d452db412d7c86ebb9dd66c12e2c12be64ccdce84a70958ed6e1ce03f9b44226bbe378c14ef506af0dbfffed1562ca91b69a82ae646ad1d7dd84364b7

data/README.adoc

@@ -7,3 +7,354 @@ image:https://codeclimate.com/github/riboseinc/metanorma-standoc/badges/gpa.svg[
 WARNING: This gem is still under development.
 
 Gem for serialising the https://github.com/riboseinc/metanorma-model-standoc[Metanorma Standoc] model. 
+
+[[model_additions]]
+== Asciidoctor model additions
+
+=== Section titles
+Metanorma standards has special section types: "Scope", "Normative References", "Terms and Definitions", "Symbols and Abbreviated Terms", "Bibliography". By default, these are identified in Asciidoc by using those titles. The gem allows you to override the title by using a `heading` attribute on the node, so that the actual title in your Asciidoc can be something different; that is useful, for example, if you are translating the document into different languages. So:
+
+[source,asciidoctor]
+--
+[heading=scope]
+== 范围
+--
+
+Note that both the XML population, and the isodoc gem will overwrite any supplied title. If you are translating Metanorma documents into other languages, you will still need access to versions of the metanorma-standoc and isodoc gems in those languages.
+
+=== Obligation
+The obligation of sections (whether they are normative or informative) is indicated
+with the attribute "obligation". For most sections, this is fixed; for annexes and clauses, the
+default value of the obligation is "normative", and users need to set the obligation
+to "informative" as a section attribute.
+
+[source,asciidoctor]
+--
+[[AnnexA]]
+[appendix,obligation=informative]
+== Determination of defects
+--
+
+=== Term markup
+
+To ensure the structure of Terms and Definitions is captured accurately, the following
+macros are defined, and must be used to mark up their respective content:
+
+`alt:[TERM]`:: for alternative terms
+`deprecated:[TERM]`:: for deprecated terms
+`domain:[TERM]`:: for term domains
+
+The macro contents can contain their own markup.
+
+[source,asciidoctor]
+--
+=== paddy 
+alt:[_paddy_ rice]
+deprecated:[#[smallcap]#cargo# rice]
+domain:[rice]
+
+_paddy_ (<<paddy>>) from which the husk only has been removed
+--
+
+=== Terms and Definitions markup
+
+If the Terms and Definitions of a standard are partly or fully sourced from
+another standard, that standard is cited in a `source` attribute to the section,
+which is set to the reference anchor of the standard (given under the Normative
+Referencecs)..
+The boilerplate of the Terms and Definitions section is adjusted accordingly.
+
+[source,asciidoctor]
+--
+[source=ISO712]
+== Terms and Definitions
+--
+
+Multiple sources are allowed, and need to be quoted and comma-delimited:
+
+[source,asciidoctor]
+--
+[source="ISO712,ISO24333"]
+== Terms and Definitions
+--
+
+
+=== Paragraph alignment
+
+Alignment is defined as an attribute for paragraphs:
+
+[source,asciidoctor]
+--
+[align=left]
+This paragraph is aligned left
+
+[align=right]
+This paragraph is aligned right
+
+[align=center]
+This paragraph is aligned center
+
+[align=justified]
+This paragraph is justified, which is the default
+--
+
+=== Reviewer notes
+
+Reviewer notes are encoded as sidebars, and can be separated at a distance from the
+text they are annotating; the text they are annotating is indicated through anchors. 
+Reviewer notes are only rendered if the document has a `:draft:` attribute.
+
+The following attributes on reviewer notes are mandatory:
+
+* `reviewer` attribute (naming the reviewer) 
+* the starting target anchor of the note (`from` attribute)
+
+The following attributes are optional:
+
+* `date` attribute, optionally including the time (as xs:date or xs:datetime)
+* the ending target anchor of the note (`to` attribute)
+
+The span of text covered by the reviewer note is from the start of the
+text encompassed by the `from` element, to the end of the text encompassed
+by the `to` element. If only the `from` element supplied, the reviewer note
+covers the `from` element. The `from` and `to` elements can be bookmarks,
+which cover no space.
+
+[source,asciidoctor]
+--
+[[clause_address_profile_definition]]
+=== Address Profile Definition (AddressProfileDescription)
+
+[[para1]]
+This is a clause address [[A]]profile[[B]] definition
+
+[reviewer="Nick Nicholas",date=20180125T0121,from=clause_address_profile_definition,to=para1]
+****
+I do not agree with this statement.
+****
+
+[reviewer="Nick Nicholas",date=20180125T0121,from=A,to=B]
+****
+Profile?!
+****
+--
+
+=== Strikethrough and Small Caps
+
+The following formatting macros are used for strikethrough and small caps text:
+
+[source,asciidoctor]
+--
+[strike]#strike through text#
+[smallcap]#small caps text#
+--
+
+=== Count of table header and footer rows
+
+In Asciidoc, a table can have at most one header row or footer row. In Metanorma,
+a nominal single header row is routinely broken up into multiple rows in order
+to accommodate units or symbols, that line up against each other, though
+they are displayed as merged cells with no grid between them. To address this,
+tables can be marked up with an optional `headerrows` attribute:
+
+[source,asciidoctor]
+--
+[headerrows=2]
+|===
+.2+|Defect 4+^| Maximum permissible mass fraction of defects in husked rice +
+stem:[w_max]
+| in husked rice | in milled rice (non-glutinous) | in husked parboiled rice | in milled parboiled rice
+
+| Extraneous matter: organic footnote:[Organic extraneous matter includes foreign seeds, husks, bran, parts of straw, etc.] | 1,0 | 0,5 | 1,0 | 0,5
+|===
+--
+
+=== Inline clause numbers
+
+For some clauses (notably test methods), the clause heading appears inline with the clause, instead of being separated on a different line. This is indicated in Asciidoc by the option
+attribute `inline-header`:
+
+[source,asciidoctor]
+--
+[%inline-header]
+[[AnnexA-2-1]]
+==== Sample divider, 
+
+consisting of a conical sample divider
+--
+
+=== Bibliographic details
+
+Citations can include details of where in the document the citation is located; these
+are entered by suffixing the type of locality, then an equals sign, then the reference. 
+The word "whole" on its own is also treated as a locality. Multiple
+instances of locality and reference can be provided, delimited by comma or colon. Any trailing
+text after the sequence of locality=reference (or locality, space, reference) are treated
+as substitute text, as would occur normally in an Asciidoctor crossreference. For
+example:
+
+[source,asciidoctor]
+--
+<<ISO712,the foregoing reference>>     # renders as: the foregoing reference
+<<ISO712,section=5, page 8-10>>         # renders as: ISO 712, Section 5, Page 8-10
+<<ISO712,section=5, page=8-10: 5:8-10>> # renders as ISO 712, 5:8-10 ("5:8-10" treated as replacement text for all the foregoing)
+<<ISO712,whole>>                        # renders as: ISO 712, Whole of text
+--
+
+The references cannot contain spaces. Any text following the sequence of localities
+will be displayed instead of the localities.
+
+A custom locality can be entered by prefixing it with `locality:`:
+
+[source,asciidoctor]
+--
+<<ISO712,locality:frontispiece=5, page=8-10>>         # renders as: ISO 712, Frontispiece 5, Page 8-10
+--
+
+Custom localities may not contain commas, colons, or space. Localities with the `locality:`
+prefix are recognised in internationalisation configuration files.
+
+=== Block Quotes
+
+As in normal Asciidoctor, block quotes are preceded with an author and a citation;
+but the citation is expected to be in the same format as all other citations, 
+a cross-reference optionally followed by text, which may include the bibliographic
+sections referenced:
+
+[source,asciidoctor]
+--
+[quote, ISO, "ISO7301,section 1"]
+_____
+This International Standard gives the minimum specifications for rice (_Oryza sativa_ L.) 
+which is subject to international trade. It is applicable to the following types: husked rice 
+and milled rice, parboiled or not, intended for direct human consumption. It is neither 
+applicable to other products derived from rice, nor to waxy rice (glutinous rice).
+_____
+--
+
+=== Image size
+
+The value `auto` is accepted for image width and height attributes. It is only passed on
+to HTML output; if the output is to Word, both the width and height attributes are stripped
+from the image.
+
+[source,asciidoctor]
+--
+[height=90,width=auto]
+image::logo.jpg
+--
+
+=== Subclauses in Terms & Definitions sections
+
+Normally any terminal subclause in a Terms & Definitions section is treated as a term
+definition. Exceptionally, an introductory section can be tagged to be treated as a clause,
+instead of a term, by prefixing it with the style attribute `[.nonterm]`.
+
+[source,asciidoctor]
+--
+== Terms and definitions
+
+[.nonterm]
+=== Introduction
+The following terms have non-normative effect, and should be ignored by the ametrical.
+
+=== Anapaest
+
+metrical foot consisting of a short, a long, and a short
+--
+
+=== Sections embedded more than 5 levels
+
+Asciidoctor permits only 5 levels of section embedding (not counting the document title).
+Standards do contain more levels of embedding; ISO/IEC DIR 2 only considers it a problem
+if there are more than 7 levels of embedding. To realise higher levels of embedding,
+prefix a 5-level section title with the attribute `level=`:
+
+[source,asciidoctor]
+--
+====== Clause 5
+
+[level=6]
+===== Clause 6
+
+[level=7]
+====== Clause 7A
+
+[level=7]
+====== Clause 7B
+
+[level=6]
+====== Clause 6B
+
+====== Clause 5B
+--
+
+This generates the following ISO XML:
+
+[source,xml]
+--
+<clause id="_" inline-header="false" obligation="normative">
+	<title>
+		Clause 5 
+	</title>
+	<clause id="_" inline-header="false" obligation="normative">
+		<title>
+			Clause 6 
+		</title>
+		<clause id="_" inline-header="false" obligation="normative">
+			<title>
+				Clause 7A 
+			</title>
+		</clause>
+		<clause id="_" inline-header="false" obligation="normative">
+			<title>
+				Clause 7B 
+			</title>
+		</clause>
+	</clause>
+	<clause id="_" inline-header="false" obligation="normative">
+		<title>
+			Clause 6B 
+		</title>
+	</clause>
+</clause>
+<clause id="_" inline-header="false" obligation="normative">
+	<title>
+		Clause 5B 
+	</title>
+</clause>
+--
+
+=== PlantUML
+
+The http://plantuml.com[PlantUML] diagramming tool is integrated with Asciidoctor
+in this gem, as a literal block with the style attribute `plantuml`:
+
+[source,asciidoctor]
+--
+[plantuml]
+....
+@startuml
+Alice -> Bob: Authentication Request
+Bob --> Alice: Authentication Response
+
+Alice -> Bob: Another authentication Request
+Alice <-- Bob: another authentication Response
+@enduml
+....
+--
+
+The integration runs PlantUML for each such block, generating a PNG image.
+The images are stored in the `plantuml` directory, and linked into the output
+document in place of the PlantUML.
+
+PlantUML needs to be installed by users separately, and accesssible from the
+command line:
+
+* `brew install plantuml` on MacOS.
+* For Linux, link the PlantUML jar file into a command line executable; see
+`.travis.yml` for an example.
+
+If PlantUML is not installed locally, the source PlantUML is incorporated into
+the output document as sourcecode. 
+

data/lib/asciidoctor/standoc/base.rb

@@ -42,6 +42,8 @@ module Asciidoctor
           htmlcoverpage: node.attr("htmlcoverpage"),
           htmlintropage: node.attr("htmlintropage"),
           scripts: node.attr("scripts"),
+          scripts_pdf: node.attr("scripts-pdf"),
+          datauriimage: node.attr("data-uri-image"),
         }
       end
 
@@ -92,8 +94,9 @@ module Asciidoctor
 
       def init_bib_caches(node)
         unless (@no_isobib_cache || @no_isobib)
-          globalname = bibliocache_name(true)
-          localname = bibliocache_name(false) if node.attr("local-cache")
+          globalname = bibliocache_name(true) unless node.attr("local-cache-only")
+          localname = bibliocache_name(false) if node.attr("local-cache") ||
+            node.attr("local-cache-only")
           if node.attr("flush-caches")
             system("rm -f #{globalname}") unless globalname.nil?
             system("rm -f #{localname}") unless localname.nil?
@@ -104,8 +107,9 @@ module Asciidoctor
 
       def init_iev_caches(node)
         unless (@no_isobib_cache || @no_isobib)
-          globalname = ievcache_name(true)
-          localname = ievcache_name(false) if node.attr("local-cache")
+          globalname = ievcache_name(true) unless node.attr("local-cache-only")
+          localname = ievcache_name(false) if node.attr("local-cache") ||
+          node.attr("local-cache-only")
           if node.attr("flush-caches")
             system("rm -f #{globalname}") unless globalname.nil?
             system("rm -f #{localname}") unless localname.nil?

data/lib/asciidoctor/standoc/biblio.rng

@@ -599,6 +599,7 @@
           <value>issued</value>
           <value>transmitted</value>
           <value>copied</value>
+          <value>unchanged</value>
         </choice>
       </attribute>
       <choice>

data/lib/asciidoctor/standoc/cleanup_ref.rb

@@ -116,11 +116,7 @@ module Asciidoctor
         xmldoc.xpath("//bibitem[not(ancestor::bibitem)]").each do |ref|
           isopub = ref.at(ISO_PUBLISHER_XPATH)
           docid = ref.at("./docidentifier[not(@type = 'DOI')]")
-          #date = ref.at("./date[@type = 'published']")
-          #allparts = ref.at("./allparts")
           reference = format_ref(docid.text, isopub)
-          #reference += ":#{date_range(date)}" if date
-          #reference += " (all parts)" if allparts
           @anchors[ref["id"]] = { xref: reference }
         end
       end
@@ -137,19 +133,22 @@ module Asciidoctor
           m = /^(\d+)/.match cl || next
           parts << m[0]
           x["citeas"] = x["citeas"].sub(/60050/, "60050-#{m[0]}")
-          x["bibitemid"] = x["bibitemid"].sub(/IEV/, "IEC60050-#{m[0]}")
+          x["bibitemid"] = "IEC60050-#{m[0]}"
         end
         parts
       end
 
       # replace generic IEV reference with references to all extracted
       # IEV parts
-      def refsIev2iec60050part(parts, iev)
+      def refsIev2iec60050part(xmldoc, parts, iev)
         new_iev = ""
         parts.sort.each do |p|
-          hit = @bibdb&.fetch("IEC 60050-#{p}", nil, keep_year: true)
-          next if hit.nil?
+          hit = @bibdb&.fetch("IEC 60050-#{p}", nil, keep_year: true) || next
           new_iev += hit.to_xml.sub(/ id="[^"]+"/, %{ id="IEC60050-#{p}"})
+          date = hit.dates[0].on.year
+          xmldoc.xpath("//*[@citeas = 'IEC 60050-#{p}:2011']").each do |x|
+            x["citeas"] = x["citeas"].sub(/:2011$/, ":#{date}")
+          end
         end
         iev.replace(new_iev)
       end
@@ -158,7 +157,7 @@ module Asciidoctor
       def iev_cleanup(xmldoc)
         iev = xmldoc.at("//bibitem[docidentifier = 'IEC 60050:2011']") || return
         parts = linksIev2iec60050part(xmldoc)
-        refsIev2iec60050part(parts, iev)
+        refsIev2iec60050part(xmldoc, parts, iev)
       end
     end
   end

data/lib/asciidoctor/standoc/front.rb

@@ -29,10 +29,17 @@ module Asciidoctor
         out.send compname.gsub(/-/, "_"), node.attr(compname),
           **attr_code(number: node.attr("#{compname}-number"),
                       type: node.attr("#{compname}-type"))
+        i = 2
+        while node.attr(compname+"_#{i}") do
+          out.send compname.gsub(/-/, "_"), node.attr(compname+"_#{i}"),
+            **attr_code(number: node.attr("#{compname}-number_#{i}"),
+                        type: node.attr("#{compname}-type_#{i}"))
+          i += 1
+        end
       end
 
       def organization(org, orgname)
-          org.name orgname
+        org.name orgname
       end
 
       def metadata_author(node, xml)

data/lib/asciidoctor/standoc/ref.rb

@@ -44,8 +44,8 @@ module Asciidoctor
       end
 
       def docid(t, code)
-        type, code_stripped = @bibdb&.docid_type(code)
-        t.docidentifier (code_stripped || code), **attr_code(type: type)
+        type, code1 = @bibdb&.docid_type(code) unless /^\[\d+\]$/.match(code)
+        t.docidentifier (code1 || code), **attr_code(type: type)
       end
 
       def isorefmatches(xml, m)
@@ -101,6 +101,7 @@ module Asciidoctor
       end
 
       def fetch_ref(xml, code, year, **opts)
+        return nil if opts[:no_year]
         hit = @bibdb&.fetch(code, year, opts) 
         return nil if hit.nil?
         xml.parent.add_child(hit.to_xml)

data/lib/metanorma/standoc/version.rb

@@ -1,5 +1,5 @@
 module Metanorma
   module Standoc
-    VERSION = "1.0.6".freeze
+    VERSION = "1.0.7".freeze
   end
 end

data/metanorma-standoc.gemspec

@@ -45,4 +45,5 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "metanorma", "~> 0.2.6"
   spec.add_development_dependency "isobib", "~> 0.3.0"
   spec.add_development_dependency "ietfbib", "~> 0.4.0"
+  spec.add_development_dependency "iecbib", "~> 0.1.1"
 end

data/spec/asciidoctor-standoc/base_spec.rb

@@ -52,6 +52,15 @@ RSpec.describe Asciidoctor::Standoc do
       :workgroup: WG
       :workgroup-number: 3
       :workgroup-type: C
+      :technical-committee_2: TC1
+      :technical-committee-number_2: 11
+      :technical-committee-type_2: A1
+      :subcommittee_2: SC1
+      :subcommittee-number_2: 21
+      :subcommittee-type_2: B1
+      :workgroup_2: WG1
+      :workgroup-number_2: 31
+      :workgroup-type_2: C1
       :secretariat: SECRETARIAT
       :copyright-year: 2001
       :docstage: 10
@@ -76,6 +85,7 @@ RSpec.describe Asciidoctor::Standoc do
   </copyright>
   <editorialgroup>
     <technical-committee number="1" type="A">TC</technical-committee>
+    <technical-committee number="11" type="A1">TC1</technical-committee>
   </editorialgroup>
   <ics>
     <code>1</code>

data/spec/asciidoctor-standoc/cleanup_spec.rb

@@ -1,4 +1,5 @@
 require "spec_helper"
+require "iecbib"
 
 RSpec.describe Asciidoctor::Standoc do
   it "removes empty text elements" do
@@ -807,6 +808,11 @@ r = 1 %</stem>
   it "separates IEV citations by top-level clause" do
     system "mv ~/.iev.pstore ~/.iev.pstore1"
     system "rm test.iev.pstore"
+    system "mv ~/.relaton-bib.pstore ~/.relaton-bib.pstore1"
+    system "rm test.relaton.pstore"
+    mock_iecbib_get_iec60050_102_01
+    mock_iecbib_get_iec60050_103_01
+    mock_iev
     expect(strip_guid(Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true))).to be_equivalent_to <<~"OUTPUT"
     #{CACHED_ISOBIB_BLANK_HDR}
 
@@ -836,27 +842,27 @@ r = 1 %</stem>
        <terms id="_" obligation="normative"><title>Terms and definitions</title><term id="_">
          <preferred>Automation1</preferred>
          <termsource status="identical">
-         <origin bibitemid="iev" type="inline" citeas="IEC 60050-103:2011"><locality type="clause"><referenceFrom>103-01-02</referenceFrom></locality></origin>
+         <origin bibitemid="IEC60050-103" type="inline" citeas="IEC 60050-103:2009"><locality type="clause"><referenceFrom>103-01-02</referenceFrom></locality></origin>
        </termsource>
        </term>
        <term id="_">
          <preferred>Automation2</preferred>
          <termsource status="identical">
-         <origin bibitemid="iev" type="inline" citeas="IEC 60050-102:2011"><locality type="clause"><referenceFrom>102-01-02</referenceFrom></locality></origin>
+         <origin bibitemid="IEC60050-102" type="inline" citeas="IEC 60050-102:2007"><locality type="clause"><referenceFrom>102-01-02</referenceFrom></locality></origin>
        </termsource>
        </term>
        <term id="_">
          <preferred>Automation3</preferred>
          <termsource status="identical">
-         <origin bibitemid="iev" type="inline" citeas="IEC 60050-103:2011"><locality type="clause"><referenceFrom>103-01-02</referenceFrom></locality></origin>
+         <origin bibitemid="IEC60050-103" type="inline" citeas="IEC 60050-103:2009"><locality type="clause"><referenceFrom>103-01-02</referenceFrom></locality></origin>
        </termsource>
        </term></terms></sections><bibliography><references id="_" obligation="informative">
          <title>Normative References</title>
          <bibitem type="international-standard" id="IEC60050-102">
          <title format="text/plain" language="en" script="Latn">International Electrotechnical Vocabulary</title>
-         <docidentifier>IEC 60050-102:2011</docidentifier>
+         <docidentifier>IEC 60050-102:2007</docidentifier>
          <date type="published">
-           <on>2011</on>
+           <on>2007</on>
          </date>
          <contributor>
            <role type="publisher"/>
@@ -884,9 +890,9 @@ r = 1 %</stem>
          </copyright>
        </bibitem><bibitem type="international-standard" id="IEC60050-103">
          <title format="text/plain" language="en" script="Latn">International Electrotechnical Vocabulary</title>
-         <docidentifier>IEC 60050-103:2011</docidentifier>
+         <docidentifier>IEC 60050-103:2009</docidentifier>
          <date type="published">
-           <on>2011</on>
+           <on>2009</on>
          </date>
          <contributor>
            <role type="publisher"/>
@@ -917,5 +923,126 @@ r = 1 %</stem>
        </standard-document>
   OUTPUT
   system "mv ~/.iev.pstore1 ~/.iev.pstore"
+      system "rm ~/.relaton-bib.pstore"
+    system "mv ~/.relaton-bib.pstore1 ~/.relaton-bib.pstore"
   end
+
+  private
+
+    def mock_iecbib_get_iec60050_103_01
+      expect(Iecbib::IecBibliography).to receive(:get).with("IEC 60050-103", nil, {keep_year: true}) do
+      IsoBibItem.from_xml(<<~"OUTPUT")
+      <bibitem type="international-standard" id="IEC60050-103">
+         <title format="text/plain" language="en" script="Latn">International Electrotechnical Vocabulary</title>
+         <docidentifier>IEC 60050-103:2009</docidentifier>
+         <date type="published">
+           <on>2009</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Electrotechnical Commission</name>
+             <abbreviation>IEC</abbreviation>
+             <uri>www.iec.ch</uri>
+           </organization>
+         </contributor>
+         <language>en</language>
+         <language>fr</language>
+         <script>Latn</script>
+         <status>
+           <stage>60</stage>
+         </status>
+         <copyright>
+           <from>2018</from>
+           <owner>
+             <organization>
+               <name>International Electrotechnical Commission</name>
+               <abbreviation>IEC</abbreviation>
+               <uri>www.iec.ch</uri>
+             </organization>
+           </owner>
+         </copyright>
+       </bibitem>
+OUTPUT
+    end
+end
+
+    def mock_iecbib_get_iec60050_102_01
+      expect(Iecbib::IecBibliography).to receive(:get).with("IEC 60050-102", nil, {keep_year: true}) do
+      IsoBibItem.from_xml(<<~"OUTPUT")
+      <bibitem type="international-standard" id="IEC60050-102">
+         <title format="text/plain" language="en" script="Latn">International Electrotechnical Vocabulary</title>
+         <docidentifier>IEC 60050-102:2007</docidentifier>
+         <date type="published">
+           <on>2007</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Electrotechnical Commission</name>
+             <abbreviation>IEC</abbreviation>
+             <uri>www.iec.ch</uri>
+           </organization>
+         </contributor>
+         <language>en</language>
+         <language>fr</language>
+         <script>Latn</script>
+         <status>
+           <stage>60</stage>
+         </status>
+         <copyright>
+           <from>2018</from>
+           <owner>
+             <organization>
+               <name>International Electrotechnical Commission</name>
+               <abbreviation>IEC</abbreviation>
+               <uri>www.iec.ch</uri>
+             </organization>
+           </owner>
+         </copyright>
+       </bibitem>
+OUTPUT
+    end
+end
+
+    def mock_iev
+      expect(Iecbib::IecBibliography).to receive(:get).with("IEV", nil, {}) do
+      IsoBibItem.from_xml(<<~"OUTPUT")
+      <bibitem type="international-standard" id="IEC60050:2001">
+         <title format="text/plain" language="en" script="Latn">International Electrotechnical Vocabulary</title>
+         <docidentifier>IEC 60050:2011</docidentifier>
+         <date type="published">
+           <on>2007</on>
+         </date>
+         <contributor>
+           <role type="publisher"/>
+           <organization>
+             <name>International Electrotechnical Commission</name>
+             <abbreviation>IEC</abbreviation>
+             <uri>www.iec.ch</uri>
+           </organization>
+         </contributor>
+         <language>en</language>
+         <language>fr</language>
+         <script>Latn</script>
+         <status>
+           <stage>60</stage>
+         </status>
+         <copyright>
+           <from>2018</from>
+           <owner>
+             <organization>
+               <name>International Electrotechnical Commission</name>
+               <abbreviation>IEC</abbreviation>
+               <uri>www.iec.ch</uri>
+             </organization>
+           </owner>
+         </copyright>
+       </bibitem>
+OUTPUT
+    end.at_least :once
+end
+
+
+
 end

data/spec/asciidoctor-standoc/isobib_cache_spec.rb

@@ -119,6 +119,25 @@ EOS
     system "mv ~/.iev.pstore1 ~/.iev.pstore"
   end
 
+  it "does not fetch references for ISO references in preparation" do
+    system "mv ~/.relaton-bib.pstore ~/.relaton-bib.pstore1"
+    system "rm -f test.relaton.pstore"
+    Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)
+      #{CACHED_ISOBIB_BLANK_HDR}
+      [bibliography]
+      == Normative References
+
+      * [[[iso123,ISO 123:--]]] footnote:[The standard is in press] _Standard_
+    INPUT
+    expect(File.exist?("#{Dir.home}/.relaton-bib.pstore")).to be true
+    db = Relaton::Db.new "#{Dir.home}/.relaton-bib.pstore", nil
+    entry = db.load_entry("ISO(ISO 123:--)")
+    expect(entry).to be nil
+
+    system "rm ~/.relaton-bib.pstore"
+    system "mv ~/.relaton-bib.pstore1 ~/.relaton-bib.pstore"
+  end
+
   it "activates global cache" do
     system "mv ~/.relaton-bib.pstore ~/.relaton-bib.pstore1"
     system "rm -f test.relaton.pstore"
@@ -167,6 +186,26 @@ EOS
     system "mv ~/.relaton-bib.pstore1 ~/.relaton-bib.pstore"
   end
 
+  it "activates only local cache" do
+    system "mv ~/.relaton-bib.pstore ~/.relaton-bib.pstore1"
+    system "rm -f test.relaton.pstore"
+    mock_isobib_get_123
+    Asciidoctor.convert(<<~"INPUT", backend: :standoc, header_footer: true)
+      #{LOCAL_ONLY_CACHED_ISOBIB_BLANK_HDR}
+      [bibliography]
+      == Normative References
+
+      * [[[iso123,ISO 123:2001]]] _Standard_
+    INPUT
+    expect(File.exist?("#{Dir.home}/.relaton-bib.pstore")).to be false
+    expect(File.exist?("test.relaton.pstore")).to be true
+
+    db = Relaton::Db.new "test.relaton.pstore", nil
+    entry = db.load_entry("ISO(ISO 123:2001)")
+    expect(entry).to_not be nil
+
+    system "mv ~/.relaton-bib.pstore1 ~/.relaton-bib.pstore"
+  end
 
   it "fetches uncached references" do
     system "mv ~/.relaton-bib.pstore ~/.relaton-bib.pstore1"

data/spec/asciidoctor-standoc/validate_spec.rb

@@ -1,4 +1,5 @@
 require "spec_helper"
+require "iecbib"
 
 RSpec.describe Asciidoctor::Standoc do
 

data/spec/spec_helper.rb

@@ -76,6 +76,16 @@ LOCAL_CACHED_ISOBIB_BLANK_HDR = <<~"HDR"
 
 HDR
 
+LOCAL_ONLY_CACHED_ISOBIB_BLANK_HDR = <<~"HDR"
+      = Document title
+      Author
+      :docfile: test.adoc
+      :nodoc:
+      :novalid:
+      :local-cache-only:
+
+HDR
+
 VALIDATING_BLANK_HDR = <<~"HDR"
       = Document title
       Author
@@ -189,10 +199,10 @@ end
 
 def mock_open_uri(code)
   expect(OpenURI).to receive(:open_uri).and_wrap_original do |m, *args|
-    expect(args[0]).to be_instance_of String
+    # expect(args[0]).to be_instance_of String
     file = "spec/examples/#{code.tr('-', '_')}.html"
     File.write file, m.call(*args).read unless File.exist? file
     File.read file
-  end
+  end.at_least :once
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-standoc
 version: !ruby/object:Gem::Version
-  version: 1.0.6
+  version: 1.0.7
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-15 00:00:00.000000000 Z
+date: 2018-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -262,6 +262,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.4.0
+- !ruby/object:Gem::Dependency
+  name: iecbib
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 description: |
   metanorma-standoc realises standards following the Metanorma standoc model