INFORMANT(1) Informant Manual INFORMANT(1)

informant - بررسی اخبار مهم آرچ لینوکس پیش از به‌روزرسانی با Pacman

informant [گزینه‌ها] check

informant [گزینه‌ها] list [--reverse --unread]

informant [گزینه‌ها] read [<مورد> | --all]

دستور informant دارای سه حالت عملیاتی است: check، list و read.

اخبار خوانده‌نشده آرچ لینوکس را بررسی می‌کند و با کد خروجی برابر با تعداد موارد خوانده‌نشده خارج می‌شود.
عناوین جدیدترین اخبار را (صرف‌نظر از اینکه خوانده شده‌اند یا خیر) چاپ می‌کند. دستور list دو گزینه اختصاصی نیز می‌پذیرد:
عناوین را از قدیمی‌ترین به جدیدترین (به جای جدیدترین به قدیمی‌ترین) چاپ می‌کند.
تنها عناوین موارد خوانده‌نشده را چاپ می‌کند.
مورد خبری مشخص‌شده را چاپ کرده و آن را به عنوان خوانده‌شده علامت‌گذاری می‌کند. <مورد> می‌تواند به صورت یک اندیس (چاپ‌شده توسط دستور list بدون گزینه‌های --unread یا --reverse) یا به صورت یک رشته منطبق بر بخشی از عنوان یک مورد خبری داده شود. دستور read در صورتی که دسترسی نوشتن روی فایل ذخیره‌سازی را نداشته باشد، با کد وضعیت 255 خارج می‌شود.

هنگامی که بدون <مورد> یا --all اجرا شود، دستور read به صورت تعاملی اجرا شده و تمامی موارد خبری خوانده‌نشده را از قدیمی‌ترین به جدیدترین چاپ می‌کند و از کاربر می‌پرسد که آیا مایل به ادامه خواندن است یا خیر.

تمامی جدیدترین موارد خبری را بدون چاپ کردن، به عنوان خوانده‌شده علامت‌گذاری می‌کند.

این‌ها گزینه‌های عمومی هستند که می‌توان آن‌ها را برای هر یک از زیردستورها به کار برد.

پیکربندی را از <cfile> می‌خواند. تنظیمات و نحو پیکربندی در بخش «پیکربندی (CONFIGURATION)» در ادامه آمده است.
پیام‌های اشکال‌زدایی را چاپ می‌کند و تغییری در فایل ذخیره‌سازی ایجاد نمی‌کند.
هنگام چاپ موارد، هیچ نشانه‌گذاری را جایگزین نمی‌کند؛ موارد دقیقاً همان‌طور که توسط فید RSS برگردانده شده‌اند چاپ می‌شوند.
از <file> به عنوان مسیر ذخیره‌سازی برای علامت‌گذاری موارد به عنوان خوانده‌شده استفاده می‌کند. این یک فایل باینری است.

نکته: تغییر این فایل، فایلی را که توسط قلاب pacman خوانده می‌شود تغییر نخواهد داد زیرا قلاب pacman با دسترسی ریشه (root) اجرا می‌شود؛ در صورتی که می‌خواهید آن را تغییر دهید، می‌توانید به صورت دستی با ویرایش فایل /usr/share/libalpm/hooks/00-informant.hook این کار را انجام دهید.

از <pager> برای نمایش موارد خبری استفاده می‌کند. این گزینه متغیر محیطی $INFORMANT_PAGER را بازنویسی می‌کند.
هنگام دریافت فیدها از حافظه پنهان (/var/cache/informant/) صرف‌نظر می‌کند (این کار احتمالاً منجر به دریافت کندتر فید اما نتایج به‌روزتر می‌شود). استفاده از این گزینه می‌تواند برای بررسی مشکلات اجرای informant ناشی از حافظه پنهان مفید باشد.
دایرکتوری حافظه پنهان (/var/cache/informant/) را پیش از دریافت فید(ها) خالی می‌کند.
فایل ذخیره‌سازی اخبار خوانده‌شده (به صورت پیش‌فرض /var/lib/informant.dat) را خالی می‌کند؛ این بدان معناست که هر مورد خبری که قبلاً خوانده شده و در فید بازگردانده می‌شود، باید دوباره خوانده شود. فید خبری تنها تعداد مشخصی از فایل‌ها را برمی‌گرداند و به مرور زمان ممکن است مواردی در فایل ذخیره‌سازی باقی بمانند که دیگر هنگام دریافت فید برگردانده نمی‌شوند؛ این گزینه می‌تواند برای پاکسازی فایل ذخیره‌سازی استفاده شود.

