This code converts input_string
, which is in the format
described in markup/simple_markup.rb, to HTML. The conversion takes place
in the convert
method, so you can use the same SimpleMarkup object to convert multiple input
strings.
require 'rdoc/markup/simple_markup' require 'rdoc/markup/simple_markup/to_html' p = SM::SimpleMarkup.new h = SM::ToHtml.new puts p.convert(input_string, h)
You can extend the SimpleMarkup parser to recognise new markup sequences, and to add special processing for text that matches a regular epxression. Here we make WikiWords significant to the parser, and also make the sequences {word} and <no>text…</no> signify strike-through text. When then subclass the HTML output class to deal with these:
require 'rdoc/markup/simple_markup' require 'rdoc/markup/simple_markup/to_html' class WikiHtml < SM::ToHtml def handle_special_WIKIWORD(special) "<font color=red>" + special.text + "</font>" end end p = SM::SimpleMarkup.new p.add_word_pair("{", "}", :STRIKE) p.add_html("no", :STRIKE) p.add_special(/\b([A-Z][a-z]+[A-Z]\w+)/, :WIKIWORD) h = WikiHtml.new h.add_tag(:STRIKE, "<strike>", "</strike>") puts "<body>" + p.convert(ARGF.read, h) + "</body>"
missing
List entries look like:
* text 1. text [label] text label:: text
Flag it as a list entry, and work out the indent for subsequent lines
take a block of text and use various heuristics to determine it's structure (paragraphs, lists, and so on). Invoke an event handler as we identify significant chunks.
# File rdoc/markup/simple_markup.rb, line 207 def initialize @am = AttributeManager.new @output = nil end
Add to the sequences recognized as general markup
# File rdoc/markup/simple_markup.rb, line 225 def add_html(tag, name) @am.add_html(tag, name) end
Add to other inline sequences. For example, we could add WikiWords using something like:
parser.add_special(/\b([A-Z][a-z]+[A-Z]\w+)/, :WIKIWORD)
Each wiki word will be presented to the output formatter via the accept_special method
# File rdoc/markup/simple_markup.rb, line 239 def add_special(pattern, name) @am.add_special(pattern, name) end
Add to the sequences used to add formatting to an individual word (such as
bold). Matching entries will generate attibutes that the
output formatters can recognize by their name
# File rdoc/markup/simple_markup.rb, line 217 def add_word_pair(start, stop, name) @am.add_word_pair(start, stop, name) end
for debugging, we allow access to our line contents as text
# File rdoc/markup/simple_markup.rb, line 464 def content @lines.as_text end
We take a string, split it into lines, work out the type of each line, and from there deduce groups of lines (for example all lines in a paragraph). We then invoke the output formatter using a Visitor to display the result
# File rdoc/markup/simple_markup.rb, line 249 def convert(str, op) @lines = Lines.new(str.split(/\r?\n/).collect { |aLine| Line.new(aLine) }) return "" if @lines.empty? @lines.normalize assign_types_to_lines group = group_lines # call the output formatter to handle the result # group.to_a.each {|i| p i} group.accept(@am, op) end