# This file is part of NIT ( http://www.nitlanguage.org ). # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # Handle markdown formatting in Nit comments. module doc_down import markdown import highlight private import parser_util redef class MDoc # Comment synopsys HTML escaped var short_comment: String is lazy do return content.first.html_escape # Full comment HTML escaped var full_comment: String is lazy do return content.join("\n").html_escape # Synopsys in a template var tpl_short_comment: Streamable is lazy do var res = new Template var syn = nitdoc_inline_processor.process(content.first) res.add "{syn}" return res end # Full comment in a template var tpl_comment: Streamable is lazy do var res = new Template var lines = content.to_a res.add "
{syn}
" end # check for annotations for i in [0 .. lines.length[ do var line = lines[i] if line.to_upper.has_prefix("ENSURE") or line.to_upper.has_prefix("REQUIRE") then var html = nitdoc_inline_processor.process(line) lines[i] = "{html}
" else if line.to_upper.has_prefix("TODO") or line.to_upper.has_prefix("FIXME") then var html = nitdoc_inline_processor.process(line) lines[i] = "{html}
" end end # add other lines res.add nitdoc_md_processor.process(lines.join("\n")) res.add ""
v.emit_in block
v.add "
\n"
return
end
# Try to parse code
var code = code_from_block(block)
var ast = toolcontext.parse_something(code)
if ast isa AError then
v.add ""
v.emit_in block
v.add "
\n"
return
end
v.add ""
var hl = new HighlightVisitor
hl.line_id_prefix = ""
hl.enter_visit(ast)
v.add(hl.html)
v.add "
\n"
end
redef fun add_span_code(v, text, from, to) do
# Try to parse it
var code = code_from_text(text, from, to)
var ast = toolcontext.parse_something(code)
if ast isa AError then
v.add ""
append_code(v, text, from, to)
else
v.add ""
var hl = new HighlightVisitor
hl.line_id_prefix = ""
hl.enter_visit(ast)
v.add(hl.html)
end
v.add "
"
end
fun code_from_text(buffer: Text, from, to: Int): String do
var out = new FlatBuffer
for i in [from..to[ do out.add buffer[i]
return out.write_to_string
end
fun code_from_block(block: BlockCode): String do
var infence = block isa BlockFence
var text = new FlatBuffer
var line = block.block.first_line
while line != null do
if not line.is_empty then
var str = line.value
if not infence and str.has_prefix(" ") then
text.append str.substring(4, str.length - line.trailing)
else
text.append str
end
end
text.append "\n"
line = line.next
end
return text.write_to_string
end
end
# Decorator for span elements.
#
# Because inline comments can appear as span elements,
# InlineDecorator do not decorate things like paragraphs or headers.
private class InlineDecorator
super NitdocDecorator
redef fun add_paragraph(v, block) do
v.emit_in block
end
redef fun add_headline(v, block) do
v.emit_in block
end
redef fun add_code(v, block) do
# Try to parse code
var ast = toolcontext.parse_something(block.block.text.to_s)
if ast isa AError then
v.add ""
v.emit_in block
v.add "
"
return
end
v.add ""
var hl = new HighlightVisitor
hl.enter_visit(ast)
v.add(hl.html)
v.add "
"
end
end
# Get a markdown processor for Nitdoc comments.
private fun nitdoc_md_processor: MarkdownProcessor do
var proc = new MarkdownProcessor
proc.emitter.decorator = new NitdocDecorator
return once proc
end
# Get a markdown inline processor for Nitdoc comments.
#
# This processor is specificaly designed to inlinable doc elements like synopsys.
private fun nitdoc_inline_processor: MarkdownProcessor do
var proc = new MarkdownProcessor
proc.emitter.decorator = new InlineDecorator
return once proc
end