Im Zuge der Erneuerung der hier befindlichen Dokumentation soll dargestellt werden, wie die Macros im Quellcode zusammengesetzt werden:

- (Fast) jeder Prototype enthält eine nach ihm benannte JavaScript-Datei (z.B. Story/Story.js)
- Macros sind JavaScript-Funktionen, die auf _macro enden (z.B. abstract_macro())
- Der Macroname ist der Teil vor dem _macro-Suffix (im Beispiel »abstract«)
- Die Argumente für ein Macro bestehen immer aus dem (meist) param genannten Objekt; die Keys müssen allerdings aus der Funktion oder dem Macro-Aufruf erschlossen werden
- Zusätzlich gibt es sog. »positional parameters«, die auf das param-Objekt folgen.

Beispiele:

// Definiert globales Macro der Form [Macro not allowed in sandbox: foo]
function foo_macro(param) {
res.write(param.bar); // xyz
}</p><p>// Definiert Story-Macro der Form [Macro not allowed in sandbox: story.foo]
Story.prototype.foo_macro = function(param, bar) {
res.write(bar) // xzy
};</p><p>// Definiert HopObject-Macro der Form [Macro not allowed in sandbox: this.foo]
HopObject.prototype.foo_macro = function(param, arg1, whatever) {
res.write(param.bar); // xyz
res.write(param.baz); // 123
res.write(arg1); // frumm
res.write(whatever); // 4711
};

Globale Macros gelten überall, alle anderen immer nur für den Prototypen, für den sie definiert werden, sowie für die Prototypen, die sich davon ableiten (z.B. kennt Comment die Macros von Story, alle Prototypen kennen die von HopObject).

Es stehen immer alle Macros von Prototypen zur Verfügung, die im path vorkommen. D.h. in einem Stories-Skin gibt es auch die Site-Macros, in einem Story-Skin die von Site und Stories usw.

In einer Story selbst (also im Story-Editor) sind nur Macros erlaubt, die in Story.ALLOWED_MACROS definiert sind.

Quelle: https://help.antville.org/stories/2248348/#2248373

FIXME

Using the layout handler to define colors everywhere in your skins makes changing the appearance of your site according to the four seasons a piece of cake. Use the following macros to refer to the color values as set in your layout preferences:

<% layout.bgcolor %>
<% layout.textcolor %>
<% layout.titlecolor %>
<% layout.linkcolor %>
<% layout.alinkcolor %>
<% layout.vlinkcolor %>
<% layout.smallcolor %>

please note that you do not have to care about whether the color value is a string or a hexadecimal number. antville will add a hash (#) whenever it is necessary.

not enough, there are macros for fonts and font sizes, too. every font definition in the preferences can be expressed by an appropriate macro:

<% layout.textfont %>
<% layout.textsize %>
<% layout.titlefont %>
<% layout.titlesize %>
<% layout.smallfont %>
<% layout.smallsize %>

certainly, you have to include the color and font macros at the right place, ie. inside a valid html tag or a correct cascading style sheet definition.

This macro displays a link to the comments's reply form. To override the default action the "to" parameter can be set, e.g. if you want to provide the reply form directly below the comment:

<% comment.replylink to="#replies" %>

The "text" parameter is available to set a custom link text:

<% comment.replylink text="place your reply" %>

This macro lists all of the replied comments once added to a comment. There are no options available for this macro. The layout of each comment is determined by the corresponding comment skin.