.\" Man page for stationlist.xml
.\" Copyright (c) 2003, 2004  Billy Biggs
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or (at
.\" your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
.\" General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.TH stationlist.xml 5 "October 2004" "tvtime 1.0RC1"

.SH "نام (NAME)"
stationlist.xml \- پرونده پیکربندی ایستگاه‌های برنامه tvtime

.SH "خلاصه پرونده (SYNOPSIS)"

.I ~/.tvtime/stationlist.xml

.SH "توضیحات (DESCRIPTION)"

پرونده
.I stationlist.xml
شامل پیکربندی اطلاعات کانال‌ها برای کارت‌های کپچر دارای تیونر (گیرنده تلویزیونی) است. این پرونده فهرستی از کانال‌های فعال را به همراه فرکانس، اطلاعات شماره‌گذاری مجدد و نام کانال در بر دارد. پرونده
.I stationlist.xml
توسط
.B tvtime
در زمان اجرا به‌روزرسانی می‌شود تا تنظیمات را در بین نشست‌های مختلف ذخیره و نگهداری کند. به همین دلیل، نباید هنگامی که
.B tvtime
در حال اجراست این پرونده را ویرایش کنید، چرا که ممکن است تغییرات شما رونویسی و بازنویسی شوند.

این پرونده هر بار که اطلاعات کانال در
.B tvtime
تغییر کند، ایجاد یا به‌روزرسانی می‌شود. این امر هنگام شماره‌گذاری مجدد یک کانال، استفاده از اسکنر کانال، یا فعال/غیرفعال کردن دستی یک کانال مشخص از فهرست صورت می‌گیرد.

تنظیمات کانال به تفکیک استاندارد تلویزیونی (norm) و جدول فرکانسی (frequency table) ذخیره می‌شوند.

.nf
    <?xml version="1.0"?>
    <!DOCTYPE stationlist PUBLIC "-//tvtime//DTD stationlist 1.0//EN"
      "http://tvtime.sourceforge.net/DTD/stationlist.dtd">
    <stationlist xmlns="http://tvtime.sourceforge.net/DTD/">
      <list norm="NTSC" frequencies="US-Cable">
        <station ... />
        ... station list
      </list>
    </stationlist>
.fi

به این معنی که هر ترکیب استاندارد/فرکانس، بخش مختص به خود را در پرونده پیکربندی دریافت خواهد کرد. نام فرکانس‌ها نام ویژه‌ای نیست، شما می‌توانید frequencies="foobar" را داشته باشید و اجرای
.br
\h'4n'tvtime -f foobar
.br
عملکرد مورد نظر را به درستی انجام خواهد داد. با این حال، مقدار norm باید با استاندارد تلویزیونی مورد استفاده مطابقت داشته باشد.

ورودی‌های موجود در یک فهرست به شکل زیر هستند:

.nf
    <station name="CNN" active="1" position="18"
             band="US Cable" channel="18"/>
    <station name="DSF" active="1" position="12"
             band="VHF E2-E12" channel="E12"/>
.fi


.SH "ایستگاه‌ها (STATIONS)"

هر ایستگاه ویژگی‌های مختص به خود را دارد که باید تنظیم شوند.

.TP
.B name
نام خوانا برای انسان برای ایستگاه فعلی.

.TP
.B active
هنگامی که روی
.IR 1
تنظیم شده باشد، کانال فعال است. برای غیرفعال کردن کانال، این مقدار را روی
.IR 0
تنظیم کنید.

.TP
.B position
این تنظیم موقعیتی را که کانال روی صفحه انتخاب کانال (dial) اشغال می‌کند مشخص می‌کند. این گزینه به کاربران امکان می‌دهد تا هر کانال دلخواهی را به یک موقعیت دلخواه روی صفحه انتخاب کانال نگاشت کنند.

.TP
.PD 0
.B band
.TP
.B channel

باندها و کانال‌های احتمالی در دسترس در
.B tvtime
عبارتند از:
.PD

.TS
nokeep tab (@);
lb lb
l l.
نام باند@کانال‌های ارائه‌شده
US Cable@1\[en]99
US Cable 100@100\[en]125
US Two-Way@T7, T8, T9, T10, T11, T12 T13, T14
US Broadcast@2\[en]83
China Broadcast@1\[en]68, A1\[en]A7, B1\[en]B31, C1\[en]C5
Japan Broadcast@1\[en]62
Japan Cable@13\[en]63
VHF E2-E12@E1\[en]E12
VHF S1-S41@S1\[en]S41
VHF Misc@X, Y, Z, Z+1, Z+2
VHF France@K01\[en]K10, KB\[en]KQ, H01\[en]H19
VHF Russia@R1\[en]R12, SR1\[en]SR19
VHF Australia@AS1\[en]AS12, AS5A, AS9A
VHF Italy@A\[en]H, H1, H2
VHF Ireland@I1\[en]I9
VHF South Africa@1\[en]13
UHF@U21\[en]U69
UHF Australia@AU28\[en]AU69
Australia Optus@01\[en]058
.TE

کانال‌های سفارشی را می‌توان به صورت دستی با مشخص کردن فرکانس بر حسب مگاهرتز اضافه کرد:

.nf
    <station name="2" active="1" position="0"
             band="Custom" channel="55.69MHz"/>
.fi

.TP
.B norm
یک استاندارد تلویزیونی به ازای هر کانال را می‌توان در stationlist تعیین کرد. این برای ایستگاه‌هایی است که هر دو سیگنال PAL و SECAM را دریافت می‌کنند، به طوری که می‌توانند قالب کدگذاری رنگ را برای هر کانال انتخاب کنند. تنها مقادیر معتبر در اینجا PAL یا SECAM هستند.

.TP
.B network
نام شبکه را برای نمایش در OSD (نمایش روی صفحه) تنظیم می‌کند. در مناطق NTSC، در صورتی که رمزگشایی VBI فعال باشد، این مقدار از اطلاعات XDS در VBI دریافت و تنظیم می‌شود.

.TP
.B call
حروف شناسایی (call letters) شبکه را برای نمایش در OSD تنظیم می‌کند. در مناطق NTSC، در صورتی که رمزگشایی VBI فعال باشد، این مقدار از اطلاعات XDS در VBI دریافت و تنظیم می‌شود.

.TP
.B xmltvid
شناسه کانال XMLTV را تنظیم می‌کند تا در صورتی که tvtime نتواند ارتباط را به طور خودکار برقرار کند، این کانال با آن مرتبط شود. برای تعریف کانال زیر در یک پرونده XMLTV:

.nf
  <channel id="I10119.labs.zap2it.com">
    <display-name>CICA</display-name>
    <display-name>TV Ontario (CICA)</display-name>
    <display-name>Canadian Independent</display-name>
  </channel>
.fi

ورودی مرتبط در stationlist به این صورت خواهد بود:

.nf
    <station name="2" active="1" position="0"
             band="Custom" channel="55.69MHz"
             xmltvid="I10119.labs.zap2it.com"/>
.fi

.SH "نویسندگان (AUTHORS)"

Achim Schneider,
Billy Biggs.

.SH "همچنین ببینید (SEE ALSO)"

.BR tvtime (1),
.BR tvtime-command (1),
.BR tvtime-scanner (1),
.IR tvtime.xml (5).