=head1 NAME

F<epgsearchuservars.conf> - Die Uservariablen

=head1 BESCHREIBUNG

In dieser Datei knnen Variablen definiert werden die dann in epgsearch
in allen Feldern, in denen Variablen mglich sind, zur Verfgung stehen.

=head1 FORMAT

Die Variablen selbst sind in dem Format %Variablenname% aufgebaut.

"Variablenname" kann aus alphanumerischen Zeichen bestehen, Leerzeichen
und Sonderzeichen sind nicht erlaubt.

Zwischen Gross-/und Kleinschreibung wird nicht unterscheiden.

Beispiele fr mgliche Namen:

 %Serie% %DokuVar1% %ThemesSubtitleDate1%

=head2 Zuweisung

Die Zuweisung eines Wertes erfolgt so:

 %Serie%=Neue Serie~Krimi

Hier wird der Variablen %Serie% die Zeichenkette "Neue Serie~Krimi" zugewiesen.

Es wird immer eine Zeichenkette zugewiesen. Leerzeichen werden daher auch
als Leerzeichen mit bernommen.

 %Pfad%=%Serie%

Hier wird der Variablen %Pfad% der Inhalt der Variablen %Serie% zugewiesen.

Das lsst sich beliebig verwenden.

 %Pfad%=%Serie%~Tatort

Pfad enthlt hier den String "Neue Serie~Krimi~Tatort".

=head2 Kontroll-Strukturen

Einfache "if then else" Konstrukte sind mgliche.

Innerhalb dieser Konstrukte knnen keine Strings, wohl aber Variablen
zugwiesen werden. Leerzeichen werden ignoriert.

 %Foo%=Verschiedenes

 %Variable%=%Pfad% ? %Pfad% : %Foo%

Ist Pfad nicht leer, weise %Variable% den Inhalt aus %Pfad% zu, sonst
den Inhalt aus %Foo%.

"%Pfad% ?" bedeutet also "nicht leer?". Es sind auch andere Prfungen
mglich.

 %Variable%=%Pfad%!=5 ? %Pfad% : %Foo%

"%Pfad%!=5 ?" bedeutet "ist %Pfad% ungleich 5?"

Es knnen auch Variablen verglichen werden.

 %Fuenf%=5

 %Variable%=%Pfad%!=%Fuenf% ? %Pfad% : %Foo%


Folgende Prfungen sind mglich:

 ==   ist gleich
 !=   ist nicht gleich

=head2 Systemaufruf

Es knnen auch externe Programme/Scripte aufgerufen werden. Die zurck-
gegebene Zeichenkette wird dann einer Variablen zugewiesen.

 %Ergebnis%=system(scriptname,%Variable1% %Variable2% -f %Variable3% --dir=%Variable4% --dummy)

Ruft das Script "scriptname" mit den Parametern "%Variable1%",
"%Variable2%", usw. auf. Das Ergebnis wird der Variablen %Ergebnis%
zugewiesen.

Es sind beliebig viele Variablen mglich.

Wenn ntig, umfasst epgsearch die Variablen automatisch mit "".

Das Script darf nur eine Zeichenkette ohne Zeilenumbruch zurckgeben.

Erfolgt keine Rckgabe wird der Variablen %Ergebnis% eine leere Zeichenkette
zugewiesen.

=head2 Verfgbare Variablen

Folgende Variablen sind bereits intern definiert und knnen verwendet
werden.

 %title%          - Title der Sendung
 %subtitle%       - Subtitle der Sendung
 %time%           - Startzeit im Format HH:MM
 %timeend%        - Endzeit im Format HH:MM
 %date%           - Startzeit im Format TT.MM.YY
 %datesh%         - Startdatum im Format TT.MM.
 %time_w%         - Name des Wochentages
 %time_d%         - Tag der Sendung im Format TT
 %time_lng%       - Startzeit in Sekunden seit 1970-01-01 00:00
 %chnr%           - Kanalnummer
 %chsh%           - Kanalname kurz
 %chlng%          - Kanalname lang
 %chdata%         - VDR's interne Kanaldarstellung (z.B. 'S19.2E-1-1101-28106')

 %summary%        - Beschreibung
 %htmlsummary%    - Beschreibung, alle CR ersetzt durch '<br />'
 %eventid%        - Event ID

 %colon%          - Das Zeichen ':'
 %datenow%        - Aktuelles Datum im Format TT.MM.YY
 %dateshnow%      - Aktuelles Datum im Format TT.MM.
 %timenow%        - Aktuelle Zeit im Format HH:MM
 %videodir%       - VDRs Aufnahme-Verzeichnis (z.B. /video)
 %plugconfdir%    - VDRs Verzeichnis fr Plugin-Konfigurationsdateien (z.B. /etc/vdr/plugins)
 %epgsearchdir%   - epgsearchs Verzeichnis fr Konfiguratzionsdateien (z.B. /etc/vdr/plugins/epgsearch)

Desweiteren knnen die in der Datei F<epgsearchcats.conf> definierten Variablen
verwendet werden. Siehe dazu C<epgsearchcats.conf(5)>.

=head1 BEISPIELE

 # Wochentag, Datum, Uhrzeit
 %Datum%=%time_w% %date% %time%

 # Themes oder Subtitle oder Datum
 %ThemesSubtitleDate1%=%Subtitle% ? %Subtitle% : %Datum%
 %ThemesSubtitleDate%=%Themes% ? %Themes% : %ThemesSubtitleDate1%

 # Rufe das Script auf das den Aufnahmepfad erzeugt
 %DokuScript%=system(doku.pl,%Title%,%Subtitle%,%Episode%,%Themes%,%Category%,%Genre%)
 %Doku%=%DokuScript%

=head1 SIEHE AUCH

C<epgsearch(1)>, C<epgsearchcats.conf(5)>

=head1 AUTOR (man pages)

Mike Constabel <epgsearch (at) constabel (dot) net>

=head1 FEHLER MELDEN

Fehlerberichte bitte im Bugtracker.

L<http://www.vdr-developer.org/mantisbt/>

Mailinglist:

L<http://www.vdr-developer.org/mailman/listinfo/epgsearch>   

=head1 COPYRIGHT und LIZENZ

Copyright  2005 - 2007 Christian Wieninger

Dieses Dokument wird unter den Bedingungen der Gnu Public License
(GPL) verffentlicht. Alle Angaben sind nach bestem Wissen, aber
natrlich ohne Gewhr (no warranty in any kind). 

