نام (NAME)

urlwatch - پایش صفحه‌های وب و خروجی دستورها برای تغییرات

خلاصه دستور (SYNOPSIS)

urlwatch [گزینه‌ها] [JOB ...]

توضیحات (DESCRIPTION)

ابزار urlwatch برای کمک به شما در پایش تغییرات صفحه‌های وب و دریافت اعلان (از طریق رایانامه، در ترمینال یا از طریق سرویس‌های شخص ثالث مختلف) به ازای هر تغییری طراحی شده است. اعلان تغییرات شامل نشانی وب (URL) تغییریافته و یک diff یکپارچه از تغییرات خواهد بود.

برای راهنمای شروع سریع و آموزش، urlwatch-intro(7) و برای دستورالعمل‌ها و ترفندهای استفاده، urlwatch-cookbook(7) را ببینید.

این صفحه‌ی راهنما به شرح ابزار خط فرمان (CLI) می‌پردازد.

آرگومان‌های مکانی:

JOB: شاخص‌ها یا برچسب‌های کار(ها) برای اجرا. اگر --tags تنظیم شده باشد، هر JOB یک برچسب است، در غیر این صورت، هر JOB یک شاخص شماره‌گذاری‌شده مطابق با دستور --list است.

آرگومان‌های اختیاری:

-h, --help: نمایش این پیام راهنما و خروج
--tags: استفاده از برچسب‌ها به جای شاخص‌ها برای انتخاب کارهای اجرایی
--version: نمایش شماره نگارش برنامه و خروج
-v, --verbose: نمایش خروجی اشکال‌زدایی

فایل‌ها و دایرکتوری‌ها:

--urls FILE: خواندن فهرست کارها (URLs) از FILE
--config FILE: خواندن پیکربندی از FILE
--hooks FILE: استفاده از FILE به عنوان ماژول hooks.py
--cache FILE: استفاده از FILE به عنوان پایگاه‌داده حافظه موقت (cache)

احراز هویت:

--smtp-login: ورود گذرواژه برای SMTP (ذخیره در دسته‌کلید keyring)
--xmpp-login: ورود گذرواژه برای XMPP (ذخیره در دسته‌کلید keyring)
--telegram-chats: فهرست کردن چت‌های تلگرامی که ربات در آن‌ها عضو است
--test-reporter REPORTER: ارسال یک اعلان آزمایشی

مدیریت فهرست کارها:

--list: فهرست کردن کارها
--add JOB: افزودن کار (key1=value1,key2=value2,...)
--delete JOB: حذف کار بر اساس مکان یا شاخص
--enable JOB: فعال کردن کار بر اساس مکان یا شاخص
--disable JOB: غیرفعال کردن کار بر اساس مکان یا شاخص

--change_location JOB NEW_LOCATION: تغییر مکان یک کار موجود بر اساس مکان یا شاخص

--test-filter JOB: آزمایش خروجی پالایه کار بر اساس مکان یا شاخص
--test-diff-filter JOB: آزمایش خروجی پالایه diff کار بر اساس مکان یا شاخص (نیاز به دست‌کم ۲ اسنپ‌شات دارد)
--dump-history JOB: تخلیه داده‌های ذخیره‌شده در حافظه موقت برای یک کار

دستورهای تعاملی ($EDITOR/$VISUAL):

--edit: ویرایش فهرست URL/کارها
--edit-config: ویرایش فایل پیکربندی
--edit-hooks: ویرایش اسکریپت قلاب‌ها (hooks)

متفرقه:

--features: فهرست کردن کارها/پالایه‌ها/گزارش‌دهنده‌های پشتیبانی‌شده
--gc-cache RETAIN_LIMIT: پاک‌سازی مدخل‌های قدیمی حافظه موقت و نگه‌داشتن آخرین RETAIN_LIMIT مورد (پیش‌فرض: 1)

فایل‌ها (FILES)

$XDG_CONFIG_HOME/urlwatch/urls.yaml: فهرست کارها و پالایه‌های پیکربندی‌شده؛ urlwatch-jobs(5) و urlwatch-filters(5) را ببینید
$XDG_CONFIG_HOME/urlwatch/urlwatch.yaml: تنظیمات سراسری و گزارش‌دهنده‌ها؛ urlwatch-config(5) و urlwatch-reporters(5) را ببینید
$XDG_CONFIG_HOME/urlwatch/hooks.py: یک ماژول Python 3 که می‌تواند انواع کارهای جدید، پالایه‌ها و گزارش‌دهنده‌ها را پیاده‌سازی کند
$XDG_CACHE_HOME/urlwatch/cache.db: یک پایگاه‌داده SQLite 3 (minidb) که تاریخچه وضعیت کارها را در بر دارد (برای مقایسه diff)

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

urlwatch-intro(7), urlwatch-cookbook(7), urlwatch-deprecated(7), urlwatch-jobs(5), urlwatch-filters(5), urlwatch-config(5), urlwatch-reporters(5)

نویسندگان (AUTHORS)

Thomas Perl https://thp.io

گزارش باگ‌ها (BUG TRACKER)

https://github.com/thp/urlwatch/issues

وبگاه (WEBSITE)

https://thp.io/2008/urlwatch

کپی‌رایت و تکثیر (COPYRIGHT)

2024 Thomas Perl