{gclass}(Go to page of class {gclass})\":/class_{lkclass}"
+msgstr ""
+"\"{gclass}(Ir a la pagina de la clase {gclass})\":/"
+"class_{lkclass}"
+
+#: makedocs.py:76
+msgid ""
+"\"{gclass}.{method}(Go to page {gclass}, section {method})\":/"
+"class_{lkclass}#{lkmethod}"
+msgstr ""
+"\"{gclass}.{method}(Ir a la pagina {gclass}, sección "
+"{method})\":/class_{lkclass}#{lkmethod}"
+
+#: makedocs.py:79
+msgid "\"{method}(Jump to method {method})\":#{lkmethod}"
+msgstr "\"{method}(Saltar al método {method})\":#{lkmethod}"
+
+#: makedocs.py:81
+msgid " \"{rtype}(Go to page of class {rtype})\":/class_{link} "
+msgstr " \"{rtype}(Ir a la pagina de la clase {rtype})\":/class_{link} "
+
+#: makedocs.py:82
+msgid ""
+"\"*{funcname}*(Jump to description for node {funcname})\":#{link} ( "
+msgstr ""
+"\"*{funcname}*(Saltar a la descripción para el nodo {funcname})\":#{link} "
+"( "
+
+#: makedocs.py:87
+msgid "h4. Inherits: "
+msgstr "h4. Hereda de: "
+
+#: makedocs.py:232
+msgid "{gclass}(Go to page of class {gclass})\":/class_{lkclass}"
+msgstr ""
+
+#: makedocs.py:76
+msgid "\"{gclass}.{method}(Go to page {gclass}, section {method})\":/class_{lkclass}#{lkmethod}"
+msgstr ""
+
+#: makedocs.py:79
+msgid "\"{method}(Jump to method {method})\":#{lkmethod}"
+msgstr ""
+
+#: makedocs.py:81
+msgid " \"{rtype}(Go to page of class {rtype})\":/class_{link} "
+msgstr ""
+
+#: makedocs.py:82
+msgid "\"*{funcname}*(Jump to description for node {funcname})\":#{link} ( "
+msgstr ""
+
+#: makedocs.py:87
+msgid "h4. Inherits: "
+msgstr ""
+
+#: makedocs.py:232
+msgid "{gclass}(Go to page of class"
+ " {gclass})\":/class_{lkclass}")
+MC_LINK = _("\"{gclass}.{method}(Go "
+ "to page {gclass}, section {method})\""
+ ":/class_{lkclass}#{lkmethod}")
+TM_JUMP = _("\"{method}(Jump to method"
+ " {method})\":#{lkmethod}")
+GTC_LINK = _(" \"{rtype}(Go to page of class {rtype})\":/class_{link} ")
+DFN_JUMP = _("\"*{funcname}*(Jump to description for"
+ " node {funcname})\":#{link} ( ")
+M_ARG_DEFAULT = C_LINK + " {name}={default}"
+M_ARG = C_LINK + " {name}"
+
+OPENPROJ_INH = _("h4. Inherits: ") + C_LINK + "\n\n"
+
+
+def tb(string):
+ """ Return a byte representation of a string
+ """
+ return bytes(string, "UTF-8")
+
+
+def sortkey(c):
+ """ Symbols are first, letters second
+ """
+ if "_" == c.attrib["name"][0]:
+ return "A"
+ else:
+ return c.attrib["name"]
+
+
+def toOP(text):
+ """ Convert commands in text to Open Project commands
+ """
+ # TODO: Make this capture content between [command] ... [/command]
+ groups = re.finditer((r'\[html (?P"
+ elif (cmd=="/center"):
+ tag_text="
"
+ elif (cmd=="br"):
+ tag_text="" + elif (cmd=="i" or cmd=="/i" or cmd=="b" or cmd=="/b" or cmd=="u" or cmd=="/u"): + tag_text="<"+tag_text+">" #html direct mapping + else: + tag_text="["+tag_text+"]" + + + text=pre_text+tag_text+post_text + pos=len(pre_text)+len(tag_text) + + #tnode = ET.SubElement(parent,"div") + #tnode.text=text + text="
"+text+"
"
+ try:
+ tnode=ET.XML(text)
+ parent.append(tnode)
+ except:
+ print("Error parsing description text: '"+text+"'")
+ sys.exit(255)
+
+
+ return tnode
+
+
+
+
+def make_method_def(name,m,declare,event=False):
+
+ mdata={}
+
+
+ if (not declare):
+ div=ET.Element("tr")
+ div.attrib["class"]="method"
+ ret_parent=ET.SubElement(div,"td")
+ ret_parent.attrib["align"]="right"
+ func_parent=ET.SubElement(div,"td")
+ else:
+ div=ET.Element("div")
+ div.attrib["class"]="method"
+ ret_parent=div
+ func_parent=div
+
+ mdata["argidx"]=[]
+ mdata["name"]=m.attrib["name"]
+ qualifiers=""
+ if ("qualifiers" in m.attrib):
+ qualifiers=m.attrib["qualifiers"]
+
+ args=list(m)
+ for a in args:
+ if (a.tag=="return"):
+ idx=-1
+ elif (a.tag=="argument"):
+ idx=int(a.attrib["index"])
+ else:
+ continue
+
+ mdata["argidx"].append(idx)
+ mdata[idx]=a
+
+ if (not event):
+ if (-1 in mdata["argidx"]):
+ make_type(mdata[-1].attrib["type"],ret_parent)
+ mdata["argidx"].remove(-1)
+ else:
+ make_type("void",ret_parent)
+
+ span=ET.SubElement(func_parent,"span")
+ if (declare):
+ span.attrib["class"]="funcdecl"
+ a=ET.SubElement(span,"a")
+ a.attrib["name"]=name+"_"+m.attrib["name"]
+ a.text=name+"::"+m.attrib["name"]
+ else:
+ span.attrib["class"]="identifier funcdef"
+ a=ET.SubElement(span,"a")
+ a.attrib["href"]="#"+name+"_"+m.attrib["name"]
+ a.text=m.attrib["name"]
+
+ span=ET.SubElement(func_parent,"span")
+ span.attrib["class"]="symbol"
+ span.text=" ("
+
+ for a in mdata["argidx"]:
+ arg=mdata[a]
+ if (a>0):
+ span=ET.SubElement(func_parent,"span")
+ span.text=", "
+ else:
+ span=ET.SubElement(func_parent,"span")
+ span.text=" "
+
+
+ make_type(arg.attrib["type"],func_parent)
+
+ span=ET.SubElement(func_parent,"span")
+ span.text=arg.attrib["name"]
+ if ("default" in arg.attrib):
+ span.text=span.text+"="+arg.attrib["default"]
+
+
+ span=ET.SubElement(func_parent,"span")
+ span.attrib["class"]="symbol"
+ if (len(mdata["argidx"])):
+ span.text=" )"
+ else:
+ span.text=")"
+
+ if (qualifiers):
+ span=ET.SubElement(func_parent,"span")
+ span.attrib["class"]="qualifier"
+ span.text=" "+qualifiers
+
+ return div
+
+
+def make_html_class(node):
+
+ div=ET.Element("div")
+ div.attrib["class"]="class";
+
+ a=ET.SubElement(div,"a")
+ a.attrib["name"]=node.attrib["name"]
+
+ h3=ET.SubElement(a,"h3")
+ h3.attrib["class"]="title class_title"
+ h3.text=node.attrib["name"]
+
+ briefd = node.find("brief_description")
+ if (briefd!=None):
+ div2=ET.SubElement(div,"div")
+ div2.attrib["class"]="description class_description"
+ div2.text=briefd.text
+
+ if ("inherits" in node.attrib):
+ ET.SubElement(div,"br")
+
+ div2=ET.SubElement(div,"div")
+ div2.attrib["class"]="inheritance";
+
+ span=ET.SubElement(div2,"span")
+ span.text="Inherits: "
+
+ make_type(node.attrib["inherits"],div2)
+
+ if ("category" in node.attrib):
+ ET.SubElement(div,"br")
+
+ div3=ET.SubElement(div,"div")
+ div3.attrib["class"]="category";
+
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="category"
+ span.text="Category: "
+
+ a = ET.SubElement(div3,"a")
+ a.attrib["class"]="category_ref"
+ a.text=node.attrib["category"]
+ catname=a.text
+ if (catname.rfind("/")!=-1):
+ catname=catname[catname.rfind("/"):]
+ catname="CATEGORY_"+catname
+
+ if (single_page):
+ a.attrib["href"]="#"+catname
+ else:
+ a.attrib["href"]="category.html#"+catname
+
+
+ methods = node.find("methods")
+
+ if(methods!=None and len(list(methods))>0):
+
+ h4=ET.SubElement(div,"h4")
+ h4.text="Public Methods:"
+
+ method_table=ET.SubElement(div,"table")
+ method_table.attrib["class"]="method_list";
+
+ for m in list(methods):
+# li = ET.SubElement(div2, "li")
+ method_table.append( make_method_def(node.attrib["name"],m,False) )
+
+ events = node.find("signals")
+
+ if(events!=None and len(list(events))>0):
+ h4=ET.SubElement(div,"h4")
+ h4.text="Events:"
+
+ event_table=ET.SubElement(div,"table")
+ event_table.attrib["class"]="method_list";
+
+ for m in list(events):
+# li = ET.SubElement(div2, "li")
+ event_table.append( make_method_def(node.attrib["name"],m,False,True) )
+
+
+ members = node.find("members")
+ if(members!=None and len(list(members))>0):
+
+ h4=ET.SubElement(div,"h4")
+ h4.text="Public Variables:"
+ div2=ET.SubElement(div,"div")
+ div2.attrib["class"]="member_list";
+
+ for c in list(members):
+
+ li = ET.SubElement(div2, "li")
+ div3=ET.SubElement(li,"div")
+ div3.attrib["class"]="member";
+ make_type(c.attrib["type"],div3)
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="identifier member_name"
+ span.text=" "+c.attrib["name"]+" "
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="member_description"
+ span.text=c.text
+
+
+ constants = node.find("constants")
+ if(constants!=None and len(list(constants))>0):
+
+ h4=ET.SubElement(div,"h4")
+ h4.text="Constants:"
+ div2=ET.SubElement(div,"div")
+ div2.attrib["class"]="constant_list";
+
+ for c in list(constants):
+ li = ET.SubElement(div2, "li")
+ div3=ET.SubElement(li,"div")
+ div3.attrib["class"]="constant";
+
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="identifier constant_name"
+ span.text=c.attrib["name"]+" "
+ if ("value" in c.attrib):
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="symbol"
+ span.text="= "
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="constant_value"
+ span.text=c.attrib["value"]+" "
+ span=ET.SubElement(div3,"span")
+ span.attrib["class"]="constant_description"
+ span.text=c.text
+
+# ET.SubElement(div,"br")
+
+
+ descr=node.find("description")
+ if (descr!=None and descr.text.strip()!=""):
+ h4=ET.SubElement(div,"h4")
+ h4.text="Description:"
+
+ make_text_def(node.attrib["name"],div,descr.text)
+# div2=ET.SubElement(div,"div")
+# div2.attrib["class"]="description";
+# div2.text=descr.text
+
+
+
+ if(methods!=None or events!=None):
+
+ h4=ET.SubElement(div,"h4")
+ h4.text="Method Documentation:"
+ iter_list = []
+ if (methods!=None):
+ iter_list+=list(methods)
+ if (events!=None):
+ iter_list+=list(events)
+
+ for m in iter_list:
+
+ descr=m.find("description")
+
+ if (descr==None or descr.text.strip()==""):
+ continue;
+
+ div2=ET.SubElement(div,"div")
+ div2.attrib["class"]="method_doc";
+
+
+ div2.append( make_method_def(node.attrib["name"],m,True) )
+ #anchor = ET.SubElement(div2, "a")
+ #anchor.attrib["name"] =
+ make_text_def(node.attrib["name"],div2,descr.text)
+ #div3=ET.SubElement(div2,"div")
+ #div3.attrib["class"]="description";
+ #div3.text=descr.text
+
+
+ return div
+
+class_names=[]
+classes={}
+
+for file in input_list:
+ tree = ET.parse(file)
+ doc=tree.getroot()
+
+ if ("version" not in doc.attrib):
+ print("Version missing from 'doc'")
+ sys.exit(255)
+
+ version=doc.attrib["version"]
+
+ for c in list(doc):
+ if (c.attrib["name"] in class_names):
+ continue
+ class_names.append(c.attrib["name"])
+ classes[c.attrib["name"]]=c
+
+html = ET.Element("html")
+css = ET.SubElement(html, "link")
+css.attrib["href"] = "main.css"
+css.attrib["rel"] = "stylesheet"
+css.attrib["type"] = "text/css"
+
+body = ET.SubElement(html, "body")
+if (not single_page):
+ make_html_top(body)
+
+
+
+class_names.sort()
+
+body.append( make_html_class_list(class_names,5) )
+
+for cn in class_names:
+ c=classes[cn]
+ if (single_page):
+ body.append( make_html_class(c))
+ else:
+ html2 = ET.Element("html")
+ css = ET.SubElement(html2, "link")
+ css.attrib["href"] = "main.css"
+ css.attrib["rel"] = "stylesheet"
+ css.attrib["type"] = "text/css"
+ body2 = ET.SubElement(html2, "body" )
+ make_html_top(body2)
+ body2.append( make_html_class(c) );
+ make_html_bottom(body2)
+ et_out = ET.ElementTree(html2)
+ et_out.write(c.attrib["name"]+".html")
+
+
+et_out = ET.ElementTree(html)
+if (single_page):
+ et_out.write("singlepage.html")
+else:
+ make_html_bottom(body)
+ et_out.write("alphabetical.html")
+
diff --git a/doc/tools/makemd.py b/doc/tools/makemd.py
new file mode 100644
index 000000000..f85d145d5
--- /dev/null
+++ b/doc/tools/makemd.py
@@ -0,0 +1,345 @@
+#!/usr/bin/python
+# -*- coding: utf-8 -*-
+import sys
+import xml.etree.ElementTree as ET
+
+input_list = []
+
+for arg in sys.argv[1:]:
+ input_list.append(arg)
+
+if len(input_list) < 1:
+ print 'usage: makedoku.py