Überblick
Chioro bietet die Möglichkeit Werkzeuge einzubinden, die in einem Git-Projekt liegen. Eine Vorlage ist hier zu finden. Das Anlegen und Testen eines oder mehrerer Werkzeuge ist im dortigen Readme beschrieben.
Die chioro-toolbox mit den Standard-Werkzeugen ist immer vorhanden. Auf dem Tab Werkzeuge
sind in der oberen Hälfte die momentan eingehängten Bibliotheken aufgelistet.
- Auf den Tab Werkzeuge klicken um eine Liste der eingehängten Bibliotheken zu sehen.
- Der Name der Bibliothek: Dieser Name muss mit dem Namen in der Datei package.json im git Repository übereinstimmen.
- Hier kann die Bibliothek aktualisiert oder gelöscht werden. Da die Bibliotheken nur bei einem Neustart des Chioro-Servers automatisch geladen werden, muss nach einer Änderung der Werkzeuge in Git die Aktualisierung hier manuell angestossen werden.
Neue Bibliothek einhängen
Nach Klicken auf das Plus-Zeichen öffnet sich folgendes Fenster:
- Der Name der Bibliothek. Dieser Name muss mit dem Namen in der Datei package.json im git Repository übereinstimmen.
- Unter diesem Alias kann die Bibliothek alternativ verwendet werden.
- Die URL des Git-Repositories. Die Syntax muss wie abgebildet eingehalten werden.
Verwenden des Werkzeugs in einer Regel
Voraussetzung in diesem Beispiel: Name der Bibliothek my_tools
mit Alias mt
, es gibt ein Werkzeug namens happyFunktion
:
Wie zu sehen, wird zunächst das Alias genannt, gefolgt von einem Punkt und dem eigentlichen Aufruf der Funktion. Nach Speichern & Preview
kann, wie gewohnt, das Ergebnis der Regel überprüft werden.
Die Tools sind natürlich auch in der Werkzeugliste unter Hilfsmittel zu finden und können per “Drag & Drop” in den Regeleditor gezogen werden.