Merge remote-tracking branch 'manage/master' into subtree

this merges master branch of https://github.com/helma-org/apps-manage-mirror into helma

apps/manage/DocFunction/actions.js

@@ -0,0 +1,11 @@
+function main_action() {
+    if (checkAddress() == false)
+        return;
+    if (checkAuth() == false)
+        return;
+    res.data.body = this.renderSkinAsString("main");
+    renderSkin("api");
+}
+
+
+

apps/manage/DocFunction/asIndexItem.skin

@@ -0,0 +1,7 @@
+<tr><td>
+<% this.link handler="false" %>
+- <% this.type %> in <% docprototype.name %>
+<br/>
+<% this.comment length="200" %>
+</td></tr>
+

apps/manage/DocFunction/asLargeListItem.skin

@@ -0,0 +1,5 @@
+<tr><td>
+<a href="<% this.href action="main" %>" target="main"><% this.link %></a><br/>
+<% this.comment length="200" %>
+</td></tr>
+

apps/manage/DocFunction/asLargeListItemSkin.skin

@@ -0,0 +1,8 @@
+<tr><td>
+<a href="<% this.href action="main" %>" target="main"><% this.link %></a><br/>
+<% this.comment length="200" %>
+<% this.skinparameters separator=", "%>
+</td></tr>
+
+
+

apps/manage/DocFunction/asListItem.skin

@@ -0,0 +1,2 @@
+<% this.link %><br>
+

apps/manage/DocFunction/asParentListItem.skin

@@ -0,0 +1 @@
+<% this.link %>

apps/manage/DocFunction/functions.js

@@ -0,0 +1,10 @@
+/**
+ * Method used by Helma for URL composition.
+ */
+function href(action) {
+    var base = this.getParentElement().href() 
+             + this.getElementName() + "/";
+    return action ? base + action : base;
+}
+
+

apps/manage/DocFunction/macros.js

