Module: IsoDoc::Function::Section

Included in:
Common
Defined in:
lib/isodoc/function/section.rb,
lib/isodoc/function/section_titles.rb

Constant Summary collapse

TERM_CLAUSE = 
"//sections/terms | " \
"//sections/clause[descendant::terms]".freeze

Instance Method Summary collapse

Instance Method Details

#abstract(clause, out) ⇒ Object 



122
123
124
125
126
127
128
129
 
# File 'lib/isodoc/function/section.rb', line 122

def abstract(clause, out)
  page_break(out)
  out.div **attr_code(id: clause["id"]) do |s|
    clause_name(clause, clause.at(ns("./title")), s,
                { class: "AbstractTitle" })
    clause.elements.each { |e| parse(e, s) unless e.name == "title" }
  end
end

#acknowledgements(clause, out) ⇒ Object 



111
112
113
114
115
116
117
118
119
120
 
# File 'lib/isodoc/function/section.rb', line 111

def acknowledgements(clause, out)
  title_attr = { class: "IntroTitle" }
  page_break(out)
  out.div class: "Section3", id: clause["id"] do |div|
    clause_name(clause, clause.at(ns("./title")), div, title_attr)
    clause.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#annex(node, out) ⇒ Object 



33
34
35
36
37
38
39
40
41
42
 
# File 'lib/isodoc/function/section.rb', line 33

def annex(node, out)
  page_break(out)
  out.div **attr_code(annex_attrs(node)) do |s|
    node.elements.each do |c1|
      if c1.name == "title" then annex_name(node, c1, s)
      else parse(c1, s)
      end
    end
  end
end

#annex_attrs(node) ⇒ Object 



29
30
31
 
# File 'lib/isodoc/function/section.rb', line 29

def annex_attrs(node)
  { id: node["id"], class: "Section3" }
end

#annex_name(_annex, name, div) ⇒ Object 



78
79
80
81
82
83
84
85
 
# File 'lib/isodoc/function/section_titles.rb', line 78

def annex_name(_annex, name, div)
  return if name.nil?

  div.h1 class: "Annex" do |t|
    name.children.each { |c2| parse(c2, t) }
    clause_parse_subtitle(name, t)
  end
end

#clause(node, out) ⇒ Object 



20
21
22
23
24
25
26
27
 
# File 'lib/isodoc/function/section.rb', line 20

def clause(node, out)
  out.div **attr_code(clause_attrs(node)) do |s|
    clause_name(node, node.at(ns("./title")), s, nil)
    node.elements.reject { |c1| c1.name == "title" }.each do |c1|
      parse(c1, s)
    end
  end
end

#clause_attrs(node) ⇒ Object 



6
7
8
 
# File 'lib/isodoc/function/section.rb', line 6

def clause_attrs(node)
  { id: node["id"] }
end

#clause_name(node, title, div, header_class) ⇒ Object

top level clause names



66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/isodoc/function/section_titles.rb', line 66

def clause_name(node, title, div, header_class)
  header_class = {} if header_class.nil?
  div.h1 **attr_code(header_class) do |h1|
    if title.is_a?(String) then h1 << title
    else
      title&.children&.each { |c2| parse(c2, h1) }
      clause_parse_subtitle(title, h1)
    end
  end
  div.parent.at(".//h1")
end

#clause_parse(node, out) ⇒ Object

used for subclauses



11
12
13
14
15
16
17
18
 
# File 'lib/isodoc/function/section.rb', line 11

def clause_parse(node, out)
  out.div **attr_code(clause_attrs(node)) do |div|
    clause_parse_title(node, div, node.at(ns("./title")), out)
    node.children.reject { |c1| c1.name == "title" }.each do |c1|
      parse(c1, div)
    end
  end
end

#clause_parse_subtitle(title, heading) ⇒ Object 



56
57
58
59
60
61
62
63
 
# File 'lib/isodoc/function/section_titles.rb', line 56

def clause_parse_subtitle(title, heading)
  if var = title&.at("./following-sibling::xmlns:variant-title" \
                     "[@type = 'sub']")&.remove
    heading.br nil
    heading.br nil
    var.children.each { |c2| parse(c2, heading) }
  end
end

#clause_parse_title(node, div, title, out, header_class = {}) ⇒ Object

used for subclauses



30
31
32
33
34
35
36
37
38
 
# File 'lib/isodoc/function/section_titles.rb', line 30

def clause_parse_title(node, div, title, out, header_class = {})
  return if title.nil?

  if node["inline-header"] == "true"
    inline_header_title(out, node, title)
  else
    clause_parse_title1(node, div, title, out, header_class)
  end
end

