# This file is part of NIT ( http://www.nitlanguage.org ).
#
-# Copyright 2008 Jean Privat <jean@pryen.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
# See the License for the specific language governing permissions and
# limitations under the License.
+# Documentation generator for the nit language.
+# Generate API documentation in HTML format from nit source code.
module ni_nitdoc
import model_utils
-import abstract_compiler
-import html
+import modelize_property
+
+# The NitdocContext contains all the knowledge used for doc generation
+class NitdocContext
-class Nitdoc
- private var toolcontext: ToolContext
+ private var toolcontext = new ToolContext
private var model: Model
- private var modelbuilder: ModelBuilder
+ private var mbuilder: ModelBuilder
private var mainmodule: MModule
private var class_hierarchy: POSet[MClass]
private var arguments: Array[String]
private var dot_dir: nullable String
private var share_dir: nullable String
private var source: nullable String
+ private var min_visibility: MVisibility
private var opt_dir = new OptionString("Directory where doc is generated", "-d", "--dir")
private var opt_source = new OptionString("What link for source (%f for filename, %l for first line, %L for last line)", "--source")
private var opt_sharedir = new OptionString("Directory containing the nitdoc files", "--sharedir")
private var opt_nodot = new OptionBool("Do not generate graphes with graphiviz", "--no-dot")
+ private var opt_private: OptionBool = new OptionBool("Generate the private API", "--private")
- init(toolcontext: ToolContext) do
- # We need a model to collect stufs
- self.toolcontext = toolcontext
+ private var opt_custom_title: OptionString = new OptionString("Title displayed in the top of the Overview page and as suffix of all page names", "--custom-title")
+ private var opt_custom_menu_items: OptionString = new OptionString("Items displayed in menu before the 'Overview' item (Each item must be enclosed in 'li' tags)", "--custom-menu-items")
+ private var opt_custom_overview_text: OptionString = new OptionString("Text displayed as introduction of Overview page before the modules list", "--custom-overview-text")
+ private var opt_custom_footer_text: OptionString = new OptionString("Text displayed as footer of all pages", "--custom-footer-text")
+
+ init do
self.arguments = toolcontext.option_context.rest
toolcontext.option_context.options.clear
toolcontext.option_context.add_option(opt_dir)
toolcontext.option_context.add_option(opt_source)
toolcontext.option_context.add_option(opt_sharedir)
toolcontext.option_context.add_option(opt_nodot)
+ toolcontext.option_context.add_option(opt_private)
+ toolcontext.option_context.add_option(opt_custom_title)
+ toolcontext.option_context.add_option(opt_custom_footer_text)
+ toolcontext.option_context.add_option(opt_custom_overview_text)
+ toolcontext.option_context.add_option(opt_custom_menu_items)
toolcontext.process_options
- process_options
if arguments.length < 1 then
toolcontext.option_context.usage
end
model = new Model
- modelbuilder = new ModelBuilder(model, toolcontext)
-
- # Here we load an process std modules
- var mmodules = modelbuilder.parse_and_build([arguments.first])
+ mbuilder = new ModelBuilder(model, toolcontext)
+ # Here we load an process all modules passed on the command line
+ var mmodules = mbuilder.parse(arguments)
if mmodules.is_empty then return
- modelbuilder.full_propdef_semantic_analysis
- assert mmodules.length == 1
- self.mainmodule = mmodules.first
+ mbuilder.run_phases
+
+ if mmodules.length == 1 then
+ mainmodule = mmodules.first
+ else
+ # We need a main module, so we build it by importing all modules
+ mainmodule = new MModule(model, null, "<main>", new Location(null, 0, 0, 0, 0))
+ mainmodule.set_imported_mmodules(mmodules)
+ end
self.class_hierarchy = mainmodule.flatten_mclass_hierarchy
+ self.process_options
end
private fun process_options do
print "Error: Invalid nitdoc share files. Check --sharedir or envvar NIT_DIR"
abort
end
+
+ if opt_private.value then
+ min_visibility = none_visibility
+ else
+ min_visibility = protected_visibility
+ end
end
- if not opt_source.value is null then
- source = ""
- else
- source = opt_source.value
- end
+ source = opt_source.value
end
- fun start do
- if arguments.length == 1 then
- # Create destination dir if it's necessary
- if not output_dir.file_exists then output_dir.mkdir
- sys.system("cp -r {share_dir.to_s}/* {output_dir.to_s}/")
- self.dot_dir = null
- if not opt_nodot.value then self.dot_dir = output_dir.to_s
- overview
- #fullindex
- modules
- classes
- #quicksearch_list
- end
+ fun generate_nitdoc do
+ # Create destination dir if it's necessary
+ if not output_dir.file_exists then output_dir.mkdir
+ sys.system("cp -r {share_dir.to_s}/* {output_dir.to_s}/")
+ self.dot_dir = null
+ if not opt_nodot.value then self.dot_dir = output_dir.to_s
+ overview
+ fullindex
+ modules
+ classes
+ quicksearch_list
end
- fun overview do
- var overviewpage = new NitdocOverview(modelbuilder, dot_dir)
+ private fun overview do
+ var overviewpage = new NitdocOverview(self, dot_dir)
overviewpage.save("{output_dir.to_s}/index.html")
end
- fun fullindex do
- var fullindex = new NitdocFullindex(model.mmodules)
+ private fun fullindex do
+ var fullindex = new NitdocFullindex(self)
fullindex.save("{output_dir.to_s}/full-index.html")
end
- fun modules do
+ private fun modules do
for mmodule in model.mmodules do
- var modulepage = new NitdocModule(mmodule, modelbuilder, dot_dir)
- modulepage.save("{output_dir.to_s}/{mmodule.name}.html")
+ if mmodule.name == "<main>" then continue
+ var modulepage = new NitdocModule(mmodule, self, dot_dir)
+ modulepage.save("{output_dir.to_s}/{mmodule.url}")
end
end
- fun classes do
- for mclass in modelbuilder.model.mclasses do
+ private fun classes do
+ for mclass in mbuilder.model.mclasses do
var classpage = new NitdocClass(mclass, self, dot_dir, source)
- classpage.save("{output_dir.to_s}/{mclass.name}.html")
+ classpage.save("{output_dir.to_s}/{mclass.url}")
end
end
- # Generate QuickSearch file
- fun quicksearch_list do
+ private fun quicksearch_list do
var file = new OFStream.open("{output_dir.to_s}/quicksearch-list.js")
- var content = new Buffer
- content.append("var entries = \{ ")
- for prop in model.mproperties do
- if not prop isa MMethod then continue
- content.append("\"{prop.name}\": [")
- for propdef in prop.mpropdefs do
- content.append("\{txt: \"{propdef.mproperty.full_name}\", url:\"{propdef.mproperty.anchor}\" \}")
- if not propdef is prop.mpropdefs.last then content.append(", ")
- end
- content.append("]")
- content.append(", ")
+ file.write("var entries = \{ ")
+ for mmodule in model.mmodules do
+ file.write("\"{mmodule.name}\": [")
+ file.write("\{txt: \"{mmodule.name}\", url:\"{mmodule.url}\" \},")
+ file.write("],")
end
-
for mclass in model.mclasses do
- content.append("\"{mclass.name}\": [")
- for mclassdef in mclass.mclassdefs do
- content.append("\{txt: \"{mclassdef.mclass.full_name}\", url:\"{mclass.link_anchor}\" \}")
- if not mclassdef is mclass.mclassdefs.last then content.append(", ")
+ if mclass.visibility < min_visibility then continue
+ file.write("\"{mclass.name}\": [")
+ file.write("\{txt: \"{mclass.name}\", url:\"{mclass.url}\" \},")
+ file.write("],")
+ end
+ var name2mprops = new HashMap[String, Set[MPropDef]]
+ for mproperty in model.mproperties do
+ if mproperty.visibility < min_visibility then continue
+ if mproperty isa MAttribute then continue
+ if not name2mprops.has_key(mproperty.name) then name2mprops[mproperty.name] = new HashSet[MPropDef]
+ name2mprops[mproperty.name].add_all(mproperty.mpropdefs)
+ end
+ for mproperty, mpropdefs in name2mprops do
+ file.write("\"{mproperty}\": [")
+ for mpropdef in mpropdefs do
+ file.write("\{txt: \"{mpropdef.full_name}\", url:\"{mpropdef.url}\" \},")
end
- content.append("]")
- if not mclass is model.mclasses.last then content.append(", ")
+ file.write("],")
end
-
- content.append(" \};")
- file.write(content.to_s)
+ file.write(" \};")
file.close
end
# Nitdoc base page
abstract class NitdocPage
- super HTMLPage
var dot_dir: nullable String
var source: nullable String
+ var ctx: NitdocContext
- redef fun head do
- add("meta").attr("charset", "utf-8")
- add("script").attr("type", "text/javascript").attr("src", "scripts/jquery-1.7.1.min.js")
- add("script").attr("type", "text/javascript").attr("src", "quicksearch-list.js")
- add("script").attr("type", "text/javascript").attr("src", "scripts/js-facilities.js")
- add("link").attr("rel", "stylesheet").attr("href", "styles/main.css").attr("type", "text/css").attr("media", "screen")
+ init(ctx: NitdocContext) do
+ self.ctx = ctx
end
- redef fun body do
- header
- open("div").add_class("page")
- content
- close("div")
- footer
+ protected fun head do
+ append("<meta charset='utf-8'/>")
+ append("<script type='text/javascript' src='scripts/jquery-1.7.1.min.js'></script>")
+ append("<script type='text/javascript' src='scripts/ZeroClipboard.min.js'></script>")
+ append("<script type='text/javascript' src='quicksearch-list.js'></script>")
+ append("<script type='text/javascript' src='scripts/base64.js'></script>")
+ append("<script type='text/javascript' src='scripts/github.js'></script>")
+ append("<script type='text/javascript' src='scripts/js-facilities.js'></script>")
+ append("<link rel='stylesheet' href='styles/main.css' type='text/css' media='screen'/>")
+ var title = ""
+ if ctx.opt_custom_title.value != null then
+ title = " | {ctx.opt_custom_title.value.to_s}"
+ end
+ append("<title>{self.title}{title}</title>")
end
- fun menu is abstract
+ protected fun menu do
+ if ctx.opt_custom_menu_items.value != null then
+ append(ctx.opt_custom_menu_items.value.to_s)
+ end
+ end
+
+ protected fun title: String is abstract
- fun header do
- open("header")
- open("nav").add_class("main")
- open("ul")
+ protected fun header do
+ append("<header>")
+ append("<nav class='main'>")
+ append("<ul>")
menu
- open("li").attr("id", "liGitHub")
- open("a").add_class("btn").attr("id", "logGitHub")
- add("img").attr("id", "imgGitHub").attr("src", "resources/icons/github-icon.png")
- close("a")
- open("div").add_class("popover bottom")
- add("div").add_class("arrow").text(" ")
- open("div").add_class("githubTitle")
- add("h3").text("Github Sign In")
- close("div")
- open("div")
- add("label").attr("id", "lbloginGit").text("Username")
- add("input").attr("id", "loginGit").attr("name", "login").attr("type", "text")
- open("label").attr("id", "logginMessage").text("Hello ")
- open("a").attr("id", "githubAccount")
- add("strong").attr("id", "nickName").text(" ")
- close("a")
- close("label")
- close("div")
- open("div")
- add("label").attr("id", "lbpasswordGit").text("Password")
- add("input").attr("id", "passwordGit").attr("name", "password").attr("type", "password")
- open("div").attr("id", "listBranches")
- add("label").attr("id", "lbBranches").text("Branch")
- add("select").add_class("dropdown").attr("id", "dropBranches").attr("name", "dropBranches").attr("tabindex", "1").text(" ")
- close("div")
- close("div")
- open("div")
- add("label").attr("id", "lbrepositoryGit").text("Repository")
- add("input").attr("id", "repositoryGit").attr("name", "repository").attr("type", "text")
- close("div")
- open("div")
- add("label").attr("id", "lbbranchGit").text("Branch")
- add("input").attr("id", "branchGit").attr("name", "branch").attr("type", "text")
- close("div")
- open("div")
- add("a").attr("id", "signIn").text("Sign In")
- close("div")
- close("div")
- close("li")
- close("ul")
- close("nav")
- close("header")
- end
-
- fun content is abstract
-
- fun footer do
- add("footer").text("Nit standard library. Version jenkins-component=stdlib-19.")
+ append("</ul>")
+ append("</nav>")
+ append("</header>")
+ end
+
+ protected fun content is abstract
+
+ protected fun footer do
+ if ctx.opt_custom_footer_text.value != null then
+ append("<footer>{ctx.opt_custom_footer_text.value.to_s}</footer>")
+ end
end
# Generate a clickable graphviz image using a dot content
- fun generate_dot(dot: String, name: String, alt: String) do
+ protected fun generate_dot(dot: String, name: String, alt: String) do
var output_dir = dot_dir
if output_dir == null then return
var file = new OFStream.open("{output_dir}/{name}.dot")
file.write(dot)
file.close
sys.system("\{ test -f {output_dir}/{name}.png && test -f {output_dir}/{name}.s.dot && diff {output_dir}/{name}.dot {output_dir}/{name}.s.dot >/dev/null 2>&1 ; \} || \{ cp {output_dir}/{name}.dot {output_dir}/{name}.s.dot && dot -Tpng -o{output_dir}/{name}.png -Tcmapx -o{output_dir}/{name}.map {output_dir}/{name}.s.dot ; \}")
- open("article").add_class("graph")
- add("img").attr("src", "{name}.png").attr("usemap", "#{name}").attr("style", "margin:auto").attr("alt", "{alt}")
- close("article")
+ append("<article class='graph'>")
+ append("<img src='{name}.png' usemap='#{name}' style='margin:auto' alt='{alt}'/>")
+ append("</article>")
var fmap = new IFStream.open("{output_dir}/{name}.map")
- add_html(fmap.read_all)
+ append(fmap.read_all)
fmap.close
end
# Add a (source) link for a given location
- fun show_source(l: Location): String
+ protected fun show_source(l: Location): String
do
if source == null then
return "({l.file.filename.simplify_path})"
source = x.join(l.line_start.to_s)
x = source.split_with("%L")
source = x.join(l.line_end.to_s)
- return " (<a href=\"{source.to_s}\">show code</a>)"
+ return " (<a target='_blank' title='Show source' href=\"{source.to_s}\">source</a>)"
end
end
+
+ # Render the page as a html string
+ protected fun render do
+ append("<!DOCTYPE html>")
+ append("<head>")
+ head
+ append("</head>")
+ append("<body>")
+ header
+ append("<div class='page'>")
+ content
+ append("</div>")
+ footer
+ append("</body>")
+ end
+
+ # Append a string to the page
+ fun append(s: String) do out.write(s)
+
+ # Save html page in the specified file
+ fun save(file: String) do
+ self.out = new OFStream.open(file)
+ render
+ self.out.close
+ end
+ private var out: nullable OFStream
end
# The overview page
private var mbuilder: ModelBuilder
private var mmodules = new Array[MModule]
- init(mbuilder: ModelBuilder, dot_dir: nullable String) do
- self.mbuilder = mbuilder
+ init(ctx: NitdocContext, dot_dir: nullable String) do
+ super(ctx)
+ self.mbuilder = ctx.mbuilder
self.dot_dir = dot_dir
# get modules
var mmodules = new HashSet[MModule]
for mmodule in mbuilder.model.mmodules do
+ if mmodule.name == "<main>" then continue
var owner = mmodule.public_owner
if owner != null then
mmodules.add(owner)
end
end
# sort modules
- var sorter = new ComparableSorter[MModule]
+ var sorter = new MModuleNameSorter
self.mmodules.add_all(mmodules)
sorter.sort(self.mmodules)
end
- redef fun head do
- super
- add("title").text("Overview | Nit Standard Library")
- end
+ redef fun title do return "Overview"
redef fun menu do
- add("li").add_class("current").text("Overview")
- open("li")
- add("a").attr("href", "full-index.html").text("Full Index")
- close("li")
+ super
+ append("<li class='current'>Overview</li>")
+ append("<li><a href='full-index.html'>Full Index</a></li>")
end
redef fun content do
- open("div").add_class("content fullpage")
- add("h1").text("Nit Standard Library")
- open("article").add_class("overview")
- add_html("<p>Documentation for the standard library of Nit<br />Version jenkins-component=stdlib-19<br />Date: TODAY</p>")
- close("article")
- open("article").add_class("overview")
+ var footed = ""
+ if ctx.opt_custom_footer_text.value != null then footed = "footed"
+ append("<div class='content fullpage {footed}'>")
+ var title = "Overview"
+ if ctx.opt_custom_title.value != null then
+ title = ctx.opt_custom_title.value.to_s
+ end
+ append("<h1>{title}</h1>")
+ var text = ""
+ if ctx.opt_custom_overview_text.value != null then
+ text = ctx.opt_custom_overview_text.value.to_s
+ end
+ append("<article class='overview'>{text}</article>")
+ append("<article class='overview'>")
# module list
- add("h2").text("Modules")
- open("ul")
+ append("<h2>Modules</h2>")
+ append("<ul>")
for mmodule in mmodules do
- var amodule = mbuilder.mmodule2nmodule[mmodule]
- open("li")
- add_html("{mmodule.link(amodule)} {amodule.short_comment}")
- close("li")
+ if mbuilder.mmodule2nmodule.has_key(mmodule) then
+ var amodule = mbuilder.mmodule2nmodule[mmodule]
+ append("<li>")
+ mmodule.html_link(self)
+ append(" {amodule.short_comment}</li>")
+ end
end
- close("ul")
+ append("</ul>")
# module graph
process_generate_dot
- close("article")
- close("div")
+ append("</article>")
+ append("</div>")
end
- fun process_generate_dot do
- var op = new Buffer
- op.append("digraph dep \{ rankdir=BT; node[shape=none,margin=0,width=0,height=0,fontsize=10]; edge[dir=none,color=gray]; ranksep=0.2; nodesep=0.1;\n")
+ private fun process_generate_dot do
+ # build poset with public owners
+ var poset = new POSet[MModule]
for mmodule in mmodules do
- op.append("\"{mmodule.name}\"[URL=\"{mmodule.name}.html\"];\n")
- for imported in mmodule.in_importation.direct_greaters do
- if imported.direct_owner == null then
- op.append("\"{mmodule.name}\"->\"{imported.name}\";\n")
+ poset.add_node(mmodule)
+ for omodule in mmodules do
+ if mmodule == omodule then continue
+ if mmodule.in_importation < omodule then
+ poset.add_node(omodule)
+ poset.add_edge(mmodule, omodule)
end
end
end
+ # build graph
+ var op = new Buffer
+ op.append("digraph dep \{ rankdir=BT; node[shape=none,margin=0,width=0,height=0,fontsize=10]; edge[dir=none,color=gray]; ranksep=0.2; nodesep=0.1;\n")
+ for mmodule in poset do
+ op.append("\"{mmodule.name}\"[URL=\"{mmodule.url}\"];\n")
+ for omodule in poset[mmodule].direct_greaters do
+ op.append("\"{mmodule.name}\"->\"{omodule.name}\";\n")
+ end
+ end
op.append("\}\n")
generate_dot(op.to_s, "dep", "Modules hierarchy")
end
class NitdocFullindex
super NitdocPage
- private var mmodules: Array[MModule]
-
- init(mmodules: Array[MModule]) do
- self.mmodules = mmodules
+ init(ctx: NitdocContext) do
+ super(ctx)
self.dot_dir = null
end
- redef fun head do
- super
- add("title").text("Full Index | Nit Standard Library")
- end
+ redef fun title do return "Full Index"
redef fun menu do
- open("li")
- add("a").attr("href", "index.html").text("Overview")
- close("li")
- add("li").add_class("current").text("Full Index")
+ super
+ append("<li><a href='index.html'>Overview</a></li>")
+ append("<li class='current'>Full Index</li>")
end
redef fun content do
- open("div").add_class("content fullpage")
- add("h1").text("Full Index")
+ var footed = ""
+ if ctx.opt_custom_footer_text.value != null then footed = "footed"
+ append("<div class='content fullpage {footed}'>")
+ append("<h1>Full Index</h1>")
module_column
classes_column
properties_column
- close("div")
+ append("</div>")
end
# Add to content modules column
- fun module_column do
- var ls = new List[nullable MModule]
- var sorted = mmodules
- var sorterp = new ComparableSorter[MModule]
- sorterp.sort(sorted)
- open("article").add_class("modules filterable")
- add("h2").text("Modules")
- open("ul")
+ private fun module_column do
+ var sorted = ctx.mbuilder.model.mmodule_importation_hierarchy.to_a
+ var sorter = new MModuleNameSorter
+ sorter.sort(sorted)
+ append("<article class='modules filterable'>")
+ append("<h2>Modules</h2>")
+ append("<ul>")
for mmodule in sorted do
- if mmodule.public_owner != null and not ls.has(mmodule.public_owner) then
- ls.add(mmodule.public_owner)
- open("li")
- add("a").attr("href", "{mmodule.public_owner.name}.html").text(mmodule.public_owner.name)
- close("li")
- end
+ append("<li>")
+ mmodule.html_link(self)
+ append("</li>")
end
- close("ul")
- close("article")
+ append("</ul>")
+ append("</article>")
end
# Add to content classes modules
- fun classes_column do
- var sorted = mmodules.first.imported_mclasses.to_a
- var sorterp = new ComparableSorter[MClass]
- sorterp.sort(sorted)
- open("article").add_class("classes filterable")
- add("h2").text("Classes")
- open("ul")
-
+ private fun classes_column do
+ var sorted = ctx.mbuilder.model.mclasses
+ var sorter = new MClassNameSorter
+ sorter.sort(sorted)
+ append("<article class='modules filterable'>")
+ append("<h2>Classes</h2>")
+ append("<ul>")
for mclass in sorted do
- open("li")
- add("a").attr("href", "{mclass}.html").text(mclass.name)
- close("li")
+ if mclass.visibility < ctx.min_visibility then continue
+ append("<li>")
+ mclass.html_link(self)
+ append("</li>")
end
-
- close("ul")
- close("article")
+ append("</ul>")
+ append("</article>")
end
# Insert the properties column of fullindex page
- fun properties_column do
- open("article").add_class("properties filterable")
- add("h2").text("Properties")
- open("ul")
- var sorted_imported = mmodules.first.imported_methods.to_a
- var sorted_redef = mmodules.first.redef_methods.to_a
- var sorterp = new ComparableSorter[MProperty]
- sorterp.sort(sorted_imported)
- sorterp.sort(sorted_redef)
-
- for method in sorted_imported do
- if method.visibility is none_visibility or method.visibility is intrude_visibility then continue
- open("li").add_class("intro")
- add("span").attr("title", "introduction").text("I")
- add_html(" ")
- add("a").attr("href", "{method.local_class.name}.html").attr("title", "").text("{method.name} ({method.local_class.name})")
- close("li")
- end
-
- for method in sorted_redef do
- if method.visibility is none_visibility or method.visibility is intrude_visibility then continue
- open("li").add_class("redef")
- add("span").attr("title", "redefinition").text("R")
- add_html(" ")
- add("a").attr("href", "{method.local_class.name}.html").attr("title", "").text("{method.name} ({method.local_class.name})")
- close("li")
- end
-
- close("ul")
- close("article")
+ private fun properties_column do
+ var sorted = ctx.mbuilder.model.mproperties
+ var sorter = new MPropertyNameSorter
+ sorter.sort(sorted)
+ append("<article class='modules filterable'>")
+ append("<h2>Properties</h2>")
+ append("<ul>")
+ for mproperty in sorted do
+ if mproperty.visibility < ctx.min_visibility then continue
+ if mproperty isa MAttribute then continue
+ append("<li>")
+ mproperty.intro.html_link(self)
+ append(" (")
+ mproperty.intro.mclassdef.mclass.html_link(self)
+ append(")</li>")
+ end
+ append("</ul>")
+ append("</article>")
end
end
private var mmodule: MModule
private var mbuilder: ModelBuilder
- init(mmodule: MModule, mbuilder: ModelBuilder, dot_dir: nullable String) do
+ init(mmodule: MModule, ctx: NitdocContext, dot_dir: nullable String) do
+ super(ctx)
self.mmodule = mmodule
- self.mbuilder = mbuilder
+ self.mbuilder = ctx.mbuilder
self.dot_dir = dot_dir
end
- redef fun head do
- super
- var amodule = mbuilder.mmodule2nmodule[mmodule]
- add("title").text("{mmodule.name} module | {amodule.short_comment}")
+ redef fun title do
+ if mbuilder.mmodule2nmodule.has_key(mmodule) then
+ var nmodule = mbuilder.mmodule2nmodule[mmodule]
+ return "{mmodule.name} module | {nmodule.short_comment}"
+ else
+ return "{mmodule.name} module"
+ end
end
redef fun menu do
- open("li")
- add("a").attr("href", "index.html").text("Overview")
- close("li")
- add("li").add_class("current").text(mmodule.name)
- open("li")
- add("a").attr("href", "full-index.html").text("Full Index")
- close("li")
+ super
+ append("<li><a href='index.html'>Overview</a></li>")
+ append("<li class='current'>{mmodule.name}</li>")
+ append("<li><a href='full-index.html'>Full Index</a></li>")
end
redef fun content do
sidebar
- open("div").add_class("content")
- add("h1").text(mmodule.name)
- add("div").add_class("subtitle")
- add_html("module {mmodule.namespace(mbuilder)}")
- module_comment
+ var footed = ""
+ if ctx.opt_custom_footer_text.value != null then footed = "footed"
+ append("<div class='content {footed}'>")
+ append("<h1>{mmodule.name}</h1>")
+ append("<div class='subtitle info'>")
+ mmodule.html_signature(self)
+ append("</div>")
+ mmodule.html_full_comment(self)
process_generate_dot
classes
properties
- close("div")
- end
-
- # Insert module comment in the content
- fun module_comment do
- var amodule = mbuilder.mmodule2nmodule[mmodule]
- var doc = amodule.comment
- open("div").attr("id", "description")
- add("pre").add_class("text_label").text(doc)
- add("textarea").add_class("edit").attr("rows", "1").attr("cols", "76").attr("id", "fileContent").text(" ")
- add("a").attr("id", "cancelBtn").text("Cancel")
- add("a").attr("id", "commitBtn").text("Commit")
- add("pre").add_class("text_label").attr("id", "preSave").attr("type", "2")
- close("div")
- end
-
- fun process_generate_dot do
- var name = "dep_{mmodule.name}"
+ append("</div>")
+ end
+
+ private fun process_generate_dot do
+ # build poset with public owners
+ var poset = new POSet[MModule]
+ for mmodule in self.mmodule.in_importation.poset do
+ if mmodule.name == "<main>" then continue
+ if mmodule.public_owner != null then continue
+ if not mmodule.in_importation < self.mmodule and not self.mmodule.in_importation < mmodule and mmodule != self.mmodule then continue
+ poset.add_node(mmodule)
+ for omodule in mmodule.in_importation.poset do
+ if mmodule == omodule then continue
+ if omodule.name == "<main>" then continue
+ if omodule.public_owner != null then continue
+ if mmodule.in_importation < omodule then
+ poset.add_node(omodule)
+ poset.add_edge(mmodule, omodule)
+ end
+ end
+ end
+ # build graph
var op = new Buffer
+ var name = "dep_{mmodule.name}"
op.append("digraph {name} \{ rankdir=BT; node[shape=none,margin=0,width=0,height=0,fontsize=10]; edge[dir=none,color=gray]; ranksep=0.2; nodesep=0.1;\n")
- for m in mmodule.in_importation.poset do
- var public_owner = m.public_owner
- if public_owner == null then
- public_owner = m
- if m == mmodule then
- op.append("\"{m.name}\"[shape=box,margin=0.03];\n")
- else
- op.append("\"{m.name}\"[URL=\"{m.name}.html\"];\n")
- end
+ for mmodule in poset do
+ if mmodule == self.mmodule then
+ op.append("\"{mmodule.name}\"[shape=box,margin=0.03];\n")
+ else
+ op.append("\"{mmodule.name}\"[URL=\"{mmodule.url}\"];\n")
end
- for imported in m.in_importation.direct_greaters do
- if imported.public_owner == null then
- op.append("\"{public_owner.name}\"->\"{imported.name}\";\n")
- end
+ for omodule in poset[mmodule].direct_greaters do
+ op.append("\"{mmodule.name}\"->\"{omodule.name}\";\n")
end
end
op.append("\}\n")
generate_dot(op.to_s, name, "Dependency graph for module {mmodule.name}")
end
- fun sidebar do
- var amodule = mbuilder.mmodule2nmodule[mmodule]
- open("div").add_class("menu")
- open("nav")
- add("h3").text("Module Hierarchy")
+ private fun sidebar do
+ append("<div class='menu'>")
+ append("<nav>")
+ append("<h3>Module Hierarchy</h3>")
var dependencies = new Array[MModule]
for dep in mmodule.in_importation.greaters do
if dep == mmodule or dep.public_owner != null then continue
dependencies.add(dep)
end
if dependencies.length > 0 then
- add("h4").text("All dependencies")
+ append("<h4>All dependencies</h4>")
display_module_list(dependencies)
end
var clients = new Array[MModule]
for dep in mmodule.in_importation.smallers do
+ if dep.name == "<main>" then continue
if dep == mmodule or dep.public_owner != null then continue
clients.add(dep)
end
if clients.length > 0 then
- add("h4").text("All clients")
+ append("<h4>All clients</h4>")
display_module_list(clients)
end
- close("nav")
- if mmodule.in_nesting.direct_greaters.length > 0 then
- open("nav")
- add("h3").text("Nested Modules")
- display_module_list(mmodule.in_nesting.direct_greaters.to_a)
- close("nav")
+ append("</nav>")
+ if ctx.min_visibility < protected_visibility then
+ if mmodule.in_nesting.direct_greaters.length > 0 then
+ append("<nav>")
+ append("<h3>Nested Modules</h3>")
+ display_module_list(mmodule.in_nesting.direct_greaters.to_a)
+ append("</nav>")
+ end
end
- close("div")
+ append("</div>")
end
private fun display_module_list(list: Array[MModule]) do
- open("ul")
- var sorter = new ComparableSorter[MModule]
+ append("<ul>")
+ var sorter = new MModuleNameSorter
sorter.sort(list)
for m in list do
- var am = mbuilder.mmodule2nmodule[m]
- open("li")
- add_html(m.link(am))
- close("li")
+ append("<li>")
+ m.html_link(self)
+ append("</li>")
end
- close("ul")
+ append("</ul>")
end
- fun classes do
- var amodule = mbuilder.mmodule2nmodule[mmodule]
+ # display the class column
+ private fun classes do
var intro_mclasses = mmodule.intro_mclasses
var redef_mclasses = mmodule.redef_mclasses
var all_mclasses = new HashSet[MClass]
var sorted = new Array[MClass]
sorted.add_all(all_mclasses)
- var sorter = new ComparableSorter[MClass]
+ var sorter = new MClassNameSorter
sorter.sort(sorted)
- open("div").add_class("module")
- open("article").add_class("classes filterable")
- add("h2").text("Classes")
- open("ul")
+ append("<div class='module'>")
+ append("<article class='classes filterable'>")
+ append("<h2>Classes</h2>")
+ append("<ul>")
for c in sorted do
- var nclass = mbuilder.mclassdef2nclassdef[c.intro].as(AStdClassdef)
+ if c.visibility < ctx.min_visibility then continue
if redef_mclasses.has(c) and c.intro_mmodule.public_owner != mmodule then
- open("li").add_class("redef")
- add("span").attr("title", "refined in this module").text("R ")
+ append("<li class='redef'>")
+ append("<span title='refined in this module'>R </span>")
else
- open("li").add_class("intro")
- add("span").attr("title", "introduced in this module").text("I ")
+ append("<li class='intro'>")
+ append("<span title='introduced in this module'>I </span>")
end
- add_html(c.link(nclass))
- close("li")
+ c.html_link(self)
+ append("</li>")
end
- close("ul")
- close("article")
- close("div")
+ append("</ul>")
+ append("</article>")
+ append("</div>")
end
- fun properties do
- var amodule = mbuilder.mmodule2nmodule[mmodule]
+ # display the property column
+ private fun properties do
+ # get properties
var mpropdefs = new HashSet[MPropDef]
for m in mmodule.in_nesting.greaters do
for c in m.mclassdefs do mpropdefs.add_all(c.mpropdefs)
end
for c in mmodule.mclassdefs do mpropdefs.add_all(c.mpropdefs)
var sorted = mpropdefs.to_a
- var sorter = new ComparableSorter[MPropDef]
+ var sorter = new MPropDefNameSorter
sorter.sort(sorted)
- open("article").add_class("properties filterable")
- add("h2").text("Properties")
- open("ul")
- for p in sorted do
- if p isa MAttributeDef then continue
- if p.mproperty.visibility <= none_visibility then continue
- if not mbuilder.mpropdef2npropdef.has_key(p) then continue
- var nprop = mbuilder.mpropdef2npropdef[p]
- if p.is_intro then
- open("li").add_class("intro")
- add("span").attr("title", "introduction").text("I")
- else
- open("li").add_class("redef")
- add("span").attr("title", "redefinition").text("R")
- end
- add_html(" {p.link(nprop)} ({p.mclassdef.mclass.name})")
- close("li")
- end
- close("ul")
- close("article")
+ # display properties in one column
+ append("<article class='properties filterable'>")
+ append("<h2>Properties</h2>")
+ append("<ul>")
+ for mprop in sorted do
+ if mprop isa MAttributeDef then continue
+ if mprop.mproperty.visibility < ctx.min_visibility then continue
+ mprop.html_list_item(self)
+ end
+ append("</ul>")
+ append("</article>")
end
end
super NitdocPage
private var mclass: MClass
- private var mbuilder: ModelBuilder
- private var nitdoc: Nitdoc
+ private var vtypes = new HashSet[MVirtualTypeDef]
+ private var consts = new HashSet[MMethodDef]
+ private var meths = new HashSet[MMethodDef]
+ private var inherited = new HashSet[MPropDef]
- init(mclass: MClass, nitdoc: Nitdoc, dot_dir: nullable String, source: nullable String) do
+ init(mclass: MClass, ctx: NitdocContext, dot_dir: nullable String, source: nullable String) do
+ super(ctx)
self.mclass = mclass
- self.mbuilder = nitdoc.modelbuilder
- self.nitdoc = nitdoc
self.dot_dir = dot_dir
self.source = source
+ # load properties
+ for mclassdef in mclass.mclassdefs do
+ for mpropdef in mclassdef.mpropdefs do
+ if mpropdef.mproperty.visibility < ctx.min_visibility then continue
+ if mpropdef isa MVirtualTypeDef then vtypes.add(mpropdef)
+ if mpropdef isa MMethodDef then
+ if mpropdef.mproperty.is_init then
+ consts.add(mpropdef)
+ else
+ meths.add(mpropdef)
+ end
+ end
+ end
+ end
+ # get inherited properties
+ for pclass in mclass.in_hierarchy(ctx.mainmodule).greaters do
+ if pclass == mclass then continue
+ for pclassdef in pclass.mclassdefs do
+ for mprop in pclassdef.intro_mproperties do
+ var mpropdef = mprop.intro
+ if mprop.visibility < ctx.min_visibility then continue
+ if mpropdef isa MVirtualTypeDef then vtypes.add(mpropdef)
+ if mpropdef isa MMethodDef then
+ if mpropdef.mproperty.is_init then
+ consts.add(mpropdef)
+ else
+ meths.add(mpropdef)
+ end
+ end
+ inherited.add(mpropdef)
+ end
+ end
+ end
end
- redef fun head do
- super
- var nclass = mbuilder.mclassdef2nclassdef[mclass.intro]
+ redef fun title do
+ var nclass = ctx.mbuilder.mclassdef2nclassdef[mclass.intro]
if nclass isa AStdClassdef then
- add("title").text("{mclass.name} class | {nclass.short_comment}")
+ return "{mclass.name} class | {nclass.short_comment}"
else
- add("title").text("{mclass.name} class")
+ return "{mclass.name} class"
end
end
redef fun menu do
- open("li")
- add("a").attr("href", "index.html").text("Overview")
- close("li")
- open("li")
+ super
+ append("<li><a href='index.html'>Overview</a></li>")
var public_owner = mclass.public_owner
if public_owner is null then
- var am = mbuilder.mmodule2nmodule[mclass.intro_mmodule]
- add_html(mclass.intro_mmodule.link(am))
+ append("<li>")
+ mclass.intro_mmodule.html_link(self)
+ append("</li>")
else
- var am = mbuilder.mmodule2nmodule[public_owner]
- add_html(public_owner.link(am))
+ append("<li>")
+ public_owner.html_link(self)
+ append("</li>")
end
- close("li")
- add("li").add_class("current").text(mclass.name)
- open("li")
- add("a").attr("href", "full-index.html").text("Full Index")
- close("li")
+ append("<li class='current'>{mclass.name}</li>")
+ append("<li><a href='full-index.html'>Full Index</a></li>")
end
redef fun content do
- open("div").add_class("menu")
+ append("<div class='menu'>")
properties_column
inheritance_column
- close("div")
- open("div").add_class("content")
+ append("</div>")
+ var footed = ""
+ if ctx.opt_custom_footer_text.value != null then footed = "footed"
+ append("<div class='content {footed}'>")
class_doc
- close("div")
+ append("</div>")
end
- fun properties_column do
- var sorter = new ComparableSorter[MPropDef]
- open("nav").add_class("properties filterable")
- add("h3").text("Properties")
- # get properties
- var vtypes = new HashSet[MVirtualTypeDef]
- var consts = new HashSet[MMethodDef]
- var meths = new HashSet[MMethodDef]
- for mclassdef in mclass.mclassdefs do
- for mpropdef in mclassdef.mpropdefs do
- if not mbuilder.mpropdef2npropdef.has_key(mpropdef) then continue
- if mpropdef.mproperty.visibility <= none_visibility then continue
- if mpropdef isa MVirtualTypeDef then vtypes.add(mpropdef)
- if mpropdef isa MMethodDef then
- if mpropdef.mproperty.is_init then
- consts.add(mpropdef)
- else
- meths.add(mpropdef)
- end
- end
- end
- end
- for mprop in mclass.inherited_methods do
- var mpropdef = mprop.intro
- if not mbuilder.mpropdef2npropdef.has_key(mpropdef) then continue
- if mprop.visibility <= none_visibility then continue
- if mprop.intro_mclassdef.mclass.name == "Object" then continue
- meths.add(mpropdef)
- end
+ private fun properties_column do
+ var sorter = new MPropDefNameSorter
+ append("<nav class='properties filterable'>")
+ append("<h3>Properties</h3>")
# virtual types
if vtypes.length > 0 then
var vts = new Array[MVirtualTypeDef]
vts.add_all(vtypes)
sorter.sort(vts)
- add("h4").text("Virtual Types")
- display_mpropdef_list(vts)
+ append("<h4>Virtual Types</h4>")
+ append("<ul>")
+ for mprop in vts do
+ mprop.html_sidebar_item(self)
+ end
+ append("</ul>")
end
+ # constructors
if consts.length > 0 then
var cts = new Array[MMethodDef]
cts.add_all(consts)
sorter.sort(cts)
- add("h4").text("Constructors")
- display_mpropdef_list(cts)
+ append("<h4>Constructors</h4>")
+ append("<ul>")
+ for mprop in cts do
+ if mprop.mproperty.name == "init" and mprop.mclassdef.mclass != mclass then continue
+ mprop.html_sidebar_item(self)
+ end
+ append("</ul>")
end
+ # methods
if meths.length > 0 then
var mts = new Array[MMethodDef]
mts.add_all(meths)
sorter.sort(mts)
- add("h4").text("Methods")
- display_mpropdef_list(mts)
- end
- close("nav")
- end
-
- private fun display_mpropdef_list(list: Array[MPropDef]) do
- open("ul")
- for prop in list do
- var nprop = mbuilder.mpropdef2npropdef[prop]
- if prop.is_intro and prop.mproperty.intro_mclassdef.mclass != mclass then
- open("li").add_class("inherit")
- add("span").attr("title", "Inherited").text("H")
- else if prop.is_intro then
- open("li").add_class("intro")
- add("span").attr("title", "Introduced").text("I")
- else
- open("li").add_class("redef")
- add("span").attr("title", "Redefined").text("R")
+ append("<h4>Methods</h4>")
+ append("<ul>")
+ for mprop in mts do
+ if mclass.name != "Object" and mprop.mproperty.intro_mclassdef.mclass.name == "Object" and mprop.mproperty.visibility <= protected_visibility then continue
+ mprop.html_sidebar_item(self)
end
- add_html(prop.link(nprop))
- close("li")
+ append("</ul>")
end
- close("ul")
+ append("</nav>")
end
- fun inheritance_column do
+ private fun inheritance_column do
var sorted = new Array[MClass]
- var sorterp = new ComparableSorter[MClass]
- open("nav")
- add("h3").text("Inheritance")
- if mclass.ancestors.length > 1 then
- sorted = mclass.ancestors.to_a
- sorterp.sort(sorted)
- add("h4").text("Superclasses")
- open("ul")
- for sup in sorted do
+ var sorterp = new MClassNameSorter
+ append("<nav>")
+ append("<h3>Inheritance</h3>")
+ var greaters = mclass.in_hierarchy(ctx.mainmodule).greaters.to_a
+ if greaters.length > 1 then
+ ctx.mainmodule.linearize_mclasses(greaters)
+ append("<h4>Superclasses</h4>")
+ append("<ul>")
+ for sup in greaters do
if sup == mclass then continue
- open("li")
- add("a").attr("href", "{sup.name}.html").text(sup.name)
- close("li")
+ append("<li>")
+ sup.html_link(self)
+ append("</li>")
end
- close("ul")
- end
-
- if mclass.descendants.length <= 1 then
- add("h4").text("No Known Subclasses")
- else if mclass.descendants.length <= 100 then
- sorted = mclass.descendants.to_a
- sorterp.sort(sorted)
- add("h4").text("Subclasses")
- open("ul")
- for sub in sorted do
+ append("</ul>")
+ end
+ var smallers = mclass.in_hierarchy(ctx.mainmodule).smallers.to_a
+ var direct_smallers = mclass.in_hierarchy(ctx.mainmodule).direct_smallers.to_a
+ if smallers.length <= 1 then
+ append("<h4>No Known Subclasses</h4>")
+ else if smallers.length <= 100 then
+ ctx.mainmodule.linearize_mclasses(smallers)
+ append("<h4>Subclasses</h4>")
+ append("<ul>")
+ for sub in smallers do
if sub == mclass then continue
- open("li")
- add("a").attr("href", "{sub.name}.html").text(sub.name)
- close("li")
+ append("<li>")
+ sub.html_link(self)
+ append("</li>")
end
- close("ul")
- else if mclass.children.length <= 100 then
- sorted = mclass.children.to_a
- sorterp.sort(sorted)
- add("h4").text("Direct Subclasses Only")
- open("ul")
- for sub in sorted do
+ append("</ul>")
+ else if direct_smallers.length <= 100 then
+ ctx.mainmodule.linearize_mclasses(direct_smallers)
+ append("<h4>Direct Subclasses Only</h4>")
+ append("<ul>")
+ for sub in direct_smallers do
if sub == mclass then continue
- open("li")
- add("a").attr("href", "{sub.name}.html").text(sub.name)
- close("li")
+ append("<li>")
+ sub.html_link(self)
+ append("</li>")
end
- close("ul")
+ append("</ul>")
else
- add("h4").text("Too much Subclasses to list")
+ append("<h4>Too much Subclasses to list</h4>")
end
- close("nav")
+ append("</nav>")
end
- fun class_doc do
- var nclass = mbuilder.mclassdef2nclassdef[mclass.intro]
- var sorted = new Array[MModule]
- sorted.add_all(mclass.concerns.keys)
- var sorterp = new ComparableSorter[MModule]
- var sorterprop = new ComparableSorter[MProperty]
- var sorterc = new ComparableSorter[MClass]
- sorterp.sort(sorted)
- var subtitle = ""
- var lmmodule = new List[MModule]
- # Insert the subtitle part
- add("h1").text(mclass.to_s)
- open("div").add_class("subtitle")
- if mclass.visibility is none_visibility then subtitle += "private "
- subtitle += "{mclass.kind} {mclass.public_owner.namespace(mbuilder)}::{mclass}"
- add_html(subtitle)
- close("div")
- add_html("<div style=\"float: right;\"><a id=\"lblDiffCommit\"></a></div>")
- # We add the class description
- open("section").add_class("description")
- if nclass isa AStdClassdef and not nclass.comment.is_empty then add_html("<pre class=\"text_label\" title=\"122\" name=\"\" tag=\"{mclass.mclassdefs.first.location.to_s}\" type=\"2\">{nclass.comment} </pre><textarea id=\"fileContent\" class=\"edit\" cols=\"76\" rows=\"1\" style=\"display: none;\"></textarea><a id=\"cancelBtn\" style=\"display: none;\">Cancel</a><a id=\"commitBtn\" style=\"display: none;\">Commit</a><pre id=\"preSave\" class=\"text_label\" type=\"2\"></pre>")
+ private fun class_doc do
+ # title
+ append("<h1>{mclass.signature}</h1>")
+ append("<div class='subtitle info'>")
+ mclass.html_full_signature(self)
+ append("</div>")
+ # comment
+ var nclass = ctx.mbuilder.mclassdef2nclassdef[mclass.intro]
+ append("<section class='description'>")
process_generate_dot
- close("section")
- open("section").add_class("concerns")
- add("h2").add_class("section-header").text("Concerns")
- open("ul")
- for owner in sorted do
- var nmodule = mbuilder.mmodule2nmodule[owner]
- var childs = mclass.concerns[owner]
- open("li")
- add_html("<a href=\"#MOD_{owner.name}\">{owner.name}</a>: {nmodule.short_comment}")
- if not childs is null then
- open("ul")
- var sortedc = childs.to_a
- var sorterpc = new ComparableSorter[MModule]
- sorterpc.sort(sortedc)
- for child in sortedc do
- var nchild = mbuilder.mmodule2nmodule[child]
- add_html("<li><a href=\"#MOD_{child.name}\">{child.name}</a>: {nchild.short_comment} </li>")
+ append("</section>")
+ # concerns
+ var concern2meths = new ArrayMap[MModule, Array[MMethodDef]]
+ var sorted_meths = new Array[MMethodDef]
+ var sorted = new Array[MModule]
+ sorted_meths.add_all(meths)
+ ctx.mainmodule.linearize_mpropdefs(sorted_meths)
+ for meth in meths do
+ if inherited.has(meth) then continue
+ var mmodule = meth.mclassdef.mmodule
+ if not concern2meths.has_key(mmodule) then
+ sorted.add(mmodule)
+ concern2meths[mmodule] = new Array[MMethodDef]
+ end
+ concern2meths[mmodule].add(meth)
+ end
+ var sections = new ArrayMap[MModule, Array[MModule]]
+ for mmodule in concern2meths.keys do
+ var owner = mmodule.public_owner
+ if owner == null then owner = mmodule
+ if not sections.has_key(owner) then sections[owner] = new Array[MModule]
+ if owner != mmodule then sections[owner].add(mmodule)
+ end
+ append("<section class='concerns'>")
+ append("<h2 class='section-header'>Concerns</h2>")
+ append("<ul>")
+ for owner, mmodules in sections do
+ var nowner = ctx.mbuilder.mmodule2nmodule[owner]
+ append("<li>")
+ if nowner.short_comment.is_empty then
+ append("<a href=\"#{owner.anchor}\">{owner.name}</a>")
+ else
+ append("<a href=\"#{owner.anchor}\">{owner.name}</a>: {nowner.short_comment}")
+ end
+ if not mmodules.is_empty then
+ append("<ul>")
+ for mmodule in mmodules do
+ var nmodule = ctx.mbuilder.mmodule2nmodule[mmodule]
+ if nmodule.short_comment.is_empty then
+ append("<li><a href=\"#{mmodule.anchor}\">{mmodule.name}</a></li>")
+ else
+ append("<li><a href=\"#{mmodule.anchor}\">{mmodule.name}</a>: {nmodule.short_comment}</li>")
+ end
end
- close("ul")
+ append("</ul>")
end
- close("li")
- end
- close("ul")
- close("section")
- # Insert virtual types if there is almost one
- if mclass.virtual_types.length > 0 or mclass.arity > 0 then
- open("section").add_class("types")
- add("h2").text("Formal and Virtual Types")
- if mclass.virtual_types.length > 0 then for prop in mclass.virtual_types do description(prop)
+ append("</li>")
+ end
+ append("</ul>")
+ append("</section>")
+ # properties
+ var prop_sorter = new MPropDefNameSorter
+ var lmmodule = new List[MModule]
+ # virtual and formal types
+ var local_vtypes = new Array[MVirtualTypeDef]
+ for vt in vtypes do if not inherited.has(vt) then local_vtypes.add(vt)
+ if local_vtypes.length > 0 or mclass.arity > 0 then
+ append("<section class='types'>")
+ append("<h2>Formal and Virtual Types</h2>")
+ # formal types
if mclass.arity > 0 and nclass isa AStdClassdef then
- for prop in nclass.n_formaldefs do
- open("article").attr("id", "FT_Object_{prop.collect_text}")
- open("h3").add_class("signature").text("{prop.collect_text}: nullable ")
- add_html("<a title=\"The root of the class hierarchy.\" href=\"Object.html\">Object</a>")
- close("h3")
- add_html("<div class=\"info\">formal generic type</div>")
- close("article")
+ for ft, bound in mclass.parameter_types do
+ append("<article id='FT_{ft}'>")
+ append("<h3 class='signature' data-untyped-signature='{ft.to_s}'><span>{ft}: ")
+ bound.html_link(self)
+ append("</span></h3>")
+ append("<div class=\"info\">formal generic type</div>")
+ append("</article>")
end
end
- close("section")
+ # virtual types
+ prop_sorter.sort(local_vtypes)
+ for prop in local_vtypes do prop.html_full_desc(self)
+ append("</section>")
end
# constructors
- if mclass.constructors.length > 0 then
- var sortedc = mclass.constructors.to_a
- sorterprop.sort(sortedc)
- open("section").add_class("constructors")
- add("h2").add_class("section-header").text("Constructors")
- for prop in sortedc do description(prop)
- close("section")
+ var local_consts = new Array[MMethodDef]
+ for const in consts do if not inherited.has(const) then local_consts.add(const)
+ prop_sorter.sort(local_consts)
+ if local_consts.length > 0 then
+ append("<section class='constructors'>")
+ append("<h2 class='section-header'>Constructors</h2>")
+ for prop in local_consts do prop.html_full_desc(self)
+ append("</section>")
end
# methods
- open("section").add_class("methods")
- add("h2").add_class("section-header").text("Methods")
- for mmodule, mmethods in mclass.all_methods do
- var nmodule = mbuilder.mmodule2nmodule[mmodule]
- add_html("<a id=\"MOD_{mmodule.name}\"></a>")
- if mmodule != mclass.intro_mmodule and mmodule != mclass.public_owner then
- if mclass.has_mmodule(mmodule) then
- add_html("<p class=\"concern-doc\">{mmodule.name}: {nmodule.short_comment}</p>")
- else
- add_html("<h3 class=\"concern-toplevel\">Methods refined in {mmodule.link(nmodule)}</h3><p class=\"concern-doc\">{mmodule.name}: {nmodule.short_comment}</p>")
+ if not concern2meths.is_empty then
+ append("<section class='methods'>")
+ append("<h2 class='section-header'>Methods</h2>")
+ for owner, mmodules in sections do
+ append("<a id=\"{owner.anchor}\"></a>")
+ if owner != mclass.intro_mmodule and owner != mclass.public_owner then
+ var nowner = ctx.mbuilder.mmodule2nmodule[owner]
+ append("<h3 class=\"concern-toplevel\">Methods refined in ")
+ owner.html_link(self)
+ append("</h3>")
+ append("<p class=\"concern-doc\">")
+ owner.html_link(self)
+ if not nowner.short_comment.is_empty then
+ append(": {nowner.short_comment}")
+ end
+ append("</p>")
end
- end
- var sortedc = mmethods.to_a
- sorterprop.sort(sortedc)
- for prop in sortedc do description(prop)
- end
- # inherited methods
- if mclass.inherited_methods.length > 0 then
- var sortedc = new Array[MClass]
- sortedc.add_all(mclass.inherited.keys)
- sorterc.sort(sortedc)
- add("h3").text("Inherited Methods")
- for imclass in sortedc do
- var inclass = mbuilder.mclassdef2nclassdef[imclass.intro].as(AStdClassdef)
- var sortedp = mclass.inherited[imclass].to_a
- sorterprop.sort(sortedp)
- open("p")
- add_html("Defined in {imclass.link(inclass)}: ")
- for method in sortedp do
- #TODO link to inherited propdef
- add_html("<a href=\"\">{method.name}</a>")
- if method != sortedp.last then add_html(", ")
+ if concern2meths.has_key(owner) then
+ var mmethods = concern2meths[owner]
+ prop_sorter.sort(mmethods)
+ for prop in mmethods do prop.html_full_desc(self)
+ end
+ for mmodule in mmodules do
+ append("<a id=\"{mmodule.anchor}\"></a>")
+ var nmodule = ctx.mbuilder.mmodule2nmodule[mmodule]
+ if mmodule != mclass.intro_mmodule and mmodule != mclass.public_owner then
+ append("<p class=\"concern-doc\">")
+ mmodule.html_link(self)
+ if not nmodule.short_comment.is_empty then
+ append(": {nmodule.short_comment}")
+ end
+ append("</p>")
+ end
+ var mmethods = concern2meths[mmodule]
+ prop_sorter.sort(mmethods)
+ for prop in mmethods do prop.html_full_desc(self)
end
- close("p")
end
end
- close("section")
- end
-
- fun description(prop: MProperty) do
- if not mbuilder.mpropdef2npropdef.has_key(prop.intro) then return
- var nprop = mbuilder.mpropdef2npropdef[prop.intro]
- if not nprop isa AMethPropdef then return
- var classes = new Array[String]
- if nprop isa AInitPropdef then
- classes.add("init")
- else
- classes.add("fun")
- end
- if prop.is_redef then classes.add("redef")
- if prop.visibility == none_visibility then
- classes.add("private")
- else if prop.visibility == protected_visibility then
- classes.add("protected")
- else
- classes.add("public")
- end
- open("article").add_classes(classes).attr("id", "{prop.anchor}")
- var sign = prop.name
- open("h3").add_class("signature")
- add_html("{prop.name}{nprop.signature}")
- close("h3")
- open("div").add_class("info")
- add_html("{if prop.is_redef then "redef" else ""} fun {prop.intro_mclassdef.namespace(mclass)}::{prop.name}</div><div style=\"float: right;\"><a id=\"lblDiffCommit\"></a>")
- close("div")
- open("div").add_class("description")
- if nprop.comment == "" then
- add_html("<a class=\"newComment\" title=\"32\" tag=\"\">New Comment</a>")
- else
- add_html("<pre class=\"text_label\" title=\"\" name=\"\" tag=\"\" type=\"1\">{nprop.comment}</pre>")
- end
- add_html("<textarea id=\"fileContent\" class=\"edit\" cols=\"76\" rows=\"1\" style=\"display: none;\"></textarea><a id=\"cancelBtn\" style=\"display: none;\">Cancel</a><a id=\"commitBtn\" style=\"display: none;\">Commit</a><pre id=\"preSave\" class=\"text_label\" type=\"2\"></pre>")
- open("p")
- if prop.local_class != mclass then
- var mredef = prop.local_class.intro_mmodule
- var nredef = mbuilder.mmodule2nmodule[mredef]
- add_html("inherited from {mredef.link(nredef)} ")
- end
- #TODO display show code if doc github
- var mintro = prop.intro_mclassdef.mmodule
- var nintro = mbuilder.mmodule2nmodule[mintro]
- add_html("defined by the module {mintro.link(nintro)}{if prop.apropdef is null then "" else show_source(prop.apropdef.location)}.")
-
- for parent in mclass.parents do
- var mparent = parent.intro_mmodule
- var nparent = mbuilder.mmodule2nmodule[mparent]
- if prop isa MMethod then if parent.constructors.has(prop) then add_html(" Previously defined by: {mparent.link(nparent)} for <a href=\"{parent.name}.html\">{parent.name}</a>.")
+ # inherited properties
+ if inherited.length > 0 then
+ var sorted_inherited = new Array[MPropDef]
+ sorted_inherited.add_all(inherited)
+ ctx.mainmodule.linearize_mpropdefs(sorted_inherited)
+ var classes = new ArrayMap[MClass, Array[MPropDef]]
+ for mmethod in sorted_inherited.reversed do
+ var mclass = mmethod.mclassdef.mclass
+ if not classes.has_key(mclass) then classes[mclass] = new Array[MPropDef]
+ classes[mclass].add(mmethod)
+ end
+ append("<h3>Inherited Properties</h3>")
+ for c, mmethods in classes do
+ prop_sorter.sort(mmethods)
+ append("<p>Defined in ")
+ c.html_link(self)
+ append(": ")
+ for i in [0..mmethods.length[ do
+ var mmethod = mmethods[i]
+ mmethod.html_link(self)
+ if i <= mmethods.length - 1 then append(", ")
+ end
+ append("</p>")
+ end
end
- close("p")
- close("div")
-
- close("article")
+ append("</section>")
end
- fun process_generate_dot do
- var pe = nitdoc.class_hierarchy[mclass]
+ private fun process_generate_dot do
+ var pe = ctx.class_hierarchy[mclass]
var cla = new HashSet[MClass]
var sm = new HashSet[MClass]
var sm2 = new HashSet[MClass]
if c == mclass then
op.append("\"{c.name}\"[shape=box,margin=0.03];\n")
else
- op.append("\"{c.name}\"[URL=\"{c.name}.html\"];\n")
+ op.append("\"{c.name}\"[URL=\"{c.url}\"];\n")
end
for c2 in pe.poset[c].direct_greaters do
if not cla.has(c2) then continue
end
end
-redef class AModule
- private fun comment: String do
- var ret = ""
- if n_moduledecl is null or n_moduledecl.n_doc is null then ret
- if n_moduledecl.n_doc is null then return ""
- for t in n_moduledecl.n_doc.n_comment do
- var txt = t.text
- txt = txt.replace("# ", "")
- txt = txt.replace("#", "")
- ret += txt
- end
- return ret
- end
+#
+# Model redefs
+#
- private fun short_comment: String do
- var ret = ""
- if n_moduledecl != null and n_moduledecl.n_doc != null then
- var txt = n_moduledecl.n_doc.n_comment.first.text
- txt = txt.replace("# ", "")
- txt = txt.replace("\n", "")
- ret += txt
+redef class MModule
+ # URL to nitdoc page
+ fun url: String do
+ if url_cache == null then
+ var res = new Buffer
+ res.append("module_")
+ var mowner = public_owner
+ if mowner != null then
+ res.append("{public_owner.name}_")
+ end
+ res.append("{self.name}.html")
+ url_cache = res.to_s
end
- return ret
+ return url_cache.as(not null)
end
-end
+ private var url_cache: nullable String
-redef class MModule
- super Comparable
- redef type OTHER: MModule
- redef fun <(other: OTHER): Bool do return self.name < other.name
-
- # Get the list of all methods in a module
- fun imported_methods: Set[MMethod] do
- var methods = new HashSet[MMethod]
- for mclass in imported_mclasses do
- for method in mclass.intro_methods do
- methods.add(method)
+ # html anchor id to the module in a nitdoc page
+ fun anchor: String do
+ if anchor_cache == null then
+ var res = new Buffer
+ res.append("MOD_")
+ var mowner = public_owner
+ if mowner != null then
+ res.append("{public_owner.name}_")
end
+ res.append(self.name)
+ anchor_cache = res.to_s
end
- return methods
+ return anchor_cache.as(not null)
end
+ private var anchor_cache: nullable String
- # Get the list aof all refined methods in a module
- fun redef_methods: Set[MMethod] do
- var methods = new HashSet[MMethod]
- for mclass in redef_mclasses do
- for method in mclass.intro_methods do
- methods.add(method)
+ # Return a link (html a tag) to the nitdoc module page
+ fun html_link(page: NitdocPage) do
+ if html_link_cache == null then
+ var res = new Buffer
+ if page.ctx.mbuilder.mmodule2nmodule.has_key(self) then
+ res.append("<a href='{url}' title='{page.ctx.mbuilder.mmodule2nmodule[self].short_comment}'>{name}</a>")
+ else
+ res.append("<a href='{url}'>{name}</a>")
end
+ html_link_cache = res.to_s
end
- return methods
+ page.append(html_link_cache.as(not null))
end
+ private var html_link_cache: nullable String
- # Return a link (html a tag) to the nitdoc module page
- fun link(amodule: AModule): String do
- return "<a href=\"{name}.html\" title=\"{amodule.short_comment}\">{name}</a>"
+ # Return the module signature decorated with html
+ fun html_signature(page: NitdocPage) do
+ page.append("<span>module ")
+ html_full_namespace(page)
+ page.append("</span>")
+ end
+
+ # Return the module full namespace decorated with html
+ fun html_full_namespace(page: NitdocPage) do
+ page.append("<span>")
+ var mowner = public_owner
+ if mowner != null then
+ public_owner.html_namespace(page)
+ page.append("::")
+ end
+ html_link(page)
+ page.append("</span>")
end
- # Return the module namespace decorated with html
- fun namespace(mbuilder: ModelBuilder): String do
- var str = new Buffer
+ # Return the module full namespace decorated with html
+ fun html_namespace(page: NitdocPage) do
+ page.append("<span>")
var mowner = public_owner
if mowner != null then
- var nowner = mbuilder.mmodule2nmodule[mowner]
- str.append(public_owner.link(nowner))
- str.append("::")
+ public_owner.html_namespace(page)
+ else
+ html_link(page)
+ end
+ page.append("</span>")
+ end
+
+ # Return the full comment of the module decorated with html
+ fun html_full_comment(page: NitdocPage) do
+ if page.ctx.mbuilder.mmodule2nmodule.has_key(self) then
+ page.append("<div id='description'>")
+ page.append("<pre class='text_label'>{page.ctx.mbuilder.mmodule2nmodule[self].full_comment}</pre>")
+ page.append("</div>")
end
- var nmodule = mbuilder.mmodule2nmodule[self]
- str.append(self.link(nmodule))
- return str.to_s
end
end
-redef class MPropDef
- super Comparable
- redef type OTHER: MPropDef
- redef fun <(other: OTHER): Bool do return self.mproperty.name < other.mproperty.name
+
+redef class MClass
+ # Return the module signature decorated with html
+ fun html_full_signature(page: NitdocPage) do
+ if visibility < public_visibility then page.append("{visibility.to_s} ")
+ page.append("{kind} ")
+ html_namespace(page)
+ end
+
+ # name with formal parameter
+ # Foo[A, B]
+ private fun signature: String do
+ if arity > 0 then
+ return "{name}[{intro.parameter_names.join(", ")}]"
+ else
+ return name
+ end
+ end
# Return a link (html a tag) to the nitdoc class page
- fun link(nprop: APropdef): String do
- return "<a href=\"{mclassdef.mclass.name}.html#{mproperty.anchor}\" title=\"{nprop.short_comment}\">{mproperty}</a>"
+ fun html_link(page: NitdocPage) do
+ if html_link_cache == null then
+ var res = new Buffer
+ res.append("<a href='{url}'")
+ if page.ctx.mbuilder.mclassdef2nclassdef.has_key(intro) then
+ var nclass = page.ctx.mbuilder.mclassdef2nclassdef[intro]
+ if nclass isa AStdClassdef then
+ res.append(" title=\"{nclass.short_comment}\"")
+ end
+ end
+ res.append(">{signature}</a>")
+ html_link_cache = res.to_s
+ end
+ page.append(html_link_cache.as(not null))
+ end
+ private var html_link_cache: nullable String
+
+ # Return the class namespace decorated with html
+ fun html_namespace(page: NitdocPage) do
+ intro_mmodule.html_namespace(page)
+ page.append("::<span>")
+ html_link(page)
+ page.append("</span>")
+ end
+
+ fun url: String do
+ return "class_{public_owner}_{name}.html"
end
+
+ # Escape name for html output
+ redef fun name do return super.html_escape
end
redef class MProperty
- super Comparable
- redef type OTHER: MProperty
- redef fun <(other: OTHER): Bool do return self.name < other.name
+ # Return the property namespace decorated with html
+ fun html_namespace(page: NitdocPage) do
+ intro_mclassdef.mclass.html_namespace(page)
+ page.append("::<span>")
+ intro.html_link(page)
+ page.append("</span>")
+ end
- var is_redef: Bool
- var apropdef: nullable APropdef
+ # Escape name for html output
+ redef fun name do return super.html_escape
+end
- redef init(intro_mclassdef: MClassDef, name: String, visibility: MVisibility)
- do
- super
- is_redef = false
+redef class MType
+ fun html_link(page: NitdocPage) is abstract
+end
+
+redef class MClassType
+ redef fun html_link(page) do mclass.html_link(page)
+end
+
+redef class MNullableType
+ redef fun html_link(page) do
+ page.append("nullable ")
+ mtype.html_link(page)
end
+end
- fun local_class: MClass do
- var classdef = self.intro_mclassdef
- return classdef.mclass
+redef class MGenericType
+ redef fun html_link(page) do
+ page.append("<a href='{mclass.url}'>{mclass.name}</a>[")
+ for i in [0..arguments.length[ do
+ arguments[i].html_link(page)
+ if i < arguments.length - 1 then page.append(", ")
+ end
+ page.append("]")
end
+end
- fun anchor: String do
- return "PROP_{c_name}"
+redef class MParameterType
+ redef fun html_link(page) do
+ var name = mclass.intro.parameter_names[rank]
+ page.append("<a href='{mclass.url}#FT_{name}' title='formal type'>{name}</a>")
end
+end
+redef class MVirtualType
+ redef fun html_link(page) do mproperty.intro.html_link(page)
end
-redef class MClass
- super Comparable
- redef type OTHER: MClass
- redef fun <(other: OTHER): Bool do return self.name < other.name
+redef class MClassDef
+ # Return the classdef namespace decorated with html
+ fun html_namespace(page: NitdocPage) do
+ mmodule.html_full_namespace(page)
+ page.append("::<span>")
+ mclass.html_link(page)
+ page.append("</span>")
+ end
+end
- # Add type parameters
- redef fun to_s do
- if arity > 0 then
- return "{name}[{intro.parameter_names.join(", ")}]"
- else
- return name
+redef class MPropDef
+ fun url: String do
+ if url_cache == null then
+ url_cache = "{mclassdef.mclass.url}#{anchor}"
end
+ return url_cache.as(not null)
end
+ private var url_cache: nullable String
- # Return a link (html a tag) to the nitdoc class page
- fun link(aclass: AStdClassdef): String do
- return "<a href=\"{name}.html\" title=\"{aclass.short_comment}\">{self}</a>"
- end
-
- # Associate all MMethods to each MModule concerns
- fun all_methods: HashMap[MModule, Set[MMethod]] do
- var hm = new HashMap[MModule, Set[MMethod]]
- for mmodule, childs in concerns do
- if not hm.has_key(mmodule) then hm[mmodule] = new HashSet[MMethod]
- for prop in intro_methods do
- if mmodule == prop.intro_mclassdef.mmodule then
- prop.is_redef = false
- hm[mmodule].add(prop)
- end
- end
- for prop in redef_methods do
- if mmodule == prop.intro_mclassdef.mmodule then
- prop.is_redef = true
- hm[mmodule].add(prop)
- end
- end
+ fun anchor: String do
+ if anchor_cache == null then
+ anchor_cache = "PROP_{mclassdef.mclass.public_owner.name}_{mproperty.name}"
+ end
+ return anchor_cache.as(not null)
+ end
+ private var anchor_cache: nullable String
- if childs != null then
- for child in childs do
- if not hm.has_key(child) then hm[child] = new HashSet[MMethod]
- for prop in intro_methods do
- if child == prop.intro_mclassdef.mmodule then
- prop.is_redef = false
- hm[child].add(prop)
- end
- end
- for prop in redef_methods do
- if child == prop.intro_mclassdef.mmodule then
- prop.is_redef = true
- hm[child].add(prop)
- end
- end
- end
+ # Return a link (html a tag) to the nitdoc class page
+ fun html_link(page: NitdocPage) do
+ if html_link_cache == null then
+ var res = new Buffer
+ if page.ctx.mbuilder.mpropdef2npropdef.has_key(self) then
+ var nprop = page.ctx.mbuilder.mpropdef2npropdef[self]
+ res.append("<a href=\"{url}\" title=\"{nprop.short_comment}\">{mproperty.name}</a>")
+ else
+ res.append("<a href=\"{url}\">{mproperty.name}</a>")
end
+ html_link_cache = res.to_s
end
- return hm
+ page.append(html_link_cache.as(not null))
end
+ private var html_link_cache: nullable String
- fun public_owner: MModule do
- var owner = intro_mmodule
- if owner.public_owner is null then
- return owner
+ # Return a list item for the mpropdef
+ private fun html_list_item(page: NitdocPage) do
+ if is_intro then
+ page.append("<li class='intro'>")
+ page.append("<span title='introduction'>I</span> ")
+ else
+ page.append("<li class='redef'>")
+ page.append("<span title='redefinition'>R</span> ")
+ end
+ html_link(page)
+ page.append("(")
+ mclassdef.mclass.html_link(page)
+ page.append(")")
+ page.append("</li>")
+ end
+
+ # Return a list item for the mpropdef
+ private fun html_sidebar_item(page: NitdocClass) do
+ if is_intro and mclassdef.mclass == page.mclass then
+ page.append("<li class='intro'>")
+ page.append("<span title='Introduced'>I</span>")
+ else if is_intro and mclassdef.mclass != page.mclass then
+ page.append("<li class='inherit'>")
+ page.append("<span title='Inherited'>H</span>")
else
- return owner.public_owner.as(not null)
+ page.append("<li class='redef'>")
+ page.append("<span title='Redefined'>R</span>")
end
+ html_link(page)
+ page.append("</li>")
end
- # Associate MClass to all MMethod include in 'inherited_methods'
- fun inherited: HashMap[MClass, Set[MMethod]] do
- var hm = new HashMap[MClass, Set[MMethod]]
- for method in inherited_methods do
- var mclass = method.intro_mclassdef.mclass
- if not hm.has_key(mclass) then hm[mclass] = new HashSet[MMethod]
- hm[mclass].add(method)
- end
- return hm
- end
+ private fun html_full_desc(page: NitdocClass) is abstract
+ private fun html_info(page: NitdocClass) is abstract
- # Return true if MModule concern contain subMModule
- fun has_mmodule(sub: MModule): Bool do
- for mmodule, childs in concerns do
- if childs is null then continue
- if childs.has(sub) then return true
- end
- return false
+ fun full_name: String do
+ return "{mclassdef.mclass.public_owner.name}::{mclassdef.mclass.name}::{mproperty.name}"
end
- fun mmethod(mprop2npropdef: Map[MProperty, APropdef]) do
- for const in constructors do
- if mprop2npropdef.has_key(const)then
- const.apropdef = mprop2npropdef[const].as(AMethPropdef)
+ private fun html_inheritance(page: NitdocClass) do
+ # definitions block
+ page.append("<p class='info'>")
+ page.ctx.mainmodule.linearize_mpropdefs(mproperty.mpropdefs)
+ var previous_defs = new Array[MPropDef]
+ var next_defs = new Array[MPropDef]
+ var self_passed = false
+ for def in mproperty.mpropdefs do
+ if def == self then
+ self_passed = true
+ continue
+ end
+ if not self_passed then
+ if def.mclassdef.mclass.in_hierarchy(page.ctx.mainmodule) < page.mclass then continue
+ if def.is_intro then continue
+ previous_defs.add(def)
+ else
+ if page.mclass.in_hierarchy(page.ctx.mainmodule) < def.mclassdef.mclass then continue
+ next_defs.add(def)
end
end
-
- for intro in intro_methods do
- if mprop2npropdef.has_key(intro)then
- if mprop2npropdef[intro] isa AMethPropdef then intro.apropdef = mprop2npropdef[intro].as(AMethPropdef)
+ page.append("defined by ")
+ mclassdef.mmodule.html_full_namespace(page)
+ if page.ctx.mbuilder.mpropdef2npropdef.has_key(self) then
+ page.append(" {page.show_source(page.ctx.mbuilder.mpropdef2npropdef[self].location)}")
+ end
+ if not is_intro then
+ page.append(", introduced by ")
+ mproperty.intro.mclassdef.mclass.html_link(page)
+ if page.ctx.mbuilder.mpropdef2npropdef.has_key(self) then
+ page.append(" {page.show_source(page.ctx.mbuilder.mpropdef2npropdef[self].location)}")
end
end
+ if not previous_defs.is_empty then
+ page.append(", inherited from ")
+ for i in [0..previous_defs.length[ do
+ var def = previous_defs[i]
+ def.mclassdef.mclass.html_link(page)
+ if page.ctx.mbuilder.mpropdef2npropdef.has_key(def) then
+ page.append(" {page.show_source(page.ctx.mbuilder.mpropdef2npropdef[def].location)}")
+ end
- for rd in redef_methods do
- if mprop2npropdef.has_key(rd)then
- if mprop2npropdef[rd] isa AMethPropdef then rd.apropdef = mprop2npropdef[rd].as(AMethPropdef)
+ if i < previous_defs.length - 1 then page.append(", ")
end
end
+ if not next_defs.is_empty then
+ page.append(", redefined by ")
+ for i in [0..next_defs.length[ do
+ var def = next_defs[i]
+ def.mclassdef.mclass.html_link(page)
+ if page.ctx.mbuilder.mpropdef2npropdef.has_key(def) then
+ page.append(" {page.show_source(page.ctx.mbuilder.mpropdef2npropdef[def].location)}")
+ end
+ if i < next_defs.length - 1 then page.append(", ")
+ end
+ end
+ page.append(".</p>")
end
- fun link_anchor: String do
- return "{name}.html"
+ private fun html_comment(page: NitdocClass) do
+ if not page.ctx.mbuilder.mpropdef2npropdef.has_key(self) then return
+ var nprop = page.ctx.mbuilder.mpropdef2npropdef[self]
+ page.append("<div class='description'>")
+ if not is_intro and page.ctx.mbuilder.mpropdef2npropdef.has_key(mproperty.intro) then
+ var intro_nprop = page.ctx.mbuilder.mpropdef2npropdef[mproperty.intro]
+ page.append("<p class='info'>from ")
+ mproperty.html_namespace(page)
+ page.append("</p>")
+ if intro_nprop.full_comment == "" then
+ page.append("<span class=\"noComment\">No comment</span>")
+ else
+ page.append("<pre>{intro_nprop.full_comment}</pre>")
+ end
+ page.append("<p class='info'>from ")
+ mclassdef.html_namespace(page)
+ page.append("</p>")
+ end
+ if nprop.full_comment == "" then
+ page.append("<span class=\"noComment\">No comment</span>")
+ else
+ page.append("<pre>{nprop.full_comment}</pre>")
+ end
+ html_inheritance(page)
+ page.append("</div>")
end
-
end
-redef class AStdClassdef
- private fun comment: String do
- var ret = ""
- if n_doc != null then
- for t in n_doc.n_comment do
- var txt = t.text.replace("# ", "")
- txt = txt.replace("#", "")
- ret += "{txt}"
- end
+redef class MMethodDef
+ redef fun html_full_desc(page) do
+ var classes = new Array[String]
+ var is_redef = mproperty.intro_mclassdef.mclass != page.mclass
+ if mproperty.is_init then
+ classes.add("init")
+ else
+ classes.add("fun")
+ end
+ if is_redef then classes.add("redef")
+ classes.add(mproperty.visibility.to_s)
+ page.append("<article class='{classes.join(" ")}' id='{anchor}'>")
+ if page.ctx.mbuilder.mpropdef2npropdef.has_key(self) then
+ page.append("<h3 class='signature' data-untyped-signature='{mproperty.name}{msignature.untyped_signature(page)}'>")
+ page.append("<span>{mproperty.name}")
+ msignature.html_signature(page)
+ page.append("</span></h3>")
+ else
+ page.append("<h3 class='signature' data-untyped-signature='init{msignature.untyped_signature(page)}'>")
+ page.append("<span>init")
+ msignature.html_signature(page)
+ page.append("</span></h3>")
+ end
+ html_info(page)
+ html_comment(page)
+ page.append("</article>")
+ end
+
+ redef fun html_info(page) do
+ page.append("<div class='info'>")
+ if mproperty.visibility < public_visibility then page.append("{mproperty.visibility.to_s} ")
+ if mproperty.intro_mclassdef.mclass != page.mclass then page.append("redef ")
+ if mproperty.is_init then
+ page.append("init ")
+ else
+ page.append("fun ")
end
- return ret
+ mproperty.html_namespace(page)
+ page.append("</div>")
end
+end
- private fun short_comment: String do
- var ret = ""
- if n_doc != null then
- var txt = n_doc.n_comment.first.text
- txt = txt.replace("# ", "")
- txt = txt.replace("\n", "")
- ret += txt
- end
- return ret
+redef class MVirtualTypeDef
+ redef fun html_full_desc(page) do
+ var is_redef = mproperty.intro_mclassdef.mclass != page.mclass
+ var classes = new Array[String]
+ classes.add("type")
+ if is_redef then classes.add("redef")
+ classes.add(mproperty.visibility.to_s)
+ page.append("<article class='{classes.join(" ")}' id='{anchor}'>")
+ page.append("<h3 class='signature' data-untyped-signature='{mproperty.name}'><span>{mproperty.name}: ")
+ bound.html_link(page)
+ page.append("</span></h3>")
+ html_info(page)
+ html_comment(page)
+ page.append("</article>")
+ end
+
+ redef fun html_info(page) do
+ page.append("<div class='info'>")
+ if mproperty.intro_mclassdef.mclass != page.mclass then page.append("redef ")
+ page.append("type ")
+ mproperty.html_namespace(page)
+ page.append("</div>")
end
end
-redef class ASignature
- redef fun to_s do
- #TODO closures
- var ret = ""
- if not n_params.is_empty then
- ret = "{ret}({n_params.join(", ")})"
+redef class MSignature
+ private fun html_signature(page: NitdocPage) do
+ if not mparameters.is_empty then
+ page.append("(")
+ for i in [0..mparameters.length[ do
+ mparameters[i].html_link(page)
+ if i < mparameters.length - 1 then page.append(", ")
+ end
+ page.append(")")
+ end
+ if return_mtype != null then
+ page.append(": ")
+ return_mtype.html_link(page)
end
- if n_type != null and n_type.to_s != "" then ret += ": {n_type.to_s}"
- return ret
end
-end
-redef class AParam
- redef fun to_s do
- var ret = "{n_id.text}"
- if n_type != null then
- ret = "{ret}: {n_type.to_s}"
- if n_dotdotdot != null then ret = "{ret}..."
+ private fun untyped_signature(page: NitdocPage): String do
+ var res = new Buffer
+ if not mparameters.is_empty then
+ res.append("(")
+ for i in [0..mparameters.length[ do
+ res.append(mparameters[i].name)
+ if i < mparameters.length - 1 then res.append(", ")
+ end
+ res.append(")")
end
- return ret
+ return res.to_s
end
end
-redef class AType
- redef fun to_s do
- var ret = "<a href=\"{n_id.text}.html\">{n_id.text}</a>"
- if n_kwnullable != null then ret = "nullable {ret}"
- if not n_types.is_empty then ret = "{ret}[{n_types.join(", ")}]"
- return ret
+redef class MParameter
+ private fun html_link(page: NitdocPage) do
+ page.append("{name}: ")
+ mtype.html_link(page)
+ if is_vararg then page.append("...")
end
end
-redef class APropdef
- private fun short_comment: String is abstract
- private fun signature: String is abstract
- private fun comment: String is abstract
-end
+#
+# Nodes redefs
+#
-redef class AAttrPropdef
- redef fun short_comment do
- var ret = ""
- if n_doc != null then
- var txt = n_doc.n_comment.first.text
- txt = txt.replace("# ", "")
- txt = txt.replace("\n", "")
- ret += txt
+redef class AModule
+ private fun short_comment: String do
+ if n_moduledecl != null and n_moduledecl.n_doc != null then
+ return n_moduledecl.n_doc.n_comment.first.text.substring_from(2).replace("\n", "").html_escape
end
- return ret
+ return ""
end
-end
-redef class AMethPropdef
- redef fun short_comment do
- var ret = new Buffer
- if n_doc != null then
- var txt = n_doc.n_comment.first.text
- txt = txt.replace("# ", "")
- txt = txt.replace("\n", "")
- ret.append(txt)
+ private fun full_comment: String do
+ var res = new Buffer
+ if n_moduledecl != null and n_moduledecl.n_doc != null then
+ for t in n_moduledecl.n_doc.n_comment do
+ res.append(t.text.substring_from(1).html_escape)
+ end
end
- return ret.to_s
+ return res.to_s
end
+end
- redef fun signature: String do
- var sign = ""
- if n_signature != null then sign = "{n_signature.to_s}"
- return sign
+redef class AStdClassdef
+ private fun short_comment: String do
+ if n_doc != null then return n_doc.n_comment.first.text.substring_from(2).replace("\n", "").html_escape
+ return ""
end
- redef private fun comment: String do
- var ret = new Buffer
+ private fun full_comment: String do
+ var res = new Buffer
if n_doc != null then
- for t in n_doc.n_comment do
- var txt = t.text.replace("# ", "")
- txt = txt.replace("#", "")
- ret.append(txt)
- end
+ for t in n_doc.n_comment do res.append(t.text.substring_from(1).html_escape)
end
- return ret.to_s
+ return res.to_s
end
end
-redef class MClassDef
- private fun namespace(mclass: MClass): String do
-
- if mmodule.public_owner is null then
- return "{mmodule.full_name}::{mclass.name}"
- else if mclass is self.mclass then
- return "{mmodule.public_owner.name}::{mclass.name}"
- else
- return "{mmodule.public_owner.name}::<a href=\"{mclass.name}.html\">{mclass.name}</a>"
- end
+redef class APropdef
+ private fun short_comment: String do
+ if n_doc != null then return n_doc.n_comment.first.text.substring_from(2).replace("\n", "").html_escape
+ return ""
end
-end
-redef class Set[E]
- fun last: E do
- return to_a[length-1]
+ private fun full_comment: String do
+ var res = new Buffer
+ if n_doc != null then
+ for t in n_doc.n_comment do res.append(t.text.substring_from(1).html_escape)
+ end
+ return res.to_s
end
end
-# Create a tool context to handle options and paths
-var toolcontext = new ToolContext
-
-# Here we launch the nit index
-var nitdoc = new Nitdoc(toolcontext)
-nitdoc.start
+var nitdoc = new NitdocContext
+nitdoc.generate_nitdoc
nitlanguage / nit.git / blobdiff