Macro-Liste
Um die Dokumentation unter macro.antville.org wieder frisch zu machen, hätte ich gerne eine möglichst vollständige Liste aller Macros. Ich habe mir das Programmpaket herunter geladen und bin nun nach ein paar Tagen Recherche nicht dahinter gekommen, a) wie diese Macros sich zusammensetzen (oder zusammen gesetzt werden) und b) welche Argumente pro Macro gültig sind.
Existiert solch eine Übersicht oder eine Beschreibung der Macro-Synthese?
tobi Verwaltung
Außer der bestehenden Dokumentation auf https://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](https://github.com/antville/antville/blob/develop/code/Story/Story.js))
* Macros sind JS-Funktionen, die auf `_macro` enden (z.B. [abstract_macro()](https://github.com/antville/antville/blob/develop/code/Story/Story.js#L556))
* 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:
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](https://github.com/antville/antville/blob/develop/code/Story/Story.js#L29) definiert sind.
PS. Zu Ihrer Anfrage per E-Mail: Ja, UIKit ist das verwendete CSS-Framework.
libralop
Das sieht doch schonmal nicht schlecht aus. Daraus lässt sich was machen. Dankeschön für's Erste!
0000ff
Ist denn aus dem Projekt was geworden? Ich fänd eine Doku, und sei sie noch so rudimentär, schon sehr hilfreich.