با پاک کردن فایل ذخیره‌سازی و سپس علامت‌گذاری همه موارد به عنوان خوانده‌شده، عملاً تمام موارد قدیمی را از فایل ذخیره‌سازی حذف می‌کنید:

informant --clear-readlist read --all
راهنما را چاپ کرده و خارج می‌شود.
اطلاعات نسخه را چاپ کرده و خارج می‌شود.

در صورت تنظیم بودن $INFORMANT_PAGER، مقدار آن به عنوان نام برنامه‌ای که برای نمایش موارد خبری استفاده می‌شود، به کار می‌رود.

برنامه Informant می‌تواند پیکربندی شود تا به جای فید اخبار آرچ لینوکس، چندین فید را بررسی کند (اینکه این کار واقعاً مفید است یا خیر بر عهده کاربر است). Informant به دنبال فایل informantrc.json در چند مکان می‌گردد و به این ترتیب آن‌ها را بررسی می‌کند:

- گزینه ارائه‌شده در خط فرمان (cfile)

- $HOME/.informantrc.json

- $XDG_CONFIG_HOME/informantrc.json

- /etc/informantrc.json

- به ازای هر دایرکتوری $d در $XDG_CONFIG_DIRS به دنبال $d/informantrc.json می‌گردد.

نکته: اگر می‌خواهید فایل پیکربندی در قلاب pacman استفاده شود، اطمینان حاصل کنید که از مسیر ذخیره‌سازی‌ای استفاده کنید که هنگام اجرای informant به صورت root/sudo قابل دسترسی باشد.

ساختار informantrc.json یک شیء JSON است که شامل یک کلید است: feeds که فهرستی است که فیدهایی را که می‌خواهید informant بررسی کند، توصیف می‌کند. هر فید به عنوان یک شیء JSON با کلیدهای زیر نمایش داده می‌شود:

برای نشان دادن اینکه هر مورد خبری از کدام فید است استفاده می‌شود.
نشانی اینترنتی (URL) فید.
پیش‌فرض آن title است؛ کلیدی که برای ارجاع به عنوان مورد خبری در فید استفاده می‌شود.
پیش‌فرض آن summary است؛ کلیدی که برای ارجاع به بدنه مورد خبری در فید استفاده می‌شود.
پیش‌فرض آن published است؛ کلیدی که برای ارجاع به تاریخ مورد خبری در فید استفاده می‌شود.

برای مثال، فایل informantrc.json زیر، informant را طوری پیکربندی می‌کند که فید اخبار آرچ لینوکس و همچنین فید اخبار Arch Linux 32 را بررسی کند:

{
    "feeds": [
        {
            "name": "Arch News",
            "url": "https://archlinux.org/feeds/news",
            "title-key": "title",
            "body-key": "summary",
            "timestamp-key": "published"
        },
        {
            "name": "Arch32 News",
            "url": "https://bbs.archlinux32.org/extern.php?action=feed&fid=12&type=atom",
            "title-key": "title",
            "body-key": "summary",
            "timestamp-key": "updated"
        }
    ]
}

Bradford Smith https://github.com/bradford-smith94

MIT

لطفاً اشکالات را در این نشانی گزارش دهید: https://github.com/bradford-smith94/informant/issues

alpm-hooks(5)

02 SEPTEMBER 2024 informant-v0.6.0