isodoc 1.2.4 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cd5c7cab435113879315a8de5d3219df7577d057df5adee3a87f7431b9d17f7
-  data.tar.gz: 22f07d9de5b5b8a26c57ca5321a53fafd591e6703615921d9a79d939c0276295
+  metadata.gz: f1edc88536663d06a4d23249a6ec1909148185456f84a427fe2299da8e138ab4
+  data.tar.gz: fd6099657296706882b03eb557f59b242c733415b9d49fe8bf4e3aa73bd67eb8
 SHA512:
-  metadata.gz: 1ca2bd4cf9b70ea4eb12d118c26e66e90340070453e132db89e7b6748a1a02f8a10f62c5944e2b1ffe6e18d4a69504b08f7b687ec6b8a573983f58d03de12b48
-  data.tar.gz: 1b6702e74e5041ad95509cf1b8655e044f36f27a0fa3cbd12e6ac82684e6b535ed1c3ad9ea6ad938ab2cb42a3880f2e0153ddb0424bf322d4238806616582a54
+  metadata.gz: 4112c5b84d25a09e9d701b9735d80e01e9f4bf294288c097524c83e31689dc90c1dd9168e9f70061868d41c032d2b864a96b76b19f0926584a2549a1f5309a63
+  data.tar.gz: b002124056e50a37732ad78fa9e959658b0f07c9f5af9d248f69c0d282cc74804471124fc4b7f150ba19935e3aa904df0d54222fb201e279d6325ebfffe9def8

data/.github/workflows/rake.yml

