Bearbeiten von „Spezialtext“

'''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 ==
=== Normale Platzhalter ===
Normale Platzhalter werden in '''geschweiften Klammern''' geschrieben.

Beispiel: <code>{name}</code>

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

=== Zufallsplatzhalter ===
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 [[wikipedia:Senkrechter Strich|'''senkrechten Strich''']] getrennt.

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

=== Fallunterscheidung ===
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>

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 <code>Platzhalter</code> um einen '''Zahlenwert''', muss ein leicht abgewandeltes Format verwendet werden:

<code>{<ins>Platzhalter</ins>, plural, <ins>=1</ins> {Platzhalter hat den Wert eins} <ins>=2</ins> {Platzhalter hat den Wert zwei} other {Platzhalter hat weder den Wert eins noch den Wert zwei}}</code>

* 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 ==
=== Sonderzeichen ===
Um runde oder geschweifte Klammern in einem normalen Text zu verwenden, muss vor die Klammer ein [[wikipedia:Umgekehrter Schrägstrich|umgekehrter Schrägstrich]] geschrieben werden. Beispiel: <code>Ich wünsche euch einen \(sehr\) guten (Morgen|Tag|Abend)! ;-\}</code>

=== Platzhalter ===
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 ===
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 ===
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 ===
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 ==

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

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

Platzhalter, die in diesem Beispiel ersetzt werden:

; {anzahl_fahrzeuge}
: Wird durch die Anzahl der Fahrzeuge, die alarmiert werden, ersetzt.

; {einsatzort}
: Wird durch die Stadt des Einsatzorts ersetzt.

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

; {leitstelle}
: Wird durch den Namen der Leitstelle (ohne das Wort "Leitstelle") ersetzt.

; {notarzt}
: Wird durch "ja" oder "nein" ersetzt, je nach dem ob diesem Einsatz ein Notarzt 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.


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. 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.