Wichtig: Benutzerleitstellen bitte in dieser Liste eintragen! Beim Erstellen eines Leitstellenartikels bitte diese Hinweise beachten.

Spezialtext: Unterschied zwischen den Versionen

Aus LstSim-Wiki
Wechseln zu: Navigation, Suche
(Übersichtlichkeit)
(Fallunterscheidung)
 
(13 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 7: Zeile 7:
 
Beispiel: <code>{name}</code>
 
Beispiel: <code>{name}</code>
  
Es wird zwischen Groß- und Kleinschreibung unterschieden. <code>{name}</code> ist nicht das gleiche wie <code>{Name}</code>!
+
Es wird zwischen '''Groß- und Kleinschreibung''' unterschieden. <code>{name}</code> ist nicht das gleiche wie <code>{Name}</code>!
  
 
=== Zufallsplatzhalter ===
 
=== Zufallsplatzhalter ===
Zeile 17: Zeile 17:
 
Es ist möglich, Fallunterscheidungen einzubauen, die von den Platzhaltern abhängen. Es muss ein bestimmtes Format eingehalten werden:
 
Es ist möglich, Fallunterscheidungen einzubauen, die von den Platzhaltern abhängen. Es muss ein bestimmtes Format eingehalten werden:
  
<code>{<ins>Platzhalter</ins>, select, <ins>ErsterFall</ins> {''Ausgabe im ersten Fall''} <ins>ZweiterFall</ins> {''Ausgabe im zweiten Fall''}} other {''Ausgabe in allen anderen Fällen''}}</code>
+
<code>{<ins>Platzhalter</ins>, select, <ins>ErsterFall</ins> {''Ausgabe im ersten Fall''} <ins>ZweiterFall</ins> {''Ausgabe im zweiten Fall''} other {''Ausgabe in allen anderen Fällen''}}</code>
  
 
Die Teile, die unterstrichen sind, müssen durch eigene Werte ersetzt werden. Es muss stets ein '''other'''-Fall angegeben werden, der alle Fälle abdeckt, die nicht durch die anderen Bedingungen erfasst werden.
 
Die Teile, die unterstrichen sind, müssen durch eigene Werte ersetzt werden. Es muss stets ein '''other'''-Fall angegeben werden, der alle Fälle abdeckt, die nicht durch die anderen Bedingungen erfasst werden.
Zeile 40: Zeile 40:
 
=== Syntax ===
 
=== Syntax ===
 
Grundsätzlich gilt, dass auf jede runde oder geschweifte Klammer, die geöffnet wird, auch eine entsprechende Klammer folgen muss, die sie wieder schließt. Das gilt natürlich nicht für Klammern, vor denen ein <code>\</code> steht, da umgekehrte Schrägstriche die Sonderfunktion der Klammern aushebeln.
 
Grundsätzlich gilt, dass auf jede runde oder geschweifte Klammer, die geöffnet wird, auch eine entsprechende Klammer folgen muss, die sie wieder schließt. Das gilt natürlich nicht für Klammern, vor denen ein <code>\</code> steht, da umgekehrte Schrägstriche die Sonderfunktion der Klammern aushebeln.
 +
 +
Sollten '''Syntaxfehler''' vorhanden sein, ist es wahrscheinlich, dass im Spiel der entsprechende Dialog nicht funktioniert und es zu anderen Fehlern kommt. Vor dem Speichern von Änderungen also stets per '''Vorschaufunktion''' auf Syntaxfehler testen.
  
 
=== Übersichtlichkeit ===
 