#clause_parse_title1(node, div, title, _out, header_class = {}) ⇒ Object 



40
41
42
43
44
45
46
 
# File 'lib/isodoc/function/section_titles.rb', line 40

def clause_parse_title1(node, div, title, _out, header_class = {})
  depth = clause_title_depth(node, title)
  div.send "h#{depth}", **attr_code(header_class) do |h|
    title&.children&.each { |c2| parse(c2, h) }
    clause_parse_subtitle(title, h)
  end
end

#clause_title_depth(node, title) ⇒ Object 



48
49
50
51
52
53
54
 
# File 'lib/isodoc/function/section_titles.rb', line 48

def clause_title_depth(node, title)
  depth = node.ancestors("clause, annex, terms, references, " \
                         "definitions, acknowledgements, introduction, " \
                         "foreword").size + 1
  depth = title["depth"] if title && title["depth"]
  depth
end

#clausedelim ⇒ Object 



4
5
6
 
# File 'lib/isodoc/function/section_titles.rb', line 4

def clausedelim
  "."
end

#clausedelimspace(_node, out) ⇒ Object 



8
9
10
 
# File 'lib/isodoc/function/section_titles.rb', line 8

def clausedelimspace(_node, out)
  insert_tab(out, 1)
end

#colophon(node, out) ⇒ Object 



167
168
169
170
171
172
173
174
175
176
177
 
# File 'lib/isodoc/function/section.rb', line 167

def colophon(node, out)
  @seen_colophon or page_break(out)
  @seen_colophon = true
  out.div class: "Section3", id: node["id"] do |div|
    clause_name(node, node.at(ns("./title")), div,
                { class: "IntroTitle" })
    node.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#copyright_parse(node, out) ⇒ Object 



198
199
200
201
202
203
 
# File 'lib/isodoc/function/section.rb', line 198

def copyright_parse(node, out)
  @bare and return
  out.div class: "boilerplate-copyright" do |div|
    node.children.each { |n| parse(n, div) }
  end
end

#executivesummary(clause, out) ⇒ Object 



189
190
191
 
# File 'lib/isodoc/function/section.rb', line 189

def executivesummary(clause, out)
  introduction clause, out
end

#feedback_parse(node, out) ⇒ Object 



219
220
221
222
223
224
 
# File 'lib/isodoc/function/section.rb', line 219

def feedback_parse(node, out)
  @bare and return
  out.div class: "boilerplate-feedback" do |div|
    node.children.each { |n| parse(n, div) }
  end
end

#foreword(clause, out) ⇒ Object 



102
103
104
105
106
107
108
109
 
# File 'lib/isodoc/function/section.rb', line 102

def foreword(clause, out)
  page_break(out)
  out.div **attr_code(id: clause["id"]) do |s|
    clause_name(clause, clause.at(ns("./title")) || @i18n.foreword, s,
                { class: "ForewordTitle" })
    clause.elements.each { |e| parse(e, s) unless e.name == "title" }
  end
end

#freestanding_title(node, out) ⇒ Object 



21
22
23
24
25
26
27
 
# File 'lib/isodoc/function/section_titles.rb', line 21

def freestanding_title(node, out)
  parents = node.ancestors("clause, annex, terms, references, " \
                         "definitions, acknowledgements, introduction, " \
                         "foreword")
  clause_parse_title(parents.empty? ? node : parents.first,
                     out, node, out)
end

#indexsect(node, out) ⇒ Object 



44
45
46
 
# File 'lib/isodoc/function/section.rb', line 44

def indexsect(node, out)
  clause_parse(node, out)
end

#inline_header_title(out, node, title) ⇒ Object 



12
13
14
15
16
17
18
19
 
# File 'lib/isodoc/function/section_titles.rb', line 12

def inline_header_title(out, node, title)
  out.span class: "zzMoveToFollowing inline-header" do |s|
    s.b do |b|
      title&.children&.each { |c2| parse(c2, b) }
      clausedelimspace(node, out) if /\S/.match?(title&.text)
    end
  end
end

#introduction(clause, out) ⇒ Object 



91
92
93
94
95
96
97
98
99
100
 
# File 'lib/isodoc/function/section.rb', line 91

def introduction(clause, out)
  page_break(out)
  out.div class: "Section3", id: clause["id"] do |div|
    clause_name(clause, clause.at(ns("./title")), div,
                { class: "IntroTitle" })
    clause.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#is_clause?(name) ⇒ Boolean

Returns:

  • (Boolean) 


179
180
181
182
 
# File 'lib/isodoc/function/section.rb', line 179

def is_clause?(name)
  %w(clause references definitions terms foreword introduction abstract
     acknowledgements).include? name
end

#legal_parse(node, out) ⇒ Object 



