.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "URLWATCH-JOBS" "5" "28 اکتبر 2024" "urlwatch " "مستندات urlwatch"
.SH "نام (NAME)"
urlwatch-jobs \- انواع وظایف و پیکربندی برای urlwatch
.SH "خلاصه دستور (SYNOPSIS)"
.sp
urlwatch \-\-edit
.SH "توضیحات (DESCRIPTION)"
.sp
وظایف (Jobs) مواردی هستند که \fBurlwatch(1)\fP می‌تواند بر آن‌ها نظارت کند.
.sp
فهرست وظایف جهت اجرا در فایل پیکربندی \fBurls.yaml\fP قرار دارد که با دستور \fBurlwatch \-\-edit\fP قابل دسترسی است و هر وظیفه با خطی که تنها شامل \fB\-\-\-\fP است از وظیفه دیگر جدا می‌شود\&. دستور \fBurlwatch \-\-list\fP نام هر وظیفه را به همراه شماره اندیس آن (1, 2, 3, ...) که بر اساس موقعیت آن در فایل پیکربندی به صورت خودکار تخصیص داده می‌شود، چاپ می‌کند.
.sp
هرچند اختیاری است، اما توصیه می‌شود که هر وظیفه با یک مدخل \fBname\fP شروع شود:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
name: "این یک نام/برچسب خوانا برای انسان از وظیفه است"
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
انواع وظایف زیر در دسترس هستند:
.SH "نشانی وب (URL)"
.sp
این نوع اصلی وظیفه است \-\- سندی را از یک کارساز وب دریافت می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
name: "urlwatch homepage"
url: "https://thp.io/2008/urlwatch"
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
کلیدهای الزامی:
.INDENT 0.0
.IP \(bu 2
\fBurl\fP: نشانی وب سندی که باید برای تغییرات پایش شود
.UNINDENT
.sp
کلیدهای اختیاری مختص این نوع وظیفه:
.INDENT 0.0
.IP \(bu 2
\fBcookies\fP: کوکی‌هایی که همراه با درخواست ارسال می‌شوند (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBmethod\fP: متد HTTP مورد استفاده (پیش‌فرض: \fBGET\fP)
.IP \(bu 2
\fBdata\fP: داده‌های HTTP POST/PUT
.IP \(bu 2
\fBssl_no_verify\fP: اعتبارسنجی نکردن گواهی‌های SSL (true/false)
.IP \(bu 2
\fBignore_cached\fP: استفاده نکردن از مقادیر کنترل حافظه موقت (ETag/Last\-Modified) (true/false)
.IP \(bu 2
\fBhttp_proxy\fP: سرور پروکسی مورد استفاده برای درخواست‌های HTTP (می‌تواند http:// یا socks5:// باشد)
.IP \(bu 2
\fBhttps_proxy\fP: سرور پروکسی مورد استفاده برای درخواست‌های HTTPS (می‌تواند http:// یا socks5:// باشد)
.IP \(bu 2
\fBheaders\fP: هدرهای HTTP که باید همراه با درخواست ارسال شوند
.IP \(bu 2
\fBencoding\fP: بازنویسی رمزگذاری نویسه‌ها از سمت سرور (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBtimeout\fP: بازنویسی مهلت زمانی (timeout) پیش‌فرض سوکت (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBignore_connection_errors\fP: نادیده گرفتن خطاهای اتصال (موقتی) (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBignore_http_error_codes\fP: فهرستی از کدهای خطای HTTP برای نادیده گرفته شدن (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBignore_timeout_errors\fP: گزارش نکردن خطا در زمان رسیدن به مهلت زمانی (timeout)
.IP \(bu 2
\fBignore_too_many_redirects\fP: نادیده گرفتن حلقه‌های تغییر مسیر (redirect loops) (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBignore_incomplete_reads\fP: نادیده گرفتن پاسخ‌های ناقص HTTP (به مباحث پیشرفته مراجعه کنید)
.UNINDENT
.sp
(توجه: وجود \fBurl\fP بیانگر \fBkind: url\fP است)
.SH "مرورگر (BROWSER)"
.sp
این نوع وظیفه نوعی منبع‌بر از وظیفه "URL" است که برای مدیریت صفحاتی به کار می‌رود که نیازمند جاوااسکریپت برای رندر محتوای تحت پایش هستند.
.sp
بسته اختیاری \fIplaywright\fP باید نصب باشد تا بتوان وظایف مرورگر را اجرا کرد. همچنین باید مرورگرها را با استفاده از \fBplaywright install\fP نصب کنید (برای جزئیات به مستندات پلی‌رایت مراجعه کنید).
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
name: "یک صفحه دارای جاوااسکریپت"
navigate: "https://example.org"
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
کلیدهای الزامی:
.INDENT 0.0
.IP \(bu 2
\fBnavigate\fP: نشانی وب برای پیمایش با مرورگر
.UNINDENT
.sp
کلیدهای اختیاری مختص این نوع وظیفه:
.INDENT 0.0
.IP \(bu 2
\fBwait_until\fP: یکی از موارد \fBload\fP، \fBdomcontentloaded\fP، \fBnetworkidle\fP، یا \fBcommit\fP (به مباحث پیشرفته مراجعه کنید)
.IP \(bu 2
\fBwait_for\fP: یک انتخاب‌گر CSS یا XPath. این وظیفه به اندازه مهلت زمانی پیش‌فرض ۳۰ ثانیه منتظر خواهد ماند.
.IP \(bu 2
\fBuseragent\fP: هدر \fBUser\-Agent\fP برای درخواست‌ها (در غیر این صورت از پیش‌فرض مرورگر استفاده می‌شود)
.IP \(bu 2
\fBbrowser\fP: یکی از گزینه‌های \fBchromium\fP، \fBchrome\fP، \fBchrome\-beta\fP، \fBmsedge\fP، \fBmsedge\-beta\fP، \fBmsedge\-dev\fP، \fBfirefox\fP، \fBwebkit\fP (باید از طریق \fBplaywright install\fP نصب شده باشند)
.UNINDENT
.sp
از آنجا که این نوع وظیفه از \fIPlaywright\fP برای رندر صفحه در یک مرورگر بدون رابط کاربری (headless) استفاده می‌کند، منابع به مراتب بیشتری نسبت به وظیفه "URL" مصرف می‌کند. تنها در صفحاتی از آن استفاده کنید که \fBurl\fP نتایج صحیح را برنمی‌گرداند. در بسیاری از موارد، به جای استفاده از وظیفه "Browser"، می‌توانید از خروجی یک API که صفحه هنگام بارگذاری فراخوانی می‌کند استفاده کنید که اطلاعات مورد نظر شما را در بر دارد و از طریق وظیفه بسیار سریع‌تر "URL" قابل دریافت است.
.sp
(توجه: وجود \fBnavigate\fP بیانگر \fBkind: browser\fP است)
.SH "پوسته (SHELL)"
.sp
این نوع وظیفه به شما امکان می‌دهد بر خروجی دستورات دلخواه پوسته نظارت کنید، که مثلاً برای مانیتور کردن پوشه آپلودر FTP، خروجی اسکریپت‌هایی که دستگاه‌های خارجی (RPi GPIO) را بررسی می‌کنند و غیره مفید است...
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
name: "محتویات دایرکتوری خانگی من چیست؟"
command: "ls \-al ~"
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
کلیدهای الزامی:
.INDENT 0.0
.IP \(bu 2
\fBcommand\fP: دستور پوسته‌ای که باید اجرا شود
.UNINDENT
.sp
کلیدهای اختیاری مختص این نوع وظیفه:
.INDENT 0.0
.IP \(bu 2
\fBstderr\fP: تغییر نحوه برخورد با خروجی خطای استاندارد، به بخش زیر مراجعه کنید
.UNINDENT
.sp
(توجه: وجود \fBcommand\fP بیانگر \fBkind: shell\fP است)
.SS "پیکربندی رفتار stderr برای وظایف پوسته"
.sp
به طور پیش‌فرض urlwatch خروجی \fBstderr\fP را برای گزارش خطا (کد خروج غیر صفر) ضبط می‌کند، اما در صورتی که وظیفه پوسته با کد خروج 0 خارج شود، این خروجی را نادیده می‌گیرد.
.sp
این رفتار با استفاده از کلید \fBstderr\fP قابل سفارشی‌سازی است:
.INDENT 0.0
.IP \(bu 2
\fBignore\fP: ضبط \fBstderr\fP، گزارش در صورت کد خروج غیر صفر، و نادیده گرفتن در غیر این صورت (پیش‌فرض)
.IP \(bu 2
\fBurlwatch\fP: خروجی \fBstderr\fP وظیفه پوسته به \fBstderr\fP فرآیند \fBurlwatch\fP ارسال می‌شود؛ هیچ پیام خطایی در خروجی خطای استاندارد در پیام خطای گزارشگر نمایش داده نخواهد شد (رفتار پیش‌فرض قدیمی urlwatch نسخه 2.24 و قبل‌تر)
.IP \(bu 2
\fBfail\fP: ناموفق قلمداد کردن وظیفه در صورت وجود \fIهرگونه\fP خروجی در \fBstderr\fP، حتی با کد وضعیت خروج 0
.IP \(bu 2
\fBstdout\fP: ادغام خروجی \fBstderr\fP در \fBstdout\fP، به این معنی که خروجی خطای استاندارد نیز در بخش تشخیص تغییرات/diff برنامه urlwatch لحاظ می‌شود (مشابه \fB2>&1\fP در پوسته)
.UNINDENT
.sp
برای مثال، این تعریف وظیفه باعث می‌شود وظیفه ناموفق به نظر برسد، حتی اگر اسکریپت با کد خروج 0 پایان یابد:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
command: |
  echo "خروجی استاندارد معمولی."
  echo "مقداری متن در stderr که باعث شکست این وظیفه می‌شود." 1>&2
  exit 0
stderr: fail
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
از طرف دیگر، اگر می‌خواهید هر دو خروجی استاندارد و خطای استاندارد وظیفه را مقایسه (diff) کنید، از این پیکربندی استفاده نمایید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
command: |
  echo "یک خط مهم در stdout."
  echo "یک خط مهم دیگر در stderr." 1>&2
stderr: stdout
.ft P
.fi
.UNINDENT
.UNINDENT
.SH "کلیدهای اختیاری برای تمام انواع وظایف"
.INDENT 0.0
.IP \(bu 2
\fBname\fP: نام/برچسب خوانا برای انسان از وظیفه
.IP \(bu 2
\fBtags\fP: آرایه‌ای از برچسب‌ها، یا یک تک‌برچسب به عنوان رشته متنی
.IP \(bu 2
\fBfilter\fP: فیلترها (در صورت وجود) برای اعمال روی خروجی (با \fB\-\-test\-filter\fP قابل آزمایش است)
.IP \(bu 2
\fBmax_tries\fP: پس از این تعداد اجرای ناموفق متوالی، خطا به جای نادیده گرفته شدن گزارش خواهد شد
.IP \(bu 2
\fBdiff_tool\fP: دستور ابزار سفارشی برای تولید متن تغییرات (diff)
.IP \(bu 2
\fBdiff_filter\fP: فیلترها (در صورت وجود) برای اعمال روی نتیجه تغییرات (با \fB\-\-test\-diff\-filter\fP قابل آزمایش است)
.IP \(bu 2
\fBtreat_new_as_changed\fP: وظایفی که هیچ داده تاریخی قبلی ندارند را به جای \fBNEW\fP به عنوان \fBCHANGED\fP در نظر می‌گیرد (و برای وظایف جدید فایل تغییرات ایجاد می‌کند)
.IP \(bu 2
\fBcompared_versions\fP: تعداد نسخه‌ها برای مقایسه شباهت
.IP \(bu 2
\fBkind\fP (تکراری/افزونه): یکی از مقادیر \fBurl\fP، \fBshell\fP یا \fBbrowser\fP\&. به صورت خودکار از روی کلید اختصاصی نوع وظیفه (\fBurl\fP، \fBcommand\fP یا \fBnavigate\fP) مشتق می‌شود
.IP \(bu 2
\fBuser_visible_url\fP: نشانی وب متفاوتی برای نمایش در گزارش‌ها (مثلاً زمانی که نشانی مورد پایش یک REST API است، و می‌خواهید یک صفحه وب را نشان دهید)
.IP \(bu 2
\fBenabled\fP: می‌تواند روی false تنظیم شود تا یک وظیفه منفرد غیرفعال گردد (پیش‌فرض \fBtrue\fP است)
.UNINDENT
.SH "تنظیم کلیدها برای همه وظایف به طور همزمان"
.sp
فایل اصلی پیکربندی شامل کلیدی به نام \fBjob_defaults\fP است که می‌تواند برای پیکربندی کلیدها برای تمام وظایف به صورت یکجا استفاده شود.
.sp
برای نحوه پیکربندی مقادیر پیش‌فرض وظایف، به \fBurlwatch\-config(5)\fP مراجعه کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
برای مشاهده مثال‌های پیکربندی وظایف به \fBurlwatch\-cookbook(7)\fP مراجعه کنید.
.SH "فایل‌ها (FILES)"
.sp
\fB$XDG_CONFIG_HOME/urlwatch/urls.yaml\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBurlwatch(1)\fP,
\fBurlwatch\-intro(5)\fP,
\fBurlwatch\-filters(5)\fP
.SH "حق نشر (COPYRIGHT)"
2024 Thomas Perl
.\" Generated by docutils manpage writer.
.