Module: Asciidoctor::Standoc::Section
- Included in:
- Converter
- Defined in:
- lib/asciidoctor/standoc/terms.rb,
lib/asciidoctor/standoc/section.rb,
lib/asciidoctor/standoc/ref_sect.rb
Constant Summary collapse
- TERM_REFERENCE_RE_STR =
<<~REGEXP.freeze ^(?<xref><(xref|concept)[^>]+>(.*?</(xref|concept)>)?) (,\s(?<text>.*))? $ REGEXP
- TERM_REFERENCE_RE =
Regexp.new(TERM_REFERENCE_RE_STR.gsub(/\s/, "").gsub(/_/, "\\s"), Regexp::IGNORECASE | Regexp::MULTILINE)
Instance Method Summary collapse
- #abstract_parse(attrs, xml, node) ⇒ Object
- #acknowledgements_parse(attrs, xml, node) ⇒ Object
- #add_term_source(node, xml_t, seen_xref, match) ⇒ Object
- #annex_parse(attrs, xml, node) ⇒ Object
- #bibitem_parse(attrs, xml, node) ⇒ Object
- #bibliography_parse(attrs, xml, node) ⇒ Object
- #clause_parse(attrs, xml, node) ⇒ Object
- #emend_biblio(xml, code, title, usrlbl) ⇒ Object
- #extract_termsource_refs(text, node) ⇒ Object
- #fetch_ref(xml, code, year, **opts) ⇒ Object
- #foreword_parse(attrs, xml, node) ⇒ Object
- #global_ievcache_name ⇒ Object
- #in_biblio? ⇒ Boolean
- #in_norm_ref? ⇒ Boolean
- #in_terms? ⇒ Boolean
- #indexsect_parse(attrs, xml, node) ⇒ Object
- #init_bib_caches(node) ⇒ Object
- #init_iev_caches(node) ⇒ Object
- #introduction_parse(attrs, xml, node) ⇒ Object
- #local_ievcache_name(cachename) ⇒ Object
- #nonterm_symbols_parse(attrs, xml, node) ⇒ Object
- #nonterm_term_def_subclause_parse(attrs, xml, node) ⇒ Object
- #norm_ref_parse(attrs, xml, node) ⇒ Object
- #preamble(node) ⇒ Object
- #reference(node) ⇒ Object
- #scope_parse(attrs, xml, node) ⇒ Object
- #section(node) ⇒ Object
- #section_attributes(node) ⇒ Object
- #sectiontype(node, level = true) ⇒ Object
- #sectiontype1(node) ⇒ Object
- #sectiontype_streamline(ret) ⇒ Object
- #set_obligation(attrs, node) ⇒ Object
- #smart_render_xml(xml, code, opts) ⇒ Object
- #symbols_attrs(node, attr) ⇒ Object
- #symbols_parse(attr, xml, node) ⇒ Object
- #term_def_parse(attrs, xml, node, _toplevel) ⇒ Object
-
#term_def_subclause_parse(attrs, xml, node) ⇒ Object
subclause contains subclauses.
- #term_def_subclause_parse1(attrs, xml, node) ⇒ Object
- #term_source_attrs(_node, seen_xref) ⇒ Object
- #termdefinition(node) ⇒ Object
- #terms_boilerplate_parse(attrs, xml, node) ⇒ Object
- #termsource(node) ⇒ Object
Instance Method Details
#abstract_parse(attrs, xml, node) ⇒ Object
135 136 137 138 139 |
# File 'lib/asciidoctor/standoc/section.rb', line 135 def abstract_parse(attrs, xml, node) xml.abstract **attr_code(attrs) do |xml_section| xml_section << node.content end end |
#acknowledgements_parse(attrs, xml, node) ⇒ Object
181 182 183 184 185 186 187 |
# File 'lib/asciidoctor/standoc/section.rb', line 181 def acknowledgements_parse(attrs, xml, node) xml.acknowledgements **attr_code(attrs) do |xml_section| xml_section.title { |t| t << node.title || @i18n.acknowledgements } content = node.content xml_section << content end end |
#add_term_source(node, xml_t, seen_xref, match) ⇒ Object
94 95 96 97 98 99 100 101 102 103 104 105 |
# File 'lib/asciidoctor/standoc/terms.rb', line 94 def add_term_source(node, xml_t, seen_xref, match) if seen_xref.children[0].name == "concept" xml_t.origin { |o| o << seen_xref.children[0].to_xml } else attrs = term_source_attrs(node, seen_xref) attrs.delete(:text) xml_t.origin seen_xref.children[0].content, **attr_code(attrs) end match[:text] && xml_t.modification do |mod| mod.p { |p| p << match[:text].sub(/^\s+/, "") } end end |
#annex_parse(attrs, xml, node) ⇒ Object
156 157 158 159 160 161 162 163 |
# File 'lib/asciidoctor/standoc/section.rb', line 156 def annex_parse(attrs, xml, node) attrs["inline-header".to_sym] = node.option? "inline-header" set_obligation(attrs, node) xml.annex **attr_code(attrs) do |xml_section| xml_section.title { |name| name << node.title } xml_section << node.content end end |
#bibitem_parse(attrs, xml, node) ⇒ Object
31 32 33 34 35 36 37 38 39 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 31 def bibitem_parse(attrs, xml, node) norm_ref = @norm_ref biblio = @biblio @biblio = false @norm_ref = false clause_parse(attrs, xml, node) @biblio = biblio @norm_ref = norm_ref end |
#bibliography_parse(attrs, xml, node) ⇒ Object
18 19 20 21 22 23 24 25 26 27 28 29 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 18 def bibliography_parse(attrs, xml, node) node.option? "bibitem" and return bibitem_parse(attrs, xml, node) node.attr("style") == "bibliography" or @log.add("AsciiDoc Input", node, "Section not marked up as [bibliography]!") @biblio = true xml.references **attr_code(attrs.merge( normative: node.attr("normative") || false)) do |xml_section| xml_section.title { |t| t << node.title } xml_section << node.content end @biblio = false end |
#clause_parse(attrs, xml, node) ⇒ Object
145 146 147 148 149 150 151 152 153 154 |
# File 'lib/asciidoctor/standoc/section.rb', line 145 def clause_parse(attrs, xml, node) attrs["inline-header".to_sym] = node.option? "inline-header" attrs[:bibitem] = true if node.option? "bibitem" attrs[:level] = node.attr("level") set_obligation(attrs, node) xml.send "clause", **attr_code(attrs) do |xml_section| xml_section.title { |n| n << node.title } unless node.title.nil? xml_section << node.content end end |
#emend_biblio(xml, code, title, usrlbl) ⇒ Object
81 82 83 84 85 86 87 88 89 90 91 92 93 94 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 81 def emend_biblio(xml, code, title, usrlbl) unless xml.at("/bibitem/docidentifier[not(@type = 'DOI')][text()]") @log.add("Bibliography", nil, "ERROR: No document identifier retrieved for #{code}") xml.root << "<docidentifier>#{code}</docidentifier>" end unless xml.at("/bibitem/title[text()]") @log.add("Bibliography", nil, "ERROR: No title retrieved for #{code}") xml.root << "<title>#{title || "(MISSING TITLE)"}</title>" end usrlbl and xml.at("/bibitem/docidentifier").next = "<docidentifier type='metanorma'>#{mn_code(usrlbl)}</docidentifier>" end |
#extract_termsource_refs(text, node) ⇒ Object
116 117 118 119 120 121 122 |
# File 'lib/asciidoctor/standoc/terms.rb', line 116 def extract_termsource_refs(text, node) matched = TERM_REFERENCE_RE.match text matched.nil? and @log.add("AsciiDoc Input", node, "term reference not in expected format:"\ "#{text}") matched end |
#fetch_ref(xml, code, year, **opts) ⇒ Object
66 67 68 69 70 71 72 73 74 75 76 77 78 79 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 66 def fetch_ref(xml, code, year, **opts) return nil if opts[:no_year] code = code.sub(/^\([^)]+\)/, "") hit = @bibdb&.fetch(code, year, opts) return nil if hit.nil? xml.parent.add_child(smart_render_xml(hit, code, opts)) xml rescue RelatonBib::RequestError @log.add("Bibliography", nil, "Could not retrieve #{code}: "\ "no access to online site") nil end |
#foreword_parse(attrs, xml, node) ⇒ Object
173 174 175 176 177 178 179 |
# File 'lib/asciidoctor/standoc/section.rb', line 173 def foreword_parse(attrs, xml, node) xml.foreword **attr_code(attrs) do |xml_section| xml_section.title { |t| t << node.title } content = node.content xml_section << content end end |
#global_ievcache_name ⇒ Object
54 55 56 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 54 def global_ievcache_name "#{Dir.home}/.iev/cache" end |
#in_biblio? ⇒ Boolean
4 5 6 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 4 def in_biblio? @biblio end |
#in_norm_ref? ⇒ Boolean
8 9 10 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 8 def in_norm_ref? @norm_ref end |
#in_terms? ⇒ Boolean
4 5 6 |
# File 'lib/asciidoctor/standoc/terms.rb', line 4 def in_terms? @term_def end |
#indexsect_parse(attrs, xml, node) ⇒ Object
128 129 130 131 132 133 |
# File 'lib/asciidoctor/standoc/section.rb', line 128 def indexsect_parse(attrs, xml, node) xml.indexsect **attr_code(attrs) do |xml_section| xml_section.title { |name| name << node.title } xml_section << node.content end end |
#init_bib_caches(node) ⇒ Object
107 108 109 110 111 112 113 114 115 116 117 118 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 107 def init_bib_caches(node) return if @no_isobib global = !@no_isobib_cache && !node.attr("local-cache-only") local = node.attr("local-cache") || node.attr("local-cache-only") local = nil if @no_isobib_cache @bibdb = Relaton::DbCache.init_bib_caches( local_cache: local, flush_caches: node.attr("flush-caches"), global_cache: global ) end |
#init_iev_caches(node) ⇒ Object
120 121 122 123 124 125 126 127 128 129 130 131 132 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 120 def init_iev_caches(node) unless @no_isobib_cache || @no_isobib node.attr("local-cache-only") or @iev_globalname = global_ievcache_name @iev_localname = local_ievcache_name(node.attr("local-cache") || node.attr("local-cache-only")) if node.attr("flush-caches") FileUtils.rm_f @iev_globalname unless @iev_globalname.nil? FileUtils.rm_f @iev_localname unless @iev_localname.nil? end end #@iev = Iev::Db.new(globalname, localname) unless @no_isobib end |
#introduction_parse(attrs, xml, node) ⇒ Object
165 166 167 168 169 170 171 |
# File 'lib/asciidoctor/standoc/section.rb', line 165 def introduction_parse(attrs, xml, node) xml.introduction **attr_code(attrs) do |xml_section| xml_section.title { |t| t << @i18n.introduction } content = node.content xml_section << content end end |
#local_ievcache_name(cachename) ⇒ Object
58 59 60 61 62 63 64 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 58 def local_ievcache_name(cachename) return nil if cachename.nil? cachename += "_iev" unless cachename.empty? cachename = "iev" if cachename.empty? "#{cachename}/cache" end |
#nonterm_symbols_parse(attrs, xml, node) ⇒ Object
8 9 10 11 12 13 |
# File 'lib/asciidoctor/standoc/terms.rb', line 8 def nonterm_symbols_parse(attrs, xml, node) defs = @definitions @definitions = false clause_parse(attrs, xml, node) @definitions = defs end |
#nonterm_term_def_subclause_parse(attrs, xml, node) ⇒ Object
39 40 41 42 43 44 |
# File 'lib/asciidoctor/standoc/terms.rb', line 39 def nonterm_term_def_subclause_parse(attrs, xml, node) defs = @term_def @term_def = false clause_parse(attrs, xml, node) @term_def = defs end |
#norm_ref_parse(attrs, xml, node) ⇒ Object
41 42 43 44 45 46 47 48 49 50 51 52 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 41 def norm_ref_parse(attrs, xml, node) node.option? "bibitem" and return bibitem_parse(attrs, xml, node) node.attr("style") == "bibliography" or @log.add("AsciiDoc Input", node, "Section not marked up as [bibliography]!") @norm_ref = true attrs = attrs.merge(normative: node.attr("normative") || true) xml.references **attr_code(attrs) do |xml_section| xml_section.title { |t| t << node.title } xml_section << node.content end @norm_ref = false end |
#preamble(node) ⇒ Object
118 119 120 121 122 123 124 125 126 |
# File 'lib/asciidoctor/standoc/section.rb', line 118 def preamble(node) noko do |xml| xml.foreword **attr_code(section_attributes(node)) do |xml_abstract| xml_abstract.title { |t| t << (node.blocks[0].title || @i18n.foreword) } content = node.content xml_abstract << content end end.join("\n") end |
#reference(node) ⇒ Object
12 13 14 15 16 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 12 def reference(node) noko do |xml| node.items.each { |item| reference1(node, item.text, xml) } end.join end |
#scope_parse(attrs, xml, node) ⇒ Object
141 142 143 |
# File 'lib/asciidoctor/standoc/section.rb', line 141 def scope_parse(attrs, xml, node) clause_parse(attrs.merge(type: "scope"), xml, node) end |
#section(node) ⇒ Object
66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
# File 'lib/asciidoctor/standoc/section.rb', line 66 def section(node) a = section_attributes(node) noko do |xml| case sectiontype(node) when "introduction" then introduction_parse(a, xml, node) when "foreword" then foreword_parse(a, xml, node) when "scope" then scope_parse(a, xml, node) when "normative references" then norm_ref_parse(a, xml, node) when "terms and definitions" @term_def = true term_def_parse(a, xml, node, true) @term_def = false when "symbols and abbreviated terms" symbols_parse(symbols_attrs(node, a), xml, node) when "acknowledgements" acknowledgements_parse(a, xml, node) when "bibliography" bibliography_parse(a, xml, node) else if @term_def then term_def_subclause_parse(a, xml, node) elsif @definitions then symbols_parse(a, xml, node) elsif @norm_ref then norm_ref_parse(a, xml, node) elsif @biblio then bibliography_parse(a, xml, node) elsif node.attr("style") == "bibliography" && sectiontype(node, false) == "normative references" norm_ref_parse(a, xml, node) elsif node.attr("style") == "bibliography" && sectiontype(node, false) == "bibliography" bibliography_parse(a, xml, node) elsif node.attr("style") == "bibliography" bibliography_parse(a, xml, node) elsif node.attr("style") == "abstract" abstract_parse(a, xml, node) elsif node.attr("style") == "index" indexsect_parse(a, xml, node) elsif node.attr("style") == "appendix" && node.level == 1 annex_parse(a, xml, node) else clause_parse(a, xml, node) end end end.join("\n") end |
#section_attributes(node) ⇒ Object
46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 |
# File 'lib/asciidoctor/standoc/section.rb', line 46 def section_attributes(node) ret = { id: Metanorma::Utils::anchor_or_uuid(node), language: node.attributes["language"], script: node.attributes["script"], number: node.attributes["number"], type: node.attributes["type"], annex: (if (node.attr("style") == "appendix" || node.role == "appendix") && node.level == 1 true end), preface: ( node.role == "preface" || node.attr("style") == "preface" ? true : nil) } return ret unless node.attributes["change"] ret.merge(change: node.attributes["change"], path: node.attributes["path"], path_end: node.attributes["path_end"], title: node.attributes["title"]) end |
#sectiontype(node, level = true) ⇒ Object
18 19 20 21 22 23 24 25 26 27 |
# File 'lib/asciidoctor/standoc/section.rb', line 18 def sectiontype(node, level = true) ret = sectiontype1(node) ret1 = sectiontype_streamline(ret) return ret1 if "symbols and abbreviated terms" == ret1 return nil unless !level || node.level == 1 return nil if @seen_headers.include? ret @seen_headers << ret ret1 end |
#sectiontype1(node) ⇒ Object
12 13 14 15 16 |
# File 'lib/asciidoctor/standoc/section.rb', line 12 def sectiontype1(node) node&.attr("heading")&.downcase || node.title.gsub(%r{<index>.*?</index>}m, "").gsub(/<[^>]+>/, "") .strip.downcase end |
#sectiontype_streamline(ret) ⇒ Object
29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
# File 'lib/asciidoctor/standoc/section.rb', line 29 def sectiontype_streamline(ret) case ret when "terms and definitions", "terms, definitions, symbols and abbreviated terms", "terms, definitions, symbols and abbreviations", "terms, definitions and symbols", "terms, definitions and abbreviations", "terms, definitions and abbreviated terms" "terms and definitions" when "symbols and abbreviated terms", "symbols", "abbreviated terms", "abbreviations" "symbols and abbreviated terms" else ret end end |
#set_obligation(attrs, node) ⇒ Object
108 109 110 111 112 113 114 115 116 |
# File 'lib/asciidoctor/standoc/section.rb', line 108 def set_obligation(attrs, node) attrs[:obligation] = if node.attributes.has_key?("obligation") node.attr("obligation") elsif node.parent.attributes.has_key?("obligation") node.parent.attr("obligation") else "normative" end end |
#smart_render_xml(xml, code, opts) ⇒ Object
96 97 98 99 100 101 102 103 104 105 |
# File 'lib/asciidoctor/standoc/ref_sect.rb', line 96 def smart_render_xml(xml, code, opts) xml.respond_to? :to_xml or return nil xml = Nokogiri::XML(xml.to_xml(lang: opts[:lang])) emend_biblio(xml, code, opts[:title], opts[:usrlbl]) xml.xpath("//date").each { |d| Metanorma::Utils::endash_date(d) } xml.traverse do |n| n.text? and n.replace(Metanorma::Utils::smartformat(n.text)) end xml.to_xml.sub(/<\?[^>]+>/, "") end |
#symbols_attrs(node, attr) ⇒ Object
15 16 17 18 19 20 21 22 23 |
# File 'lib/asciidoctor/standoc/terms.rb', line 15 def symbols_attrs(node, attr) case sectiontype1(node) when "symbols" then attr.merge(type: "symbols") when "abbreviated terms", "abbreviations" attr.merge(type: "abbreviated_terms") else attr end end |
#symbols_parse(attr, xml, node) ⇒ Object
25 26 27 28 29 30 31 32 33 34 35 36 37 |
# File 'lib/asciidoctor/standoc/terms.rb', line 25 def symbols_parse(attr, xml, node) node.role == "nonterm" and return nonterm_symbols_parse(attr, xml, node) xml.definitions **attr_code(attr) do |xml_section| xml_section.title { |t| t << node.title } defs = @definitions termdefs = @term_def @definitions = true @term_def = false xml_section << node.content @definitions = defs @term_def = termdefs end end |
#term_def_parse(attrs, xml, node, _toplevel) ⇒ Object
77 78 79 80 81 82 83 84 85 |
# File 'lib/asciidoctor/standoc/terms.rb', line 77 def term_def_parse(attrs, xml, node, _toplevel) xml.terms **attr_code(attrs) do |section| section.title { |t| t << node.title } (s = node.attr("source")) && s.split(",").each do |s1| section.termdocsource(nil, **attr_code(bibitemid: s1)) end section << node.content end end |
#term_def_subclause_parse(attrs, xml, node) ⇒ Object
subclause contains subclauses
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 |
# File 'lib/asciidoctor/standoc/terms.rb', line 54 def term_def_subclause_parse(attrs, xml, node) node.role == "nonterm" and return nonterm_term_def_subclause_parse(attrs, xml, node) node.role == "boilerplate" and return terms_boilerplate_parse(attrs, xml, node) st = sectiontype(node, false) return symbols_parse(attrs, xml, node) if @definitions sub = node.find_by(context: :section) { |s| s.level == node.level + 1 } sub.empty? || (return term_def_parse(attrs, xml, node, false)) st == "symbols and abbreviated terms" and return symbols_parse(attrs, xml, node) st == "terms and definitions" and return clause_parse(attrs, xml, node) term_def_subclause_parse1(attrs, xml, node) end |
#term_def_subclause_parse1(attrs, xml, node) ⇒ Object
70 71 72 73 74 75 |
# File 'lib/asciidoctor/standoc/terms.rb', line 70 def term_def_subclause_parse1(attrs, xml, node) xml.term **attr_code(attrs) do |xml_section| xml_section.preferred { |name| name << node.title } xml_section << node.content end end |
#term_source_attrs(_node, seen_xref) ⇒ Object
87 88 89 90 91 92 |
# File 'lib/asciidoctor/standoc/terms.rb', line 87 def term_source_attrs(_node, seen_xref) { case: seen_xref.children[0]["case"], droploc: seen_xref.children[0]["droploc"], bibitemid: seen_xref.children[0]["target"], format: seen_xref.children[0]["format"], type: "inline" } end |
#termdefinition(node) ⇒ Object
135 136 137 138 139 140 141 |
# File 'lib/asciidoctor/standoc/terms.rb', line 135 def termdefinition(node) noko do |xml| xml.definition do |d| d << node.content end end.join("\n") end |
#terms_boilerplate_parse(attrs, xml, node) ⇒ Object
46 47 48 49 50 51 |
# File 'lib/asciidoctor/standoc/terms.rb', line 46 def terms_boilerplate_parse(attrs, xml, node) defs = @term_def @term_def = false clause_parse(attrs.merge(type: "boilerplate"), xml, node) @term_def = defs end |
#termsource(node) ⇒ Object
124 125 126 127 128 129 130 131 132 133 |
# File 'lib/asciidoctor/standoc/terms.rb', line 124 def termsource(node) matched = extract_termsource_refs(node.content, node) || return noko do |xml| attrs = { status: matched[:text] ? "modified" : "identical" } xml.termsource **attrs do |xml_t| seen_xref = Nokogiri::XML.fragment(matched[:xref]) add_term_source(node, xml_t, seen_xref, matched) end end.join("\n") end |