Handbuch

STS Handbuch

Stellwerksim Handbuch

Webseiten-Werkzeuge


stellwerksim:erbauer:themascripte

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung
Vorhergehende Überarbeitung
stellwerksim:erbauer:themascripte [2016/03/13 11:58] – Externe Bearbeitung 127.0.0.1stellwerksim:erbauer:themascripte [2021/04/14 15:57] (aktuell) – Neue Version des ThemaScript-Editors DevonFrosch
Zeile 1: Zeile 1:
 ====== ThemaScripte ====== ====== ThemaScripte ======
-{{indexmenu_n>40}} +Mit ThemaScripten können die Werte sowie das Verhalten eines Zuges angepasst werden. Dies kann pro AnlageZugtemplate und/oder Thema erfolgen.
-Mit ThemaScripten können die Werte eines Templates überschrieben, sowie das Verhalten eines Zuges angepasst werden. Dies kann pro StellwerkTemplate und/oder Thema erfolgen.+
  
-Jede 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> <code>Blockkopf(Befehle);</code>
  
-<note warnung>Nach jeder Block muss ein Semikolon gesetzt werden.</note>+<note info>Nach jedem Block muss ein Semikolon gesetzt werden.</note>
  
 Der Befehl kann folgende Elemente enthalten: Der Befehl kann folgende Elemente enthalten:
Zeile 20: Zeile 19:
 Alle Befehle werden nach der [[stellwerksim:erbauer:themascripte:upn|Umgekehrt polnischen Notation (UPN)]] geschrieben. 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-Liste =====
  
-{{tag>Zugbau ThemaScript}}+Alle ThemaScripte sind über die ThemaScript-Liste verfügbar. Grundsätzlich darf jeder Erbauer alle ThemaScripte ansehen.
  
 +{{:stellwerksim:erbauer:themascripte:themascript-liste.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.
 +
 +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.
 +
 +<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>
 +
 +==== Filter ====
 +
 +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.
 +
 +Über der Liste gibt es drei weitere Filter:
 +  * 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.
 +
 +Wird ein anderes ThemaScript per Befehl sub eingebunden, wird dieses ThemaScript bei "Aufgerufene Themascripte" aufgelistet und verlinkt.
 +
 +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).
 +
 +Darunter sind die Knöpfe zum Öffnen des [[stellwerksim:erbauer:themascripte:ts_tester|ThemaScript-Testers]] sowie dessen Ergebnis.
 +
 +Solange keine Änderung am Script vorgenommen wurde ist der Speichern-Knopf ausgegraut. Das Speichern ist aber trotzdem möglich.
 +
 +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}}
  
stellwerksim/erbauer/themascripte.1457866714.txt.gz · Zuletzt geändert: 2016/03/13 11:58 von 127.0.0.1