@@ -0,0 +1,69 @@
+# Auto-generated by Cimas: Do not edit it manually!
+# See https://github.com/metanorma/cimas
+name: rake
+
+on:
+  push:
+    branches: [ master, main ]
+    tags: [ v* ]
+  pull_request:
+
+jobs:
+  rake:
+    name: Test on Ruby ${{ matrix.ruby }} ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    continue-on-error: ${{ matrix.experimental }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: [ '2.6', '2.5', '2.4' ]
+        os: [ ubuntu-latest, windows-latest, macos-latest ]
+        experimental: [ false ]
+        include:
+          - ruby: '2.7'
+            os: 'ubuntu-latest'
+            experimental: true
+          - ruby: '2.7'
+            os: 'windows-latest'
+            experimental: true
+          - ruby: '2.7'
+            os: 'macos-latest'
+            experimental: true
+    steps:
+      - uses: actions/checkout@master
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      - uses: actions/cache@v2
+        with:
+          path: vendor/bundle
+          key: bundle-${{ matrix.os }}-${{ matrix.ruby }}-${{ hashFiles('**/*.gemspec') }}
+          restore-keys: bundle-${{ matrix.os }}-${{ matrix.ruby }}
+
+      - run: bundle config set path 'vendor/bundle'
+
+      - run: bundle install --jobs 4 --retry 3
+
+      - name: Install Inkscape macOS
+        if: matrix.os == 'macos-latest'
+        run: |
+          brew cask install inkscape
+          inkscape --version
+
+      - name: Install Inkscape Ubuntu
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo add-apt-repository ppa:inkscape.dev/stable
+          sudo apt update
+          sudo apt install inkscape
+          inkscape --version
+
+      - name: Install Inkscape Windows
+        if: matrix.os == 'windows-latest'
+        run: |
+          choco install --no-progress -y inkscape
+          inkscape --version
+
+      - run: bundle exec rake

data/README.adoc

@@ -1,9 +1,7 @@
 = isodoc: Processor to generate HTML/Word from Metanorma XML
 
 image:https://img.shields.io/gem/v/isodoc.svg["Gem Version", link="https://rubygems.org/gems/isodoc"]
-image:https://github.com/metanorma/isodoc/workflows/ubuntu/badge.svg["Ubuntu Build Status", link="https://github.com/metanorma/isodoc/actions?query=workflow%3Aubuntu"]
-image:https://github.com/metanorma/isodoc/workflows/macos/badge.svg["OSX Build Status", link="https://github.com/metanorma/isodoc/actions?query=workflow%3Amacos"]
-image:https://github.com/metanorma/isodoc/workflows/windows/badge.svg["Windows Build Status", link="https://github.com/metanorma/isodoc/actions?query=workflow%3Awindows"]
+image:https://github.com/metanorma/isodoc/workflows/rake/badge.svg["Build Status", link="https://github.com/metanorma/isodoc/actions?query=workflow%3Arake"]
 image:https://codeclimate.com/github/metanorma/isodoc/badges/gpa.svg["Code Climate", link="https://codeclimate.com/github/metanorma/isodoc"]
 image:https://img.shields.io/github/issues-pr-raw/metanorma/isodoc.svg["Pull Requests", link="https://github.com/metanorma/isodoc/pulls"]
 image:https://img.shields.io/github/commits-since/metanorma/isodoc/latest.svg["Commits since latest",link="https://github.com/metanorma/isodoc/releases"]

data/isodoc.gemspec

@@ -35,8 +35,10 @@ Gem::Specification.new do |spec|
   spec.add_dependency "uuidtools"
   spec.add_dependency "html2doc", "~> 1.0.0"
   spec.add_dependency "liquid"
+  spec.add_dependency "twitter_cldr"
   spec.add_dependency "roman-numerals"
-  spec.add_dependency "metanorma", "~> 1.1.0"
+  spec.add_dependency "metanorma", "~> 1.2.0"
+  spec.add_dependency "relaton-cli"
 
   spec.add_development_dependency "rake", "~> 13.0"
   spec.add_development_dependency "byebug", "~> 9.1"

data/lib/isodoc-yaml/i18n-en.yaml

@@ -36,6 +36,7 @@ external_terms_boilerplate: |
 internal_external_terms_boilerplate: |
           <p>For the purposes of this document, the terms and definitions 
             given in % and the following apply.</p>
+term_defined_in: "[term defined in %]"
 note: NOTE
 note_xref: Note
 termnote: Note % to entry

data/lib/isodoc-yaml/i18n-fr.yaml

@@ -1,5 +1,5 @@
 term_def_boilerplate: 
-scope: Domaine d'application
+scope: Domaine d’application
 symbolsabbrev: Symboles et termes abrégés
 abbrev: Termes abrégés
 symbols: Symboles
@@ -18,20 +18,21 @@ clause: Article
 annex: Annexe
 appendix: Appendice
 no_terms_boilerplate: |
-          <p>Aucun terme n'est defini dans le présent document.</p>
+          <p>Aucun terme n’est defini dans le présent document.</p>
 internal_terms_boilerplate: |
-         <p>Pour les besoins du présent document, les termes et définitions suivants s'appliquent.</p>
+         <p>Pour les besoins du présent document, les termes et définitions suivants s’appliquent.</p>
 norm_with_refs_pref: 
-     Les documents suivants cités dans le texte constituent, pour tout ou partie de leur contenu, des exigences du présent document. Pour les références datées, seule l’édition citée s'applique. Pour les références non datées, la dernière édition du document de référence s'applique (y compris les éventuels amendements).
+     Les documents suivants cités dans le texte constituent, pour tout ou partie de leur contenu, des exigences du présent document. Pour les références datées, seule l’édition citée s’applique. Pour les références non datées, la dernière édition du document de référence s’applique (y compris les éventuels amendements).
 norm_empty_pref: 
           Le présent document ne contient aucune référence normative.
 external_terms_boilerplate: |
-          <p>Pour les besoins du présent document, les termes et définitions de % s'appliquent.</p>
+          <p>Pour les besoins du présent document, les termes et définitions de % s’appliquent.</p>
 internal_external_terms_boilerplate: |
-          <p>Pour les besoins du présent document, les termes et définitions de % ainsi que les suivants, s'appliquent.</p>
+          <p>Pour les besoins du présent document, les termes et définitions de % ainsi que les suivants, s’appliquent.</p>
+term_defined_in: "[terme défini dans %]"
 note: NOTE
 note_xref: Note
-termnote: Note % à l'article
+termnote: Note % à l’article
 figure: Figure
 formula: Formule
 inequality: Formule

data/lib/isodoc-yaml/i18n-zh-Hans.yaml

@@ -31,6 +31,7 @@ external_terms_boilerplate: |
           <p>% 界定的术语和定义适用于本文件。</p>
 internal_external_terms_boilerplate: |
           <p>% 界定的以及下列术语和定义适用于本文件。</p>
+term_defined_in: "〖术语于%中定义〗"
 note: 注
 note_xref: 注
 termnote: 注%

data/lib/isodoc/base_style/all.css

@@ -9,7 +9,7 @@ fieldset, form, label, legend,
 table, caption, tbody, tfoot, thead, tr, th, td,
 article, aside, canvas, details, embed,
 figure, figcaption, footer, header, hgroup,
-menu, nav, output, ruby, section, summary,
+menu, output, ruby, section, summary,
 time, mark, audio, video {
   margin: 0;
   padding: 0; }
@@ -104,6 +104,10 @@ b, strong {
 div.document-stage-band, div.document-type-band {
   background-color: #333333; }
 
+a.FootnoteRef + a.FootnoteRef:before {
+  content: ", ";
+  vertical-align: super; }
+
 #standard-band {
   background-color: #0AC442; }
 

data/lib/isodoc/base_style/blocks.scss

@@ -50,7 +50,7 @@
   }
 
   background-color: $colorBg;
-  font-size: 0.8em;
+  font-size: $monospacefontsize;
   line-height: 1.6em;
   padding: 1.5em;
   margin: 2em 0 1em 0;
@@ -68,7 +68,7 @@
   }
 
   background-color: $colorBg;
-  font-size: 0.8em;
+  font-size: $monospacefontsize;
   line-height: 1.6em;
   padding: 1.5em;
   margin: 2em 0 1em 0;

data/lib/isodoc/base_style/reset.css

@@ -9,7 +9,7 @@ fieldset, form, label, legend,
 table, caption, tbody, tfoot, thead, tr, th, td,
 article, aside, canvas, details, embed,
 figure, figcaption, footer, header, hgroup,
-menu, nav, output, ruby, section, summary,
+menu, output, ruby, section, summary,
 time, mark, audio, video {
   margin: 0;
   padding: 0; }
@@ -103,3 +103,7 @@ b, strong {
 
 div.document-stage-band, div.document-type-band {
   background-color: #333333; }
+
+a.FootnoteRef + a.FootnoteRef:before {
+  content: ", ";
+  vertical-align: super; }

data/lib/isodoc/base_style/reset.scss

@@ -9,7 +9,7 @@ fieldset, form, label, legend,
 table, caption, tbody, tfoot, thead, tr, th, td,
 article, aside, canvas, details, embed,
 figure, figcaption, footer, header, hgroup,
-menu, nav, output, ruby, section, summary,
+menu, output, ruby, section, summary,
 time, mark, audio, video {
   margin: 0;
   padding: 0;
@@ -127,3 +127,8 @@ b, strong {
 div.document-stage-band, div.document-type-band {
   background-color: #333333;
 }
+
+a.FootnoteRef + a.FootnoteRef:before {
+    content: ", ";
+    vertical-align: super;
+  }

data/lib/isodoc/base_style/typography.scss

@@ -56,7 +56,7 @@
 
   &, th, td {
     border: $border;
-    font-size: 0.95em;
+    font-size: 0.95em; // NN 20201115: ??? normalfontsize - 0.05?
   }
   th, td {
     padding: 1em;

data/lib/isodoc/convert.rb

@@ -3,6 +3,7 @@ require "isodoc/common"
 require "fileutils"
 require "tempfile"
 require_relative "i18n"
+require_relative "css"
 
 module IsoDoc
   class Convert < ::IsoDoc::Common
@@ -17,6 +18,10 @@ module IsoDoc
     # wordcoverpage: Cover page for Word
     # htmlintropage: Introductory page for HTML
     # wordintropage: Introductory page for Word
+    # normalfontsize: Font size for body text
+    # smallerfontsize: Font size for smaller than body text
+    # monospacefontsize: Font size for monospace font
+    # footnotefontsize: Font size for footnotes
     # i18nyaml: YAML file for internationalisation of text
     # ulstyle: list style in Word CSS for unordered lists
     # olstyle: list style in Word CSS for ordered lists
@@ -25,8 +30,10 @@ module IsoDoc
     # monospace: font to use for monospace text
     # suppressheadingnumbers: suppress heading numbers for clauses
     # scripts: Scripts file for HTML
-    # scripts_pdf: Scripts file for PDF
+    # scripts_pdf: Scripts file for PDF (not used in XSLT PDF)
     # datauriimage: Encode images in HTML output as data URIs
+    # break_up_urls_in_tables: whether to insert spaces in URLs in tables
+    #   every 40-odd chars
     def initialize(options)
       @libdir ||= File.dirname(__FILE__)
       options.merge!(default_fonts(options)) do |_, old, new|
@@ -46,6 +53,10 @@ module IsoDoc
       @wordcoverpage = options[:wordcoverpage]
       @htmlintropage = options[:htmlintropage]
       @wordintropage = options[:wordintropage]
+      @normalfontsize = options[:normalfontsize]
+      @smallerfontsize = options[:smallerfontsize]
+      @monospacefontsize = options[:monospacefontsize]
+      @footnotefontsize = options[:footnotefontsize]
       @scripts = options[:scripts]
       @scripts_pdf = options[:scripts_pdf]
       @i18nyaml = options[:i18nyaml]
@@ -80,75 +91,10 @@ module IsoDoc
       @fn_bookmarks = {}
     end
 
-    # Check if already compiled version(.css) exists,
-    #   if not, return original scss file. During release
-    #   we compile scss into css files in order to not depend on scss
-    def precompiled_style_or_original(stylesheet_path)
-      # Already have compiled stylesheet, use it
-      return stylesheet_path if stylesheet_path.nil? ||
-                                File.extname(stylesheet_path) == '.css'
-
-      basename = File.basename(stylesheet_path, '.*')
-      compiled_path = File.join(File.dirname(stylesheet_path),
-                                "#{basename}.css")
-      return stylesheet_path unless File.file?(compiled_path)
-
-      compiled_path
-    end
-
-    # run this after @meta is populated
-    def populate_css
-      @htmlstylesheet = generate_css(@htmlstylesheet_name, true)
-      @wordstylesheet = generate_css(@wordstylesheet_name, false)
-      @standardstylesheet = generate_css(@standardstylesheet_name, false)
-    end
-
     def tmpimagedir_suffix
       '_images'
     end
 
-    def default_fonts(_options)
-      {
-        bodyfont: 'Arial',
-        headerfont: 'Arial',
-        monospacefont: 'Courier'
-      }
-    end
-
-    # none for this parent gem, but will be populated in child gems 
-    # which have access to stylesheets &c; e.g.
-    # {
-    #      htmlstylesheet: html_doc_path("htmlstyle.scss"),
-    #      htmlcoverpage: html_doc_path("html_rsd_titlepage.html"),
-    #      htmlintropage: html_doc_path("html_rsd_intro.html"),
-    #      scripts: html_doc_path("scripts.html"),
-    #      wordstylesheet: html_doc_path("wordstyle.scss"),
-    #      standardstylesheet: html_doc_path("rsd.scss"),
-    #      header: html_doc_path("header.html"),
-    #      wordcoverpage: html_doc_path("word_rsd_titlepage.html"),
-    #      wordintropage: html_doc_path("word_rsd_intro.html"),
-    #      ulstyle: l3
-    #      olstyle: l2
-    # }
-    def default_file_locations(_options)
-      {}
-    end
-
-    def fonts_options
-      {
-        'bodyfont' => options[:bodyfont] || 'Arial',
-        'headerfont' => options[:headerfont] || 'Arial',
-        'monospacefont' => options[:monospacefont] || 'Courier'
-      }
-    end
-
-    def scss_fontheader
-      b = options[:bodyfont] || 'Arial'
-      h = options[:headerfont] || 'Arial'
-      m = options[:monospacefont] || 'Courier'
-      "$bodyfont: #{b};\n$headerfont: #{h};\n$monospacefont: #{m};\n"
-    end
-
     def html_doc_path(*file)
       file.each do |f|
         ret = File.join(@libdir, File.join('html', f))
@@ -157,37 +103,6 @@ module IsoDoc
       nil
     end
 
-    def convert_scss(filename, stylesheet)
-      require 'sassc'
-      require 'isodoc/sassc_importer'
-
-      [File.join(Gem.loaded_specs['isodoc'].full_gem_path,
-                 'lib', 'isodoc'),
-                 File.dirname(filename)].each do |name|
-                   SassC.load_paths << name
-                 end
-                 SassC::Engine.new(scss_fontheader + stylesheet, syntax: :scss,
-                                   importer: SasscImporter)
-                   .render
-    end
-
-    def generate_css(filename, stripwordcss)
-      return nil if filename.nil?
-
-      filename = precompiled_style_or_original(filename)
-      stylesheet = File.read(filename, encoding: 'UTF-8')
-      stylesheet = populate_template(stylesheet, :word)
-      stylesheet.gsub!(/(\s|\{)mso-[^:]+:[^;]+;/m, '\\1') if stripwordcss
-      if File.extname(filename) == '.scss'
-        stylesheet = convert_scss(filename, stylesheet)
-      end
-      Tempfile.open([File.basename(filename, '.*'), 'css'],
-                    encoding: 'utf-8') do |f|
-        f.write(stylesheet)
-        f
-      end
-    end
-
     def convert1(docxml, filename, dir)
       @xrefs.parse docxml
       noko do |xml|

data/lib/isodoc/css.rb

@@ -0,0 +1,95 @@
+module IsoDoc
+  class Convert < ::IsoDoc::Common
+    # Check if already compiled version(.css) exists,
+    #   if not, return original scss file. During release
+    #   we compile scss into css files in order to not depend on scss
+    def precompiled_style_or_original(stylesheet_path)
+      # Already have compiled stylesheet, use it
+      return stylesheet_path if stylesheet_path.nil? ||
+        File.extname(stylesheet_path) == '.css'
+      basename = File.basename(stylesheet_path, '.*')
+      compiled_path = File.join(File.dirname(stylesheet_path),
+                                "#{basename}.css")
+      return stylesheet_path unless File.file?(compiled_path)
+      compiled_path
+    end
+
+    # run this after @meta is populated
+    def populate_css
+      @htmlstylesheet = generate_css(@htmlstylesheet_name, true)
+      @wordstylesheet = generate_css(@wordstylesheet_name, false)
+      @standardstylesheet = generate_css(@standardstylesheet_name, false)
+    end
+
+    def default_fonts(_options)
+      {
+        bodyfont: 'Arial',
+        headerfont: 'Arial',
+        monospacefont: 'Courier',
+      }
+    end
+
+    # none for this parent gem, but will be populated in child gems
+    # which have access to stylesheets &c
+    def default_file_locations(_options)
+      {}
+    end
+
+    def fonts_options
+      {
+        'bodyfont' => options[:bodyfont] || 'Arial',
+        'headerfont' => options[:headerfont] || 'Arial',
+        'monospacefont' => options[:monospacefont] || 'Courier',
+        "normalfontsize" => options[:normalfontsize],
+        "monospacefontsize" => options[:monospacefontsize],
+        "smallerfontsize" => options[:smallerfontsize],
+        "footnotefontsize" => options[:footnotefontsize] 
+      }
+    end
+
+    def scss_fontheader(is_html_css)
+      b = options[:bodyfont] || 'Arial'
+      h = options[:headerfont] || 'Arial'
+      m = options[:monospacefont] || 'Courier'
+      ns = options[:normalfontsize] || (is_html_css ? "1.0em" : '12.0pt')
+      ms = options[:monospacefontsize] || (is_html_css ? "0.8em" : '11.0pt')
+      ss = options[:smallerfontsize] || (is_html_css ? "0.9em" : '10.0pt')
+      fs = options[:footnotefontsize] || (is_html_css ? "0.9em" : '9.0pt')
+      "$bodyfont: #{b};\n$headerfont: #{h};\n$monospacefont: #{m};\n"\
+        "$normalfontsize: #{ns};\n$monospacefontsize: #{ms};\n"\
+        "$smallerfontsize: #{ss};\n$footnotefontsize: #{fs};\n"
+    end
+
+    def convert_scss(filename, stylesheet, stripwordcss)
+      require 'sassc'
+      require 'isodoc/sassc_importer'
+
+      [File.join(Gem.loaded_specs['isodoc'].full_gem_path,
+                 'lib', 'isodoc'),
+                 File.dirname(filename)].each do |name|
+                   SassC.load_paths << name
+                 end
+                 SassC::Engine.new(scss_fontheader(stripwordcss) + stylesheet,
+                                   syntax: :scss, importer: SasscImporter)
+                   .render
+    end
+
+    # stripwordcss if HTML stylesheet, !stripwordcss if DOC stylesheet
+    def generate_css(filename, stripwordcss)
+      return nil if filename.nil?
+
+      filename = precompiled_style_or_original(filename)
+      stylesheet = File.read(filename, encoding: 'UTF-8')
+      stylesheet = populate_template(stylesheet, :word)
+      stylesheet.gsub!(/(\s|\{)mso-[^:]+:[^;]+;/m, '\\1') if stripwordcss
+      if File.extname(filename) == '.scss'
+        stylesheet = convert_scss(filename, stylesheet, stripwordcss)
+      end
+      Tempfile.open([File.basename(filename, '.*'), 'css'],
+                    encoding: 'utf-8') do |f|
+        f.write(stylesheet)
+        f
+      end
+    end
+  end
+end