HTML:
Das Objekt HTML des Beispiels ist vom Typ TextDisciplineConfiguration. Es ist das zentrale Objekt der Konfiguration einer Text-Disziplin und erhält den beim Anlegen der Disziplin angegebenen Namen.
Zentrale Einstellungen, beispielsweise der im Kontextmenü angezeigte Name, werden hier vorgenommen:
In der HTMLDisciplineConfiguration wird auch festgelegt, ob bei neuen Komponenten die Ressourcen im Modell intern oder extern zu speichern sind (siehe interne und externe Ressourcen).
Wichtig für die Konfiguration der Disziplin ist im Weiteren die Editorseite Konfiguration mit folgenden Einstellmöglichkeiten:
Konfigurations-Parameter | Bedeutung |
---|---|
Disziplin-Root | Referenz auf das Objekt, das die Wurzel der Disziplinstruktur in Projekten repräsentiert |
Disziplin-Oberkomponente | Referenz auf die Komponente, von der alle Komponenten der Disziplin erben |
Parameter-Unit | Unit innerhalb der Bibliothek in der bei Bedarf automatisch Poolparameter angelegt werden. Wenn beispielsweise eine Ressource mit bisher unbekannten Parametern hinzugefügt wird, legt EEC automatisch neue Poolparameter in dieser Unit an |
Ressourcen-Speicherort | Pfad zum Ordner, in dem die externen Ressourcen der Disziplin liegen |
Parser-Konfiguration | Referenz auf das Objekt, in dem die Konfiguration des Parsers für die Ressourcen der Disziplin eingestellt ist |
Struktur-Generator | Spezifikation des Verhaltens des Strukturgenerators. Grundsätzlich arbeitet der Strukturgenerator derzeit immer auf einem Plug-Socket-Konzept. Einstellbar ist, ob ein Socket auch durch den Namen einer Komponente definiert werden darf. Ist die Option Namen definieren keinen Socket gewählt, dann werden nur Parameter vom Typ Socket als Socket verwendet |
Code-Generator | Einstellbar ist, ob der Inhalt aller Ressourcen einer Disziplinstruktur in eine Datei zu erzeugen ist oder ob für jede Ressource jeweils eine spezifische Datei erzeugt werden soll, beispielsweise dann, wenn eine HTML-Dokumentation mit mehreren Seiten und Hyperlinks er-zeugt wird |
Zu referenzierten Komponenten kann über Hyperlinks navigiert werden (Alt+Linke-Maustaste-Klick).
HTMLRoot:
Das Objekt HTMLRoot ist die Bibliothekskomponente für die Wurzel der disziplinspezifischen Struktur im Projekt:
Für diese Wurzel können Sie das Icon (Bild) sowie den angezeigten Namen anpassen:
HTMLComponenten:
Für jede Textdisziplin wird eine Oberkomponente angelegt, von der alle Komponenten der Disziplin abgeleitet werden.
HTMLParserConfiguration:
Die Konfiguration des Parsers für die Ressourcen einer Textdisziplin wird über ein separates Objekt eingestellt:
Einstellbar ist dabei die Syntax, mit der Parameter in den vorhandenen Ressourcen spezifiziert werden können.
HTML-Commands:
Beim Anlegen der HTML-Disziplin wurden Objekte angelegt, mit denen es möglich ist, spezifische Kommandos für die HTML-Disziplin auszuführen:
- GenerateHTMLStructureCommand: Erzeugt in einem Projekt aus der mechatronischen Struktur die HTML-Disziplin-Struktur.
- GenerateHTMLCodeCommand: Erzeugt aus der HTML-Disziplin-Struktur das HTML-Dokument in den Eclipse-Workspace
- OpenHTMLWithEclipseCommand: Öffnet das erzeugte HTML-Dokument mit dem in Eclipse eingestellten Editor (Über Benutzervorgaben -> Allgemein -> Editoren -> Dateizuordnungen spezifiziert)
- OpenHTMLWithOSCommand: Öffnet das erzeugte HTML-Dokument mit dem Editor, der im Betriebssystem für das Öffnen von HTML-Dateien festgelegt ist.
Die Commands referenzieren Disziplinen für die sie ausführbar sind über die Editorseite Disziplinen:
HTML-Actions:
Beim Anlegen der HTML-Disziplin wurden Objekte angelegt, durch die das UI um bestimmte Actions erweitert wird. Die Actions stellen den Zugriff des Users auf die Commands her:
- HTMLStrukturGenerieren: Führt das GenerateHTMLStructureCommand aus.
- HTMLCodeGenerieren: Führt das GenerateHTMLCodeCommand aus.
- HTMLStrukturGenerierenUndÖffnen: Führt in einem Schritt das GenerateHTMLStructureCommand, GenerateHTMLCodeCommand und OpenHTMLWithEclipseCommand aus.
Die Actions sind als sinnvoller Vorschlag für die Bereitstellung einer Textdisziplin zu verstehen und können natürlich bei Bedarf angepasst werden.
Text-Disziplin:
Im Ordner \install\icon-collection haben wir mit der Sammlung von Icons begonnen, die man für die Konfiguration von Text-Disziplinen verwenden kann (Weitere Beiträge für die Sammlung sind herzlich willkommen!).
Plug-Socket-Variante einstellbar:
Die Text-Disziplin unterstützt die beiden Plug-Socket-Varianten Plug Socket (Namen definieren Sockets) und Plug Socket (Namen definieren keine Sockets) des Strukturgenerators. Sie sind im Text-Disziplin-Editor einstellbar.