@@ -0,0 +1,150 @@
+/**
+* macro rendering a skin
+* @param name name of skin
+*/
+function skin_macro(par) {
+    if (par && par.name) {
+        this.renderSkin(par.name);
+    }
+}
+
+/**
+  * macro-wrapper for href-function
+  * @param action name of action to call on this prototype, default main
+  */
+function href_macro(param) {
+    return this.href((param && param.action) ? param.action : "main");
+}
+
+function comment_macro(param) {
+    return renderComment(this, param);
+}
+function content_macro(param) {
+    return this.getContent();
+}
+function tags_macro(param) {
+    return renderTags(this, param);
+}
+function location_macro(param) {
+    return renderLocation(this, param);
+}
+function link_macro(param) {
+    return renderLink(this, param);
+}
+
+//// END OF COPIED FUNCTIONS
+
+
+function headline_macro(param) {
+    var p = this.getParentElement();
+    var handler = (p != null) ? p.getName() : "";
+    if (this.getType() == this.ACTION) {
+        res.write("/" + this.getName());
+    } else if (this.getType() == this.FUNCTION) {
+        if (handler != "" && handler != "global")
+            res.write(handler + ".");
+        res.write(this.getName() + " (");
+        var arr = this.listParameters();
+        for (var i = 0; i < arr.length; i++) {
+            res.write(arr[i]);
+            if (i < arr.length - 1) {
+                res.write(",&nbsp;");
+            }
+        }
+        res.write(")");
+    } else if (this.getType() == this.MACRO) {
+        res.write("&lt;%&nbsp;");
+        if (handler != "" && handler != "global")
+            res.write(handler + ".");
+        var name = this.getName();
+        if (name.indexOf("_macro") > -1)
+            name = name.substring(0, name.length - 6);
+        res.write(name);
+        res.write("&nbsp;%&gt;");
+    } else if (this.getType() == this.SKIN) {
+        if (handler != "" && handler != "global")
+            res.write(handler + "/");
+        res.write(this.getName());
+        res.write(".skin");
+    } else if (this.getType() == this.PROPERTIES) {
+        res.write(this.getName());
+    }
+}
+
+
+function skinparameters_macro(param) {
+    if (this.getType() == this.SKIN) {
+        this.parameters_macro(param);
+    }
+}
+
+
+function parameters_macro(param) {
+    var separator = (param.separator) ? param.separator : ", ";
+    var arr = this.listParameters();
+    for (var i = 0; i < arr.length; i++) {
+        res.write(arr[i]);
+        if (i < arr.length - 1)
+            res.write(separator);
+    }
+}
+
+
+function type_macro(param) {
+    return this.getTypeName();
+}
+
+
+/**
+  * macro returning nicely formatted sourcecode of this method.
+  * code is encoded, &gt% %&lt;-tags are colorcoded, line numbers are added
+  */
+function source_macro(param) {
+    var sourcecode = this.getContent();
+    if (param.as == "highlighted") {
+
+        sourcecode = encode(sourcecode);
+
+        // highlight macro tags
+        r = new RegExp("&lt;%", "gim");
+        sourcecode = sourcecode.replace(r, '<font color="#aa3300">&lt;%');
+
+        r = new RegExp("%&gt;", "gim");
+        sourcecode = sourcecode.replace(r, '%&gt;</font>');
+
+        // highlight js-comments
+        r = new RegExp("^([ \\t]*//.*)", "gm");
+        sourcecode = sourcecode.replace(r, '<font color="#33aa00">$1</font>');
+
+        // highlight quotation marks, but not for skins
+        if (this.getTypeName() != "Skin") {
+            r = new RegExp("(&quot;.*?&quot;)", "gm");
+            sourcecode = sourcecode.replace(r, '<font color="#9999aa">$1</font>');
+            r = new RegExp("(\'[\']*\')", "gm");
+            sourcecode = sourcecode.replace(r, '<font color="#9999aa">$1</font>');
+        }
+
+        // remove all CR and LF, just <br> remains
+        var r = new RegExp("[\\r\\n]", "gm");
+        sourcecode = sourcecode.replace(r, "");
+
+        var arr = sourcecode.split("<br />");
+        var line = this.getStartLine ? this.getStartLine() : 1;
+        for (var i = 0; i < arr.length; i++) {
+            res.write('<font color="#aaaaaa">' + (line++) + ':</font> ');
+            if (i < 99) {
+                res.write(' ');
+            }
+            if (i < 9) {
+                res.write(' ');
+            }
+            res.write(arr[i] + "\n");
+        }
+
+    } else {
+        res.write(sourcecode);
+    }
+}
+
+
+

apps/manage/DocFunction/main.skin

@@ -0,0 +1,34 @@
+<table width="90%" border="0" cellspacing="1" cellpadding="5">
+<tr>
+	<td class="headline">
+	<big><tt><% this.headline %></tt></big><br>
+	</td>
+</tr>
+
+<tr>
+	<td class="mainbox">
+	<% this.comment suffix="<br><br>" %>
+	<% this.skinparameters prefix="general parameters used in this skin:<ul><li><code>" separator="</code><li><code>" suffix="</code></ul><br>" %>
+	<ul>
+		<% this.tags type="param"  skin="parameter" %>
+		<% this.tags type="return" skin="return" %>
+		<% this.tags type="author" skin="author" %>
+		<% this.tags type="see"    skin="see" %>
+		<% this.tags type="deprecated" skin="deprecated" %>
+		<% this.tags type="overrides"  skin="overrides" %>
+	</ul>
+	</td>
+</tr>
+</table>
+
+<table width="90%" border="0" cellspacing="1" cellpadding="5">
+<tr>
+	<td>Sourcecode in <% this.location %>:
+	<pre><% this.source as="highlighted" %></pre>
+	</td>
+</tr>
+
+</table>
+
+
+