212
213
214
215
216
217
 
# File 'lib/isodoc/function/section.rb', line 212

def legal_parse(node, out)
  @bare and return
  out.div class: "boilerplate-legal" do |div|
    node.children.each { |n| parse(n, div) }
  end
end

#license_parse(node, out) ⇒ Object 



205
206
207
208
209
210
 
# File 'lib/isodoc/function/section.rb', line 205

def license_parse(node, out)
  @bare and return
  out.div class: "boilerplate-license" do |div|
    node.children.each { |n| parse(n, div) }
  end
end

#preface(clause, out) ⇒ Object 



136
137
138
139
140
141
142
 
# File 'lib/isodoc/function/section.rb', line 136

def preface(clause, out)
  if clause["type"] == "toc"
    table_of_contents(clause, out)
  else
    preface_normal(clause, out)
  end
end

#preface_attrs(node) ⇒ Object 



131
132
133
134
 
# File 'lib/isodoc/function/section.rb', line 131

def preface_attrs(node)
  { id: node["id"],
    class: node["type"] == "toc" ? "TOC" : "Section3" }
end

#preface_block(block, out) ⇒ Object

block, e.g. note, admonition



194
195
196
 
# File 'lib/isodoc/function/section.rb', line 194

def preface_block(block, out)
  parse(block, out)
end

#preface_normal(clause, out) ⇒ Object 



144
145
146
147
148
149
150
151
152
153
 
# File 'lib/isodoc/function/section.rb', line 144

def preface_normal(clause, out)
  page_break(out)
  out.div **attr_code(preface_attrs(clause)) do |div|
    clause_name(clause, clause.at(ns("./title")), div,
                { class: "IntroTitle" })
    clause.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#scope(node, out) ⇒ Object 



48
49
50
51
52
53
54
55
 
# File 'lib/isodoc/function/section.rb', line 48

def scope(node, out)
  out.div **attr_code(id: node["id"]) do |div|
    clause_name(node, node.at(ns("./title")), div, nil)
    node.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#single_term_clause?(elem) ⇒ Boolean

Returns:

  • (Boolean) 


184
185
186
187
 
# File 'lib/isodoc/function/section.rb', line 184

def single_term_clause?(elem)
  t = elem.xpath(ns("./clause | ./terms | ./definitions | ./references"))
  t.size == 1 && %w(terms definitions references).include?(t[0].name)
end

#symbols_abbrevs(node, out) ⇒ Object 



74
75
76
77
78
79
80
81
 
# File 'lib/isodoc/function/section.rb', line 74

def symbols_abbrevs(node, out)
  out.div **attr_code(id: node["id"], class: "Symbols") do |div|
    clause_name(node, node.at(ns("./title")), div, nil)
    node.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#symbols_parse(isoxml, out) ⇒ Object

subclause



84
85
86
87
88
89
 
# File 'lib/isodoc/function/section.rb', line 84

def symbols_parse(isoxml, out)
  isoxml.at(ns("./title")) or
    #isoxml.children.first.previous = "<title>#{@i18n.symbols}</title>"
    isoxml.add_first_child "<title>#{@i18n.symbols}</title>"
  clause_parse(isoxml, out)
end

#table_of_contents(clause, out) ⇒ Object 



155
156
157
158
159
160
161
162
163
164
165
 
# File 'lib/isodoc/function/section.rb', line 155

def table_of_contents(clause, out)
  @bare and return
  page_break(out)
  out.div **attr_code(preface_attrs(clause)) do |div|
    clause_name(clause, clause.at(ns("./title")), div,
                { class: "IntroTitle" })
    clause.elements.each do |e|
      parse(e, div) unless e.name == "title"
    end
  end
end

#terms_defs(node, out) ⇒ Object 



60
61
62
63
64
65
66
67
 
# File 'lib/isodoc/function/section.rb', line 60

def terms_defs(node, out)
  out.div **attr_code(id: node["id"]) do |div|
    clause_name(node, node.at(ns("./title")), div, nil)
    node.elements.each do |e|
      parse(e, div) unless %w{title source}.include? e.name
    end
  end
end

#terms_parse(isoxml, out) ⇒ Object

subclause



70
71
72
 
# File 'lib/isodoc/function/section.rb', line 70

def terms_parse(isoxml, out)
  clause_parse(isoxml, out)
end

#variant_title(node, out) ⇒ Object 



87
88
89
90
91
92
 
# File 'lib/isodoc/function/section_titles.rb', line 87

def variant_title(node, out)
  out.p **attr_code(style: "display:none;",
                    class: "variant-title-#{node['type']}") do |p|
    node.children.each { |c| parse(c, p) }
  end
end