.\" 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-REPORTERS" "5" "Oct 28, 2024" "urlwatch " "urlwatch Documentation" .SH "نام (NAME)" urlwatch-reporters \- گزارش‌دهنده‌ها برای اعلان‌های تغییر .SH "خلاصه دستور (SYNOPSIS)" .sp urlwatch \-\-edit\-config .SH "توضیحات (DESCRIPTION)" .sp به‌طور پیش‌فرض \fBurlwatch(1)\fP اطلاعات مربوط به تغییرات را در خروجی استاندارد چاپ می‌کند که در صورت اجرای تعاملی، همان ترمینال شماست. در صورت اجرا از طریق \fBcron(8)\fP یا سرویس زمان‌بندی دیگر، نحوه نمایش به پیکربندی زمان‌بند بستگی دارد. .sp می‌توانید یک یا چند گزارش‌دهنده الحاقی را فعال کنید که برای ارسال اعلان‌های تغییر به کار می‌روند. لطفاً توجه داشته باشید که اکثر گزارش‌دهنده‌ها نیازمند نصب وابستگی‌های جانبی هستند. .sp برای تنظیمات عمومی پیکربندی، \fBurlwatch\-config(5)\fP را ببینید. .sp برای ارسال یک اعلان آزمایشی، از گزینه خط فرمان \fB\-\-test\-reporter\fP به همراه نام گزارش‌دهنده استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C urlwatch \-\-test\-reporter stdout .ft P .fi .UNINDENT .UNINDENT .sp این دستور یک گزارش آزمایشی با اعلان‌های \fBnew\fP، \fBchanged\fP، \fBunchanged\fP و \fBerror\fP ایجاد می‌کند (فقط مواردی که در بخش \fBdisplay\fP در پیکربندی تنظیم شده‌اند نمایش داده خواهند شد) و آن را از طریق گزارش‌دهنده \fBstdout\fP (در صورت فعال بودن) ارسال می‌نماید. .sp برای آزمایش صحت پیکربندی گزارش‌دهنده ایمیل، می‌توانید از دستور زیر استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C urlwatch \-\-test\-reporter email .ft P .fi .UNINDENT .UNINDENT .sp هر گزارش‌دهنده‌ای که پیکربندی و فعال شده باشد، قابل آزمایش است. .sp اگر ارسال اعلان کار نکرد، پیکربندی خود را بررسی کرده و/یا گزینه خط فرمان \fB\-\-verbose\fP را برای نمایش گزارش‌های اشکال‌زدایی با جزئیات اضافه کنید. .SH "گزارش‌دهنده‌های توکار (BUILT-IN REPORTERS)" .sp فهرست گزارش‌دهنده‌های توکار را می‌توان با استفاده از دستور زیر دریافت کرد: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C urlwatch \-\-features .ft P .fi .UNINDENT .UNINDENT .sp در حال حاضر، گزارش‌دهنده‌های زیر به‌صورت توکار موجود هستند: .INDENT 0.0 .IP \(bu 2 \fBdiscord\fP: ارسال پیام به کانال دیسکورد .IP \(bu 2 \fBemail\fP: ارسال خلاصه از طریق ایمیل / SMTP / sendmail .IP \(bu 2 \fBgotify\fP: ارسال پیام به سرور gotify .IP \(bu 2 \fBifttt\fP: ارسال خلاصه از طریق IFTTT .IP \(bu 2 \fBmailgun\fP: ارسال ایمیل از طریق سرویس Mailgun .IP \(bu 2 \fBmatrix\fP: ارسال پیام به یک اتاق با استفاده از پروتکل Matrix .IP \(bu 2 \fBmattermost\fP: ارسال پیام به کانال Mattermost .IP \(bu 2 \fBprowl\fP: ارسال اعلان دقیق از طریق prowlapp.com .IP \(bu 2 \fBpushbullet\fP: ارسال خلاصه از طریق pushbullet.com .IP \(bu 2 \fBpushover\fP: ارسال خلاصه از طریق pushover.net .IP \(bu 2 \fBshell\fP: هدایت (pipe) پیام به یک دستور شل .IP \(bu 2 \fBslack\fP: ارسال پیام به کانال اسلک .IP \(bu 2 \fBstdout\fP: چاپ خلاصه در خروجی استاندارد (کنسول) .IP \(bu 2 \fBtelegram\fP: ارسال پیام با استفاده از تلگرام .IP \(bu 2 \fBxmpp\fP: ارسال پیام با استفاده از پروتکل XMPP .UNINDENT .SH "سرویس PUSHOVER" .sp می‌توانید urlwatch را برای ارسال اعلان‌های بی‌درنگ درباره تغییرات از طریق \fI\%Pushover\fP <\fBhttps://pushover.net\fP> پیکربندی کنید. برای فعال‌سازی، مطمئن شوید که بسته پایتون \fBchump\fP نصب شده است. سپس فایل پیکربندی خود را ویرایش کرده (\fBurlwatch \-\-edit\-config\fP) و pushover را فعال کنید. همچنین باید کلید کاربری Pushover و یک کلید اختصاصی برنامه (تولیدشده با ثبت urlwatch در حساب کاربری Pushover در <\fBhttps://pushover.net/apps/build\fP>) را به پیکربندی اضافه نمایید. .sp می‌توانید با استفاده از نام دستگاه (همان‌طور که در کنسول Pushover هنگام افزودن یا مشاهده دستگاه‌ها نمایش داده می‌شود)، پیام را به یک دستگاه خاص بفرستید؛ برای مثال \fBdevice: \(aqMyPhone\(aq\fP یا \fBdevice: \(aqMyLaptop\(aq\fP. برای ارسال به \fIتمام\fR دستگاه‌ها، مقدار \fBdevice: null\fP را در پیکربندی (\fBurlwatch \-\-edit\-config\fP) تنظیم کنید یا پیکربندی device را به‌طور کامل حذف نمایید. .sp تنظیم اولویت از طریق گزینه پیکربندی \fBpriority\fP امکان‌پذیر است که می‌تواند \fBlowest\fP، \fBlow\fP، \fBnormal\fP، \fBhigh\fP یا \fBemergency\fP باشد. هر مقدار دیگری (شامل خالی گذاشتن آن) به \fBnormal\fP نگاشت می‌شود. .SH "سرویس PUSHBULLET" .sp اعلان‌های Pushbullet مشابه Pushover پیکربندی می‌شوند (به بالا مراجعه کنید). شما باید توکن دسترسی Pushbullet خود را که می‌توانید در نشانی <\fBhttps://www.pushbullet.com/#settings\fP> تولید کنید، به فایل پیکربندی بیفزایید. .SH "تلگرام (TELEGRAM)" .sp اعلان‌های تلگرام با استفاده از رابط برنامه‌نویسی ربات تلگرام (Telegram Bot API) پیکربندی می‌شوند. برای این کار به یک توکن Bot API و شناسه چت (chat id) نیاز دارید (به <\fBhttps://core.telegram.org/bots\fP> مراجعه کنید). نمونه پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C telegram: bot_token: \(aq999999999:3tOhy2CuZE0pTaCtszRfKpnagOG8IQbP5gf\(aq # your bot api token chat_id: \(aq88888888\(aq # the chat id where the messages should be sent enabled: true .ft P .fi .UNINDENT .UNINDENT .sp در صورتی که اعلان‌های بی‌صدا را ترجیح می‌دهید، پیام‌ها می‌توانند به‌صورت بی‌صدا (\fBsilent\fP) و همچنین با قالب قلم با عرض ثابت (\fBmonospace\fP) ارسال شوند. به‌طور پیش‌فرض اعلان‌ها بی‌صدا نیستند و هیچ قالب‌بندی انجام نمی‌شود. .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C telegram: # ... silent: true # message is sent silently monospace: true # display message as pre\-formatted code block .ft P .fi .UNINDENT .UNINDENT .sp برای راه‌اندازی تلگرام، از درون برنامه تلگرام خود، با BotFather گفتگو را آغاز کنید (پیام جدید، جستجوی “BotFather”)، سپس عبارت \fB/newbot\fP را بفرستید و دستورالعمل‌ها را دنبال کنید. در نهایت توکن ربات به شما داده می‌شود (در قالب \fB:\fP همان‌طور که در بالا دیده می‌شود)؛ این مقدار را به فایل پیکربندی خود اضافه کنید. .sp سپس می‌توانید روی لینک ربات خود کلیک کنید تا پیام \fB/start\fP ارسال شود. در این مرحله می‌توانید از دستور \fBurlwatch \-\-telegram\-chats\fP برای فهرست کردن چت‌های خصوصی که ربات در آن‌ها عضو است استفاده نمایید. این همان شناسه چتی است که باید در فایل پیکربندی تحت عنوان \fBchat_id\fP قرار دهید. همچنین می‌توانید چندین شناسه چت را در قالب یک فهرست YAML وارد کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C telegram: bot_token: \(aq999999999:3tOhy2CuZE0pTaCtszRfKpnagOG8IQbP5gf\(aq # your bot api token chat_id: \- \(aq11111111\(aq \- \(aq22222222\(aq enabled: true .ft P .fi .UNINDENT .UNINDENT .sp فراموش نکنید که گزارش‌دهنده را نیز فعال نمایید. .SH "اسلک (SLACK)" .sp اعلان‌های اسلک با استفاده از وب‌هوک‌های ورودی اسلک (“Slack Incoming Webhooks”) پیکربندی می‌شوند. نمونه‌ای از پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C slack: webhook_url: \(aqhttps://hooks.slack.com/services/T50TXXXXXU/BDVYYYYYYY/PWTqwyFM7CcCfGnNzdyDYZ\(aq enabled: true .ft P .fi .UNINDENT .UNINDENT .sp برای راه‌اندازی اسلک، از تیم اسلک خود یک برنامه جدید ایجاد کرده و “Incoming Webhooks” را روی یک کانال فعال کنید؛ نشانی اینترنتی وب‌هوک را دریافت کرده و همان‌طور که در بالا نشان داده شده در پیکربندی کپی کنید. .SH "ماترموست (MATTERMOST)" .sp اعلان‌های Mattermost به همان شیوه اعلان‌های Slack راه‌اندازی می‌شوند، نشانی وب‌هوک متفاوت است: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C mattermost: webhook_url: \(aqhttp://{your\-mattermost\-site}/hooks/XXXXXXXXXXXXXXXXXXXXXX\(aq enabled: true .ft P .fi .UNINDENT .UNINDENT .sp برای جزئیات بیشتر به بخش مستندات ماترموست در <\fBhttps://developers.mattermost.com/integrate/incoming-webhooks\fP> مراجعه فرمایید. .SH "دیسکورد (DISCORD)" .sp اعلان‌های دیسکورد با استفاده از وب‌هوک‌های ورودی دیسکورد (“Discord Incoming Webhooks”) پیکربندی می‌شوند. نمونه‌ای از پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C discord: webhook_url: \(aqhttps://discordapp.com/api/webhooks/11111XXXXXXXXXXX/BBBBYYYYYYYYYYYYYYYYYYYYYYYyyyYYYYYYYYYYYYYY\(aq enabled: true embed: true colored: true subject: \(aq{count} changes: {jobs}\(aq .ft P .fi .UNINDENT .UNINDENT .sp برای راه‌اندازی دیسکورد، از بخش تنظیمات سرور دیسکورد خود (Server Settings)، بخش Integration را انتخاب کرده و سپس یک “New Webhook” بسازید، نامی برای انتشار پیام‌ها به آن اختصاص دهید، یک کانال را برگزینید، گزینه “Copy Webhook URL” را بزنید و آن را همانند بالا در فایل پیکربندی جای‌گذاری کنید. .sp محتوای تعبیه‌شده (Embedded) ممکن است خواندن و تشخیص گزارش‌های مجزا را ساده‌تر سازد. موضوع (Subject) قبل از گزارش تعبیه‌شده قرار می‌گیرد و تنها زمانی استفاده می‌شود که \fIembed\fP برابر با true باشد. .sp هنگامی که \fIcolored\fP برابر true باشد، گزارش‌ها در یک بلوک کد (با ساختار دستوری diff) تعبیه می‌شوند تا رنگ‌ها فعال شوند. .SH "گروه GOTIFY" .sp گروه Gotify در نشانی <\fBhttps://gotify.net\fP> سروری برای ارسال و دریافت پیام‌ها به‌صورت بی‌درنگ از طریق وب‌سوکت است. .sp برای ارسال اعلان‌ها به یک سرور gotify به یک توکن برنامه (application token) نیاز دارید. .sp می‌توانید یکی از آن‌ها را به این صورت برای urlwatch ایجاد کنید: .INDENT 0.0 .IP 1. 3 به رابط کاربری وب سرور gotify خود وارد شوید. .IP 2. 3 به برگه “APPS” بروید. .IP 3. 3 روی دکمه “CREATE APPLICATION” کلیک کنید. .UNINDENT .sp ۴. فیلدها را پر کرده و دکمه “CREATE” را فشار دهید. ۶. روی آیکون چشم مدخل تازه‌تأسیس کلیک کرده و توکن را کپی کنید. .sp نمونه‌ای از پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C gotify: enabled: true priority: 4 server_url: \(dqhttp://127.0.0.1:8090\(dq title: null token: \(dqAa1yyikLFjEm35A\(dq .ft P .fi .UNINDENT .UNINDENT .SH "سرویس IFTTT" .sp برای پیکربندی رویدادهای IFTTT، باید کلید خود را از اینجا دریافت کنید: .sp \fI\%https://ifttt.com/maker_webhooks/settings\fP .sp نشانی اینترنتی نمایش‌داده‌شده در “Account Info” دارای قالب زیر است: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C https://maker.ifttt.com/use/{key} .ft P .fi .UNINDENT .UNINDENT .sp در این نشانی اینترنتی، \fB{key}\fP کلید API شماست. پیکربندی باید به این شکل باشد (می‌توانید هر نام رویدادی را که مایلید انتخاب کنید): .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C ifttt: enabled: true key: aA12abC3D456efgHIjkl7m event: event_name_you_want .ft P .fi .UNINDENT .UNINDENT .sp رویداد شامل سه مقدار در JSON ارسال‌شده خواهد بود: .INDENT 0.0 .IP \(bu 2 \fBvalue1\fP: نوع تغییر (\fBnew\fP، \fBchanged\fP، \fBunchanged\fP یا \fBerror\fP) .IP \(bu 2 \fBvalue2\fP: نام وظیفه (کلید \fBname\fP در \fBjobs.yaml\fP) .IP \(bu 2 \fBvalue3\fP: مکان وظیفه (کلید \fBurl\fP، \fBcommand\fP یا \fBnavigate\fP در \fBjobs.yaml\fP) .UNINDENT .sp این مقادیر به بخش Action در Recipe شما ارسال خواهند شد. .SH "پروتکل MATRIX" .sp می‌توانید اعلان‌ها را از طریق پروتکل ماتریس <\fBhttps://matrix.org\fP> برای خود ارسال کنید. .sp برای دستیابی به این هدف، ابتدا باید یک حساب Matrix برای ربات در هر سرور خانگی (homeserver) ثبت کنید. .sp سپس باید با استفاده از دستورالعمل‌های زیر، توکن دسترسی و شناسه اتاق را به دست آورید: .INDENT 0.0 .IP 1. 3 نشانی <\fBhttps://riot.im/app\fP> را در یک پنجره مرور خصوصی (Private Browsing) باز کنید. .IP 2. 3 با استفاده از شناسه کاربری و گذرواژه ربات، به عنوان ربات خود ثبت‌نام کرده/وارد شوید. .IP 3. 3 در صورت تمایل، نام نمایشی و آواتار را تنظیم کنید. .IP 4. 3 در صفحه تنظیمات، برگه “Help & About” را انتخاب کنید، به پایین صفحه رفته و روی عبارت Access Token: کلیک کنید. .IP 5. 3 متن نمایان‌شده را در پیکربندی خود کپی کنید. .IP 6. 3 به اتاقی که مایلید اعلان‌ها به آن ارسال شود ملحق شوید. .IP 7. 3 به بخش Room Settings (آیکون چرخ‌دنده) رفته و مقدار \fIInternal Room ID\fP را از پایین صفحه کپی نمایید. .IP 8. 3 پنجره مرور خصوصی را ببندید، \fBاما از حساب خارج (Log out) نشوید، زیرا این کار توکن دسترسی را باطل می‌کند\fP. .UNINDENT .sp نمونه‌ای از پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C matrix: homeserver: https://matrix.org access_token: \(dqYOUR_TOKEN_HERE\(dq room_id: \(dq!roomroomroom:matrix.org\(dq enabled: true .ft P .fi .UNINDENT .UNINDENT .sp اگر قصد دارید اعلان‌های تغییر را در یک اتاق عمومی Matrix منتشر کنید، احتمالاً تمایل خواهید داشت از پیکربندی زیر برای گزارش‌دهنده \fBmarkdown\fP استفاده نمایید، زیرا پیام‌ها به‌سرعت شلوغ و پر سر و صدا می‌شوند: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C markdown: details: false footer: false minimal: true enabled: true .ft P .fi .UNINDENT .UNINDENT .SH "ایمیل از طریق SENDMAIL" .sp می‌توانید با استفاده از دستور \fBsendmail\fP ارائه‌شده توسط MTA سیستم، ایمیل بفرستید. باید مقدار \fBmethod: sendmail\fP را در فایل پیکربندی تنظیم کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C report: email: enabled: true from: \(aqpostmaster@example.com\(aq to: \(aqrecipient@bar.com\(aq method: sendmail .ft P .fi .UNINDENT .UNINDENT .SH "ایمیل از طریق GMAIL SMTP" .sp باید حساب کاربری GMail خود را به گونه‌ای پیکربندی کنید که به برنامه‌های «کم‌امنیت‌تر» (مبتنی بر گذرواژه) اجازه ورود دهد: .INDENT 0.0 .IP 1. 3 به نشانی <\fBhttps://myaccount.google.com\fP> بروید. .IP 2. 3 روی “Sign\-in & security” کلیک کنید. .IP 3. 3 به پایین صفحه به بخش “Allow less secure apps” رفته و آن را فعال کنید. .UNINDENT .sp شما نباید این کار را روی حساب اصلی جیمیل خود انجام دهید، بلکه روی حساب جداگانه‌ای که فقط برای ارسال نامه‌های urlwatch ایجاد می‌کنید این کار را بکنید. مجاز کردن برنامه‌های با امنیت کمتر و ذخیره گذرواژه برای حساب اصلی شما یک رویه امنیتی خوب نیست. .sp اکنون، ویرایشگر پیکربندی را باز کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C urlwatch \-\-edit\-config .ft P .fi .UNINDENT .UNINDENT .sp این‌ها کلیدهایی هستند که باید پیکربندی کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C report: email: enabled: true from: your.username@gmail.com to: your.destination.email@example.com method: smtp smtp: host: smtp.gmail.com auth: true port: 587 starttls: true .ft P .fi .UNINDENT .UNINDENT .sp بهتر است گذرواژه در جاکلیدی (keychain) شما ذخیره شود و نه در فایل پیکربندی. برای ذخیره گذرواژه، دستور زیر را اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C urlwatch \-\-smtp\-login .ft P .fi .UNINDENT .UNINDENT .sp این دستور گذرواژه شما را جویا شده، ورود به سیستم را اعتبارسنجی کرده و آن را در جاکلیدی شما ذخیره می‌کند. اجراهای بعدی از این گذرواژه برای ورود استفاده خواهند کرد. .SH "ایمیل از طریق سرویس AMAZON SES" .sp مشابه پیکربندی GMail در بالا است، اما برای مثال از \fBemail\-smtp.us\-west\-2.amazonaws.com\fP به عنوان میزبان SMTP، و تنظیمات نام کاربری و پورت مطابق با صفحه ورود SES استفاده کنید. .SH "ورود به SMTP بدون جاکلیدی (SMTP LOGIN WITHOUT KEYRING)" .sp اگر به هر دلیلی نمی‌توانید از یک جا‌کلیدی برای ذخیره گذرواژه خود استفاده کنید (به عنوان مثال، هنگام اجرای آن از طریق یک تسک \fBcron\fP)، می‌توانید گزینه \fBinsecure_password\fP را در پیکربندی SMTP تنظیم نمایید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C report: email: smtp: auth: true insecure_password: secret123 .ft P .fi .UNINDENT .UNINDENT .sp کلید \fBinsecure_password\fP نسبت به داده‌های ذخیره‌شده در جاکلیدی اولویت خواهد داشت. توجه داشته باشید همان‌طور که از نام آن مشخص است، ذخیره گذرواژه به‌صورت متن آشکار در فایل پیکربندی ناامن بوده و روش نادرستی است، اما برای یک حساب ایمیل که صرفاً برای ارسال ایمیل‌ها اختصاص یافته، ممکن است یک راهکار باشد. \fBهرگز و تحت هیچ شرایطی از این گزینه برای حساب اصلی ایمیل خود استفاده نکنید!\fP واقعاً! یک حساب یک‌بارمصرف جیمیل (یا سرویس دیگر) بسازید یا از \fBsendmail\fP محلی به همراه یک میل‌سرور پیکربندی‌شده استفاده کنید. .sp توجه داشته باشید که این کار باعث می‌شود استخراج گذرواژه شما توسط نرم‌افزارهای در حال اجرا روی سیستم، توسط سایر کاربران واردشده به سیستم و یا ثبت تصادفی در فایل‌های گزارش وقایع بسیار آسان شود. .SH "پروتکل XMPP" .sp می‌توانید اعلان‌ها را از طریق پروتکل \fIXMPP\fP دریافت کنید. .sp برای انجام این کار، باید یک حساب XMPP جدید ثبت کنید که فقط برای urlwatch استفاده شود. .sp نمونه‌ای از پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C xmpp: enabled: true sender: \(dqBOT_ACCOUNT_NAME\(dq recipient: \(dqYOUR_ACCOUNT_NAME\(dq .ft P .fi .UNINDENT .UNINDENT .sp گذرواژه در فایل پیکربندی ذخیره نمی‌شود، بلکه در جاکلیدی شما نگهداری می‌شود. جهت ذخیره گذرواژه، دستور \fBurlwatch \-\-xmpp\-login\fP را اجرا کرده و گذرواژه خود را وارد کنید. .sp اگر به هر دلیلی نمی‌توانید از یک جاکلیدی برای ذخیره گذرواژه خود استفاده نمایید، می‌توانید گزینه \fBinsecure_password\fP را در پیکربندی XMPP قرار دهید. برای اطلاعات بیشتر در خصوص پیامدهای امنیتی، بخش «ورود به SMTP بدون جاکلیدی» را ببینید. .SH "سرویس PROWL" .sp می‌توانید از طریق سرویس اعلان لحظه‌ای (push notification) \fIProwl\fP اعلان‌ها را دریافت کنید تا روی دستگاه‌های با سیستم‌عامل iOS نمایش داده شوند. .sp برای دستیابی به این هدف، باید یک حساب کاربری جدید در Prowl ثبت کرده و برنامه Prowl را روی دستگاه iOS خود نصب کرده باشید. .sp جهت ساخت یک کلید API برای urlwatch: .INDENT 0.0 .IP 1. 3 به وب‌سایت Prowl در نشانی <\fBhttps://prowlapp.com\fP> وارد شوید. .IP 2. 3 به برگه “API Keys” بروید. .IP 3. 3 به بخش “Generate a new API key” پیمایش کنید. .IP 4. 3 یک یادداشت برای کلید بگذارید تا به شما یادآوری کند از آن برای urlwatch استفاده کرده‌اید. .IP 5. 3 دکمه “Generate Key” را فشار دهید. .IP 6. 3 کلید حاصل را کپی نمایید. .UNINDENT .sp نمونه‌ای از پیکربندی: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C prowl: enabled: true api_key: \(aq\(aq priority: 2 application: \(aqurlwatch example\(aq subject: \(aq{count} changes: {jobs}\(aq .ft P .fi .UNINDENT .UNINDENT .sp فیلد “subject” مشابه با فیلد موضوع در ایمیل است و به عنوان نام رویداد Prowl استفاده خواهد شد. مقدار application به رویداد افزوده شده و در برنامه Prowl به عنوان منبع رویداد نشان داده می‌شود. .SH "شل (SHELL)" .sp این یک گزارش‌دهنده ساده است که اعلان گزارش متنی را به یک دستور به انتخاب شما هدایت (pipe) می‌کند. این دستور با استفاده از تابع پایتون \fI\%subprocess.Popen()\fP با آرگومان \fBshell=False\fP (برای جلوگیری از بسط ناخواسته شل) اجرا می‌شود. البته می‌توانید اسکریپت شل اختصاصی خود را بسازید و آن را از طریق \fBcommand\fP فراخوانی کنید. .sp کلید \fBignore_stdout\fP (پیش‌فرض: \fBtrue\fP) می‌تواند برای نادیده گرفتن هرگونه خروجی برنامه در خروجی استاندارد استفاده شود. کلید \fBignore_stderr\fP (پیش‌فرض: \fBfalse\fP) می‌تواند برای نادیده گرفتن هرگونه خروجی برنامه در خطای استاندارد استفاده شود. .sp اگر stdout/stderr نادیده گرفته نشوند، urlwatch هر خروجی احتمالی را در لاگ‌های \fB\-\-verbose\fP خود ثبت می‌کند. .sp گزارشی که به ورودی استاندارد (\fBstdin\fP) فرآیند فرستاده می‌شود بر اساس خروجی گزارش‌دهنده \fBtext\fP است؛ پیکربندی گزارش‌دهنده متنی داده‌های ارسالی به گزارش‌دهنده \fBshell\fP را تنظیم می‌کند. .sp برای مثال، برای افزودن ساده گزارش‌ها به انتهای یک فایل، آن را به این صورت پیکربندی کنید: .INDENT 0.0 .INDENT 3.5 .sp .nf .ft C shell: enabled: true command: [\(aqtee\(aq, \(aq\-a\(aq, \(aq/path/to/log.txt\(aq] ignore_stdout: true .ft P .fi .UNINDENT .UNINDENT .SH "فایل‌ها (FILES)" .sp \fB$XDG_CONFIG_HOME/urlwatch/urlwatch.yaml\fP .SH "همچنین ببینید (SEE ALSO)" .sp \fBurlwatch(1)\fP, \fBurlwatch\-config(5)\fP, \fBurlwatch\-intro(7)\fP, \fBurlwatch\-cookbook(7)\fP .SH "حق نشر (COPYRIGHT)" 2024 Thomas Perl .\" Generated by docutils manpage writer. .