CASTGETRC(5)                     User Commands                    CASTGETRC(5)

نام (NAME)
       castgetrc - فایل پیکربندی برای castget

توضیحات (DESCRIPTION)
       فایل پیکربندی .castgetrc باید در دایرکتوری خانگی کاربر قرار گیرد. این
       فایل رفتار ابزار بارگیری ضمیمه RSS به نام castget و به‌ویژه فهرست
       کانال‌هایی را که روی آن‌ها عمل می‌کند، تعیین می‌نماید.

       این فایل بر اساس یک قالب ساده کلید-مقدار است. این فایل شامل تعریف کانال
       برای هر فید RSS است که castget باید آن را پردازش کند. تعریف کانال با
       خطی آغاز می‌شود که حاوی یک شناسه کانال درون براکت‌ها است. شناسه کانال
       می‌تواند آزادانه توسط کاربر انتخاب شود و برای تمام عملیات‌های بعدی روی آن
       کانال به کار می‌رود. به دنبال آن یک یا چند جفت کلید-مقدار به شکل
       key=value می‌آیند که رفتار castget را هنگام کار روی آن کانال تعیین
       می‌کنند. تعریف کانال زمانی پایان می‌یابد که تعریف کانال دیگری آغاز شود یا
       فایل به انتها برسد.

       خطوطی که با نویسه هش (`#´) آغاز می‌شوند و خط‌های خالی به عنوان توضیح
       (کامنت) در نظر گرفته می‌شوند. تمامی شناسه‌ها، کلیدها و مقدارها باید با
       کدگذاری UTF-8 باشند.

       جفت‌های کلید-مقدار در تعریف یک کانال، رفتار castget را هنگام پردازش آن
       کانال مشخص می‌کنند. برای نمونه، تعریف کانال



           [fooc]
           url=http://downloads.bbc.co.uk/podcasts/radio4/fooc/rss.xml
           spool=/home/joe/podcasts




       به castget دستور می‌دهد که هنگام پردازش کانال fooc، از
       /home/joe/podcasts به عنوان دایرکتوری بارگیری استفاده کند.

کلیدها (KEYS)
       url    دریافت فید RSS از این نشانی اینترنتی (URL). این فیلد برای تمامی
              تعاریف کانال اجباری است.

       spool  بارگیری ضمیمه‌ها در این دایرکتوری.

       playlist
              نوشتن نام کامل مسیر فایل‌های تمامی ضمیمه‌های بارگیری‌شده در یک فایل
              لیست پخش به سبک m3u با این نام.

       filter محدود کردن عملیات به ضمیمه‌هایی که نشانی‌های اینترنتی (URL) آن‌ها
              با این عبارت باقاعده مطابقت دارد.

       id3leadartist
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «هنرمند اصلی» (TPE1) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       id3contentgroup
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «گروه محتوا» (TIT1) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       id3title
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «عنوان» (TIT2) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       id3album
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «آلبوم» (TALB) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       id3contenttype
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «نوع محتوا» (TCON) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       id3year
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «سال» (TYER) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       id3comment
              افزودن یا بازنویسی برچسب ID3v2 با عنوان «دیدگاه» (COMM) در
              ضمیمه‌هایی که از آن پشتیبانی می‌کنند.

       filename
              ذخیره بارگیری‌ها با استفاده از الگوی نام فایل ارائه‌شده به‌جای
              استخراج آن از نشانی اینترنتی (URL) ضمیمه. بخش الگوهای نام فایل
              (FILENAME PATTERNS) را ببینید.

پیکربندی سراسری (GLOBAL CONFIGURATION)
       تعریف یک کانال با شناسه کانال * یک پیکربندی سراسری را مشخص می‌کند که بر
       تمامی کانال‌ها تأثیر می‌گذارد. برای نمونه، پیکربندی سراسری



           [*]
           id3contenttype=Podcast




       معادل افزودن جفت کلید-مقدار id3contenttype=Podcast به تعاریف سایر
       کانال‌ها است.

       جفت‌های کلید-مقدار در تعاریف کانال‌ها بر پیکربندی سراسری اولویت داشته و
       آن را رونویسی (لغو) می‌کنند.

الگوهای نام فایل (FILENAME PATTERNS)
       الگوهای نام فایل می‌توانند شامل الگوهایی به شکل %(parameter) باشند که
       برای تشکیل یک نام فایل کامل بسط داده می‌شوند. الگوها برای هر بارگیری
       ضمیمه یک بار باز می‌شوند و بنابراین می‌توان از آن‌ها برای ایجاد نام
       فایل‌های یکتا برای هر بارگیری استفاده کرد.

       هر چیزی که الگو نباشد به عنوان متن صریح در نظر گرفته می‌شود و عیناً
       بازتولید خواهد شد (مشروط به برخی بررسی‌های اعتبارسنجی). مسیر کامل یک
       بارگیری با چسباندن دایرکتوری spool کانال به نام فایل تعیین می‌شود.

       توجه داشته باشید که castget از رونویسی فایل‌های از پیش موجود خودداری
       می‌کند، مگر زمانی که با گزینه -r برای ازسرگیری بارگیری‌ها اجرا شود. برخی
       فیدهای RSS برای تمامی ضمیمه‌ها از یک نام فایل مشترک استفاده می‌کنند. در
       چنین مواردی، گزینه -r بارگیری‌های موجود را خراب می‌کند مگر این‌که از
       الگوهای نام فایل برای ساخت نام‌های یکتا استفاده کنید.

       الگوهای زیر اطلاعات را از عنصر item یا ضمیمه موجود در فید RSS می‌گیرند:

       •   %(date): تاریخ (به‌طور پیش‌فرض در قالب YYYY-MM-DD)

       •   %(title): عنوان




       الگوهای زیر اطلاعات را از عنصر channel یا ضمیمه موجود در فید RSS
       می‌گیرند:

       •   %(channel_title): عنوان کانال




       اگر هر یک از اطلاعات مورد نیاز یک الگو در فید RSS وجود نداشته باشد یا
       نامعتبر باشد، الگو نادیده گرفته شده و از نام فایل نهایی حذف خواهد شد.

حذف کانال (CHANNEL REMOVAL)
       اگر پیکربندی یک کانال حذف شود، وضعیت کانال بدون تغییر باقی می‌ماند؛
       بنابراین در صورتی که آن کانال بعداً دوباره افزوده شود، ضمیمه‌هایی که قبلاً
       به عنوان بارگیری‌شده علامت خورده‌اند دوباره بارگیری نخواهند شد.

نکته (NOTE)
       بسته توزیع کد منبع شامل یک فایل پیکربندی نمونه است که تمامی تنظیمات
       پشتیبانی‌شده را نمایش می‌دهد.

همچنین ببینید (SEE ALSO)
       castget(1)

نویسنده (AUTHOR)
       Marius L. Jøhndal.

castget 2.0.0                    December 2018                    CASTGETRC(5)