Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- stellwerksim:erbauer:themascripte [2019/02/15 18:45] – Case 2739 petero
+++ stellwerksim:erbauer:themascripte [2021/04/14 15:57] (aktuell) – Neue Version des ThemaScript-Editors DevonFrosch
@@ Zeile 1: / Zeile 1: @@
 ====== ThemaScripte ======
-Mit ThemaScripten können die Werte eines Zugtemplates überschrieben, sowie das Verhalten eines Zuges angepasst werden. Dies kann pro Anlage, Zugtemplate und/oder Thema erfolgen.
+Mit ThemaScripten können die Werte sowie das Verhalten eines Zuges angepasst werden. Dies kann pro Anlage, Zugtemplate und/oder Thema erfolgen.
-Jeder ThemaScriptblock besitzt einen [[stellwerksim:erbauer:themascripte:blockkopf|Blockkopf]], sowie den auszuführenden Befehlen. Die Befehle stehen dabei in Klammern direkt hinter dem Blockkopf.
+Jeder ThemaScript-Block besitzt einen [[stellwerksim:erbauer:themascripte:blockkopf|Blockkopf]] sowie den auszuführenden Befehlen. Die Befehle stehen dabei in Klammern direkt hinter dem Blockkopf.
 <code>Blockkopf(Befehle);</code>
-<note warnung>Nach jedem Block muss ein Semikolon gesetzt werden.</note>
+<note info>Nach jedem Block muss ein Semikolon gesetzt werden.</note>
 Der Befehl kann folgende Elemente enthalten:
@@ Zeile 19: / Zeile 19: @@
 Alle Befehle werden nach der [[stellwerksim:erbauer:themascripte:upn|Umgekehrt polnischen Notation (UPN)]] geschrieben.
-Mit den oben verlinkten Seiten, sowie den Beispielen auf folgender Seite sollte die ThemaScripte verstanden werden könne: [[stellwerksim:erbauer:themascripte:beispiele|Beispiele]]. Ansonsten steht auch das ThemaScriptteam im Forum zur weiteren Beratung zur Verfügung.
+Zum besseren Verständnis gibt es eine Liste von [[stellwerksim:erbauer:themascripte:beispiele|Beispielen]]. Ansonsten kann im Forum das ThemaScript-Team unterstützen.
-===== ThemaScript-Library =====
+===== ThemaScript-Liste =====
-Alle ThemaScripte sind über die ThemaScript-Library verfügbar. Grundsätzlich darf jeder Erbauer alle ThemaScripte lesen ("zum Script") und kopieren.
+Alle ThemaScripte sind über die ThemaScript-Liste verfügbar. Grundsätzlich darf jeder Erbauer alle ThemaScripte ansehen.
-Bei eigenen ThemaScripten und Regions-ThemaScripten, die man als [[stellwerksim:erbauer:themascripte:tdesigner|ThemaScript-Designer]] bearbeiten darf, kann man über den Knopf "Werte" den Namen des Scripts ändern.
+{{:stellwerksim:erbauer:themascripte:themascript-liste.png}}
-{{ :stellwerksim:erbauer:ts_library.png }}
+Die meisten ThemaScripte sind, ähnlich wie Zugtemplates, einer Region zugeordnet. Die [[stellwerksim:erbauer:themascripte:tdesigner|T-Designer]] dieser Region können neue ThemaScripte anlegen und bestehende Scripte der Region verändern und umbenennen. Der [[stellwerksim:erbauer:r-admin|R-Admin]] kann zusätzlich ThemaScripte löschen sowie in Regionen, in denen er mindestens T-Designer ist, verschieben. Admins können alle ThemaScripte anlegen, bearbeiten und löschen.
-Wird ein ThemaScript in Zugtemplates verwendet (ist dort als ThemaScript eingetragen), kann man sich über "Zugtemplates in Bezug" diese Zugtemplates anzeigen lassen.
+Zum Anlegen neuer ThemaScripte gibt es rechts über der Liste eine Auswahl der Region sowie ein Eingabefeld für den Namen. Anschließen wird auf den ThemaScript-Editor weitergeleitet.
-{{ :stellwerksim:erbauer:ts_bezug.png }}
+<note info>Der Name eines ThemaScripts muss innerhalb der Region eindeutig sein. Darüber hinaus gibt es besondere Namensregeln für [[stellwerksim:erbauer:themascripte:hooks|Hooks]]</note>
-Über "zum Script" kommt man zum ThemaScript-Editor. Dort lässt sich das ThemaScript bearbeiten und [[stellwerksim:erbauer:themascripte:ts_tester|testen]].
 ==== Filter ====
