Macro-Liste

Außer der bestehenden Dokumentation auf macros.antville.org und ein paar (veralteten) Kommentaren im Quellcode gibt es da leider nichts, fürchte ich…

Im Code finden Sie die Macros jedenfalls auf folgende Weise:

• (Fast) jeder Prototype enthält eine nach ihm benannte JS-Datei (z.B. Story/Story.js)
• Macros sind JS-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 <% foo bar='xyz' %>
function foo_macro(param) {
   res.write(param.bar); // xyz
}

// Definiert Story-Macro der Form <% story.foo xyz %>
Story.prototype.foo_macro = function(param, bar) {
   res.write(bar) // xzy
};

// Definiert HopObject-Macro der Form <% this.foo bar='xyz' baz=123 'frumm' 4711 %>
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.

PS. Zu Ihrer Anfrage per E-Mail: Ja, UIKit ist das verwendete CSS-Framework.