.\" Hey, EMACS: -*- nroff -*- .TH URLSCAN 1 "16 August 2026" .SH "نام (NAME)" urlscan \- مرور URLها در یک پیام ایمیل از درون ترمینال .SH "خلاصه دستور (SYNOPSIS)" \fBurlscan\fR [options] < .I message \fBurlscan\fR [options] .I message .SH "توضیحات (DESCRIPTION)" دستور \fBurlscan\fR یک پیام ایمیل منفرد را از ورودی استاندارد دریافت می‌کند، سپس فهرستی مبتنی بر ترمینال از URLهای موجود در پیام داده‌شده را نمایش می‌دهد. انتخاب یک URL از ماژول webbrowser پایتون برای تعیین این‌که کدام مرورگر باز شود استفاده می‌کند. در صورت تنظیم بودن، از متغیر محیطی \fBBROWSER\fR استفاده خواهد شد. دستور \fBurlscan\fR در درجه اول برای استفاده به همراه برنامه ایمیل‌خوان .B mutt (1) در نظر گرفته شده است، اما با هر برنامه ایمیل مبتنی بر ترمینال دیگری نیز به خوبی کار می‌کند. دستور \fBurlscan\fR شبیه به \fBurlview\fR(1) است، اما ویژگی‌های اضافی زیر را به همراه دارد: \fB1.\fR پشتیبانی از کدگذاری‌های بیشتر پیام، مانند quoted-printable و base64. \fB2.\fR استخراج و نمایش متن زمینه (context) پیرامون هر URL. تغییر وضعیت نمایش زمینه با کلید \fBc\fR. معکوس کردن ترتیب نمایش URLها با کلید \fBR\fR. \fB3.\fR رونوشت URL جاری به انتخاب اصلی (primary selection) با کلید \fBP\fR یا به کلیپ‌بورد با کلید \fBC\fR. \fB4.\fR پیوندها (URLها) به طور پیش‌فرض کوتاه می‌شوند تا در یک خط جا بگیرند. تغییر وضعیت کوتاه شدن یک یا تمام URLها با کلیدهای \fBs\fR یا \fBS\fR. \fB5.\fR جستجوی افزایشی و غیرحساس به حروف بزرگ و کوچک با استفاده از \fB/\fR. پانویس عبارت جستجوی فعلی را نشان می‌دهد. فشردن مجدد \fB/\fR جستجو را بازنشانی می‌کند. \fB6.\fR جابجایی چرخشی میان تمام پالت‌های رنگی موجود (رنگی و سیاه‌وسفید به طور پیش‌فرض موجود هستند) با استفاده از \fBp\fR. اجرای \fBurlscan \-g\fR یک فایل ~/.config/urlscan/config.json برای ویرایش یا افزودن پالت‌ها و کلیدهای میانبر اضافی تولید می‌کند. برای گزینه‌های رنگی و مقادیر مجاز به نشانی زیر مراجعه کنید: http://urwid.org/manual/displayattributes.html#display-attributes عرض نمایش را با `--width` تعیین کنید. \fB7.\fR کلید \fBu\fR در صورت نیاز نویسه‌های گریز (unescape) را از URL مشخص‌شده حذف می‌کند. \fB8.\fR اجرای یک دستور با قرار دادن URL انتخابی به عنوان آرگومان، یا هدایت (pipe) کردن URL انتخابی به یک دستور با استفاده از آرگومان‌های \fB--run-safe\fR، \fB--run\fR و \fB--pipe\fR. \fB9.\fR استفاده از \fBl\fR برای جابجایی چرخشی میان روش‌های باز شدن URLها از طریق ماژول webbrowser پایتون (پیش‌فرض)، xdg-open (در صورت نصب بودن) یا تابعی که در خط فرمان با \fB--run-safe\fR یا \fB--run\fR ارسال شده است. توابع \fB--run\fR و \fB--run-safe\fR مقدار \fB--pipe\fR را رعایت خواهند کرد. \fB10.\fR کلید \fBF1\fR منوی راهنما را نمایش می‌دهد. \fB11.\fR پویش سرآیندهای خاص ایمیل برای یافتن URLها. در حال حاضر هنگام ارسال \fB--headers\fR سرآیندهای \fBLink\fR، \fBArchived-At\fR و \fBList-*\fR پویش می‌شوند. \fB12.\fR قرار دادن چندین URL در صف برای باز کردن و باز کردن هم‌زمان همه آن‌ها با کلیدهای \fBa\fR و \fBo\fR. .SH "گزینه‌ها (OPTIONS)" .TP .BR \-c ", " \-\-compact حالت نمایش فشرده؛ متن زمینه (context) پیرامون هر URL را نشان نمی‌دهد. .TP .B \-d, \-\-dedupe حذف URLهای تکراری از فهرست URLها. .TP .B \-E, \-\-regex \ استفاده از \ به جای مجموعه پیش‌فرض عبارت‌های منظم (regular expressions)، برای هر نوع تطبیق. این گزینه مثلاً در مواردی مفید است که بخواهید پیوندهای 'mailto:' یا هر الگوی دیگری که ممکن است urlscan به عنوان URL تفسیر کند (مانند '.') را نادیده بگیرید. مثال کاربرد: $ urlscan --regex 'https?://.+\.\w+' file.txt .TP .B \-f, \-\-run\-safe \ اجرای \ به جای باز کردن URL با مرورگر. از {} در \ برای جایگذاری URL استفاده کنید. مثال‌ها: $ urlscan --run-safe 'tmux set buffer {}' .TP .B \-g, \-\-genconf تولید ~/.config/urlscan/config.json با گزینه‌های پیش‌فرض. .TP .B \-H, \-\-nohelp شروع برنامه با پنهان بودن منوی سرآیند. .TP .BR \-\-headers پویش سرآیندهای خاص پیام برای یافتن URLها. در حال حاضر Link، Archived-At و List-* پویش می‌شوند. .TP .B \-n, \-\-no-browser غیرفعال کردن رابط انتخاب و چاپ پیوندها در خروجی استاندارد. مفید برای اسکریپت‌نویسی (گزینه \fB\-\-compact\fR را اعمال می‌کند). .TP .B \-p, \-\-pipe هدایت (pipe) کردن URL انتخابی به دستوری که توسط `--run-safe` یا `--run` تعیین شده است. در صورتی که دستور پشتیبانی کند، این روش ترجیح داده می‌شود زیرا امن‌تر بوده و نسبت به نویسه‌های خاص موجود در URL سازگارتر است. مثال: $ urlscan --run-safe 'xclip -i' --pipe file.txt .TP .B \-R, \-\-reverse معکوس کردن ترتیب نمایش URLها. .TP .B \-r, \-\-run \ اجرای \ به جای باز کردن URL با مرورگر. از {} در \ برای جایگذاری URL استفاده کنید. ویژگی‌های پوسته مانند | و \> قابل استفاده هستند، اما امنیت کمتری دارد. مثال‌ها: $ urlscan --run 'echo {} | xclip -i' file.txt .TP .B \-s, \-\-single خروج از urlscan پس از باز کردن یا رونوشت گرفتن از یک پیوند منفرد مرورگر. $ urlscan -s file.txt .TP .B \-w, \-\-width تنظیم عرض نمایش. .TP .BR \-W ", " \-\-whitespace\-off خط‌های خالی و نشانه‌های تعلیق (...) نمایش داده نشوند. .TP .BR \-C ", " \-\-colors " {true,256,88,16,8,mono}" تنظیم حالت رنگ urwid. پیش‌فرض "16" است. "true" برابر با 2**24 رنگ و "mono" برابر با ۱ رنگ است. .TP .BR \-V ", " \-\-version چاپ نسخه urlscan. .SH "یکپارچه‌سازی با MUTT (MUTT INTEGRATION)" برای یکپارچه‌سازی urlscan با mutt، دو دستور زیر را در \fB~/.muttrc\fR قرار دهید: .ad l macro index,pager \\cb " urlscan" "call urlscan to extract URLs out of a message" macro attach,compose \\cb " urlscan" "call urlscan to extract URLs out of a message" .ad b پس از قرار گرفتن این خطوط در فایل پیکربندی mutt، فشردن Control-b به شما امکان می‌دهد پیوندهای موجود در پیام انتخاب‌شده را مرور کرده و باز کنید. به عنوان روش جایگزین، می‌توانید پیام را با استفاده از عملگر '|' به urlscan هدایت (pipe) کنید. این کار می‌تواند برای اعمال پرچم‌های مختلف (مانند گزینه‌های '-d' یا '-c') مفید باشد. .SH "کلیدهای میانبر (KEYBINDINGS)" دستور \fBurlscan \-g\fR را اجرا کنید تا ~/.config/urlscan/config.json تولید شود. همه کلیدها فهرست خواهند شد. می‌توانید مواردی را که تغییری نمی‌کنند همان‌طور باقی بگذارید یا حذف کنید. برای لغو انتساب یک کلید، آن را برابر "" قرار دهید. برای مثال: \fB"P": ""\fR عملیات زیر پشتیبانی می‌شوند: .TP \fBadd_url\fR \-\- افزودن یک URL به صف (پیش‌فرض: \fBa\fR) .TP \fBall_escape\fR \-\- تغییر وضعیت حذف نویسه‌های گریز (unescape) از همه URLها (پیش‌فرض: \fBu\fR) .TP \fBall_shorten\fR \-\- تغییر وضعیت کوتاه کردن تمام URLها (پیش‌فرض: \fBS\fR) .TP \fBbottom\fR \-\- انتقال مکان‌نما به آخرین مورد (پیش‌فرض: \fBG\fR) .TP \fBclear_screen\fR \-\- ترسیم مجدد صفحه (پیش‌فرض: \fBCtrl-l\fR) .TP \fBclipboard\fR \-\- رونوشت URL مشخص‌شده به کلیپ‌بورد با استفاده از xsel/xclip (پیش‌فرض: \fBC\fR) .TP \fBclipboard_pri\fR \-\- رونوشت URL مشخص‌شده به انتخاب اصلی (primary selection) با استفاده از xsel/xclip (پیش‌فرض: \fBP\fR) .TP \fBcontext\fR \-\- نمایش/پنهان‌سازی زمینه پیرامون (پیش‌فرض: \fBc\fR) .TP \fBdel_url\fR \-\- حذف URL از صف (پیش‌فرض: \fBd\fR) .TP \fBdown\fR \-\- حرکت مکان‌نما به پایین (پیش‌فرض: \fBj\fR) .TP \fBhelp_menu\fR \-\- نمایش/پنهان‌سازی منوی راهنما (پیش‌فرض: \fBF1\fR) .TP \fBlink_handler\fR \-\- جابجایی چرخشی روش باز کردن پیوند (webbrowser، xdg-open یا سفارشی) (پیش‌فرض: \fBl\fR) .TP \fBnext\fR \-\- پرش به URL بعدی (پیش‌فرض: \fBJ\fR) .TP \fBopen_queue\fR \-\- باز کردن تمام URLهای موجود در صف (پیش‌فرض: \fBo\fR) .TP \fBopen_queue_win\fR \-\- باز کردن تمام URLهای موجود در صف در پنجره‌ای جدید (پیش‌فرض: \fBO\fR) .TP \fBopen_url\fR \-\- باز کردن URL انتخاب‌شده (پیش‌فرض: \fBspace\fR یا \fBenter\fR) .TP \fBpalette\fR \-\- جابجایی چرخشی میان پالت‌ها (پیش‌فرض: \fBp\fR) .TP \fBprevious\fR \-\- پرش به URL قبلی (پیش‌فرض: \fBK\fR) .TP \fBquit\fR \-\- خروج (پیش‌فرض: \fBq\fR یا \fBQ\fR) .TP \fBreverse\fR \-\- معکوس کردن ترتیب نمایش (پیش‌فرض: \fBR\fR) .TP \fBshorten\fR \-\- تغییر وضعیت کوتاه کردن URL مشخص‌شده (پیش‌فرض: \fBs\fR) .TP \fBtop\fR \-\- انتقال مکان‌نما به اولین مورد فهرست (پیش‌فرض: \fBg\fR) .TP \fBup\fR \-\- حرکت مکان‌نما به بالا (پیش‌فرض: \fBk\fR) .SH "فایل‌ها (FILES)" $HOME/.config/urlscan/config.json تنها در صورتی مورد نیاز است که پالت‌ها یا کلیدهای میانبر اضافی یا اصلاح‌شده مورد نظر باشند. .SH "همچنین ببینید (SEE ALSO)" \fI/usr/share/doc/urlscan/README\fR, \fBurlview\fR(1), \fBmutt\fR(1) .SH "نویسندگان (AUTHORS)" این صفحه راهنما توسط Daniel Burrows و Scott Hansen نوشته شده است.