.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "epgsearchuservars.conf 5"
.TH epgsearchuservars.conf 5 "2022-01-12" "perl v5.32.1" "Epgsearch Version 2.4.1"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
epgsearchuservars.conf \- Die Uservariablen
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
In dieser Datei können Variablen definiert werden die dann in epgsearch
in allen Feldern, in denen Variablen möglich sind, zur Verfügung stehen.
.SH "FORMAT"
.IX Header "FORMAT"
Die Variablen selbst sind in dem Format \f(CW%Variablenname\fR% aufgebaut.
.PP
\&\*(L"Variablenname\*(R" kann aus alphanumerischen Zeichen bestehen, Leerzeichen
und Sonderzeichen sind nicht erlaubt.
.PP
Zwischen Gross\-/und Kleinschreibung wird nicht unterscheiden.
.PP
Beispiele für mögliche Namen:
.PP
.Vb 1
\& %Serie% %DokuVar1% %ThemesSubtitleDate1%
.Ve
.SS "Zuweisung"
.IX Subsection "Zuweisung"
Die Zuweisung eines Wertes erfolgt so:
.PP
.Vb 1
\& %Serie%=Neue Serie~Krimi
.Ve
.PP
Hier wird der Variablen \f(CW%Serie\fR% die Zeichenkette \*(L"Neue Serie~Krimi\*(R" zugewiesen.
.PP
Es wird immer eine Zeichenkette zugewiesen. Leerzeichen werden daher auch
als Leerzeichen mit übernommen.
.PP
.Vb 1
\& %Pfad%=%Serie%
.Ve
.PP
Hier wird der Variablen \f(CW%Pfad\fR% der Inhalt der Variablen \f(CW%Serie\fR% zugewiesen.
.PP
Das lässt sich beliebig verwenden.
.PP
.Vb 1
\& %Pfad%=%Serie%~Tatort
.Ve
.PP
Pfad enthält hier den String \*(L"Neue Serie~Krimi~Tatort\*(R".
.SS "Kontroll-Strukturen"
.IX Subsection "Kontroll-Strukturen"
Einfache \*(L"if then else\*(R" Konstrukte sind mögliche.
.PP
Innerhalb dieser Konstrukte können keine Strings, wohl aber Variablen
zugwiesen werden. Leerzeichen werden ignoriert.
.PP
.Vb 1
\& %Foo%=Verschiedenes
\&
\& %Variable%=%Pfad% ? %Pfad% : %Foo%
.Ve
.PP
Ist Pfad nicht leer, weise \f(CW%Variable\fR% den Inhalt aus \f(CW%Pfad\fR% zu, sonst
den Inhalt aus \f(CW%Foo\fR%.
.PP
\&\*(L"%Pfad% ?\*(R" bedeutet also \*(L"nicht leer?\*(R". Es sind auch andere Prüfungen
möglich.
.PP
.Vb 1
\& %Variable%=%Pfad%!=5 ? %Pfad% : %Foo%
.Ve
.PP
\&\*(L"%Pfad%!=5 ?\*(R" bedeutet \*(L"ist \f(CW%Pfad\fR% ungleich 5?\*(R"
.PP
Es können auch Variablen verglichen werden.
.PP
.Vb 1
\& %Fuenf%=5
\&
\& %Variable%=%Pfad%!=%Fuenf% ? %Pfad% : %Foo%
.Ve
.PP
Folgende Prüfungen sind möglich:
.PP
.Vb 2
\& ==   ist gleich
\& !=   ist nicht gleich
.Ve
.SS "Systemaufruf"
.IX Subsection "Systemaufruf"
Es können auch externe Programme/Scripte aufgerufen werden. Die zurück\-
gegebene Zeichenkette wird dann einer Variablen zugewiesen.
.PP
.Vb 1
\& %Ergebnis%=system(scriptname,%Variable1% %Variable2% \-f %Variable3% \-\-dir=%Variable4% \-\-dummy)
.Ve
.PP
Ruft das Script \*(L"scriptname\*(R" mit den Parametern \*(L"%Variable1%\*(R",
\&\*(L"%Variable2%\*(R", usw. auf. Das Ergebnis wird der Variablen \f(CW%Ergebnis\fR%
zugewiesen.
.PP
Es sind beliebig viele Variablen möglich.
.PP
Wenn nötig, umfasst epgsearch die Variablen automatisch mit "".
.PP
Das Script darf nur eine Zeichenkette ohne Zeilenumbruch zurückgeben.
.PP
Erfolgt keine Rückgabe wird der Variablen \f(CW%Ergebnis\fR% eine leere Zeichenkette
zugewiesen.
.SS "Verfügbare Variablen"
.IX Subsection "Verfügbare Variablen"
Folgende Variablen sind bereits intern definiert und können verwendet
werden.
.PP
.Vb 10
\& %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\*(Aqs interne Kanaldarstellung (z.B. \*(AqS19.2E\-1\-1101\-28106\*(Aq)
\&
\& %summary%        \- Beschreibung
\& %htmlsummary%    \- Beschreibung, alle CR ersetzt durch \*(Aq<br />\*(Aq
\& %eventid%        \- Event ID
\&
\& %colon%          \- Das Zeichen \*(Aq:\*(Aq
\& %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 für Plugin\-Konfigurationsdateien (z.B. /etc/vdr/plugins)
\& %epgsearchdir%   \- epgsearchs Verzeichnis für Konfiguratzionsdateien (z.B. /etc/vdr/plugins/epgsearch)
.Ve
.PP
Desweiteren können die in der Datei \fIepgsearchcats.conf\fR definierten Variablen
verwendet werden. Siehe dazu \f(CW\*(C`epgsearchcats.conf(5)\*(C'\fR.
.SH "BEISPIELE"
.IX Header "BEISPIELE"
.Vb 2
\& # 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%
.Ve
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\f(CWepgsearch(1)\fR, \f(CW\*(C`epgsearchcats.conf(5)\*(C'\fR
.SH "AUTOR (man pages)"
.IX Header "AUTOR (man pages)"
Mike Constabel <epgsearch (at) constabel (dot) net>
.SH "FEHLER MELDEN"
.IX Header "FEHLER MELDEN"
Fehlerberichte bitte im Bugtracker.
.PP
<http://projects.vdr\-developer.org/projects/plg\-epgsearch>
.PP
Mailinglist:
.PP
<http://www.vdr\-developer.org/mailman/listinfo/epgsearch>
.SH "COPYRIGHT and LIZENZ"
.IX Header "COPYRIGHT and LIZENZ"
Copyright © 2004\-2010 Christian Wieninger
.PP
Dieses Programm ist freie Software. Sie können es unter den Bedingungen
der \s-1GNU\s0 General Public License, wie von der Free Software Foundation
veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 2
der Lizenz oder (nach Ihrer Option) jeder späteren Version.
.PP
Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, dass es
Ihnen von Nutzen sein wird, aber \s-1OHNE IRGENDEINE GARANTIE,\s0 sogar ohne die
implizite Garantie der \s-1MARKTREIFE\s0 oder der \s-1VERWENDBARKEIT\s0 FÜR \s-1EINEN BESTIMMTEN
ZWECK.\s0 Details finden Sie in der \s-1GNU\s0 General Public License.
.PP
Sie sollten ein Exemplar der \s-1GNU\s0 General Public License zusammen mit
diesem Programm erhalten haben. Falls nicht, schreiben Sie an die
Free Software Foundation, Inc. 59 Temple Place, Suite 330, Boston, \s-1MA 02111\-1307, USA.\s0
Oder rufen Sie in Ihrem Browser http://www.gnu.org/licenses/old\-licenses/gpl\-2.0.html
auf.
.PP
Der Author kann über cwieninger@gmx.de erreicht werden.
.PP
Die Projektseite ist http://winni.vdr\-developer.org/epgsearch
.PP
Der MD5\-Code ist abgeleitet aus dem Message-Digest Algorithm
von \s-1RSA\s0 Data Security, Inc..