عنصر <channel> RSS

عنصر <channel> RSS می‌تواند فید RSS را توضیح دهد.

عنصر <channel> RSS

لطفاً مستند RSS زیر را ببینید:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<rss version="2.0">
<channel>
  <title>CodeW3C.com Home Page</title>
  <link>http://www.codew3c.com</link>
  <description>Free web building tutorials</description>
  <item>
    <title>RSS Tutorial</title>
    <link>http://www.codew3c.com/rss</link>
    <description>New RSS tutorial on CodeW3C.com</description>
  </item>
</channel>
</rss>

همانطور که قبلاً ذکر شد، عنصر <channel> می‌تواند فید RSS را توضیح دهد و دارای سه عنصر ضروری است:

  • <title> - عنوان کانال تعریف می‌شود. (مثلاً صفحه اصلی CodeW3C)
  • <link> - لینک به کانال تعریف می‌شود. (مثلاً www.codew3c.com)
  • <description> - توضیح این کانال (مثلاً آموزش‌های رایگان ساخت وب‌سایت)

عناصر <channel> معمولاً یک یا چند عناصر <item> شامل می‌شوند. هر عنصر <item> می‌تواند یک مقاله یا "story" در فید RSS را تعریف کند.

علاوه بر این، چندین عنصر فرزند اختیاری برای <channel> وجود دارد. ما در ادامه مهم‌ترین آنها را توضیح خواهیم داد.

عنصر <category>

عناصر فرزند <category> برای تعیین نوع فید استفاده می‌شود.

<category> عناصر فرزند ممکن است به RSS اتحادیه‌ای این امکان را بدهد که بر اساس دسته‌بندی‌ها به وب‌سایت‌ها گروه‌بندی شوند.

دسته‌بندی‌های مستند RSS ممکن است:

<category>توسعه وب</category>

<copyright> عنصر

عنصر <copyright> اطلاعات مربوط به نسخه را ارائه می‌دهد.

نسخه مستند RSS بالا ممکن است باشد:

<copyright>2006 codew3c.com. تمام حقوق محفوظ است.</copyright>

<image> عنصر

<image> عنصر می‌تواند در هنگام ارائه یک فید توسط یک جمع‌آوری‌کننده تصویری را نمایش دهد.

<image> سه عنصر ضروری دارد:

  • <url> - تعریف URL مورد استفاده برای ارجاع به تصویر
  • <title> - تعریف متنی که در صورت عدم نمایش تصویر نمایش داده می‌شود
  • <link> - تعریف لینک به وب‌سایتی که این کانال را ارائه می‌دهد

تصویر مستند RSS بالا ممکن است اینگونه باشد:

<image>
  <url>http://www.codew3c.com/images/logo.gif</url>
  <title>codew3c.com</title>
  <link>http://www.codew3c.com</link>
</image>

<language> عناصر

عنصر <language> برای مشخص کردن زبانی که مستند نوشته شده است استفاده می‌شود.

<language> عناصر ممکن است امکان گروه‌بندی وب‌سایت‌ها بر اساس زبان را بر اساس زبان فراهم کند.

زبان مستند RSS بالا ممکن است باشد:

<language>en-us</language>

دستورالعمل RSS <channel>

عنصر توصیف
<category> اختیاری است. یک یا چند دسته برای فید تعریف می‌کند.
<cloud> اختیاری است. فرآیند ثبت برای دریافت اطلاع‌رسانی‌های فوری از به‌روزرسانی‌های فید.
<copyright> اختیاری است. اطلاعات مربوط به حق‌版权归 مشخص می‌کند.
<description> ضروری است. کانال را توصیف می‌کند.
<docs> اختیاری است. URL به توضیحات فرمت استفاده شده برای فایل RSS اشاره دارد.
<generator> اختیاری است. برنامه‌ای که برای تولید فید استفاده شده است را مشخص می‌کند.
<image> اختیاری است. یک تصویر را در هنگام نمایش فید در یک جمع‌آوری‌کننده نشان می‌دهد.
<language> اختیاری است. زبانی که فید نوشته شده است را مشخص می‌کند.
<lastBuildDate> اختیاری است. تاریخ آخرین به‌روزرسانی محتوای فید را تعریف می‌کند.
<link> ضروری است. لینک به کانال را تعریف می‌کند.
<managingEditor> اختیاری است. آدرس ایمیل تعریف شده برای ویرایش محتوای فید را مشخص می‌کند.
<pubDate> اختیاری. تعریف تاریخ آخرین انتشار محتوای feed.
<rating> اختیاری. سطح PICS feed.
<skipDays> اختیاری. تعیین روزهایی که باید از به‌روزرسانی‌های feed صرف‌نظر شود.
<skipHours> اختیاری. تعیین ساعتی که باید از به‌روزرسانی‌های feed صرف‌نظر شود.
<textInput> اختیاری. تعیین فیلد ورودی متنی که باید با feed نمایش داده شود.
<title> ضروری. تعریف عنوان کانال.
<ttl> اختیاری. تعیین تعداد دقیقه‌ای که feed می‌تواند قبل از به‌روزرسانی از منبع feed ذخیره شود.
<webMaster> اختیاری. تعریف آدرس ایمیل مدیر وب این feed.