Module: IsoDoc::HtmlFunction::Comments

Included in:
IsoDoc::HeadlessHtmlConvert, IsoDoc::HtmlConvert, PdfConvert
Defined in:
lib/isodoc/html_function/comments.rb

Constant Summary collapse

COMMENT_IN_COMMENT_LIST = 
'//div[@style="mso-element:comment-list"]//'\
'span[@style="MsoCommentReference"]'.freeze
COMMENT_TARGET_XREFS = 
"//span[@style='mso-special-character:comment']/@target".freeze

Instance Method Summary collapse

Instance Method Details

#comment_attributes(docxml, x) ⇒ Object 



84
85
86
87
88
89
90
 
# File 'lib/isodoc/html_function/comments.rb', line 84

def comment_attributes(docxml, x)
  fromlink = docxml.at("//*[@id='#{x['from']}']")
  return(nil) if fromlink.nil?
  tolink = docxml.at("//*[@id='#{x['to']}']") || fromlink
  target = docxml.at("//*[@id='#{x['target']}']")
  { from: fromlink, to: tolink, target: target }
end

#comment_cleanup(docxml) ⇒ Object 



57
58
59
60
61
62
63
 
# File 'lib/isodoc/html_function/comments.rb', line 57

def comment_cleanup(docxml)
=begin
  move_comment_link_to_from(docxml)
  reorder_comments_by_comment_link(docxml)
  embed_comment_in_comment_list(docxml)
=end
end

#comment_link_attrs(fn, node) ⇒ Object 



27
28
29
30
31
 
# File 'lib/isodoc/html_function/comments.rb', line 27

def comment_link_attrs(fn, node)
  { style: "MsoCommentReference", target: fn,
    class: "commentLink", from: node["from"],
    to: node["to"] }
end

#comments(div) ⇒ Object 



8
9
10
11
12
13
14
15
 
# File 'lib/isodoc/html_function/comments.rb', line 8

def comments(div)
=begin
  return if @comments.empty?
  div.div **{ style: "mso-element:comment-list" } do |div1|
    @comments.each { |fn| div1.parent << fn }
  end
=end
end

#embed_comment_in_comment_list(docxml) ⇒ Object 



69
70
71
72
73
74
75
 
# File 'lib/isodoc/html_function/comments.rb', line 69

def embed_comment_in_comment_list(docxml)
  docxml.xpath(COMMENT_IN_COMMENT_LIST).each do |x|
    n = x.next_element
    n&.children&.first&.add_previous_sibling(x.remove)
  end
  docxml
end

#get_comments_from_text(docxml, link_order) ⇒ Object 



121
122
123
124
125
126
127
128
129
 
# File 'lib/isodoc/html_function/comments.rb', line 121

def get_comments_from_text(docxml, link_order)
  comments = []
  docxml.xpath("//div[@style='mso-element:comment']").each do |c|
    next unless c["id"] && !link_order[c["id"]].nil?
    comments << { text: c.remove.to_s, id: c["id"] }
  end
  comments.sort! { |a, b| link_order[a[:id]] <=> link_order[b[:id]] }
  # comments
end

#in_comment ⇒ Object 



4
5
6
 
# File 'lib/isodoc/html_function/comments.rb', line 4

def in_comment
  @in_comment
end

#insert_comment_cont(from, to, target) ⇒ Object 



101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/isodoc/html_function/comments.rb', line 101

def insert_comment_cont(from, to, target)
  # includes_to = from.at(".//*[@id='#{to}']")
  while !from.nil? && from["id"] != to
    following = from.xpath("./following::*")
    (from = following.shift) && incl_to = from.at(".//*[@id='#{to}']")
    while !incl_to.nil? && !from.nil? && skip_comment_wrap(from)
      (from = following.shift) && incl_to = from.at(".//*[@id='#{to}']")
    end
    wrap_comment_cont(from, target) if !from.nil?
  end
end

#make_comment_link(out, fn, node) ⇒ Object

add in from and to links to move the comment into place



34
35
36
37
38
39
 
# File 'lib/isodoc/html_function/comments.rb', line 34

def make_comment_link(out, fn, node)
  out.span(**comment_link_attrs(fn, node)) do |s1|
      s1.a **{ style: "mso-comment-reference:SMC_#{fn};"\
               "mso-comment-date:#{node['date'].gsub(/[-:Z]/, '')}" }
    end
end

#make_comment_target(out) ⇒ Object 



41
42
43
44
45
 
# File 'lib/isodoc/html_function/comments.rb', line 41

def make_comment_target(out)
  out.span **{ style: "MsoCommentReference" } do |s1|
      s1.span **{ style: "mso-special-character:comment" }
    end
end

#make_comment_text(node, fn) ⇒ Object 



47
48
49
50
51
52
53
54
55
 
# File 'lib/isodoc/html_function/comments.rb', line 47

def make_comment_text(node, fn)
  noko do |xml|
    xml.div **{ style: "mso-element:comment", id: fn } do |div|
      div.span **{ style: %{mso-comment-author:"#{node['reviewer']}"} }
      make_comment_target(div)
      node.children.each { |n| parse(n, div) }
    end
  end.join("\n")
end

#move_comment_link_to_from(docxml) ⇒ Object 



113
114
115
116
117
118
119
 
# File 'lib/isodoc/html_function/comments.rb', line 113

def move_comment_link_to_from(docxml)
  docxml.xpath('//span[@style="MsoCommentReference"][@from]').each do |x|
    attrs = comment_attributes(docxml, x) || next
    move_comment_link_to_from1(x, attrs[:from])
    insert_comment_cont(attrs[:from], x["to"], x["target"])
  end
end

#move_comment_link_to_from1(x, fromlink) ⇒ Object 



77
78
79
80
81
82
 
# File 'lib/isodoc/html_function/comments.rb', line 77

def move_comment_link_to_from1(x, fromlink)
  x.remove
  link = x.at(".//a")
  fromlink.replace(x)
  link.children = fromlink
end

#reorder_comments_by_comment_link(docxml) ⇒ Object 



134
135
136
137
138
139
140
141
142
 
# File 'lib/isodoc/html_function/comments.rb', line 134

def reorder_comments_by_comment_link(docxml)
  link_order = {}
  docxml.xpath(COMMENT_TARGET_XREFS).each_with_index do |target, i|
    link_order[target.value] = i
  end
  comments = get_comments_from_text(docxml, link_order)
  list = docxml.at("//*[@style='mso-element:comment-list']") || return
  list.children = comments.map { |c| c[:text] }.join("\n")
end

#review_note_parse(node, out) ⇒ Object 



17
18
19
20
21
22
23
24
25
 
# File 'lib/isodoc/html_function/comments.rb', line 17

def review_note_parse(node, out)
=begin
  fn = @comments.length + 1
  make_comment_link(out, fn, node)
  @in_comment = true
  @comments << make_comment_text(node, fn)
  @in_comment = false
=end
end

#skip_comment_wrap(from) ⇒ Object 



97
98
99
 
# File 'lib/isodoc/html_function/comments.rb', line 97

def skip_comment_wrap(from)
  from["style"] != "mso-special-character:comment"
end

#wrap_comment_cont(from, target) ⇒ Object 



92
93
94
95
 
# File 'lib/isodoc/html_function/comments.rb', line 92

def wrap_comment_cont(from, target)
  s = from.replace("<span style='mso-comment-continuation:#{target}'>")
  s.first.children = from
end