=== Übersichtlichkeit ===
Zeile 54: Zeile 56:
 
     ja {{anzahl_fahrzeuge, plural,
 
     ja {{anzahl_fahrzeuge, plural,
 
             =1 {
 
             =1 {
(|(|Hier )Leitstelle {leitstelle} mit )
+
(|(|Hier )Leitstelle {leitstelle_name} mit )
 
Einsatz(| für den) {fahrzeuge}
 
Einsatz(| für den) {fahrzeuge}
 
(|: nach {einsatzort}, {stichwort}|, {stichwort}).
 
(|: nach {einsatzort}, {stichwort}|, {stichwort}).
 
             }
 
             }
 
             =2 {
 
             =2 {
(|(|Hier )Leitstelle {leitstelle} mit )
+
(|(|Hier )Leitstelle {leitstelle_name} mit )
 
Einsatz(| für den) {fahrzeuge}
 
Einsatz(| für den) {fahrzeuge}
 
(|: nach {einsatzort}, {stichwort}|, {stichwort}).
 
(|: nach {einsatzort}, {stichwort}|, {stichwort}).
 
             }
 
             }
 
             other {
 
             other {
                 Achtung, hier Leitstelle {leitstelle} mit Einsatz für den {fahrzeuge}: nach {einsatzort}, {stichwort}.
+
                 Achtung, hier Leitstelle {leitstelle_name} mit Einsatz für den {fahrzeuge}: nach {einsatzort}, {stichwort}.
 
             }
 
             }
 
         }
 
         }
Zeile 74: Zeile 76:
 
</pre>
 
</pre>
  
Dies ist mit Absicht ein '''umfangreiches Beispiel'''. Wer sich im Umgang mit dem Spezialtext unwohl fühlt, kann auch einen einzelnen Satz, der dann entsprechend wenig oder gar keine Variation hat, nehmen, oder auch die '''Standardwerte''' belassen. Es empfiehlt sich, die Einstellungen der '''offiziellen Leitstellen''' für weitere Beispiele zu Rate zu ziehen.
+
Platzhalter, die zusätzlich zu den Standardplatzhaltern (siehe unten) ersetzt werden:
 +
 
 +
; {anzahl_fahrzeuge}
 +
: Wird durch die Anzahl der Fahrzeuge, die alarmiert werden, ersetzt.
 +
 
 +
; {fahrzeuge}
 +
: Wird durch die Namen der Fahrzeuge, die alarmiert werden, ersetzt (durch Kommas getrennt).
 +
 
 +
 
 +
Dies ist mit Absicht ein '''umfangreiches Beispiel'''. Dennoch sind wir davon überzeugt, dass man es vollständig nachvollziehen kann, wenn man es Schritt für Schritt durchgeht und sich an diese Anleitung hält. Wer sich im Umgang mit dem Spezialtext trotzdem unwohl fühlt, kann auch einen einzelnen Satz, der dann entsprechend wenig oder gar keine Variation hat, nehmen, oder auch die '''Standardwerte''' belassen. Es empfiehlt sich, die Einstellungen der '''offiziellen Leitstellen''' für weitere Beispiele zu Rate zu ziehen.
 +
 
 +
== Standardplatzhalter ==
 +
=== Allgemein ===
 +
Diese Platzhalter sind immer verfügbar:
 +
 
 +
; {leitstelle_begriff}
 +
: Wird durch den eingestellten Leitstellenbegriff (i. d. R. "Leitstelle") ersetzt.
 +
 
 +
; {leitstelle_frn}
 +
: Wird durch den Funkrufnamen der Leitstelle (ohne den eingestellten Leitstellenbegriff) ersetzt.
 +
 
 +
; {leitstelle_name}
 +
: Wird durch den Namen der Leitstelle (ohne den eingestellten Leitstellenbegriff) ersetzt.
 +
 
 +
; {minute}
 +
: Wird durch die aktuelle Uhrzeitminute ersetzt. Wenn es im Spiel also z. B. 8:03 Uhr ist, wird der Platzhalter durch 3 ersetzt.
 +
 
 +
; {spielername}
 +
: Wird durch den Spielernamen ersetzt.
 +
 
 +
; {stunde}
 +
: Wird durch die aktuelle Uhrzeitstunde ersetzt. Wenn es im Spiel also z. B. 8:03 Uhr ist, wird der Platzhalter durch 8 ersetzt.
 +
 
 +
; {uhrzeit}
 +
: Wird durch die aktuelle Spieluhrzeit in diesem Format ersetzt: <code>8:03</code>
 +
 
 +
; {tageszeit}
 +
: Wird von 0-11 Uhr durch "Morgen", von 11-19 Uhr durch "Tag" und von 19-0 Uhr durch "Abend" ersetzt.
 +
 
 +
=== Einsätze ===
 +
Manche einstellbare Dialoge beziehen sich auf einen konkreten Einsatz. In diesen Fällen sind diese Platzhalter standardmäßig verfügbar:
 +
 
 +
; {einsatzstadt}
 +
: Wird durch die Stadt, in der sich der Einsatzort befindet, ersetzt.
 +
 
 +
; {einsatzstraße}
 +
: Wird durch die Straße, in der sich der Einsatzort befindet, ersetzt.
 +
 
 +
; {einsatzort}
 +
: Falls es sich bei dem Einsatzort um einen Point of Interest handelt, wird es durch den Namen des POIs ersetzt, ansonsten durch die Stadt.
 +
 
 +
; {einsatzort_ist_poi}
 +
: Wird durch "ja" oder "nein" ersetzt, je nachdem ob es sich bei dem Einsatzort um einen Point of Interest oder eine zufällig ausgewählte Adresse handelt.
 +
 
 +
; {notarzt}
 +
: Wird durch "ja" oder "nein" ersetzt, je nach dem ob diesem Einsatz ein Notarzt zugeordnet ist.
 +
 
 +
; {rtw}
 +
: Wird durch "ja" oder "nein" ersetzt, je nach dem ob diesem Einsatz ein RTW zugeordnet ist.
 +
 
 +
; {sondersignal}
 +
: Wird durch "ja" oder "nein" ersetzt, je nach dem ob die Anfahrt mit Sondersignal ist.
 +
 
 +
; {stichwort}
 +
: Wird durch das Einsatzstichwort ersetzt.
 +
 
 +
; {text}
 +
: Wird durch den Alarmierungstext ersetzt.
 +
 
 +
; {text_vorhanden}
 +
: Wird durch "ja" oder "nein" ersetzt, je nach dem ob ein Alarmierungstext vorhanden ist.

Aktuelle Version vom 30. Oktober 2012, 19:15 Uhr

Spezialtext wird im Leitstellenbaukasten verwendet, um die Funk- und Telefondialoge im Spiel individuell gestalten zu können. Das besondere daran ist, dass normale Platzhalter, Zufallsplatzhalter und Fallunterscheidungen verwendet werden können.

Funktionen[Bearbeiten]

Normale Platzhalter[Bearbeiten]

Normale Platzhalter werden in geschweiften Klammern geschrieben.

Beispiel: {name}

Es wird zwischen Groß- und Kleinschreibung unterschieden. {name} ist nicht das gleiche wie {Name}!

Zufallsplatzhalter[Bearbeiten]

In einem Zufallsplatzhalter können mehrere Textschnipsel angegeben und es wird am Ende ein zufälliger Textschnipsel ausgewählt. Zufallsplatzhalter werden in runden Klammern geschrieben und die Textschnipsel mit einem senkrechten Strich getrennt.

Beispiel: Ich wünsche euch einen guten (Morgen|Tag|Abend)!

Fallunterscheidung[Bearbeiten]

Es ist möglich, Fallunterscheidungen einzubauen, die von den Platzhaltern abhängen. Es muss ein bestimmtes Format eingehalten werden:

{Platzhalter, select, ErsterFall {Ausgabe im ersten Fall} ZweiterFall {Ausgabe im zweiten Fall} other {Ausgabe in allen anderen Fällen}}

Die Teile, die unterstrichen sind, müssen durch eigene Werte ersetzt werden. Es muss stets ein other-Fall angegeben werden, der alle Fälle abdeckt, die nicht durch die anderen Bedingungen erfasst werden.

Handelt es sich bei Platzhalter um einen Zahlenwert, muss ein leicht abgewandeltes Format verwendet werden:

{Platzhalter, plural, =1 {Platzhalter hat den Wert eins} =2 {Platzhalter hat den Wert zwei} other {Platzhalter hat weder den Wert eins noch den Wert zwei}}

  • Es ist möglich, beliebig viele Fälle einzubauen und natürlich sind auch die Zahlenwerte frei wählbar.
  • Jeder Fall darf in einer Fallunterscheidung nur einmal auftreten. Um Variation einzubauen, müssen Zufallsplatzhalter verwenden werden.

Sonstiges[Bearbeiten]

Sonderzeichen[Bearbeiten]

Um runde oder geschweifte Klammern in einem normalen Text zu verwenden, muss vor die Klammer ein umgekehrter Schrägstrich geschrieben werden. Beispiel: Ich wünsche euch einen \(sehr\) guten (Morgen|Tag|Abend)! ;-\}

Platzhalter[Bearbeiten]

Welche Platzhalter in einer Einstellung verwendet werden können, hängt immer von der Einstellung ab. Mit anderen Worten, es sind nicht alle Platzhalter in jeder Einstellung vorhanden.

Varianten[Bearbeiten]

In den Einstellungen zu den Funk- und Telefondialogen können mehrere Varianten eingegeben werden. Diese müssen durch eine Leerzeile (also zwei Zeilenumbrüche) getrennt werden. Es wird am Ende dann eine zufällige Variante verwendet.

Syntax[Bearbeiten]

Grundsätzlich gilt, dass auf jede runde oder geschweifte Klammer, die geöffnet wird, auch eine entsprechende Klammer folgen muss, die sie wieder schließt. Das gilt natürlich nicht für Klammern, vor denen ein \ steht, da umgekehrte Schrägstriche die Sonderfunktion der Klammern aushebeln.

Sollten Syntaxfehler vorhanden sein, ist es wahrscheinlich, dass im Spiel der entsprechende Dialog nicht funktioniert und es zu anderen Fehlern kommt. Vor dem Speichern von Änderungen also stets per Vorschaufunktion auf Syntaxfehler testen.

Übersichtlichkeit[Bearbeiten]

Es ist möglich, in dem Einstellungstextfeld einzelne Zeilenumbrüche (also keine Leerzeile) zu verwenden, um die Lesbarkeit zu verbessern. Diese einzelnen Zeilenumbrüche erscheinen später nicht im Spiel. Bitte beachten, dass wirklich nur ein einzelner Zeilenumbruch verwendet wird, da durch komplette Leerzeilen Variationen definiert werden und es dadurch zu Syntaxfehlern kommen kann.

Außerdem kann es von Vorteil sein, bei umfangreicheren Einstellungen die Bearbeitung in einem externen Texteditor vorzunehmen sowie den Text wie in folgendem Beispiel sinnvoll einzurücken.

Ausführliches Beispiel[Bearbeiten]

Hier noch als Beispiel die Standardalarmierungsdurchsage, in der alle Spezialtextbesonderheiten verwendet werden:

{sondersignal, select,
    ja {{anzahl_fahrzeuge, plural,
            =1 {
(|(|Hier )Leitstelle {leitstelle_name} mit )
Einsatz(| für den) {fahrzeuge}
(|: nach {einsatzort}, {stichwort}|, {stichwort}).
            }
            =2 {
(|(|Hier )Leitstelle {leitstelle_name} mit )
Einsatz(| für den) {fahrzeuge}
(|: nach {einsatzort}, {stichwort}|, {stichwort}).
            }
            other {
                Achtung, hier Leitstelle {leitstelle_name} mit Einsatz für den {fahrzeuge}: nach {einsatzort}, {stichwort}.
            }
        }
    }
    other {
        {fahrzeuge} auf Funkempfang.
    }
}

Platzhalter, die zusätzlich zu den Standardplatzhaltern (siehe unten) ersetzt werden:

{anzahl_fahrzeuge}
Wird durch die Anzahl der Fahrzeuge, die alarmiert werden, ersetzt.
{fahrzeuge}
Wird durch die Namen der Fahrzeuge, die alarmiert werden, ersetzt (durch Kommas getrennt).


Dies ist mit Absicht ein umfangreiches Beispiel. Dennoch sind wir davon überzeugt, dass man es vollständig nachvollziehen kann, wenn man es Schritt für Schritt durchgeht und sich an diese Anleitung hält. Wer sich im Umgang mit dem Spezialtext trotzdem unwohl fühlt, kann auch einen einzelnen Satz, der dann entsprechend wenig oder gar keine Variation hat, nehmen, oder auch die Standardwerte belassen. Es empfiehlt sich, die Einstellungen der offiziellen Leitstellen für weitere Beispiele zu Rate zu ziehen.

Standardplatzhalter[Bearbeiten]

Allgemein[Bearbeiten]

Diese Platzhalter sind immer verfügbar:

{leitstelle_begriff}
Wird durch den eingestellten Leitstellenbegriff (i. d. R. "Leitstelle") ersetzt.
{leitstelle_frn}
Wird durch den Funkrufnamen der Leitstelle (ohne den eingestellten Leitstellenbegriff) ersetzt.
{leitstelle_name}
Wird durch den Namen der Leitstelle (ohne den eingestellten Leitstellenbegriff) ersetzt.
{minute}
Wird durch die aktuelle Uhrzeitminute ersetzt. Wenn es im Spiel also z. B. 8:03 Uhr ist, wird der Platzhalter durch 3 ersetzt.
{spielername}
Wird durch den Spielernamen ersetzt.
{stunde}
Wird durch die aktuelle Uhrzeitstunde ersetzt. Wenn es im Spiel also z. B. 8:03 Uhr ist, wird der Platzhalter durch 8 ersetzt.
{uhrzeit}
Wird durch die aktuelle Spieluhrzeit in diesem Format ersetzt: 8:03
{tageszeit}
Wird von 0-11 Uhr durch "Morgen", von 11-19 Uhr durch "Tag" und von 19-0 Uhr durch "Abend" ersetzt.

Einsätze[Bearbeiten]

Manche einstellbare Dialoge beziehen sich auf einen konkreten Einsatz. In diesen Fällen sind diese Platzhalter standardmäßig verfügbar:

{einsatzstadt}
Wird durch die Stadt, in der sich der Einsatzort befindet, ersetzt.
{einsatzstraße}
Wird durch die Straße, in der sich der Einsatzort befindet, ersetzt.
{einsatzort}
Falls es sich bei dem Einsatzort um einen Point of Interest handelt, wird es durch den Namen des POIs ersetzt, ansonsten durch die Stadt.
{einsatzort_ist_poi}
Wird durch "ja" oder "nein" ersetzt, je nachdem ob es sich bei dem Einsatzort um einen Point of Interest oder eine zufällig ausgewählte Adresse handelt.
{notarzt}
Wird durch "ja" oder "nein" ersetzt, je nach dem ob diesem Einsatz ein Notarzt zugeordnet ist.
{rtw}
Wird durch "ja" oder "nein" ersetzt, je nach dem ob diesem Einsatz ein RTW zugeordnet ist.
{sondersignal}
Wird durch "ja" oder "nein" ersetzt, je nach dem ob die Anfahrt mit Sondersignal ist.
{stichwort}
Wird durch das Einsatzstichwort ersetzt.
{text}
Wird durch den Alarmierungstext ersetzt.
{text_vorhanden}
Wird durch "ja" oder "nein" ersetzt, je nach dem ob ein Alarmierungstext vorhanden ist.