.\" 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-CONFIG" "5" "Oct 28, 2024" "urlwatch " "urlwatch  Documentation"
.SH "نام (NAME)"
urlwatch-config \- پیکربندی رفتار urlwatch
.SH "خلاصه دستور (SYNOPSIS)"
.sp
urlwatch \-\-edit\-config
.SH "توضیحات (DESCRIPTION)"
.sp
پیکربندی سراسری urlwatch شامل تنظیمات پایه‌ای برای رفتار کلی urlwatch و همچنین گزارش‌دهنده‌ها (\fI\%Reporters\fP) است.
.SH "نمایش (DISPLAY)"
.sp
علاوه بر گزارش همیشگی تغییرات (که هدف اصلی urlwatch است)، urlwatch به‌طور پیش‌فرض صفحات تازه اضافه‌شده (\fBnew\fP) و خطاها (\fBerror\fP) را نیز گزارش می‌دهد. می‌توانید این رفتار را در بخش \fBdisplay\fP پیکربندی تغییر دهید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
display:
  new: true
  error: true
  unchanged: false
  empty\-diff: true
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
اگر \fBunchanged\fP را روی \fBtrue\fP تنظیم کنید، urlwatch همواره تمامی صفحاتی را که بررسی شده‌اند اما تغییر نکرده‌اند نیز گزارش می‌دهد.
.sp
تنظیمات \fBempty\-diff\fP مشخص می‌کند هنگامی که صفحه‌ای دچار تغییر می‌شود (\fBchanged\fP)، اما به عنوان مثال به دلیل استفاده از یک \fBdiff_filter\fP تفاوت آن به یک رشته خالی کاهش می‌یابد، چه واکنشی رخ دهد. اگر روی \fBtrue\fP تنظیم شود، urlwatch یک تغییر (خالی) را گزارش خواهد کرد. اگر روی \fBfalse\fP تنظیم شود، این تغییر در گزارش گنجانده نخواهد شد.
.SS "تغییرات فیلتر برای \fBunchanged\fP اعمال نمی‌شوند"
.sp
به دلیل شیوه ذخیره‌سازی خروجی فیلترشده، \fBunchanged\fP همواره محتوای قدیمی را همراه با فیلترهای زمان دریافت گزارش می‌کند؛ به این معنی که هرگونه تغییر در \fBfilter\fP یک وظیفه، در گزارش \fBunchanged\fP قابل مشاهده نخواهد بود. هنگامی که صفحه تغییر کند، فیلتر جدید اعمال خواهد شد.
.sp
به همین دلیل، از \fBunchanged\fP نمی‌توان برای آزمایش فیلترها استفاده کرد؛ باید از گزینه خط فرمان \fB\-\-test\-filter\fP استفاده کنید تا فیلتر فعلی بر محتوای جاری صفحه اعمال شود.
.SH "گزارش‌دهنده‌ها (REPORTERS)"
.sp
«گزارش‌دهنده‌ها» ماژول‌هایی هستند که در صورت فعال بودن از طریق پرونده پیکربندی، اعلان‌ها را از طریق رسانه مربوط به خود تحویل می‌دهند.
.sp
برای گزینه‌های اختصاصی هر گزارش‌دهنده، \fBurlwatch\-reporters(5)\fP را ببینید.
.sp
علاوه بر گزینه‌های خاص هر گزارش‌دهنده، تمامی گزارش‌دهنده‌ها از این گزینه‌ها پشتیبانی می‌کنند:
.INDENT 0.0
.IP \(bu 2
\fBenabled\fP: \fI[bool]\fP فعال‌سازی گزارش‌دهنده. (پیش‌فرض: False)
.IP \(bu 2
\fBseparate\fP: \fI[bool]\fP ارسال یک گزارش جداگانه برای هر وظیفه به‌جای یک گزارش ترکیبی برای تمام وظایف. (پیش‌فرض: False)
.UNINDENT
.sp
گزارش‌دهنده‌ها در یک ساختار سلسله‌مراتبی پیاده‌سازی شده‌اند، به‌طوری که تنظیمات پیکربندی مشترک بر تمامی گزارش‌دهنده‌های فرزند اعمال می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
html
text
├───stdout
├───email
├───ifttt
├───webservice
│   ├───pushover
│   └───pushbullet
├───mailgun
├───telegram
├───slack
│   └───mattermost
├───discord
├───xmpp
├───prowl
└───shell
markdown
├───matrix
└───gotify
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
تنظیم گزینه \fIhtml\fP در گزارش‌دهنده \fIemail\fP روی \fItrue\fP باعث ارث‌بری آن از پیکربندی \fIhtml\fP خواهد شد.
.UNINDENT
.UNINDENT
.sp
در اینجا یک نمونه پیکربندی آورده شده است که گزارش را به‌صورت رنگی در خروجی استاندارد و همچنین با استفاده از \fBsendmail\fP به‌صورت ایمیل HTML ارسال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
report:
  text:
    details: true
    footer: true
    line_length: 75
  html:
    diff: unified
    separate: true
  email:
    enabled: true
    method: sendmail
    sendmail:
        path: /usr/sbin/sendmail
    from: \(aqurlwatch@example.org\(aq
    to: \(aqyou@example.org\(aq
    html: true
    subject: \(aq{count} changes: {jobs}\(aq
  stdout:
    color: true
    enabled: true
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
هرگونه پیکربندی مربوط به یک گزارش‌دهنده خاص باید زیر کلید \fBreport\fP در پرونده پیکربندی قرار گیرد.
.SH "پیش‌فرض‌های وظیفه (JOB DEFAULTS)"
.sp
اگر می‌خواهید برخی تنظیمات را برای تمام وظایف خود تغییر دهید، بخش \fBjob_defaults\fP را در پرونده پیکربندی خود ویرایش کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
job_defaults:
  all:
    diff_tool: wdiff
  url:
    ignore_connection_errors: true
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
پرونده پیکربندی فوق تمام وظایف را برای استفاده از \fBwdiff\fP به عنوان ابزار تفاوت تنظیم می‌کند، و همه وظایف \fBurl\fP خطاهای اتصال را نادیده خواهند گرفت.
.sp
زیرکلیدهای معتبر برای \fBjob_defaults\fP عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBall\fP: بر تمام وظایف شما بدون در نظر گرفتن نوع آن‌ها اعمال می‌شود
.IP \(bu 2
\fBshell\fP: فقط بر وظایف \fBshell\fP اعمال می‌شود (با کلید \fBcommand\fP)
.IP \(bu 2
\fBurl\fP: فقط بر وظایف \fBurl\fP اعمال می‌شود (با کلید \fBurl\fP)
.IP \(bu 2
\fBbrowser\fP: فقط بر وظایف \fBbrowser\fP اعمال می‌شود (با کلید \fBnavigate\fP)
.UNINDENT
.sp
برای اطلاع از انواع مختلف وظایف و کلیدهای مجاز آن‌ها، \fI\%Jobs\fP را ببینید.
.SH "فایل‌ها (FILES)"
.sp
\fB$XDG_CONFIG_HOME/urlwatch/urlwatch.yaml\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBurlwatch(1)\fP,
\fBurlwatch\-reporters(5)\fP,
\fBurlwatch\-intro(7)\fP,
\fBurlwatch\-cookbook(7)\fP
.SH "حق نشر (COPYRIGHT)"
2024 Thomas Perl
.\" Generated by docutils manpage writer.
.