metanorma-iec 1.2.13 → 1.3.0

data/lib/metanorma/iec/version.rb

@@ -1,6 +1,6 @@
 module Metanorma
   module Iec
-    VERSION = "1.2.13"
+    VERSION = "1.3.0".freeze
   end
 end
 

data/metanorma-iec.gemspec

@@ -1,6 +1,6 @@
 # coding: utf-8
 
-lib = File.expand_path("../lib", __FILE__)
+lib = File.expand_path("lib", __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require "metanorma/iec/version"
 
@@ -27,18 +27,18 @@ Gem::Specification.new do |spec|
   spec.test_files    = `git ls-files -- {spec}/*`.split("\n")
   spec.required_ruby_version = Gem::Requirement.new(">= 2.4.0")
 
+  spec.add_dependency "metanorma-iso", "~> 1.8.0"
   spec.add_dependency "ruby-jing"
-  spec.add_dependency "metanorma-iso", "~> 1.7.0"
 
   spec.add_development_dependency "byebug"
-  spec.add_development_dependency "sassc", "2.4.0"
   spec.add_development_dependency "equivalent-xml", "~> 0.6"
   spec.add_development_dependency "guard", "~> 2.14"
   spec.add_development_dependency "guard-rspec", "~> 4.7"
-  spec.add_development_dependency "rake", "~> 12.0"
+  spec.add_development_dependency "iev", "~> 0.2.0"
+  spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "rspec", "~> 3.6"
-  spec.add_development_dependency "rubocop", "= 0.54.0"
+  spec.add_development_dependency "rubocop", "~> 1.5.2"
+  spec.add_development_dependency "sassc", "2.4.0"
   spec.add_development_dependency "simplecov", "~> 0.15"
   spec.add_development_dependency "timecop", "~> 0.9"
-  spec.add_development_dependency "iev", "~> 0.2.0"
 end

data/spec/{asciidoctor-iec → asciidoctor}/validate_spec.rb

@@ -15,41 +15,42 @@ RSpec.describe Asciidoctor::Iec do
 
     it "generates error file" do
       expect do
+        mock_pdf
         Metanorma::Compile
           .new
-          .compile("spec/assets/xref_error.adoc", type: "iec", :"agree-to-terms" => true)
+          .compile("spec/assets/xref_error.adoc", type: "iec", no_install_fonts: true)
       end.to(change { File.exist?("spec/assets/xref_error.err") }
               .from(false).to(true))
     end
   end
 
-it "Warns of illegal doctype" do
+  it "Warns of illegal doctype" do
     FileUtils.rm_f "test.err"
     Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true)
-  = Document title
-  Author
-  :docfile: test.adoc
-  :nodoc:
-  :no-isobib:
-  :doctype: pizza
+      = Document title
+      Author
+      :docfile: test.adoc
+      :nodoc:
+      :no-isobib:
+      :doctype: pizza
 
-  text
-  INPUT
+      text
+    INPUT
     expect(File.read("test.err")).to include "pizza is not a recognised document type"
-end
+  end
 
-it "Warns of illegal function" do
+  it "Warns of illegal function" do
     FileUtils.rm_f "test.err"
     Asciidoctor.convert(<<~"INPUT", backend: :iec, header_footer: true)
-  = Document title
-  Author
-  :docfile: test.adoc
-  :nodoc:
-  :no-isobib:
-  :function: pizza
+      = Document title
+      Author
+      :docfile: test.adoc
+      :nodoc:
+      :no-isobib:
+      :function: pizza
 
-  text
-  INPUT
+      text
+    INPUT
     expect(File.read("test.err")).to include "pizza is not a recognised document function"
-end
+  end
 end

data/spec/isodoc/postproc_spec.rb

@@ -74,7 +74,7 @@ RSpec.describe IsoDoc do
   it "generates HTML output docs with null configuration from file" do
     FileUtils.rm_f "spec/assets/iso.doc"
     FileUtils.rm_f "spec/assets/iso.html"
-    IsoDoc::Iec::HtmlConvert.new({wordstylesheet: "spec/assets/word.css", htmlstylesheet: "spec/assets/html.css"}).convert("spec/assets/iso.xml", nil, false)
+    IsoDoc::Iec::HtmlConvert.new({wordstylesheet: "word.css", htmlstylesheet: "html.css"}).convert("spec/assets/iso.xml", nil, false)
     expect(File.exist?("spec/assets/iso.html")).to be true
     html = File.read("spec/assets/iso.html", encoding: "UTF-8")
     expect(html).to match(/<style>/)
@@ -84,7 +84,7 @@ RSpec.describe IsoDoc do
 
   it "generates Word output docs with null configuration from file" do
     FileUtils.rm_f "spec/assets/iso.doc"
-    IsoDoc::Iec::WordConvert.new({wordstylesheet: "spec/assets/word.css", htmlstylesheet: "spec/assets/html.css"}).convert("spec/assets/iso.xml", nil, false)
+    IsoDoc::Iec::WordConvert.new({wordstylesheet: "word.css", htmlstylesheet: "html.css"}).convert("spec/assets/iso.xml", nil, false)
     expect(File.exist?("spec/assets/iso.doc")).to be true
     word = File.read("spec/assets/iso.doc", encoding: "UTF-8")
     expect(word).to match(/<w:WordDocument>/)
