isodoc 1.5.5 → 1.6.4

data/lib/isodoc/class_utils.rb

@@ -4,18 +4,19 @@ module IsoDoc
       from = date.at(ns("./from"))
       to = date.at(ns("./to"))
       on = date.at(ns("./on"))
-      return date.text unless (from || on || to)
+      return date.text unless from || on || to
       return on.text if on
+
       ret = "#{from.text}–"
       ret += to.text if to
       ret
     end
 
     def ns(xpath)
-      xpath.gsub(%r{/([a-zA-z])}, "/xmlns:\\1").
-        gsub(%r{::([a-zA-z])}, "::xmlns:\\1").
-        gsub(%r{\[([a-zA-z][a-z0-9A-Z@/]* ?=)}, "[xmlns:\\1").
-        gsub(%r{\[([a-zA-z][a-z0-9A-Z@/]*\])}, "[xmlns:\\1")
+      xpath.gsub(%r{/([a-zA-z])}, "/xmlns:\\1")
+        .gsub(%r{::([a-zA-z])}, "::xmlns:\\1")
+        .gsub(%r{\[([a-zA-z][a-z0-9A-Z@/]* ?=)}, "[xmlns:\\1")
+        .gsub(%r{\[([a-zA-z][a-z0-9A-Z@/]*\])}, "[xmlns:\\1")
     end
 
     def liquid(doc)

data/lib/isodoc/common.rb

@@ -1,5 +1,6 @@
 require_relative "./function/blocks"
 require_relative "./function/cleanup"
+require_relative "./function/form"
 require_relative "./function/inline"
 require_relative "./function/lists"
 require_relative "./function/references"
@@ -15,6 +16,7 @@ module IsoDoc
   class Common
     include Function::Blocks
     include Function::Cleanup
+    include Function::Form
     include Function::Inline
     include Function::Lists
     include Function::References

data/lib/isodoc/convert.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require "isodoc/common"
 require "fileutils"
 require "tempfile"
@@ -7,9 +8,7 @@ require_relative "css"
 
 module IsoDoc
   class Convert < ::IsoDoc::Common
-    attr_accessor :options
-    attr_accessor :i18n
-    attr_accessor :meta
+    attr_accessor :options, :i18n, :meta, :xrefs
 
     # htmlstylesheet: Generic stylesheet for HTML
     # htmlstylesheet_override: Override stylesheet for HTML
@@ -33,16 +32,17 @@ module IsoDoc
     # monospace: font to use for monospace text
     # suppressheadingnumbers: suppress heading numbers for clauses
     # scripts: Scripts file for HTML
+    # scripts_override: Override scripts file for HTML
     # 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
+    # bare: do not insert any prefatory material (coverpage, boilerplate)
     def initialize(options)
-      @libdir ||= File.dirname(__FILE__)
+      @libdir ||= File.dirname(__FILE__) # rubocop:disable Lint/DisjunctiveAssignmentInConstructor
       options.merge!(default_fonts(options)) do |_, old, new|
         old || new
-      end
-             .merge!(default_file_locations(options)) do |_, old, new|
+      end.merge!(default_file_locations(options)) do |_, old, new|
         old || new
       end
       @options = options
@@ -53,6 +53,7 @@ module IsoDoc
       @htmlstylesheet_override_name = options[:htmlstylesheet_override]
       @wordstylesheet_override_name = options[:wordstylesheet_override]
       @standardstylesheet_name = options[:standardstylesheet]
+      @sourcefilename = options[:sourcefilename]
       @header = options[:header]
       @htmlcoverpage = options[:htmlcoverpage]
       @wordcoverpage = options[:wordcoverpage]
@@ -62,15 +63,18 @@ module IsoDoc
       @smallerfontsize = options[:smallerfontsize]
       @monospacefontsize = options[:monospacefontsize]
       @footnotefontsize = options[:footnotefontsize]
-      @scripts = options[:scripts]
+      @scripts = options[:scripts] ||
+        File.join(File.dirname(__FILE__), "base_style", "scripts.html")
       @scripts_pdf = options[:scripts_pdf]
+      @scripts_override = options[:scripts_override]
       @i18nyaml = options[:i18nyaml]
       @ulstyle = options[:ulstyle]
       @olstyle = options[:olstyle]
       @datauriimage = options[:datauriimage]
       @suppressheadingnumbers = options[:suppressheadingnumbers]
-      @break_up_urls_in_tables = options[:break_up_urls_in_tables] == 'true'
-      @termdomain = ''
+      @break_up_urls_in_tables = options[:break_up_urls_in_tables] == "true"
+      @bare = options[:bare]
+      @termdomain = ""
       @termexample = false
       @note = false
       @sourcecode = false
@@ -92,17 +96,17 @@ module IsoDoc
       @wordToClevels = 2 if @wordToClevels.zero?
       @htmlToClevels = options[:htmltoclevels].to_i
       @htmlToClevels = 2 if @htmlToClevels.zero?
-      @bookmarks_allocated = { 'X' => true }
+      @bookmarks_allocated = { "X" => true }
       @fn_bookmarks = {}
     end
 
     def tmpimagedir_suffix
-      '_images'
+      "_images"
     end
 
     def html_doc_path(*file)
       file.each do |f|
-        ret = File.join(@libdir, File.join('html', f))
+        ret = File.join(@libdir, File.join("html", f))
         File.exist?(ret) and return ret
       end
       nil
@@ -112,7 +116,7 @@ module IsoDoc
       @xrefs.parse docxml
       noko do |xml|
         xml.html **{ lang: @lang.to_s } do |html|
-          html.parent.add_namespace('epub', 'http://www.idpf.org/2007/ops')
+          html.parent.add_namespace("epub", "http://www.idpf.org/2007/ops")
           info docxml, nil
           populate_css
           html.head { |head| define_head head, filename, dir }
@@ -134,8 +138,8 @@ module IsoDoc
       @i18n = I18n.new(lang, script, i18nyaml || @i18nyaml)
     end
 
-    def l10n(x, lang = @lang, script = @script)
-      @i18n.l10n(x, lang, script)
+    def l10n(expr, lang = @lang, script = @script)
+      @i18n.l10n(expr, lang, script)
     end
 
     def convert_init(file, input_filename, debug)
@@ -157,14 +161,23 @@ module IsoDoc
       docxml, filename, dir = convert_init(file, input_filename, debug)
       result = convert1(docxml, filename, dir)
       return result if debug
+
       output_filename ||= "#{filename}.#{@suffix}"
       postprocess(result, output_filename, dir)
       FileUtils.rm_rf dir
     end
 
-    def middle_clause(docxml = nil)
+    def middle_clause(_docxml = nil)
       "//clause[parent::sections][not(@type = 'scope')]"\
-        '[not(descendant::terms)]'
+        "[not(descendant::terms)]"
+    end
+
+    def target_pdf(node)
+      if /#/.match?(node["target"])
+        node["target"].sub(/#/, ".pdf#")
+      else
+        "##{node['target']}"
+      end
     end
   end
 end

data/lib/isodoc/css.rb

@@ -6,32 +6,40 @@ module IsoDoc
     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, '.*')
+        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
 
+    def localpath(path)
+      return path if %r{^[A-Z]:|^/|^file:/}.match?(path)
+      return path unless (@sourcedir || @localdir) && path
+
+      File.expand_path(File.join((@sourcedir || @localdir), 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)
-      if @htmlstylesheet_override_name
-        @htmlstylesheet_override = File.open(@htmlstylesheet_override_name)
-      end
-      if @wordstylesheet_override_name
-        @wordstylesheet_override = File.open(@wordstylesheet_override_name)
-      end
+      @htmlstylesheet = generate_css(localpath(@htmlstylesheet_name), true)
+      @wordstylesheet = generate_css(localpath(@wordstylesheet_name), false)
+      @standardstylesheet =
+        generate_css(localpath(@standardstylesheet_name), false)
+      @htmlstylesheet_override_name and @htmlstylesheet_override =
+        File.open(localpath(@htmlstylesheet_override_name))
+      @wordstylesheet_override_name and @wordstylesheet_override =
+        File.open(localpath(@wordstylesheet_override_name))
     end
 
     def default_fonts(_options)
       {
-        bodyfont: 'Arial',
-        headerfont: 'Arial',
-        monospacefont: 'Courier',
+        bodyfont: "Arial",
+        headerfont: "Arial",
+        monospacefont: "Courier",
       }
     end
 
@@ -43,35 +51,35 @@ module IsoDoc
 
     def fonts_options
       {
-        'bodyfont' => options[:bodyfont] || 'Arial',
-        'headerfont' => options[:headerfont] || 'Arial',
-        'monospacefont' => options[:monospacefont] || 'Courier',
+        "bodyfont" => options[:bodyfont] || "Arial",
+        "headerfont" => options[:headerfont] || "Arial",
+        "monospacefont" => options[:monospacefont] || "Courier",
         "normalfontsize" => options[:normalfontsize],
         "monospacefontsize" => options[:monospacefontsize],
         "smallerfontsize" => options[:smallerfontsize],
-        "footnotefontsize" => options[:footnotefontsize] 
+        "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')
+      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'
+      require "sassc"
+      require "isodoc/sassc_importer"
 
-      [File.join(Gem.loaded_specs['isodoc'].full_gem_path,
-                 'lib', 'isodoc'),
+      [File.join(Gem.loaded_specs["isodoc"].full_gem_path,
+                 "lib", "isodoc"),
                  File.dirname(filename)].each do |name|
                    SassC.load_paths << name
                  end
@@ -83,15 +91,16 @@ module IsoDoc
     # 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 = 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.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|
+      Tempfile.open([File.basename(filename, ".*"), "css"],
+                    encoding: "utf-8") do |f|
         f.write(stylesheet)
         f
       end

data/lib/isodoc/function/blocks.rb

@@ -4,6 +4,16 @@ module IsoDoc::Function
   module Blocks
     @annotation = false
 
+    def middle_title(_isoxml, out)
+      out.p(**{ class: "zzSTDTitle1" }) { |p| p << @meta.get[:doctitle] }
+    end
+
+    def middle_admonitions(isoxml, out)
+      isoxml.xpath(ns("//sections/note | //sections/admonition")).each do |x|
+        parse(x, out)
+      end
+    end
+
     def figure_name_parse(node, div, name)
       return if name.nil? 
       div.p **{ class: "FigureTitle", style: "text-align:center;" } do |p|
@@ -24,6 +34,7 @@ module IsoDoc::Function
     def figure_parse(node, out)
       return pseudocode_parse(node, out) if node["class"] == "pseudocode" ||
         node["type"] == "pseudocode"
+
       @in_figure = true
       out.div **figure_attrs(node) do |div|
         node.children.each do |n|
@@ -51,6 +62,7 @@ module IsoDoc::Function
 
     def sourcecode_name_parse(node, div, name)
       return if name.nil? 
+
       div.p **{ class: "SourceTitle", style: "text-align:center;" } do |p|
         name.children.each { |n| parse(n, p) }
       end
@@ -91,14 +103,15 @@ module IsoDoc::Function
       @annotation = false
     end
 
-    def admonition_class(node)
+    def admonition_class(_node)
       "Admonition"
     end
 
     def admonition_name(node, type)
       name = node&.at(ns("./name")) and return name
-      name = Nokogiri::XML::Node.new('name', node.document)
+      name = Nokogiri::XML::Node.new("name", node.document)
       return unless type && @i18n.admonition[type]
+
       name << @i18n.admonition[type]&.upcase
       name
     end
@@ -119,7 +132,8 @@ module IsoDoc::Function
 
     def formula_where(dl, out)
       return unless dl
-      out.p **{ style: "page-break-after:avoid;"} do |p|
+
+      out.p **{ style: "page-break-after:avoid;" } do |p|
         p << @i18n.where
       end
       parse(dl, out)
@@ -148,6 +162,7 @@ module IsoDoc::Function
         formula_where(node.at(ns("./dl")), div)
         node.children.each do |n|
           next if %w(stem dl name).include? n.name
+
           parse(n, div)
         end
       end
@@ -182,6 +197,7 @@ module IsoDoc::Function
       author = node.at(ns("./author"))
       source = node.at(ns("./source"))
       return if author.nil? && source.nil?
+
       out.p **{ class: "QuoteAttribution" } do |p|
         p << "&mdash; #{author.text}" if author
         p << ", " if author && source
@@ -201,8 +217,9 @@ module IsoDoc::Function
     end
 
     def passthrough_parse(node, out)
-      return if node["format"] and
+      return if node["format"] &&
         !(node["format"].split(/,/).include? @format.to_s)
+
       out.passthrough node.text
     end
 

data/lib/isodoc/function/blocks_example_note.rb

@@ -59,7 +59,7 @@ module IsoDoc::Function
       name = node&.at(ns("./name"))&.remove
       div.p do |p|
         name and p.span **{ class: "note_label" } do |s|
-          name and name.children.each { |n| parse(n, s) }
+          name.children.each { |n| parse(n, s) }
           s << note_delim
         end
         insert_tab(p, 1)
@@ -98,7 +98,7 @@ module IsoDoc::Function
       @note = true
       out.div **note_attrs(node) do |div|
         node&.at(ns("./*[local-name() != 'name'][1]"))&.name == "p" ?
-        #node.first_element_child.name == "p" ?
+        # node.first_element_child.name == "p" ?
           note_p_parse(node, div) : note_parse1(node, div)
       end
       @note = false

data/lib/isodoc/function/cleanup.rb

@@ -1,16 +1,17 @@
 module IsoDoc::Function
   module Cleanup
     def textcleanup(docxml)
-      docxml = termref_cleanup(passthrough_cleanup(docxml))
+      termref_cleanup(passthrough_cleanup(docxml))
     end
 
     def termref_cleanup(docxml)
-      docxml.
-        gsub(/\s*\[MODIFICATION\]\s*\[\/TERMREF\]/, l10n(", #{@i18n.modified} [/TERMREF]")).
-        gsub(%r{\s*\[/TERMREF\]\s*</p>\s*<p>\s*\[TERMREF\]}, "; ").
-        gsub(/\[TERMREF\]\s*/, l10n("[#{@i18n.source}: ")).
-        gsub(%r{\s*\[\/TERMREF\]\s*}, l10n("]")).
-        gsub(/\s*\[MODIFICATION\]/, l10n(", #{@i18n.modified} &mdash; "))
+      docxml
+        .gsub(/\s*\[MODIFICATION\]\s*\[\/TERMREF\]/,
+              l10n(", #{@i18n.modified} [/TERMREF]"))
+        .gsub(%r{\s*\[/TERMREF\]\s*</p>\s*<p>\s*\[TERMREF\]}, "; ")
+        .gsub(/\[TERMREF\]\s*/, l10n("[#{@i18n.source}: "))
+        .gsub(%r{\s*\[/TERMREF\]\s*}, l10n("]"))
+        .gsub(/\s*\[MODIFICATION\]/, l10n(", #{@i18n.modified} &mdash; "))
     end
 
     def passthrough_cleanup(docxml)
@@ -21,7 +22,7 @@ module IsoDoc::Function
     end
 
     def cleanup(docxml)
-      @i18n ||= i18n_init(@lang, @script) 
+      @i18n ||= i18n_init(@lang, @script)
       comment_cleanup(docxml)
       footnote_cleanup(docxml)
       inline_header_cleanup(docxml)
@@ -34,30 +35,36 @@ module IsoDoc::Function
 
     def table_long_strings_cleanup(docxml)
       return unless @break_up_urls_in_tables == true
+
       docxml.xpath("//td | //th").each do |d|
         d.traverse do |n|
           next unless n.text?
+
           n.replace(HTMLEntities.new.encode(
-            break_up_long_strings(n.text)))
+                      break_up_long_strings(n.text),
+                    ))
         end
       end
     end
 
-    def break_up_long_strings(t)
-      return t if t.match(/^\s*$/)
-      t.split(/(?=\s)/).map do |w|
-        (/^\s*$/.match(t) or w.size < 30) ? w :
+    def break_up_long_strings(text)
+      return text if /^\s*$/.match?(text)
+
+      text.split(/(?=\s)/).map do |w|
+        if /^\s*$/.match(text) || (w.size < 30) then w
+        else
           w.scan(/.{,30}/).map do |w1|
-          (w1.size < 30) ? w1 : break_up_long_strings1(w1)
-        end.join
+            w1.size < 30 ? w1 : break_up_long_strings1(w1)
+          end.join
+        end
       end.join
     end
 
-    def break_up_long_strings1(w1)
-      s = w1.split(%r{(?<=[,.?+;/=])})
-      if s.size == 1 then w1 + " "
+    def break_up_long_strings1(text)
+      s = text.split(%r{(?<=[,.?+;/=])})
+      if s.size == 1 then "#{text} "
       else
-        s[-1] = " " + s[-1]
+        s[-1] = " #{s[-1]}"
         s.join
       end
     end
@@ -78,11 +85,11 @@ module IsoDoc::Function
       docxml
     end
 
-    def figure_get_or_make_dl(t)
-      dl = t.at(".//dl")
+    def figure_get_or_make_dl(elem)
+      dl = elem.at(".//dl")
       if dl.nil?
-        t.add_child("<p><b>#{@i18n.key}</b></p><dl></dl>")
-        dl = t.at(".//dl")
+        elem.add_child("<p><b>#{@i18n.key}</b></p><dl></dl>")
+        dl = elem.at(".//dl")
       end
       dl
     end
@@ -91,10 +98,10 @@ module IsoDoc::Function
       "//div[@class = 'figure'][descendant::aside]"\
       "[not(descendant::div[@class = 'figure'])]".freeze
 
-    def figure_aside_process(f, aside, key)
+    def figure_aside_process(elem, aside, key)
       # get rid of footnote link, it is in diagram
-      f&.at("./a[@class='TableFootnoteRef']")&.remove
-      fnref = f.at(".//span[@class='TableFootnoteRef']/..")
+      elem&.at("./a[@class='TableFootnoteRef']")&.remove
+      fnref = elem.at(".//span[@class='TableFootnoteRef']/..")
       dt = key.add_child("<dt></dt>").first
       dd = key.add_child("<dd></dd>").first
       fnref.parent = dt
@@ -109,6 +116,7 @@ module IsoDoc::Function
     def figure_cleanup(docxml)
       docxml.xpath(FIGURE_WITH_FOOTNOTES).each do |f|
         next unless f.at(".//aside[not(ancestor::p[@class = 'FigureTitle'])]")
+
         key = figure_get_or_make_dl(f)
         f.xpath(".//aside").each do |aside|
           figure_aside_process(f, aside, key)
@@ -137,12 +145,13 @@ module IsoDoc::Function
       docxml
     end
 
-    def merge_fnref_into_fn_text(a)
-      fn = a.at('.//span[@class="TableFootnoteRef"]/..')
+    def merge_fnref_into_fn_text(elem)
+      fn = elem.at('.//span[@class="TableFootnoteRef"]/..')
       n = fn.next_element
       n&.children&.first&.add_previous_sibling(fn.remove)
     end
 
+    # preempt html2doc putting MsoNormal under TableFootnote class
     def table_footnote_cleanup(docxml)
       docxml.xpath("//table[descendant::aside]").each do |t|
         t.xpath(".//aside").each do |a|
@@ -152,36 +161,36 @@ module IsoDoc::Function
           t << a.remove
         end
       end
-      # preempt html2doc putting MsoNormal there
       docxml.xpath("//p[not(self::*[@class])]"\
                    "[ancestor::*[@class = 'TableFootnote']]").each do |p|
         p["class"] = "TableFootnote"
       end
     end
 
-    def remove_bottom_border(td)
-      td["style"] =
-        td["style"].gsub(/border-bottom:[^;]+;/, "border-bottom:0pt;")
+    def remove_bottom_border(cell)
+      cell["style"] =
+        cell["style"].gsub(/border-bottom:[^;]+;/, "border-bottom:0pt;")
     end
 
-    def table_get_or_make_tfoot(t)
-      tfoot = t.at(".//tfoot")
+    def table_get_or_make_tfoot(table)
+      tfoot = table.at(".//tfoot")
       if tfoot.nil?
-        t.add_child("<tfoot></tfoot>")
-        tfoot = t.at(".//tfoot")
+        table.add_child("<tfoot></tfoot>")
+        tfoot = table.at(".//tfoot")
       else
         tfoot.xpath(".//td | .//th").each { |td| remove_bottom_border(td) }
       end
       tfoot
     end
 
-    def new_fullcolspan_row(t, tfoot)
+    def new_fullcolspan_row(table, tfoot)
       # how many columns in the table?
       cols = 0
-      t.at(".//tr").xpath("./td | ./th").each do |td|
+      table.at(".//tr").xpath("./td | ./th").each do |td|
         cols += (td["colspan"] ? td["colspan"].to_i : 1)
       end
-      style = %{border-top:0pt;border-bottom:#{IsoDoc::Function::Table::SW} 1.5pt;}
+      style =
+        %{border-top:0pt;border-bottom:#{IsoDoc::Function::Table::SW} 1.5pt;}
       tfoot.add_child("<tr><td colspan='#{cols}' style='#{style}'/></tr>")
       tfoot.xpath(".//td").last
     end
@@ -204,15 +213,14 @@ module IsoDoc::Function
       docxml
     end
 
-    def symbols_cleanup(docxml)
-    end
+    def symbols_cleanup(docxml); end
 
-    def table_footnote_reference_format(a)
-      a
+    def table_footnote_reference_format(link)
+      link
     end
 
-    def footnote_reference_format(a)
-      a
+    def footnote_reference_format(link)
+      link
     end
   end
 end