CASTGETRC(5) User Commands CASTGETRC(5)

castgetrc - فایل پیکربندی برای castget

فایل پیکربندی .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 به عنوان دایرکتوری بارگیری استفاده کند.

دریافت فید RSS از این نشانی اینترنتی (URL). این فیلد برای تمامی تعاریف کانال اجباری است.
بارگیری ضمیمه‌ها در این دایرکتوری.
نوشتن نام کامل مسیر فایل‌های تمامی ضمیمه‌های بارگیری‌شده در یک فایل لیست پخش به سبک m3u با این نام.
محدود کردن عملیات به ضمیمه‌هایی که نشانی‌های اینترنتی (URL) آن‌ها با این عبارت باقاعده مطابقت دارد.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «هنرمند اصلی» (TPE1) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «گروه محتوا» (TIT1) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «عنوان» (TIT2) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «آلبوم» (TALB) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «نوع محتوا» (TCON) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «سال» (TYER) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
افزودن یا بازنویسی برچسب ID3v2 با عنوان «دیدگاه» (COMM) در ضمیمه‌هایی که از آن پشتیبانی می‌کنند.
ذخیره بارگیری‌ها با استفاده از الگوی نام فایل ارائه‌شده به‌جای استخراج آن از نشانی اینترنتی (URL) ضمیمه. بخش الگوهای نام فایل (FILENAME PATTERNS) را ببینید.

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

[*]
id3contenttype=Podcast

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

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

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

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

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

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

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

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

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

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

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

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

castget(1)

Marius L. Jøhndal.

December 2018 castget 2.0.0