@@ -134,24 +134,6 @@ RSpec.describe IsoDoc do
     OUTPUT
   end
 
-  it "populates Word header" do
-    FileUtils.rm_f "test.doc"
-    IsoDoc::Iec::WordConvert.new({wordstylesheet: "spec/assets/word.css", htmlstylesheet: "spec/assets/html.css", header: "spec/assets/header.html"}).convert("test", <<~"INPUT", false)
-        <iso-standard xmlns="http://riboseinc.com/isoxml">
-               <bibdata type="article">
-                        <docidentifier>
-           <project-number part="1">1000</project-number>
-         </docidentifier>
-        </bibdata>
-</iso-standard>
-
-    INPUT
-    word = File.read("test.doc", encoding: "UTF-8").sub(%r{^.*Content-Location: file:///C:/Doc/test_files/header.html}m, "Content-Location: file:///C:/Doc/test_files/header.html").
-      sub(/------=_NextPart.*$/m, "")
-    #expect(word).to include(%{Content-Location: file:///C:/Doc/test_files/header.html\nContent-Transfer-Encoding: base64\nContent-Type: text/html charset="utf-8" })
-    expect(word).to include(%{Content-Location: file:///C:/Doc/test_files/header.html})
-  end
-
   it "processes IsoXML terms for HTML" do
     FileUtils.rm_f "test.html"
     FileUtils.rm_f "test.doc"

data/spec/spec_helper.rb

@@ -261,6 +261,12 @@ def stub_fetch_ref(**opts)
   end.at_least :once
 end
 
+def mock_pdf
+  allow(::Mn2pdf).to receive(:convert) do |url, output, c, d|
+    FileUtils.cp(url.gsub(/"/, ""), output.gsub(/"/, ""))
+  end
+end
+
 private
 
 def get_xml(search, code, opts)

metadata

@@ -1,51 +1,37 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-iec
 version: !ruby/object:Gem::Version
-  version: 1.2.13
+  version: 1.3.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-01-25 00:00:00.000000000 Z
+date: 2021-04-12 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: ruby-jing
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
 - !ruby/object:Gem::Dependency
   name: metanorma-iso
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.7.0
+        version: 1.8.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.7.0
+        version: 1.8.0
 - !ruby/object:Gem::Dependency
-  name: byebug
+  name: ruby-jing
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-  type: :development
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -53,19 +39,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: sassc
+  name: byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: equivalent-xml
   requirement: !ruby/object:Gem::Requirement
@@ -108,20 +94,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: iev
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -140,58 +140,58 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.54.0
+        version: 1.5.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.54.0
+        version: 1.5.2
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: sassc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: 2.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '0.15'
+        version: 2.4.0
 - !ruby/object:Gem::Dependency
-  name: timecop
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.15'
 - !ruby/object:Gem::Dependency
-  name: iev
+  name: timecop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: '0.9'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: '0.9'
 description: |
   metanorma-iec lets you write IEC standards in AsciiDoc syntax.
 
@@ -252,14 +252,14 @@ files:
 - lib/metanorma/iec/processor.rb
 - lib/metanorma/iec/version.rb
 - metanorma-iec.gemspec
-- spec/asciidoctor-iec/base_spec.rb
-- spec/asciidoctor-iec/blocks_spec.rb
-- spec/asciidoctor-iec/cleanup_spec.rb
-- spec/asciidoctor-iec/iev_spec.rb
-- spec/asciidoctor-iec/inline_spec.rb
-- spec/asciidoctor-iec/lists_spec.rb
-- spec/asciidoctor-iec/section_spec.rb
-- spec/asciidoctor-iec/validate_spec.rb
+- spec/asciidoctor/base_spec.rb
+- spec/asciidoctor/blocks_spec.rb
+- spec/asciidoctor/cleanup_spec.rb
+- spec/asciidoctor/iev_spec.rb
+- spec/asciidoctor/inline_spec.rb
+- spec/asciidoctor/lists_spec.rb
+- spec/asciidoctor/section_spec.rb
+- spec/asciidoctor/validate_spec.rb
 - spec/assets/header.html
 - spec/assets/html.css
 - spec/assets/iso.xml
@@ -267,15 +267,6 @@ files:
 - spec/assets/word.css
 - spec/assets/wordintro.html
 - spec/assets/xref_error.adoc
-- spec/examples/rice.adoc
-- spec/examples/rice.doc
-- spec/examples/rice.html
-- spec/examples/rice.xml
-- spec/examples/rice_img/rice_image1.png
-- spec/examples/rice_img/rice_image2.png
-- spec/examples/rice_img/rice_image3_1.png
-- spec/examples/rice_img/rice_image3_2.png
-- spec/examples/rice_img/rice_image3_3.png
 - spec/isodoc/blocks_spec.rb
 - spec/isodoc/i18n_spec.rb
 - spec/isodoc/iev_spec.rb
@@ -307,7 +298,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
 summary: metanorma-iec lets you write IEC standards in AsciiDoc.

data/spec/examples/rice.adoc

@@ -1,723 +0,0 @@
-= Rice model
-:docnumber: 17301
-:tc-docnumber: 17301
-:ref-docnumber: ISO 17301-1:2016(E)
-:partnumber: 1
-:edition: 2
-:revdate: 2016-05-01
-:copyright-year: 2016
-:language: en
-:unchangeddate: 2025
-:title-intro-en: Cereals and pulses
-:title-main-en: Specifications and test methods
-:title-part-en: Rice
-:title-intro-fr: Céréales et légumineuses
-:title-main-fr: Spécification et méthodes d'essai
-:title-part-fr: Riz
-:doctype: international-standard
-:docstage: 30
-:docsubstage: 92
-:draft: 
-:technical-committee-number: 34
-:technical-committee: Food products
-:subcommittee-number: 4
-:subcommittee: Cereals and pulses
-:workgroup-number: 3
-:workgroup: Rice Group
-:toc:
-:sectnumlevels: 7
-:stem:
-:xrefstyle: short
-:appendix-caption: Annex
-:appendix-refsig: Annex
-:section-refsig: Clause
-:table-caption: Table
-:example-caption: Figure
-:local-cache:
-:data-uri-image:
-
-[[foreword]]
-.Foreword 
-International Standard IEC {docnumber} has been prepared by subcommittee {subcommittee-number}: {subcommittee}, of IEC technical committee {technical-committee-number}:{technical-committee}.
-
-This second edition cancels and replaces the first edition published in 2009. This edition constitutes a technical revision.
-
-This edition includes the following significant technical changes with respect to the previous edition:
-
-. updated normative references; 
-. deletion of 4.3. 
-
-The text of this International Standard is based on the following documents:
-
-|===
-|FDIS	|Report on voting
-
-|XX/XX/FDIS	|XX/XX/RVD
-|===
-
-Full information on the voting for the approval of this International Standard can be found in the report on voting indicated in the above table.
-
-This document has been drafted in accordance with the ISO/IEC Directives, Part 2.
-
-The committee has decided that the contents of this document will remain unchanged until the stability date indicated on the IEC website under "http://webstore.iec.ch" in the data related to the specific document. At this date, the document will be 
-
-*	reconfirmed,
-*	withdrawn,
-*	replaced by a revised edition, or
-*	amended.
-
-[WARNING]
-====
-The National Committees are requested to note that for this document the stability date is {unchangeddate}.
-
-THIS TEXT IS INCLUDED FOR THE INFORMATION OF THE NATIONAL COMMITTEES AND WILL BE DELETED AT THE PUBLICATION STAGE.
-====
-
-[reviewer=ISO,date=2017-01-01,from=foreword,to=foreword]
-****
-A Foreword shall appear in each document. The generic text is shown here. It does not contain requirements, recommendations or permissions.
-
-For further information on the Foreword, see *ISO/IEC Directives, Part 2, 2016, Clause 12.*
-****
-
-:sectnums!:
-== Introduction 
-
-This document was developed in response to worldwide demand for minimum specifications for rice traded internationally, since most commercial bulks of grain, which have not been screened or aspirated, contain a proportion of other grains, weed seeds, chaff, straw, stones, sand, etc. The vegetable materials can have physical and biological properties which differ from those of the main constituent and can therefore affect the storage behaviour. 
-
-Rice is a permanent host to a considerable microflora; most of these microorganisms are cosmopolitan, the majority are innocuous, but some produce harmful by-products. Microflora communities present on freshly harvested rice include many types of bacteria, moulds and yeasts. While the rice is ripening and its moisture content is falling, the number of field microorganisms, mainly bacteria, diminishes. When the rice is harvested, it is invaded by storage microorganisms and the field microflora gradually dies out. If the mass fraction of moisture (formerly expressed as moisture content) is less than 18 %, the microflora does not multiply, whereas above 18 % it does so rapidly. Thus, at harvest, the qualitative and the quantitative composition of the microflora depends more upon ecological factors than upon the variety of the rice. During transport and storage, additions to the microfloral population occur. Microorganisms on the rice at harvest tend to die out during storage and are replaced by microorganisms adapted to storage conditions. 
-
-Storage losses have been estimated as being an average of 5 %, and as much as 30 %, especially in countries with climates favourable to the rapid development of agents of deterioration and where storage techniques are poorly developed, such as developing countries in the damp tropics. The magnitude of these figures highlights the need to promote throughout the world a rapid improvement in techniques of conservation. 
-
-
-The International Organization for Standardization (ISO) draws attention to the fact that it is claimed that compliance with this document may involve the use of a patent concerning sample dividers given in <<AnnexA>> and shown in <<figureA-1>>. 
-
-ISO takes no position concerning the evidence, validity and scope of this patent right. 
-
-The holder of this patent right has assured ISO that he/she is willing to negotiate licences under reasonable and non-discriminatory terms and conditions with applicants throughout the world. In this respect, the statement of the holder of this patent right is registered with ISO. Information may be obtained from: 
-
-[align=left]
-Vache Equipment +
-Fictitious +
-World +
-gehf@vacheequipment.fic
-
-Attention is drawn to the possibility that some of the elements of this document may be the subject of patent rights other than those identified above. ISO shall not be held responsible for identifying any or all such patent rights.
-
-:sectnums:
-== Scope 
-
-This document specifies minimum requirements and test methods for rice (_Oryza sativa L._). 
-
-It is applicable to husked rice, husked parboiled rice, milled rice and milled parboiled rice, suitable for human consumption, directly or after reconditioning. 
-
-It is not applicable to cooked rice products. 
-
-[bibliography]
-== Normative References 
-
-The following documents are referred to in the text in such a way that some or all of their content constitutes requirements of this document. For dated references, only the edition cited applies. For undated references, the latest edition of the referenced document (including any amendments) applies. 
-
-* [[[ISO712,ISO 712]]], _Cereals and cereal products -- Determination of moisture content -- Reference method_
-
-* [[[ISO6646, ISO 6646]]], _Rice -- Determination of the potential milling yield from paddy and from husked rice_ 
-
-* [[[ISO8351-1,ISO 8351-1:1994]]], _Packaging -- Method of specification for sacks -- Part 1: Paper sacks_
-
-* [[[ISO8351-2,ISO 8351-2]]], _Packaging -- Method of specification for sacks -- Part 2: Sacks made from thermoplastic flexible film_
-
-* [[[ISO16634,ISO 16634:--]]] footnote:[Under preparation. (Stage at the time of publication ISO/DIS 16634)], _Cereals, pulses, milled cereal products, oilseeds and animal feeding stuffs -- Determination of the total nitrogen content by combustion according to the Dumas principle and calculation of the crude protein content_ 
-
-* [[[ISO20483,ISO 20483:2013]]], _Cereals and pulses -- Determination of the nitrogen content and calculation of the crude protein content -- Kjeldahl method_
-
-* [[[ISO24333,ISO 24333:2009]]], _Cereals and cereal products -- Sampling_
-
-== Terms and Definitions 
-
-For the purposes of this document, the following terms and definitions apply. 
-
-ISO and IEC maintain terminological databases for use in standardization at the following addresses: 
-
-* ISO Online browsing platform: available at http://www.iso.org/obp
-* IEC Electropedia: available at http://www.electropedia.org
-
-:sectnums!:
-[[paddy]]
-=== paddy 
-alt:[paddy rice]
-alt:[rough rice]
-
-rice retaining its husk after threshing 
-
-[.source]
-<<ISO7301,clause 3.1>>
-
-[[husked_rice]]
-=== husked rice 
-deprecated:[cargo rice]
-
-_paddy_ (<<paddy>>) from which the husk only has been removed 
-
-[.source]
-<<ISO7301,clause 3.2>>, The term "cargo rice" is shown as deprecated, and Note 1 to entry is not included here
-
-=== milled rice 
-alt:[white rice]
-
-_husked rice_ (<<husked_rice>>) from which almost all of the bran and embryo have been removed by milling 
-
-[.source]
-<<ISO7301,clause 3.3>>
-
-=== parboiled rice 
-
-rice whose starch has been fully gelatinized by soaking _paddy_ (<<paddy>>) rice or _husked rice_ (<<husked_rice>>) in water followed by a heat treatment and a drying process 
-
-=== waxy rice 
-variety of rice whose kernels have a white and opaque appearance 
-
-alt:[EM]
-domain:[rice]
-
-organic and inorganic components other than whole or broken kernels 
-
-[example]
-Foreign seeds, husks, bran, sand, dust. 
-
-[[HDK]]
-=== HDK 
-alt:[heat-damaged kernel]
-
-kernel, whole or broken, which has changed its normal colour as a result of heating 
-
-NOTE: This category includes whole or broken kernels that are yellow due to alteration. Parboiled rice in a batch of non-parboiled rice is also included in this category. 
-
-=== damaged kernel 
-kernel, whole or broken, showing obvious deterioration due to moisture, pests, disease or other causes, but excluding _HDK_ (<<HDK>>)
-
-=== immature kernel 
-alt:[unripe kernel]
-
-kernel, whole or broken, which is unripe and/or underdeveloped 
-
-=== husked rice yield 
-amount of husked rice obtained from paddy 
-
-// all terms and defs references are dated
-[.source]
-<<ISO6646,clause 3.1>>
-
-=== nitrogen content 
-quantity of nitrogen determined after application of the procedure described 
-
-NOTE: It is expressed as a mass fraction of dry product, as a percentage. 
-
-[.source]
-<<ISO20483,clause 3.1>>
-
-=== crude protein content 
-quantity of crude protein obtained from the nitrogen content as determined by applying the specified method, calculated by multiplying this content by an appropriate factor depending on the type of cereal or pulse 
-
-NOTE: It is expressed as a mass fraction of dry product, as a percentage. 
-
-[.source]
-<<ISO20483,clause 3.1>>
-
-[[gelatinization]]
-=== gelatinization 
-hydration process conferring the jelly-like state typical of the coagulated colloids, which are named gels, on kernels 
-
-NOTE: See <<figureC-1>>. 
-
-[.source]
-<<ISO14864,clause 3.1>>
-
-[[gel_state]]
-=== gel state 
-condition reached as a consequence of _gelatinization_ (<<gelatinization>>), when the kernel is fully transparent and absolutely free from whitish and opaque granules after being pressed between two glass sheets 
-
-[.source]
-<<ISO14864,clause 3.1>>
-
-=== gelatinization time 
-stem:[t_90]
-
-time necessary for 90 % of the kernels to pass from their natural state to the _gel state_ (<<gel_state>>) 
-
-[.source]
-<<ISO14864,clause 3.1>>
-
-:sectnums:
-== Specifications 
-
-=== General, organoleptic and health characteristics 
-
-Kernels of rice, whether parboiled, husked or milled, and whether whole or broken, shall be sound, clean and free from foreign odours or odour which indicates deterioration. 
-
-The levels of additives and pesticide residues and other contaminants shall not exceed the maximum limits permitted in the country of destination. 
-
-The presence of living insects which are visible to the naked eye is not permitted. This should be determined before separating the bulk sample into test samples.
-
-=== Physical and chemical characteristics 
-
-==== {blank}
-
-The mass fraction of moisture, determined in accordance with <<ISO712>>, using an oven complying with the requirements of <<IEC61010-2>>, shall not be greater than 15 %.footnote:[Formerly denoted as 15 % (m/m).] 
-
-The mass fraction of extraneous matter and defective kernels in husked and milled rice, whether or not parboiled, determined in accordance with <<AnnexA>>, shall not be greater than the values specified in <<table1>>. 
-
-NOTE: Lower mass fractions of moisture are sometimes needed for certain destinations depending on the climate, duration of transport and storage. For further details, see <<ISO6322-1>>, <<ISO6322-2>> and <<ISO6322-3>>.
-
-==== {blank}
-
-The defect tolerance for the categories considered, and determined in accordance with the method given in <<AnnexA>>, shall not exceed the limits given in <<table1>>. 
-
-[#table1]
-[cols="<,^,^,^,^",options="header,footer",headerrows=2]
-.Maximum permissible mass fraction of defects
-|===
-.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
-// not rendered list here
-| Extraneous matter: inorganic footnote:[Inorganic extraneous matter includes stones, sand, dust, etc.] | 0,5 | 0,5 | 0,5 | 0,5
-| Paddy | 2,5 | 0,3 | 2,5 | 0,3 
-| Husked rice, non-parboiled | Not applicable | 1,0 | 1,0 | 1,0 
-| Milled rice, non-parboiled | 1,0 | Not applicable | 1,0 | 1,0 
-| Husked rice, parboiled | 1,0 | 1,0 | Not applicable | 1,0 
-| Milled rice, parboiled | 1,0 | 1,0 | 1,0 | Not applicable 
-| Chips | 0,1 | 0,1 | 0,1 | 0,1 
-| HDK | 2,0 footnoteref:[defectsmass,The maximum permissible mass fraction of defects shall be determined with respect to the mass fraction obtained after milling.] | 2,0 | 2,0 footnoteref:[defectsmass] | 2,0 
-| Damaged kernels | 4,0 | 3,0 | 4,0 | 3,0 
-| Immature and/or malformed kernels | 8,0 | 2,0 | 8,0 | 2,0 
-| Chalky kernels | 5,0 footnoteref:[defectsmass] | 5,0 | Not applicable | Not applicable 
-| Red kernels and red-streaked kernels | 12,0 | 12,0 | 12,0 footnoteref:[defectsmass] | 12,0 
-| Partly gelatinized kernels | Not applicable | Not applicable | 11,0 footnoteref:[defectsmass] | 11,0 
-| Pecks | Not applicable | Not applicable | 4,0 | 2,0 
-| Waxy rice | 1,0 footnoteref:[defectsmass] | 1,0 | 1,0 footnoteref:[defectsmass] | 1,0
-
-5+a| Live insects shall not be present. Dead insects shall be included in extraneous matter.
-|===
-
-NOTE: This table is based on <<ISO7301,table 1>>.
-
-NOTE: Some commercial contracts require information in addition to that provided in this table.
-
-NOTE: Only full red husked (cargo) rice is considered in this table.
-
-
-[[clause5]]
-== Sampling 
-Sampling shall be carried out in accordance with <<ISO24333,clause 5>>
-
-== Test methods 
-
-=== Moisture content 
-
-Determine the mass fraction of moisture in accordance with the method specified in <<ISO712>>.
-
-=== Waxy rice content 
-
-Determine the mass fraction of waxy rice. <<AnnexB>> gives an example of a suitable method. 
-
-=== Nitrogen content and crude protein content 
-
-Determine the nitrogen content and crude protein content in accordance with either <<ISO16634,clause 9>>, or <<ISO20483>>. For details on the determination of protein content using the Kjeldahl method, see Reference <<ref12>> in the Bibliography. For details concerning the use of the Dumas method, see References <<ref10>> and <<ref16>>. 
-
-// can't join two bibliographic localities with "and" currently
-Calculate the crude protein content of the dry product by multiplying the value of the nitrogen content by the conversion factor specified in <<ISO20483,annex C>> and Table C.1, that is adapted to the type of cereals or pulses <<ref13,fn>><<ref14,fn>> and to their use.
-
-=== Gelatinization time 
-
-Determine the gelatinization time, stem:[t_90], for rice kernels during cooking. An example of a typical curve is given in <<figureC-1>>. Three typical stages of gelatinization are shown in <<figureC-2>>. 
-
-Report the results as specified in <<clause7>>.
-
-=== Husked rice yield 
-
-==== Determination 
-
-CAUTION: Only use paddy or parboiled rice for the determination of husked rice yield. 
-
-Determine the husked rice yield in accordance with <<ISO6646>>.
-
-==== Precision 
-
-===== Interlaboratory test 
-
-The results of an interlaboratory test are given in <<AnnexD>> for information 
-
-===== Repeatability 
-
-The absolute difference between two independent single test results, obtained using the same method on identical test material in the same laboratory by the same operator using the same equipment within a short interval of time, shall not exceed the arithmetic mean of the values for stem:[r] obtained from the interlaboratory study for husked rice in more than 5 % of cases: 
-
-[stem]
-++++
-r = 1 % 
-++++
-
-where 
-
-stem:[r]:: is the repeatability limit. 
-
-===== Reproducibility 
-
-The absolute difference between two single test results, obtained using the same method on identical test material in different laboratories by different operators using different equipment, shall not exceed the arithmetic mean of the values for stem:[R] obtained from the interlaboratory study in more than 5 % of cases: 
-
-[stem]
-++++
-R = 3 % 
-++++
-
-where 
-
-stem:[R]:: is the reproducibility limit. 
-
-[[clause7]]
-== Test report 
-
-For each test method, the test report shall specify the following: 
-
-[loweralpha]
-. all information necessary for the complete identification of the sample; 
-. a reference to this document (i.e. ISO {docnumber}-{partnumber}); 
-. the sampling method used; 
-. the test method used; 
-. the test result(s) obtained or, if the repeatability has been checked, the final quoted result obtained; 
-. all operating details not specified in this document, or regarded as optional, together with details of any incidents which may have influenced the test result(s); 
-. any unusual features (anomalies) observed during the test; 
-. the date of the test. 
-
-== Packaging 
-
-The packaging shall not transmit any odour or flavour to the product and shall not contain substances which may damage the product or constitute a health risk. 
-
-If bags are used, they shall comply with the requirements of <<ISO8351-1,clause 9>>, or <<ISO8351-2>>, as appropriate. 
-
-== Marking 
-
-The packages shall be marked or labelled as required by the country of destination. 
-
-[[AnnexA]]
-[appendix,obligation=normative]
-== Determination of defects
-
-=== Principle 
-
-Extraneous matter, broken kernels, damaged kernels and other kinds of rice are separated manually according to the following types: husked rice, milled rice, husked parboiled rice and milled parboiled rice. Each type is then weighed. 
-
-=== Apparatus 
-
-The usual laboratory apparatus and, in particular, the following. 
-
-[%inline-header]
-[[AnnexA-2-1]]
-==== Sample divider, 
-
-consisting of a conical sample divider or multiple-slot sample divider with a distribution system, e.g. "Split-it-right" sample divider, such as that shown in <<figureA-1>>. 
-
-[%inline-header]
-==== Sieve, 
-
-with round perforations of diameter 1,4 mm. 
-
-[%inline-header]
-==== Tweezers. 
-
-[%inline-header]
-==== Scalpel. 
-
-[%inline-header]
-==== Paintbrush. 
-
-[%inline-header]
-[[AnnexA-2-6]]
-==== Steel bowls, 
-
-of diameter 100 mm ± 5 mm; seven per test sample. 
-
-[%inline-header]
-==== Balance, 
-
-which can be read to the nearest 0,01 g. 
-
-=== Sampling 
-
-See <<clause5>>. 
-
-=== Procedure 
-
-[[AnnexA-4-1]]
-==== Preparation of test sample 
-
-Carefully mix the laboratory sample to make it as uniform as possible, then proceed to reduce it, using a divider (<<AnnexA-2-1>>), until a quantity of about 30 g is obtained. 
-
-All parts of kernels which get stuck in the perforations of a sieve should be considered to be retained by the sieve. 
-
-[[figureA-1]]
-.Split-it-right sample divider
-image::rice_img/rice_image1.png[]
-
-=== Determination 
-
-Weigh, to the nearest 0,1 g, one of the test samples obtained in accordance with <<AnnexA-4-1>> and separate the different defects into the bowls (<<AnnexA-2-6>>). When a kernel has several defects, classify it in the defect category for which the maximum permissible value is the lowest (see <<table1>>). 
-
-Weigh, to the nearest 0,01 g, the fractions so obtained. 
-
-=== Calculation 
-
-Express the mass fraction of each defect using <<formulaA-1>>: 
-
-[[formulaA-1,A.1]]
-[stem]
-++++
-w = (m_D) / (m_s)
-++++
-
-where 
-
-stem:[w]:: is the mass fraction of grains with a particular defect in the test sample; 
-stem:[m_D]:: is the mass, in grams, of grains with that defect; 
-stem:[m_S]:: is the mass, in grams, of the test sample. 
-
-=== Test report 
-
-Report the results as specified in <<clause7>>. 
-
-[[AnnexB]]
-[appendix,obligation=informative]
-== Determination of the waxy rice content of parboiled rice
-
-=== Principle 
-
-Waxy rice kernels have a reddish brown colour when stained in an iodine solution, while non-waxy rice kernels show a dark blue colour. 
-
-=== Apparatus 
-
-The usual laboratory apparatus and, in particular, the following. 
-
-[%inline-header]
-[[AnnexB-2-1]]
-==== Balance, 
-
-capable of weighing to the nearest 0,01 g. 
-
-[%inline-header]
-[[AnnexB-2-2]]
-==== Glass beaker, 
-
-of capacity 250 ml. 
-
-[%inline-header]
-[[AnnexB-2-3]]
-==== Small white colour bowls, 
-
-or any white colour container of a suitable size.
-
-[%inline-header]
-[[AnnexB-2-4]]
-==== Wire sieve, 
-
-with long rounded apertures of (1 mm stem:[{:(+0.02),(0):}] mm) &times; (20 mm stem:[{:(+2),(-1):}] mm). 
-
-[%inline-header]
-[[AnnexB-2-5]]
-==== Stirrer rod. 
-
-[%inline-header]
-[[AnnexB-2-6]]
-==== Tweezers or forceps. 
-
-[%inline-header]
-[[AnnexB-2-7]]
-==== Tissue paper. 
-
-===  Reagents 
-
-WARNING: Direct contact of iodine with skin can cause lesions so care should be taken in handling iodine. Iodine vapour is very irritating to eyes and mucous membranes. 
-
-[%inline-header]
-[[AnnexB-3-1]]
-==== Deionized water, 
-
-Grade 3 quality as specified in <<ISO3696>>.
-
-[%inline-header]
-[[AnnexB-3-2]]
-==== Iodine stock solution, 
-
-containing a mass fraction of 4,1 % iodine and 6,3 % potassium iodide in deionized water such as Lugols.footnote:[Lugols is an example of a suitable product available commercially. This information is given for the convenience of users of this document and does not constitute an endorsement by ISO of this product.] 
-
-[%inline-header]
-[[AnnexB-3-3]]
-==== Iodine working solution, 
-
-obtained by diluting the stock solution (<<AnnexB-3-2>>) two times (by volume) with deionized water (<<AnnexB-3-1>>). 
-
-Prepare fresh daily. 
-
-=== Sampling 
-
-Sampling shall be carried out in accordance with <<clause5>>. 
-
-=== Determination 
-
-==== {blank}
-Weigh a portion of about 100 g of milled rice and put it into a glass beaker (<<AnnexB-2-2>>). 
-
-==== {blank}
-Add enough iodine working solution (<<AnnexB-3-3>>) to soak the kernels, and stir (<<AnnexB-2-5>>) until all the kernels are submerged under the solution. Let the kernels soak in the solution for 30 s. 
-
-==== {blank}
-Pour the rice and solution into a wire sieve (<<AnnexB-2-4>>), and shake the basket slightly in order to drain out the solution. Then place the wire sieve on a piece of tissue paper (<<AnnexB-2-7>>) to absorb the excess liquid. 
-
-==== {blank}
-Pour the stained kernels into a bowl (<<AnnexB-2-3>>). Using tweezers or forceps (<<AnnexB-2-6>>), separate the reddish brown kernels of waxy rice from the dark blue kernels of non-waxy rice. 
-
-==== {blank}
-Weigh the waxy rice portion (stem:[m_1]) and the non-waxy rice portion (stem:[m_2]) to the nearest 0,1 g. 
-
-=== Calculation 
-
-Calculate the mass fraction, expressed as a percentage, of the waxy rice, stem:[w_(wax)], using <<formulaB-1>>: 
-
-[[formulaB-1,B.1]]
-[stem]
-++++
-w_(wax) = (m_1) / (m_1 + m_2) xx 100
-++++
-
-where 
-
-stem:[m_1]:: is the mass, expressed in grams, of the waxy rice portion; 
-stem:[m_2]:: is the mass, expressed in grams, of the non-waxy rice portion. 
-
-=== Test report 
-
-Report the results as specified in <<clause7>>, giving the results calculated using <<formulaB-1>>. 
-
-[[AnnexC]]
-[appendix,obligation=informative]
-== Gelatinization
-
-<<figureC-1>> gives an example of a typical gelatinization curve. <<figureC-2>> shows the three stages of gelatinization. 
-
-[[figureC-1]]
-.Typical gelatinization curve
-image::rice_img/rice_image2.png[] 
-footnote:[The time stem:[t_90] was estimated to be 18,2 min for this example.]
-
-*Key*
-
-stem:[w]:: mass fraction of gelatinized kernels, expressed in per cent
-stem:[t]:: cooking time, expressed in minutes
-stem:[t_90]:: time required to gelatinize 90 % of the kernels
-P:: point of the curve corresponding to a cooking time of stem:[t_90]
-
-NOTE: These results are based on a study carried out on three different types of kernel.
-
-[[figureC-2]]
-.Stages of gelatinization
-====
-.Initial stages: No grains are fully gelatinized (ungelatinized starch granules are visible inside the kernels)
-image::rice_img/rice_image3_1.png[]
-
-.Intermediate stages: Some fully gelatinized kernels are visible
-image::rice_img/rice_image3_2.png[]
-
-.Final stages: All kernels are fully gelatinized
-image::rice_img/rice_image3_3.png[]
-
-====
-
-[[AnnexD]]
-[appendix,obligation=informative]
-== Results of interlaboratory test for husked rice yields
-
-An interlaboratory test <<ref15>> was carried out by the ENR [Rice Research Centre (Italy)] in accordance with <<ISO5725-1>> and <<ISO5725-2>>, with the participation of 15 laboratories. Each laboratory carried out three determinations on four different types of kernel. The statistical results are shown in <<tableD-1>>. 
-
-[[tableD-1]]
-[cols="<,^,^,^,^",headerrows=2]
-.Repeatability and reproducibility of husked rice yield 
-|===
-.2+| Description 4+| Rice sample 
-| Arborio | Drago footnote:[Parboiled rice.] | Balilla | Thaibonnet 
-
-| Number of laboratories retained after eliminating outliers | 13 | 11 | 13 | 13
-| Mean value, g/100 g | 81,2 | 82,0 | 81,8 | 77,7 
-| Standard deviation of repeatability, stem:[s_r], g/100 g | 0,41 | 0,15 | 0,31 | 0,53 
-| Coefficient of variation of repeatability, % | 0,5 | 0,2 | 0,4 | 0,7 
-| Repeatability limit, stem:[r] (= 2,83 stem:[s_r]) | 1,16 | 0,42 | 0,88 | 1,50 
-| Standard deviation of reproducibility, stem:[s_R], g/100 g | 1,02 | 0,20 | 0,80 | 2,14 
-| Coefficient of variation of reproducibility, % | 1,3 | 0,2 | 1,0 | 2,7 
-| Reproducibility limit, stem:[R] (= 2,83 stem:[s_R]) | 2,89 | 0,57 | 2,26 | 6,06 
-|===
-
-[appendix,obligation=informative]
-== Extraneous information
-
-_This appendix is not in the original Rice model document, and is inserted to illustrate elements absent from 
-that document: block quotes, source code, and examples._
-
-[quote, ISO, "ISO7301,clause 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).
-_____
-
-
-[%appendix]
-=== Appendix 1
-
-[[samplecode]]
-.Sample Code
-====
-
-[source,ruby]
---
-puts "Hello, world."
-%w{a b c}.each do |x| <1>
-  puts x
-end
---
-<1> This is an annotation
-====
-
-
-
-[bibliography]
-== Bibliography 
-
-* [[[ISO3696,ISO 3696]]] _Water for analytical laboratory use -- Specification and test methods_
-
-* [[[ISO5725-1,ISO 5725-1]]], _Accuracy (trueness and precision) of measurement methods and results -- Part 1: General principles and definitions_
-
-* [[[ISO5725-2,ISO 5725-2]]], _Accuracy (trueness and precision) of measurement methods and results -- Part 2: Basic method for the determination of repeatability and reproducibility of a standard measurement method_
-
-* [[[ISO6322-1,ISO 6322-1]]], _Storage of cereals and pulses -- Part 1: General recommendations for the keeping of cereals_
-
-* [[[ISO6322-2,ISO 6322-2]]], _Storage of cereals and pulses -- Part 2: Practical recommendations_
-
-* [[[ISO6322-3,ISO 6322-3]]], _Storage of cereals and pulses -- Part 3: Control of attack by pests_
-
-* [[[ISO7301,ISO 7301:2011]]], _Rice -- Specification_
-
-* [[[ISO14864,ISO 14864:1998]]], _Rice -- Evaluation of gelatinization time of kernels during cooking_
-
-* [[[IEC61010-2,IEC 61010-2]]], _Safety requirements for electric equipment for measurement, control, and laboratory use -- Part 2: Particular requirements for laboratory equipment for the heating of material_
-
-* [[[ref10,10]]] [smallcap]#Standard No I.C.C 167#. _Determination of the protein content in cereal and cereal products for food and animal feeding stuffs according to the Dumas combustion method_ (see http://www.icc.or.at)
-
-* [[[ref11,11]]] Nitrogen-ammonia-protein modified Kjeldahl method -- Titanium oxide and copper sulfate catalyst. _Official Methods and Recommended Practices of the AOCS_ (ed. Firestone, D.E.), AOCS Official Method Ba Ai 4-91, 1997, AOCS Press, Champaign, IL 
-
-* [[[ref12,12]]] [smallcap]#Berner D.L., & Brown J.# Protein nitrogen combustion method collaborative study I. Comparison with Smalley total Kjeldahl nitrogen and combustion results. _J. Am. Oil Chem. Soc._ 1994, *71* (11) pp 1291-1293
-
-* [[[ref13,13]]] [smallcap]#Buckee G.K.# Determination of total nitrogen in barley, malt and beer by Kjeldahl procedures and the Dumas combustion method -- Collaborative trial. _J. Inst. Brew._ 1994, *100* (2) pp 57-64
-
-* [[[ref14,14]]] [smallcap]#Frister H.# _Direct determination of nitrogen content by Dumas analysis; Interlaboratory study on precision characteristics_. AOAC International, Europe Section 4th International Symposium, Nyon, Switzerland, 1994, 33 pp 
-
-* [[[ref15,15]]] [smallcap]#Ranghino F.# Evaluation of rice resistance to cooking, based on the gelatinization time of kernels. _Il Riso_. 1966, *XV* pp 117-127
-
-* [[[ref16,16]]] [smallcap]#Tkachuk R.# Nitrogen-to-protein conversion factors for cereals and oilseed meals. _Cereal Chem._ 1969, *46* (4) pp 419-423
-