-Wie oben auf dem Bild zusehen kann man die ThemScripte filtern.
+Die Liste erlaubt das Filtern nach allen Spalten. In der Spalte für die Region kann sowohl der Name als auch das Kürzel der Regio eingegeben werden.
-Hier gibt es folgende Möglichkeiten:
-  * Alle
-  * Eigene (zeigt alle ThemaScripte dessen Eigentümr man ist)
-  * Bearbeitung möglich (zeigt alle ThemaScripte die ich Bearbeiten darf)
-  * Eigentümer (zeigt alle ThemaScripte wo der ausgewählten Erbauer Eigentümer ist)
-  * Name (zeigt alle ThemaScripte die den Suchbegriff im Namen haben)
-<WRAP center round info 60%>
-Wird die Auswahl Eigentümer mit einem Erbauer befüllt, ist die Möglichkeit nach "eigenen" bzw. "Bearbeitung möglich" deaktiviert. Umgekehrt, wird die Auswahl "Eigene" oder "Bearbeitung möglich" ausgewählt, ist es nicht mehr möglich nach Eigentümer zu filtern.
+Über der Liste gibt es drei weitere Filter:
-</WRAP>
+  * Nach ThemaScripten, die bearbeitet werden können
+  * Nach Regions- und Zughooks
+  * Nach ThemaScripten, die eine Zeile mit einer bestimmten Zugtemplate-ID (TID) im Blockkopf enthalten (z.B. für Sonderbehandlung bei Länge oder Themamarker)
+====== ThemaScript-Editor ======
+Der Editor erlaubt alle weiteren Aktionen rund um das ThemaScript.
+{{:stellwerksim:erbauer:themascripte:themascript-editor.png}}
+In der Titelleiste lassen sich (passende Rechte vorausgesetzt) Region und Name des ThemaScripts durch das Bearbeiten-Icon ändern.
+In der Zeile darunter steht die aktuelle Version. Über den Knopf "wechseln..." kann die Liste der vergangenen Versionen einschließlich der Änderungskommentare eingesehen werden - ein Klick auf eine andere Version öffnet den alten Stand im Nur-Lesen-Modus.
-===== Grundaufbau ThemaScript =====
+Wird ein anderes ThemaScript per Befehl sub eingebunden, wird dieses ThemaScript bei "Aufgerufene Themascripte" aufgelistet und verlinkt.
-Die ersten zwei Zeilen sind wie folgt aufgebaut:
-  * **#DATE**: Das Datum der letzten Bearbeitung. Es wird automatisch gesetzt.
+Auf der rechten Seite kann per Knopfdruck die Liste von ThemaScripten und Zugtemplates aufgelistet werden, die das aktuelle ThemaScript verwenden (bei ThemaScripten als sub, bei Zugtemplates oder deren Zügen in den Werten).
-  * **#DESC**: Die Beschreibung des ThemaScripts. Diese wird auch in der Übersichtsliste angezeigt und sollte einen schnellen Überblick bieten, für welchen Zweck das ThemaScript gedacht ist.
-Nach den Schlüsselworten **#DATE** und **#DESC** muss immer ein Leerzeichen folgen.
+Darunter sind die Knöpfe zum Öffnen des [[stellwerksim:erbauer:themascripte:ts_tester|ThemaScript-Testers]] sowie dessen Ergebnis.
-{{ :stellwerksim:erbauer:ts_editor.png }}
+Solange keine Änderung am Script vorgenommen wurde ist der Speichern-Knopf ausgegraut. Das Speichern ist aber trotzdem möglich.
-{{tag>Zugbau ThemaScript ThemaScript-Library}}
+Zum Speichern oder Löschen des ThemaScripts muss ein Änderungskommentar eingegeben werden, der zum späteren Auffinden der Version wichtig ist. Außerdem bekommen die R-Admins der Region, der das ThemaScript zugewiesen ist, eine ComSys-Meldung über die Änderung.
+{{tag>Zugbau ThemaScript ThemaScript-Editor}}

STS Handbuch

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge