shoes-manual 4.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6bcd1dbda40ae455475b3c20d72de2a001c78fa2
+  data.tar.gz: b8c8f08bd75ade2cb6f3e5e77b928010d6f012bf
+SHA512:
+  metadata.gz: 6acd6cabb8c4077a6ce5ed904199b3deaa3e80651da61c4504e402af58a122e94e823bf8e3db2c334abcb0331db5bc539f3db1e386c54f172c3b5835128bde9e
+  data.tar.gz: 1fc71d34d204980f8b60e9254151852848eb24c3df6fb1531d81e881c5c098b0baa4b1ae5944a3d0f2e1f32cf7b9a239a4a22bd39ef48b079fcda4e8f88fc8c7

data/.gitignore

@@ -0,0 +1,15 @@
+.DS_Store
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Jason R. Clark
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,69 @@
+# Shoes::Manual
+
+This gem represents both the content of the Shoes manual, and the necessary
+Shoes code to run it.
+
+Because of how the manual is used, this gem does not depend directly on Shoes
+itself. The content can be accessed without requiring `shoes-core`, but you
+won't be able to actually run the manual app without using this gem in a full
+Shoes installation.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'shoes-manual'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install shoes-manual
+
+## Content
+
+The content of the Shoes manual can be directly accessed via this method:
+
+```
+Shoes::Manual.load_docs('en')
+```
+
+'en' here designates the language. There is currently an (out of date) copy in
+Japanese alongside the English content.
+
+That method returns a structured output of the full manual:
+
+```
+{
+  :description=> "\n\nShoes is a tiny graphics toolkit...."
+  :sections=>
+     [["Introducing",
+       {
+         :title=>"Introducing Shoes",
+         :section=>"Hello!",
+         :description=>"\n\nHow does Shoes look on OS X and Windows?..."
+         ...
+       }
+     ]]
+}
+```
+
+## Running the Manual
+If you have an application which includes Shoes, you can also run the manual
+app by the following call:
+
+```
+Shoes::Manual.run
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/shoes/shoes-manual/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/lib/shoes/manual.rb

@@ -0,0 +1,45 @@
+require "shoes/manual/version"
+
+class Array
+  def /(len)
+    a = []
+    each_with_index do |x, i|
+      a << [] if i % len == 0
+      a.last << x
+    end
+    a
+  end
+end
+
+class Shoes
+  module Manual
+    ROOT_DIR = File.expand_path(File.join(__FILE__, "../../.."))
+
+    def self.run(lang = 'English')
+      $lang = lang
+      load 'shoes/manual/app.rb'
+    rescue LoadError
+      puts "Wasn't able to load Shoes to run the manual. Does your app have Shoes required?"
+      raise
+    end
+
+    def self.load_docs(lang)
+      @docs ||= load_path(lang =~ /\.txt$/ ? lang : File.join(ROOT_DIR, "static/manual-#{lang}.txt"))
+    end
+
+    def self.load_path(path)
+      str = IO.read(path).force_encoding("UTF-8")
+      (str.split(/^= (.+?) =/)[1..-1] / 2).map do |k, v|
+        sparts = v.split(/^== (.+?) ==/)
+        sections = (sparts[1..-1] / 2).map do |k2, v2|
+          meth = v2.split(/^=== (.+?) ===/)
+          k2t = k2[/^(?:The )?([\-\w]+)/, 1]
+          h = { title: k2, section: k, description: meth[0], methods: (meth[1..-1] / 2) }
+          [k2t, h]
+        end
+        h = { description: sparts[0], sections: sections, class: "toc" + k.downcase.gsub(/\W+/, '') }
+        [k, h]
+      end
+    end
+  end
+end

data/lib/shoes/manual/app.rb

@@ -0,0 +1,512 @@
+require 'nokogiri'
+require 'nkf'
+require 'shoes/version'
+require 'shoes/highlighter'
+require 'shoes/manual'
+
+class Array
+  def dark?
+    r, g, b = self
+    r + g + b < 0x55 * 3
+  end
+
+  def light?
+    r, g, b = self
+    r + g + b > 0xAA * 3
+  end
+end
+
+class Manual < Shoes
+  url '/', :index
+  url '/manual/(\d+)', :index
+
+  include Shoes::Highlighter::Markup
+
+  def index(pnum = 0)
+    # font LANG == 'ja' ? 'MS UI Gothic' : 'Arial'
+    # style Link, underline: false, weight: 'bold'
+    # style LinkHover, stroke: '#06E'
+    self.scroll_top = 0
+    TOC.clear; TOC_LIST.clear
+    table_of_contents.each { |toc| TOC << toc }
+    pnum == '999' ? mk_search_page : manual(*get_title_and_desc(pnum.to_i))
+  end
+
+  def get_title_and_desc(pnum)
+    chapter, section = PNUMS[pnum]
+    return nil unless chapter
+    if section
+      [pnum, DOCS[chapter][1][:sections][section][1][:title],
+       DOCS[chapter][1][:sections][section][1][:description],
+       DOCS[chapter][1][:sections][section][1][:methods]]
+    else
+      [pnum, DOCS[chapter][0], DOCS[chapter][1][:description], []]
+    end
+  end
+
+  def table_of_contents
+    PNUMS.map.with_index do |e, pnum|
+      chapter, section = e
+      title = section ? DOCS[chapter][1][:sections][section][1][:title] : DOCS[chapter][0]
+      title = title.sub('The', '').split(' ').first
+      TOC_LIST << [title, section]
+      section ? ['   ', link(title) { visit "/manual/#{pnum}" }, "\n"] : [link(fg(title, magenta)) { visit "/manual/#{pnum}" }, "\n"]
+    end.flatten
+  end
+
+  def manual(pnum, docs_title, docs_description, docs_methods)
+    flow do
+      show_header docs_title
+      show_toc
+      paras = mk_paras docs_description
+      flow width: 0.75, margin: [20, 0, 20, 0] do
+        show_page paras, true
+        show_methods docs_methods
+        para link('top') { visit "/manual/0" }, "  ",
+             link('prev') { visit "/manual/#{(pnum - 1) % PEND}" }, "  ",
+             link('next') { visit "/manual/#{(pnum + 1) % PEND}" }, "  ",
+             link('end') { visit "/manual/#{PEND - 1}" }
+      end
+    end
+  end
+
+  def show_header(docs_title)
+    background snow..white, angle: 90
+    background midnightblue..black, height: 90
+    flow width: 500 do
+      para fg("The Shoes 4 Manual #{VERSION}", gray), left: 120, top: 10
+      title fg(docs_title, white), left: 120, top: 30, font: 'Coolvetica'
+    end
+    image(File.join(DIR, 'static/shoes-icon.png'), width: 110, height: 110).move 5, -12
+  end
+
+  def show_toc
+    s = self
+    stack height: 30
+    flow width: 0.2, margin_left: 10 do
+      flow(margin_right: 20) do
+        background black(0.7), curve: 5
+        inscription "Not findng it?\n", 'Try ', link(fg 'Search', white) { visit '/manual/999' }, '!', align: 'center', stroke: lightgray
+      end
+      stack(height: 10) {}
+      para(*TOC)
+      para link(fg 'to_html', green) { s.html_manual }
+    end
+  end
+
+  def show_methods(docs_methods, term = nil)
+    docs_methods.each do |m, d|
+      flow do
+        background rgb(60, 60, 60), curve: 5
+        n = m.index("\u00BB")
+        if n
+          para '  ', fg(strong(m[0...n]), white), fg(strong(m[n..-1]), rgb(160, 160, 160))
+        else
+          para '  ', fg(strong(m), white)
+        end
+      end
+      para NL
+      show_page mk_paras(d), false, term
+    end
+  end
+
+  def show_page(paras, intro = false, term = nil)
+    s = self
+    paras.each_with_index do |text, i|
+      if text =~ CODE_RE
+        text.gsub CODE_RE do |lines|
+          lines = lines.split NL
+          n = lines[1] =~ /\#\!ruby/ ? 2 : 1
+          code = lines[n...-1].join(NL + '  ')
+          flow do
+            background rgb(190, 190, 190), curve: 5
+            inscription link(fg('Run this', magenta)) { eval s.mk_executable(code), TOPLEVEL_BINDING }, '  ', align: 'right'
+            if code.include? 'te-su-to'
+              para fg(code('  ' + code), maroon), NL, margin: [-10, 10, 0, 20]
+            else
+              para(*highlight('  ' + code, nil).map { |e| code e }, NL * 2, margin: [-10, 10, 0, 20])
+            end
+          end
+          fill_rest_of_line
+          para NL
+        end
+        next
+      end
+
+      if text =~ /\A \* (.+)/m
+        Regexp.last_match[1].split(/^ \* /).each do |txt|
+          image File.join(DIR, 'static/shoes-icon.png'), width: 20, height: 20
+          flow(width: 510) { show_paragraph txt, intro, i, term }
+          para NL
+        end
+      else
+        show_paragraph text, intro, i, term
+      end
+    end
+  end
+
+  def show_paragraph(txt, intro, i, term = nil)
+    txt = txt.gsub("\n", ' ').gsub(/\^(.+?)\^/m, '\1').gsub(/\[\[BR\]\]/i, "\n")
+    txts = txt.split(/(\[\[\S+?\]\])/m).map { |s| s.split(/(\[\[\S+? .+?\]\])/m) }.flatten
+    case txts[0]
+    when /\A==== (.+) ====/ then caption(*marker(Regexp.last_match[1], term), size: 24); para NL
+    when /\A=== (.+) ===/ then tagline(*marker(Regexp.last_match[1], term), size: 12, weight: 'bold')
+    when /\A== (.+) ==/ then subtitle(*marker(Regexp.last_match[1], term))
+    when /\A= (.+) =/ then title(*marker(Regexp.last_match[1], term))
+    when /\A\{COLORS\}/ then flow { color_page }
+    when /\A\{SAMPLES\}/ then flow { sample_page }
+    else
+      para(*mk_deco(mk_links(txts, term).flatten), NL, (intro && i.zero?) ? { size: 16 } : '')
+      txt.gsub IMAGE_RE do
+        image File.join(Shoes::Manual::ROOT_DIR, "static/#{Regexp.last_match[3]}"), eval("{#{Regexp.last_match[2] || 'margin_left: 50'}}")
+        fill_rest_of_line
+      end
+    end
+  end
+
+  def mk_links(txts, term = nil)
+    txts.map { |txt| txt.gsub(IMAGE_RE, '') }
+      .map { |txt| txt =~ /\[\[(\S+?)\]\]/m ? (t = Regexp.last_match[1].split('.'); link(ins(*marker(t.last, term))) { visit "/manual/#{find_pnum t.first}" }) : txt }
+      .map do|txt|
+        txt =~ /\[\[(\S+?) (.+?)\]\]/m ? (url = Regexp.last_match[1]; link(ins(*marker(Regexp.last_match[2], term))) { visit url =~ /^http/ ? url : "/manual/#{find_pnum url}" }) :
+        (txt.is_a?(String) ? marker(txt, term) : txt)
+      end
+  end
+
+  def mk_paras(str)
+    str.split(PARA_RE) - ['']
+  end
+
+  def mk_executable(code)
+    if code =~ /\# Not yet available/
+      "Shoes.app{para 'Sorry, not yet available...'}"
+    else
+      code
+    end
+  end
+
+  def color_page
+    COLORS.each do |color, v|
+      r, g, b = v.red, v.green, v.blue
+      c = v.dark? ? white : black
+      stack width: 0.33, height: 55, margin_top: 5 do
+        clr = send(color)
+        background clr
+        # para fg(strong(color), c), align: 'center'
+        para fg('. ', clr), fg(strong(color), c), fg(' .', clr), align: 'center'
+        para fg("rgb(#{r}, #{g}, #{b})", c), align: 'center'
+      end
+    end
+    para NL
+  end
+
+  def sample_page
+    mk_sample_names.each do |file|
+      stack width: 80 do
+        inscription file[0...-3]
+        image File.join(DIR, "snapshots/#{file[0..-3]}png"), width: 50, height: 50 do
+          Dir.chdir(File.join DIR, 'samples') { instance_eval(IO.read(file), file, 0) }
+        end
+        para NL
+      end
+    end
+  end
+
+  def mk_sample_names
+    Dir[File.join(DIR, 'samples/sample*.rb')].map do |file|
+      orig_name = File.basename file
+      dummy_name = orig_name.sub(/sample(.*)\.rb/)do
+        first, second = Regexp.last_match[1].split('-')
+        "%02d%s%s" % [first.to_i, ('-' if second), second]
+      end
+      [dummy_name, orig_name]
+    end.sort.map(&:last)
+  end
+
+  def find_pnum(page)
+    return 999 if page == 'Search'
+    TOC_LIST.each_with_index do |e, i|
+      title = e
+      return i if title == page
+    end
+  end
+
+  def self.mk_page_numbers(docs)
+    pnum = []
+    docs.length.times do |i|
+      pnum << [i, nil]
+      docs[i][1][:sections].length.times do |j|
+        pnum << [i, j]
+      end
+    end
+    pnum
+  end
+
+  def html_manual
+    dir = ask_save_folder
+    return unless dir
+    FileUtils.mkdir_p File.join(dir, 'static')
+    FileUtils.mkdir_p File.join(dir, 'snapshots')
+    %w(shoes-icon.png shoes-manual-apps.png manual.css code_highlighter.js code_highlighter_ruby.js)
+      .each { |x| FileUtils.cp "#{Shoes::Manual::ROOT_DIR}/static/#{x}", "#{dir}/static" }
+    Dir[File.join Shoes::Manual::ROOT_DIR, 'static/man-*.png'].each { |x| FileUtils.cp x, "#{dir}/static" }
+    Dir[File.join DIR, 'snapshots/sample*.png'].each { |x| FileUtils.cp x, "#{dir}/snapshots" }
+
+    TOC_LIST.length.times do |n|
+      num, title, desc, methods = get_title_and_desc n
+      open File.join(dir, "#{TOC_LIST[n][0]}.html"), 'wb:utf-8' do |f|
+        html = mk_html(title, desc, methods, TOC_LIST[n + 1], get_title_and_desc(n + 1), mk_sidebar_list(num))
+        f.puts html.force_encoding('UTF-8')
+      end
+    end
+  end
+
+  def mk_html(title, desc, methods, next_file, next_title, menu)
+    man = self
+    html = Nokogiri::HTML::Builder.new do |h|
+      h.html(lang: Manual::LANG) do
+        h.head do
+          h.meta charset: 'utf-8'
+          h.title "The Shoes 4 Manual // #{title}"
+          h.script type: "text/javascript", src: "static/code_highlighter.js"
+          h.script type: "text/javascript", src: "static/code_highlighter_ruby.js"
+          h.style type: "text/css" do
+            h.text "@import 'static/manual.css';"
+          end
+        end
+        h.body do
+          h.div.main! do
+            h.div.manual! do
+              h.h2 "The Shoes 4 Manual #{VERSION}"
+              h.h1 title
+
+              paras = man.mk_paras desc
+              h.div(class: 'intro') { h << man.manual_p(paras.shift) }
+
+              html_paragraph = proc do
+                paras.each do |str|
+                  if str =~ CODE_RE
+                    h.pre { h.code(class: 'rb') { h.text Regexp.last_match[1].gsub(/^\s*?\n/, '') } }
+                  else
+                    cmd, str = case str
+                      when /\A==== (.+) ====/ then [:h4, Regexp.last_match[1]]
+                      when /\A=== (.+) ===/ then [:h3, Regexp.last_match[1]]
+                      when /\A== (.+) ==/ then [:h2, Regexp.last_match[1]]
+                      when /\A= (.+) =/ then [:h1, Regexp.last_match[1]]
+                      when /\A\{COLORS\}/
+                        COLORS.each do |color, v|
+                          f = v.dark? ? "white" : "black"
+                          h.div(class: 'color', style: "background: #{color}; color: #{f}") { h.h3 color.to_s; h.p("rgb(%d, %d, %d)" % [v.red, v.green, v.blue]) }
+                        end
+                      when /\A\{SAMPLES\}/
+                        man.mk_sample_names.each do |name|
+                          name = name[0...-3]
+                          h.div(class: 'sample') do
+                            h.h3 name
+                            h.text '<a href="snapshots/%s.png"><img src="snapshots/%s.png" alt="%s" border=0 width=50 height=50></a>' % [name, name, name]
+                          end
+                        end
+                      when /\A \* (.+)/m
+                        h.ul { Regexp.last_match[1].split(/^ \* /).each { |x| h << man.manual_p(x) } }; nil
+                      else
+                        [:p_, str]
+                      end
+                    h.send(cmd) { h << man.manual_p(str) } if cmd.is_a?(Symbol)
+                  end
+                end
+              end
+
+              html_paragraph.call
+
+              methods.each do |m, d|
+                n = m.index("\u00BB")
+                n ? (sig, val = m[0...n - 1], m[n - 1..-1]) : (sig, val = m, nil)
+                aname = sig[/^[^(=]+=?/].gsub(/\s/, '').downcase
+                h.a(name: aname)
+                h.div(class: 'divmethod') do
+                  h.a sig, href: "##{aname}"
+                  h.text val if val
+                end
+                h.div(class: 'desc') do
+                  paras = man.mk_paras d
+                  html_paragraph.call
+                end
+              end
+
+              h.p(class: 'next') { h.text "Next: "; h.a(href: "#{next_file[0]}.html") { h.text next_title[1] } } if next_title
+            end
+            h.div(class: 'sidebar') do
+              h.img src: "static/shoes-icon.png"
+              h.ul do
+                h.li { h.a(class: 'prime', href: "./") { h.text "HELP" } }
+                menu.each do |m|
+                  h.li do
+                    unless m.is_a?(Array)
+                      h.a(href: "#{m}.html") { h.text m }
+                    else
+                      h.ul(class: 'sub') do
+                        m.each do |sm  |
+                          h.li { h.a(href: "#{sm}.html") { h.text sm }  }
+                        end
+                      end
+                    end
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end.to_html
+
+    "<!DOCTYPE html>\n#{html}"
+  end
+
+  def mk_sidebar_list(num)
+    toc = []
+    [0..3, 4..9, 10..16, 17..32, 33..37].each do |r|
+      toc.push TOC_LIST[r.first][0]
+      toc.push(TOC_LIST[r.first + 1..r.last].to_a.map(&:first)) if r.include?(num)
+    end
+    toc
+  end
+
+  def manual_p(str)
+    str.gsub(/\n+\s*/, " ")
+      .gsub(/&/, '&amp;').gsub(/>/, '&gt;').gsub(/>/, '&lt;').gsub(/"/, '&quot;')
+      .gsub(/`(.+?)`/m, '<code>\1</code>').gsub(/\[\[BR\]\]/i, "<br />\n")
+      .gsub(/\^(.+?)\^/m, '\1')
+      .gsub(/'''(.+?)'''/m, '<strong>\1</strong>').gsub(/''(.+?)''/m, '<em>\1</em>')
+      .gsub(/\[\[((http|https):\/\/\S+?)\]\]/m, '<a href="\1" target="_new">\1</a>')
+      .gsub(/\[\[((http|https):\/\/\S+?) (.+?)\]\]/m, '<a href="\1" target="_new">\3</a>')
+      .gsub(/\[\[(\S+?)\]\]/m) do
+        ms, mn = Regexp.last_match[1].split(".", 2)
+        if mn
+          '<a href="' + ms + '.html#' + mn + '">' + mn + '</a>'
+        else
+          '<a href="' + ms + '.html">' + ms + '</a>'
+        end
+      end
+      .gsub(/\[\[(\S+?) (.+?)\]\]/m, '<a href="\1.html">\2</a>')
+      .gsub(/\!(\{[^}\n]+\})?([^!\n]+\.\w+)\!/) do
+        '<img src="' + "static/#Regexp.last_match[2]" + '" />'
+      end
+  end
+
+  def mk_search_page
+    s = self
+    flow do
+      show_header 'Search'
+      show_toc
+
+      flow width: 0.8, margin: [10, 0, 20, 0] do
+        el = edit_line width: 300
+        tagline link('search'){
+          term = el.text.strip
+          unless term.empty?
+            descs, methods = s.search term
+            @f.clear { s.show_search_result term, descs, methods }
+          end
+        }
+        stack(height: 20) {}
+        @f = flow {}
+      end
+    end
+  end
+
+  def search(term)
+    descs, methods = [], []
+    PNUMS.each_with_index do |(chapter, section), pnum|
+      _pnum, docs_title, docs_description, docs_methods = get_title_and_desc(pnum)
+      paras = mk_paras(docs_description)
+      descs << [chapter, section, docs_title, paras] if paras.map { |txt| txt.gsub(CODE_RE, '').gsub(IMAGE_RE, '') }.join(' ').index(term)
+      docs_methods.each do |docs_method|
+        m, d = docs_method
+        methods << [chapter, section, docs_title, docs_method] if m.index(term) || d.gsub(CODE_RE, '').gsub(IMAGE_RE, '').index(term)
+      end
+    end
+    [descs, methods]
+  end
+
+  def show_search_result(term, descs, methods)
+    s = self
+    if descs.empty? && methods.empty?
+      subtitle 'Not Found'
+    else
+      methods.each do |(chapter, _section, docs_title, docs_method)|
+        flow margin: [10, 10, 0, 5] do
+          background rgb(200, 200, 200), curve: 5
+          para "#{DOCS[chapter][0]}: #{docs_title.sub('The', '').split(' ').first}: ",
+               link(docs_method[0]) { @f.clear { title docs_title; s.show_methods [docs_method], term } }, NL
+        end
+        stack(height: 2) {}
+      end
+      descs.each do |(chapter, section, docs_title, paras)|
+        flow margin_left: 10 do
+          if section
+            background gray, curve: 5
+            tagline link(fg(docs_title, white)) { @f.clear { title docs_title; s.show_page paras, true, term } }, width: 320
+            inscription "Sub-Section under #{DOCS[chapter][0]}", stroke: lightgray, width: 180
+          else
+            background black(0.8), curve: 5
+            subtitle link(fg(docs_title, white)) { @f.clear { title docs_title; s.show_page paras, true, term } }, width: 320
+            inscription 'Section Header', stroke: lightgray, width: 100
+          end
+        end
+        stack(height: 2) {}
+      end
+      para NL
+    end
+  end
+
+  def marker(txt, term)
+    if term && txt
+      tmp = txt.split(term).map { |s| [s, bg(term, yellow)] }.flatten
+      txt =~ /#{term}$/ ? tmp : tmp[0...-1]
+    else
+      [txt]
+    end
+  end
+
+  def mk_deco(datas)
+    datas = decoration(datas, /`(.+?)`/m) { |s| fg code(s), rgb(255, 30, 0) }
+    datas = decoration(datas, /'''(.+?)'''/m) { |s| strong s }
+    decoration(datas, /''(.+?)''/m) { |s| em s }
+  end
+
+  def decoration(datas, re, &blk)
+    datas.map do |data|
+      if data.is_a? String
+        txts = [data]
+        data.match re do |md|
+          n = data.index md[0]
+          txts = [data[0...n], blk[md[1]], decoration([data[n + md[0].length..-1]], re, &blk)]
+        end
+        txts
+      else
+        data
+      end
+    end.flatten
+  end
+
+  # Hack to consume remaining space to the right of a flow.
+  # Used to rely on NL's, but with new text flowing, that doesn't work anymore.
+  def fill_rest_of_line
+    flow width: 1.0 do
+    end
+  end
+
+  IMAGE_RE = /\!(\{([^}\n]+)\})?([^!\n]+\.\w+)\!/
+  CODE_RE = /\{{3}(?:\s*\#![^\n]+)?(.+?)\}{3}/m
+  PARA_RE = /\s*?(\{{3}(?:.+?)\}{3})|\n\n/m
+  NL = "\n"
+  LANG = $lang.downcase[0, 2]
+  DOCS = Shoes::Manual.load_docs(LANG)
+  PNUMS = mk_page_numbers DOCS
+  PEND = PNUMS.length
+  TOC, TOC_LIST = [], []
+  COLORS = Shoes::COLORS
+  VERSION = Shoes::VERSION
+end
+
+Shoes.app title: 'The Shoes 4 Manual', width: 720, height: 640