class ReVIEW::Builder
Constants
- CAPTION_TITLES
Attributes
doc_status[RW]
location[R]
Public Class Methods
new(strict = false, *_args, img_math: nil)
click to toggle source
# File lib/review/builder.rb, line 38 def initialize(strict = false, *_args, img_math: nil) @strict = strict @output = nil @logger = ReVIEW.logger @doc_status = {} @dictionary = {} @img_math = img_math @shown_endnotes = true end
Public Instance Methods
beginchild()
click to toggle source
# File lib/review/builder.rb, line 764 def beginchild @children ||= [] unless previous_list_type app_error "#{@location}: //beginchild is shown, but previous element isn't ul, ol, or dl" end puts "\x01→#{previous_list_type}←\x01" @children.push(previous_list_type) end
bibpaper(lines, id, caption)
click to toggle source
# File lib/review/builder.rb, line 432 def bibpaper(lines, id, caption) bibpaper_header(id, caption) unless lines.empty? puts bibpaper_bibpaper(id, caption, lines) end puts end
bind(compiler, chapter, location)
click to toggle source
# File lib/review/builder.rb, line 48 def bind(compiler, chapter, location) @compiler = compiler @chapter = chapter @location = location @output = StringIO.new if @chapter.present? @book = @chapter.book end @chapter.generate_indexes if @book @book.generate_indexes end @tabwidth = nil @tsize = nil if @book && @book.config @img_math ||= ReVIEW::ImgMath.new(@book.config) if words_file_path = @book.config['words_file'] if words_file_path.is_a?(String) words_files = [words_file_path] else words_files = words_file_path end words_files.each do |f| load_words(f) end end if @book.config['tabwidth'] @tabwidth = @book.config['tabwidth'] end if @book.config['join_lines_by_lang'] begin require 'unicode/eaw' rescue LoadError warn 'not found unicode/eaw. disabled join_lines_by_lang feature.', location: @location @book.config['join_lines_by_lang'] = nil end end end builder_init_file end
blankline()
click to toggle source
# File lib/review/builder.rb, line 307 def blankline puts '' end
caption_top?(type)
click to toggle source
# File lib/review/builder.rb, line 781 def caption_top?(type) unless %w[top bottom].include?(@book.config['caption_position'][type]) warn "invalid caption_position/#{type} parameter. 'top' is assumed", location: @location end @book.config['caption_position'][type] != 'bottom' end
captionblock(_type, _lines, _caption, _specialstyle = nil)
click to toggle source
# File lib/review/builder.rb, line 573 def captionblock(_type, _lines, _caption, _specialstyle = nil) raise NotImplementedError end
check_nest()
click to toggle source
# File lib/review/builder.rb, line 105 def check_nest if @children && !@children.empty? app_error "#{@location}: //beginchild of #{@children.reverse.join(',')} misses //endchild" end end
check_nested_minicolumn()
click to toggle source
# File lib/review/builder.rb, line 598 def check_nested_minicolumn if @doc_status[:minicolumn] app_error "#{@location}: nested mini-column is not allowed" end end
check_printendnotes()
click to toggle source
# File lib/review/builder.rb, line 111 def check_printendnotes if @shown_endnotes.nil? app_error "#{@location}: //endnote is found but //printendnotes is not found." end end
compile_inline(s)
click to toggle source
# File lib/review/builder.rb, line 311 def compile_inline(s) @compiler.text(s) end
detab(str, num = nil)
click to toggle source
override TextUtils::detab
Calls superclass method
ReVIEW::TextUtils#detab
# File lib/review/builder.rb, line 746 def detab(str, num = nil) if num super(str, num) elsif @tabwidth super(str, @tabwidth) else super(str) end end
embed(lines, arg = nil)
click to toggle source
# File lib/review/builder.rb, line 516 def embed(lines, arg = nil) if arg builders = arg.gsub(/^\s*\|/, '').gsub(/\|\s*$/, '').gsub(/\s/, '').split(',') c = target_name print lines.join("\n") + "\n" if builders.include?(c) else print lines.join("\n") + "\n" end end
emtable(lines, caption = nil)
click to toggle source
# File lib/review/builder.rb, line 280 def emtable(lines, caption = nil) table(lines, nil, caption) end
endchild()
click to toggle source
# File lib/review/builder.rb, line 773 def endchild if @children.nil? || @children.empty? app_error "#{@location}: //endchild is shown, but any opened //beginchild doesn't exist" else puts "\x01→/#{@children.pop}←\x01" end end
endnote(_id, _str)
click to toggle source
# File lib/review/builder.rb, line 293 def endnote(_id, _str) @shown_endnotes = nil end
endnote_begin()
click to toggle source
# File lib/review/builder.rb, line 297 def endnote_begin end
endnote_end()
click to toggle source
# File lib/review/builder.rb, line 300 def endnote_end end
endnote_item(id)
click to toggle source
# File lib/review/builder.rb, line 303 def endnote_item(id) puts "(#{@chapter.endnote(id).number}) #{compile_inline(@chapter.endnote(id).content)}" end
escape(str)
click to toggle source
# File lib/review/builder.rb, line 756 def escape(str) str end
extract_chapter_id(chap_ref)
click to toggle source
# File lib/review/builder.rb, line 562 def extract_chapter_id(chap_ref) m = /\A([\w+-]+)\|(.+)/.match(chap_ref) if m ch = @book.contents.detect { |chap| chap.id == m[1] } raise KeyError unless ch return [ch, m[2]] end [@chapter, chap_ref] end
firstlinenum(num)
click to toggle source
for //firstlinenum[num]
# File lib/review/builder.rb, line 155 def firstlinenum(num) @first_line_num = num.to_i end
get_chap(chapter = @chapter)
click to toggle source
# File lib/review/builder.rb, line 551 def get_chap(chapter = @chapter) if @book.config['secnolevel'] > 0 && !chapter.number.nil? && !chapter.number.to_s.empty? if chapter.is_a?(ReVIEW::Book::Part) return I18n.t('part_short', chapter.number) else return chapter.format_number(nil) end end nil end
graph(lines, id, command, caption = '')
click to toggle source
# File lib/review/builder.rb, line 612 def graph(lines, id, command, caption = '') c = target_name dir = File.join(@book.imagedir, c) FileUtils.mkdir_p(dir) file = "#{id}.#{image_ext}" file_path = File.join(dir, file) content = lines.join("\n") + "\n" tf = Tempfile.new('review_graph') tf.puts content tf.close begin file_path = send("graph_#{command}".to_sym, id, file_path, content, tf.path) ensure tf.unlink end @chapter.image_index.image_finder.add_entry(file_path) image(lines, id, caption) end
graph_aafigure(id, file_path, _line, tf_path)
click to toggle source
# File lib/review/builder.rb, line 661 def graph_aafigure(id, file_path, _line, tf_path) system_graph(id, 'aafigure', '-t', image_ext, '-o', file_path, tf_path) file_path end
graph_blockdiag(id, file_path, _line, tf_path)
click to toggle source
# File lib/review/builder.rb, line 656 def graph_blockdiag(id, file_path, _line, tf_path) system_graph(id, 'blockdiag', '-a', '-T', image_ext, '-o', file_path, tf_path) file_path end
graph_gnuplot(id, file_path, line, tf_path)
click to toggle source
# File lib/review/builder.rb, line 644 def graph_gnuplot(id, file_path, line, tf_path) File.open(tf_path, 'w') do |tf| tf.puts <<EOTGNUPLOT set terminal #{image_ext == 'eps' ? 'postscript eps' : image_ext} set output "#{file_path}" #{line} EOTGNUPLOT end system_graph(id, 'gnuplot', tf_path) file_path end
graph_graphviz(id, file_path, _line, tf_path)
click to toggle source
# File lib/review/builder.rb, line 639 def graph_graphviz(id, file_path, _line, tf_path) system_graph(id, 'dot', "-T#{image_ext}", "-o#{file_path}", tf_path) file_path end
graph_plantuml(id, file_path, _line, tf_path)
click to toggle source
# File lib/review/builder.rb, line 666 def graph_plantuml(id, file_path, _line, tf_path) ext = image_ext if ext == 'pdf' ext = 'eps' file_path.sub!(/\.pdf\Z/, '.eps') end plant_path = nil if File.exist?('plantuml.jar') plant_path = 'plantuml.jar' elsif File.exist?('/usr/share/plantuml/plantuml.jar') plant_path = '/usr/share/plantuml/plantuml.jar' elsif File.exist?('/usr/share/java/plantuml.jar') plant_path = '/usr/share/java/plantuml.jar' else error!('missing plantuml.jar. Please put plantuml.jar at the working folder.') end system_graph(id, 'java', '-jar', plant_path, "-t#{ext}", '-charset', 'UTF-8', tf_path) FileUtils.mv("#{tf_path}.#{ext}", file_path) file_path end
handle_metric(str)
click to toggle source
# File lib/review/builder.rb, line 526 def handle_metric(str) str end
highlight?()
click to toggle source
# File lib/review/builder.rb, line 96 def highlight? false end
image(lines, id, caption, metric = nil)
click to toggle source
# File lib/review/builder.rb, line 194 def image(lines, id, caption, metric = nil) if @chapter.image_bound?(id) image_image(id, caption, metric) else warn "image not bound: #{id}", location: @location if @strict image_dummy(id, caption, lines) end end
image_ext()
click to toggle source
# File lib/review/builder.rb, line 687 def image_ext raise NotImplementedError end
in_minicolumn?()
click to toggle source
# File lib/review/builder.rb, line 604 def in_minicolumn? @doc_status[:minicolumn] end
inline_balloon(arg)
click to toggle source
# File lib/review/builder.rb, line 481 def inline_balloon(arg) "← #{arg}" end
inline_bou(str)
click to toggle source
# File lib/review/builder.rb, line 399 def inline_bou(str) text(str) end
inline_chap(id)
click to toggle source
# File lib/review/builder.rb, line 321 def inline_chap(id) @book.chapter_index.number(id) rescue KeyError app_error "unknown chapter: #{id}" end
inline_chapref(id)
click to toggle source
# File lib/review/builder.rb, line 315 def inline_chapref(id) compile_inline(@book.chapter_index.display_string(id)) rescue KeyError app_error "unknown chapter: #{id}" end
inline_column(id)
click to toggle source
# File lib/review/builder.rb, line 455 def inline_column(id) m = /\A([^|]+)\|(.+)/.match(id) if m && m[1] chapter = @book.chapters.detect { |chap| chap.id == m[1] } end if chapter inline_column_chap(chapter, m[2]) else inline_column_chap(@chapter, id) end rescue KeyError app_error "unknown column: #{id}" end
inline_column_chap(chapter, id)
click to toggle source
# File lib/review/builder.rb, line 469 def inline_column_chap(chapter, id) I18n.t('column', chapter.column(id).caption) end
inline_embed(args)
click to toggle source
# File lib/review/builder.rb, line 728 def inline_embed(args) if matched = args.match(/\|(.*?)\|(.*)/) builders = matched[1].split(',').map { |i| i.gsub(/\s/, '') } if builders.include?(target_name) matched[2] else '' end else args end end
inline_endnote(id)
click to toggle source
# File lib/review/builder.rb, line 393 def inline_endnote(id) "(#{@chapter.endnote(id).number})" rescue KeyError app_error "unknown endnote: #{id}" end
inline_eq(id)
click to toggle source
# File lib/review/builder.rb, line 376 def inline_eq(id) chapter, id = extract_chapter_id(id) if get_chap(chapter) %Q(#{I18n.t('equation')}#{I18n.t('format_number', [get_chap(chapter), chapter.equation(id).number])}) else %Q(#{I18n.t('equation')}#{I18n.t('format_number_without_chapter', [chapter.equation(id).number])}) end rescue KeyError app_error "unknown equation: #{id}" end
inline_fn(id)
click to toggle source
# File lib/review/builder.rb, line 387 def inline_fn(id) @chapter.footnote(id).content rescue KeyError app_error "unknown footnote: #{id}" end
inline_hd(id)
click to toggle source
# File lib/review/builder.rb, line 441 def inline_hd(id) m = /\A([^|]+)\|(.+)/.match(id) if m && m[1] chapter = @book.contents.detect { |chap| chap.id == m[1] } end if chapter inline_hd_chap(chapter, m[2]) else inline_hd_chap(@chapter, id) end rescue KeyError app_error "unknown headline: #{id}" end
inline_href(arg)
click to toggle source
# File lib/review/builder.rb, line 419 def inline_href(arg) url, label = *arg.scan(/(?:(?:(?:\\\\)*\\,)|[^,\\]+)+/).map(&:lstrip) url = url.gsub(/\\,/, ',').strip if label label = label.gsub(/\\,/, ',').strip end compile_href(url, label) end
inline_img(id)
click to toggle source
# File lib/review/builder.rb, line 344 def inline_img(id) chapter, id = extract_chapter_id(id) if get_chap(chapter) %Q(#{I18n.t('image')}#{I18n.t('format_number', [get_chap(chapter), chapter.image(id).number])}) else %Q(#{I18n.t('image')}#{I18n.t('format_number_without_chapter', [chapter.image(id).number])}) end rescue KeyError app_error "unknown image: #{id}" end
inline_imgref(id)
click to toggle source
# File lib/review/builder.rb, line 355 def inline_imgref(id) img = inline_img(id) if @chapter.image(id).caption "#{img}#{I18n.t('image_quote', @chapter.image(id).caption)}" else img end end
inline_include(file_name)
click to toggle source
# File lib/review/builder.rb, line 691 def inline_include(file_name) compile_inline(File.read(file_name, mode: 'rt:BOM|utf-8').chomp) end
inline_kw(arg)
click to toggle source
# File lib/review/builder.rb, line 414 def inline_kw(arg) word, alt = *arg.split(',', 2) compile_kw(word, alt) end
inline_list(id)
click to toggle source
# File lib/review/builder.rb, line 333 def inline_list(id) chapter, id = extract_chapter_id(id) if get_chap(chapter) %Q(#{I18n.t('list')}#{I18n.t('format_number', [get_chap(chapter), chapter.list(id).number])}) else %Q(#{I18n.t('list')}#{I18n.t('format_number_without_chapter', [chapter.list(id).number])}) end rescue KeyError app_error "unknown list: #{id}" end
inline_pageref(id)
click to toggle source
# File lib/review/builder.rb, line 473 def inline_pageref(id) "[link:#{id}]" end
inline_raw(args)
click to toggle source
# File lib/review/builder.rb, line 714 def inline_raw(args) if matched = args.match(/\|(.*?)\|(.*)/) builders = matched[1].split(',').map { |i| i.gsub(/\s/, '') } c = self.class.to_s.gsub('ReVIEW::', '').gsub('Builder', '').downcase if builders.include?(c) matched[2].gsub('\\n', "\n") else '' end else args.gsub('\\n', "\n") end end
inline_ruby(arg)
click to toggle source
# File lib/review/builder.rb, line 403 def inline_ruby(arg) base, *ruby = *arg.scan(/(?:(?:(?:\\\\)*\\,)|[^,\\]+)+/) if base base = base.gsub(/\\,/, ',') end if ruby ruby = ruby.join(',').gsub(/\\,/, ',') end compile_ruby(base, ruby) end
inline_table(id)
click to toggle source
# File lib/review/builder.rb, line 365 def inline_table(id) chapter, id = extract_chapter_id(id) if get_chap(chapter) %Q(#{I18n.t('table')}#{I18n.t('format_number', [get_chap(chapter), chapter.table(id).number])}) else %Q(#{I18n.t('table')}#{I18n.t('format_number_without_chapter', [chapter.table(id).number])}) end rescue KeyError app_error "unknown table: #{id}" end
inline_tcy(arg)
click to toggle source
# File lib/review/builder.rb, line 477 def inline_tcy(arg) "#{arg}[rotate 90 degree]" end
inline_title(id)
click to toggle source
# File lib/review/builder.rb, line 327 def inline_title(id) compile_inline(@book.chapter_index.title(id)) rescue KeyError app_error "unknown chapter: #{id}" end
inline_w(s)
click to toggle source
# File lib/review/builder.rb, line 485 def inline_w(s) translated = @dictionary[s] if translated escape(translated) else warn "word not bound: #{s}", location: @location escape("[missing word: #{s}]") end end
inline_wb(s)
click to toggle source
# File lib/review/builder.rb, line 495 def inline_wb(s) translated = @dictionary[s] if translated inline_b(translated) else inline_b("[missing word: #{s}]") end end
line_num()
click to toggle source
# File lib/review/builder.rb, line 159 def line_num return 1 unless @first_line_num line_n = @first_line_num @first_line_num = nil line_n end
list(lines, id, caption, lang = nil)
click to toggle source
# File lib/review/builder.rb, line 168 def list(lines, id, caption, lang = nil) begin list_header(id, caption, lang) if caption_top?('list') list_body(id, lines, lang) list_header(id, caption, lang) unless caption_top?('list') rescue KeyError app_error "no such list: #{id}" end end
listnum(lines, id, caption, lang = nil)
click to toggle source
# File lib/review/builder.rb, line 178 def listnum(lines, id, caption, lang = nil) begin list_header(id, caption, lang) if caption_top?('list') listnum_body(lines, lang) list_header(id, caption, lang) unless caption_top?('list') rescue KeyError app_error "no such list: #{id}" end end
load_words(file)
click to toggle source
# File lib/review/builder.rb, line 136 def load_words(file) if File.exist?(file) if file =~ /\.csv\Z/i CSV.foreach(file) do |row| @dictionary[row[0]] = row[1] end end end end
minicolumn_block_name?(name)
click to toggle source
# File lib/review/builder.rb, line 608 def minicolumn_block_name?(name) CAPTION_TITLES.include?(name) end
over_secnolevel?(n)
click to toggle source
# File lib/review/builder.rb, line 741 def over_secnolevel?(n) @book.config['secnolevel'] >= n.to_s.split('.').size end
parse_metric(type, metric)
click to toggle source
# File lib/review/builder.rb, line 534 def parse_metric(type, metric) return '' if metric.blank? params = metric.split(/,\s*/) results = [] params.each do |param| if param =~ /\A.+?::/ next unless param =~ /\A#{type}::/ param.sub!(/\A#{type}::/, '') end param2 = handle_metric(param) results.push(param2) end result_metric(results) end
parse_table_rows(lines)
click to toggle source
# File lib/review/builder.rb, line 235 def parse_table_rows(lines) sepidx = nil rows = [] lines.each_with_index do |line, idx| if /\A[=\-]{12}/ =~ line || /\A[={\-}]{12}/ =~ line sepidx ||= idx next end rows.push(line.strip.split(table_row_separator_regexp).map { |s| s.sub(/\A\./, '') }) end rows = adjust_n_cols(rows) app_error 'no rows in the table' if rows.empty? [sepidx, rows] end
post_paragraph()
click to toggle source
# File lib/review/builder.rb, line 31 def post_paragraph nil end
pre_paragraph()
click to toggle source
# File lib/review/builder.rb, line 27 def pre_paragraph nil end
previous_list_type()
click to toggle source
# File lib/review/builder.rb, line 760 def previous_list_type @compiler.previous_list_type end
printendnotes()
click to toggle source
# File lib/review/builder.rb, line 284 def printendnotes @shown_endnotes = true endnote_begin @chapter.endnotes.each do |en| endnote_item(en.id) end endnote_end end
raw(str)
click to toggle source
# File lib/review/builder.rb, line 504 def raw(str) if matched = str.match(/\|(.*?)\|(.*)/) builders = matched[1].split(',').map { |i| i.gsub(/\s/, '') } c = target_name if builders.include?(c) print matched[2].gsub('\\n', "\n") end else print str.gsub('\\n', "\n") end end
result()
click to toggle source
# File lib/review/builder.rb, line 117 def result check_printendnotes solve_nest(@output.string) end
Also aliased as: raw_result
result_metric(array)
click to toggle source
# File lib/review/builder.rb, line 530 def result_metric(array) array.join(',') end
solve_nest(s)
click to toggle source
# File lib/review/builder.rb, line 100 def solve_nest(s) check_nest s.gsub(/\x01→.+?←\x01/, '') end
source(lines, caption = nil, lang = nil)
click to toggle source
# File lib/review/builder.rb, line 188 def source(lines, caption = nil, lang = nil) source_header(caption) if caption_top?('list') source_body(lines, lang) source_header(caption) unless caption_top?('list') end
system_graph(id, *args)
click to toggle source
# File lib/review/builder.rb, line 634 def system_graph(id, *args) @logger.info args.join(' ') Kernel.system(*args) or @logger.error("failed to run command for id #{id}: #{args.join(' ')}") end
table(lines, id = nil, caption = nil)
click to toggle source
# File lib/review/builder.rb, line 203 def table(lines, id = nil, caption = nil) sepidx, rows = parse_table_rows(lines) begin if caption_top?('table') && caption.present? table_header(id, caption) end table_begin(rows.first.size) table_rows(sepidx, rows) table_end if !caption_top?('table') && caption.present? table_header(id, caption) end rescue KeyError app_error "no such table: #{id}" end end
table_row_separator_regexp()
click to toggle source
# File lib/review/builder.rb, line 220 def table_row_separator_regexp case @book.config['table_row_separator'] when 'tabs' Regexp.new('\t+') when 'singletab' Regexp.new('\t') when 'spaces' Regexp.new('\s+') when 'verticalbar' Regexp.new('\s*\\' + escape('|') + '\s*') else app_error "Unknown value for 'table_row_separator', shold be: tabs, singletab, spaces, verticalbar" end end
table_rows(sepidx, rows)
click to toggle source
# File lib/review/builder.rb, line 250 def table_rows(sepidx, rows) if sepidx sepidx.times do tr(rows.shift.map { |s| th(s) }) end rows.each do |cols| tr(cols.map { |s| td(s) }) end else rows.each do |cols| h, *cs = *cols tr([th(h)] + cs.map { |s| td(s) }) end end end
target_name()
click to toggle source
# File lib/review/builder.rb, line 132 def target_name self.class.to_s.gsub(/ReVIEW::/, '').gsub(/Builder/, '').downcase end
text(str)
click to toggle source
# File lib/review/builder.rb, line 428 def text(str) str end
tsize(str)
click to toggle source
# File lib/review/builder.rb, line 702 def tsize(str) if matched = str.match(/\A\|(.*?)\|(.*)/) builders = matched[1].split(',').map { |i| i.gsub(/\s/, '') } c = self.class.to_s.gsub('ReVIEW::', '').gsub('Builder', '').downcase if builders.include?(c) @tsize = matched[2] end else @tsize = str end end
ul_item_begin(lines)
click to toggle source
# File lib/review/builder.rb, line 695 def ul_item_begin(lines) ul_item(lines) end
ul_item_end()
click to toggle source
# File lib/review/builder.rb, line 699 def ul_item_end end
Private Instance Methods
adjust_n_cols(rows)
click to toggle source
# File lib/review/builder.rb, line 266 def adjust_n_cols(rows) rows.each do |cols| while cols.last && cols.last.strip.empty? cols.pop end end n_maxcols = rows.map(&:size).max rows.each do |cols| cols.concat([''] * (n_maxcols - cols.size)) end rows end
builder_init_file()
click to toggle source
# File lib/review/builder.rb, line 90 def builder_init_file @sec_counter = SecCounter.new(5, @chapter) @doc_status = {} end
headline_prefix(level)
click to toggle source
# File lib/review/builder.rb, line 146 def headline_prefix(level) @sec_counter.inc(level) anchor = @sec_counter.anchor(level) prefix = @sec_counter.prefix(level, @book.config['secnolevel']) [prefix, anchor] end
print(*s)
click to toggle source
# File lib/review/builder.rb, line 124 def print(*s) @output.print(*s) end
puts(*s)
click to toggle source
# File lib/review/builder.rb, line 128 def puts(*s) @output.puts(*s) end