.nr N -1
.nr D 5
.TH W3M 1 "2025\-06\-07" "w3m 0.5.6"
.SH "نام (NAME)"
w3m \- مرورگر وب متنی و صفحه‌بند
.SH "خلاصه دستور (SYNOPSIS)"
w3m [OPTION]... [ \fIfile\fP | \fIURL\fP ]...
.SH "توضیحات (DESCRIPTION)"
.\" This defines appropriate quote strings for nroff and troff
.ds lq \&"
.ds rq \&"
.if t .ds lq ``
.if t .ds rq ''
.\" Just in case these number registers aren't set yet...
.if \nN==0 .nr N 10
.if \nD==0 .nr D 5

دستور \fIw3m\fP یک مرورگر متنی است که می‌تواند صفحات وب محلی یا دوردست و
همچنین سایر اسناد را نمایش دهد.
این ابزار قادر به پردازش جدول‌ها و فریم‌های (frames) HTML است،
اما جاوااسکریپت (JavaScript) و شیوه‌نامه‌های آبشاری (CSS) را نادیده می‌گیرد.
همچنین \fIw3m\fP می‌تواند به عنوان یک صفحه‌بند (pager) برای فایل‌های متنی که به عنوان
آرگومان مشخص شده‌اند یا از طریق ورودی استاندارد فرستاده شده‌اند،
و به عنوان یک مرورگر دایرکتوری با کاربرد عمومی عمل کند.

دستور \fIw3m\fP محتوای خود را در بافرها یا برگه‌ها (tabs) سازمان‌دهی می‌کند و
امکان ناوبری آسان میان آن‌ها را فراهم می‌سازد.
با نصب افزونه‌ی w3m-img، دستور \fIw3m\fP می‌تواند تصاویر گرافیکی درون‌خطی
را در صفحات وب نمایش دهد.
و هر زمان که قابلیت‌های رندر HTML در \fIw3m\fP پاسخگوی نیازهای شما نباشد،
نشانی اینترنتی (URL) مقصد را می‌توان تنها با یک دستور به یک مرورگر گرافیکی سپرد.

برای راهنمایی درباره گزینه‌های زمان اجرا، هنگام اجرای \fIw3m\fP کلید \(lqH\(rq را فشار دهید.

.SH "آرگومان‌ها (ARGUMENTS)"

هنگامی که یک یا چند آرگومان خط فرمان داده شود، \fIw3m\fP مقاصد را بر اساس نوع محتوا
پردازش می‌کند.
برای وب، \fIw3m\fP این اطلاعات را از سرایندهای HTTP به دست می‌آورد؛
برای مسیرهای نسبی یا مطلق در سیستم‌فایل، به نام فایل‌ها اتکا می‌کند.

بدون آرگومان، \fIw3m\fP انتظار داده از ورودی استاندارد را دارد و
فرض را بر \(lqtext/plain\(rq می‌گذارد، مگر اینکه نوع MIME دیگری توسط کاربر مشخص شود.

اگر هیچ مقصدی و هیچ مقصد جایگزینی تعیین نشود (برای مثال گزینه \fB\-v\fP در زیر را ببینید)،
\fIw3m\fP با نمایش اطلاعات نحوه استفاده خارج خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان با یک نویسه منفرد \(lq\-\(rq مشخص می‌شوند و
ممکن است یک آرگومان دریافت کنند.
.SS "گزینه‌های عمومی (General options)"
.TP
\fB\-B\fP
در صورت مشخص نشدن هیچ مقصد دیگری، از صفحه نشانک‌ها برای راه‌اندازی استفاده می‌کند
.TP
\fB\-H\fP
\fBمنسوخ شده است! استفاده نکنید!\fP
به جای آن از \-o high-intensity=true استفاده کنید
.TP
\fB\-M\fP
نمایش تک‌رنگ (monochrome)
.TP
\fB\-no-mouse\fP
غیرفعال کردن پشتیبانی از ماوس
.TP
\fB\-num\fP
نمایش شماره هر خط
.TP
\fB\-N\fP
توزیع چندین آرگومان خط فرمان در برگه‌ها (tabs).
به طور پیش‌فرض، از یک پشته از بافرها استفاده می‌شود
.TP
\fB\-ppc \fInum\fR
عرض \fInum\fR پیکسل به ازای هر نویسه.
محدوده بین 4.0 تا 32.0، پیش‌فرض 8.0.
مقادیر بزرگ‌تر جداول را باریک‌تر می‌کنند.
(پیاده‌سازی تأیید نشده است)
.TP
\fB\-ppl \fInum\fR
ارتفاع \fInum\fR پیکسل به ازای هر خط.
محدوده بین 4.0 تا 64.0.
(پیاده‌سازی تأیید نشده است)
.TP
\fB\-title\fP, \fB\-title=TERM\fP
استفاده از نام بافر به عنوان رشته عنوان ترمینال.
با مشخص کردن TERM، سبک پیکربندی عنوان متناسب با آن تنظیم می‌شود
.TP
\fB\-v\fP
در صورت مشخص نشدن هیچ مقصد دیگری، با یک صفحه پیش‌ساخته به کاربران خوش‌آمد می‌گوید
.TP
\fB\-W\fP
تغییر وضعیت حالت چرخش جستجو (wrapping)
.TP
\fB\-X\fP
ترمینال را مقداردهی اولیه/بازنشانی (initialize/deinitialize) نمی‌کند
.TP
\fB+\fInum\fR
رفتن به خط \fInum\fR؛
تنها در صورتی مؤثر است که \fInum\fR از تعداد خطوط ترمینال بزرگ‌تر باشد
.SS "گزینه‌های مرورگر (Browser options)"
.TP
\fB\-cols \fInum\fR
رندر کردن HTML در خطوطی به طول \fInum\fR نویسه
.TP
\fB\-cookie\fP, \fB\-no-cookie\fP
استفاده از کوکی‌های ذخیره‌شده و پذیرش کوکی‌های جدید، یا عدم انجام هیچ‌کدام
.TP
\fB\-F\fP
رندر کردن فریم‌ها (frames)
.TP
\fB\-graph\fP, \fB\-no-graph\fP
استفاده یا عدم استفاده از نویسه‌های گرافیکی برای رسم حاشیه‌های جدول و فریم در HTML
.TP
\fB\-header \fIstring\fR
الحاق \fIstring\fR به درخواست HTTP(S).
انتظار می‌رود با ساختار سرایند \f(CWVariable: Value\fP مطابقت داشته باشد
.TP
\fB\-m\fP
رندر کردن بدنه پیام‌های Usenet بر اساس سرایند \(lqContent-type\(rq
.TP
\fB\-no-proxy\fP
عدم استفاده از پروکسی
.TP
\fB\-post \fIfile\fR
استفاده از متد POST برای بارگذاری داده‌های تعریف‌شده در \fIfile\fR.
ساختار مورد استفاده باید به صورت \f(CWvar1=value1[&var2=value2]...\fP باشد
.TP
\fB\-4\fP
فقط IPv4.
متناظر با dns_order=4 در فایل‌های پیکربندی
.TP
\fB\-6\fP
فقط IPv6.
متناظر با dns_order=6 در فایل‌های پیکربندی
.TP
\fB\-insecure\fP
استفاده از گزینه‌های ناامن پیکربندی SSL،
نام مستعار برای \f(CW-o ssl_cipher=ALL:eNULL:@SECLEVEL=0 -o ssl_min_version=all
-o ssl_forbid_method= -o ssl_verify_server=0\fP.SS گزینه‌های صفحه‌بند متنی (Text pager options)
.TP
\fB\-l \fInum\fR
تعداد خطوطی که هنگام دریافت متن ساده از stdin به‌طور داخلی نگه‌داری می‌شوند (پیش‌فرض 10,000)
.TP
\fB\-r\fP
استفاده از نمادگذاری کَرِت (caret notation) برای نمایش نویسه‌های گریز ویژه (مانند نویسه‌های گریز ANSI یا پس‌برهای سبک nroff برای نویسه‌های پررنگ و خط‌کشیده‌زیر) به‌جای پردازش آن‌ها
.TP
\fB\-s\fP
فشرده‌سازی چندین خط خالی متوالی در یک خط
.TP
\fB\-t\fP \fInum\fP
تنظیم عرض تب روی \fInum\fR ستون.
تأثیری روی stdout ندارد
.SS گزینه‌های نوع داده/کدگذاری (Data type/encoding options)
.TP
\fB\-I \fIcharset\fR
کدگذاری نویسه تعریف‌شده توسط کاربر برای داده‌های ورودی
.TP
\fB\-O \fIcharset\fR
کدگذاری نویسه تعریف‌شده توسط کاربر برای داده‌های خروجی
.TP
\fB\-T \fItype\fR
تعیین صریح نوع داده ورودی با MIME type
.SS گزینه‌های خروجی داده به همراه خروج فوری (Options for data output, followed by immediate exit)
.TP
\fB\-dump\fP
تخلیه صفحه رندر شده در stdout.
هنگامی که خروجی به یک فایل یا لوله هدایت شود، به‌طور ضمنی تنظیم می‌شود
.TP
\fB\-dump_source\fP
تخلیه کد مبدأ صفحه در stdout
.TP
\fB\-dump_head\fP
تخلیه پاسخ درخواست HEAD برای یک URL در stdout
.TP
\fB\-dump_both\fP
تخلیه HEAD و کد مبدأ برای یک URL در stdout
.TP
\fB\-dump_extra\fP
تخلیه HEAD، کد مبدأ و اطلاعات اضافی برای یک URL در stdout
.TP
\fB\-help\fP
نمایش خلاصه‌ای از ویژگی‌های کامپایل‌شده داخلی و گزینه‌های خط فرمان
.TP
\fB\-show-option\fP
نمایش تمام گزینه‌های پیکربندی موجود
.TP
\fB\-version\fP
نمایش نگارش \fIw3m\fP
.SS گزینه‌های رونویسی تنظیمات و منابع پیش‌فرض (Options for overriding default settings and resources)
.TP
\fB\-bookmark \fIfile\fR
استفاده از \fIfile\fR به‌جای فایل پیش‌فرض bookmark.html
.TP
\fB\-config \fIfile\fR
استفاده از \fIfile\fR به‌جای فایل پیکربندی پیش‌فرض
.TP
\fB\-o \fIoption=value\fR
اصلاح یک مورد پیکربندی با یک مقدار مشخص؛
بدون \fIoption=value\fR، معادل \fB\-show-option\fR است
.TP
\fB\-debug\fP
استفاده از حالت اشکال‌زدایی (فقط برای اشکال‌زدایی)
.TP
\fB\-reqlog\fP
ثبت سرآیندهای ارتباطات HTTP در فایل \f(CW~/.w3m/request.log\fP
.SS گزینه‌های آزمایشی (Experimental options)
گزینه‌های آزمایشی ممکن است در آینده تغییر کنند یا حتی حذف شوند.
ارسال بازخورد به نویسنده برنامه بسیار مورد استقبال است.
.TP
\fB\-R\fP
بازیابی نشست
.TP
\fB\-cookie-jar \fIfile\fR
استفاده از \fIfile\fR به‌جای فایل کوکی پیش‌فرض
.TP
\fB\-session \fIfile\fR
استفاده از \fIfile\fR به‌جای فایل نشست پیش‌فرض
.SH "مدیریت نشست (SESSION MANAGEMENT)"
اگر \fB\-R\fP داده شود، w3m یک نشست را از فایل نشست بازیابی خواهد کرد.
اگر هیچ فایل نشستی با \fB\-session\fR ارائه نشود، از فایل نشست پیش‌فرض استفاده می‌شود.
هنگام خروج از w3m، فایل نشست پیش‌فرض پس از بازیابی نشست حذف خواهد شد.
اگر یک فایل نشست داده شده باشد، حذف نخواهد شد.
اگر نشانی‌های URL یا فایل‌ها به‌عنوان پارامتر داده شده باشند، پس از بازیابی نشست بارگذاری شده و به اولین زبانه اضافه خواهند شد.
اگر \-N و \-R داده شوند، نشست قبلی همان‌طور که هست بازیابی می‌شود و هر بافر جدید در زبانه‌های جداگانه باز خواهد شد.
\fBنکته:\fP
مدیریت نشست هنوز یک ویژگی آزمایشی است و ممکن است در آینده تغییر کند!
.SH "مثال‌ها (EXAMPLES)"
.SS کاربرد مشابه صفحه‌بند (Pager-like usage)
.TP
ترکیب قطعه‌کدهای HTML و پیش‌نمایش صفحه
.EX
$ cat header.html footer.html | w3m \-T text/html
.EE
.TP
مقایسه دو فایل با استفاده از زبانه‌ها
.EX
$ w3m \-N config.old config
.EE
.SS کاربرد مشابه مرورگر (Browser-like usage)
.TP
نمایش محتوای وب در ترمینال تک‌رنگ
.EX
$ w3m \-M http://w3m.sourceforge.net
.EE
.TP
نمایش تصاویر تعبیه‌شده
.EX
$ w3m \-o auto_image=TRUE http://w3m.sourceforge.net
.EE
.TP
نمایش محتوا از Usenet
.EX
$ w3m \-m nntp://news.aioe.org/comp.os.linux.networking
.EE
.TP
بارگذاری داده‌ها برای یک URL با استفاده از روش POST
.EX
$ w3m \-post \- http://example.com/form.php <<<'a=0&b=1'
.EE.SS استفاده به عنوان فیلتر
.TP
تبدیل یک فایل HTML به متن ساده با طول خط مشخص
.EX
$ w3m \-cols 40 foo.html > foo.txt
.EE
.TP
خروجی گرفتن از صفحه نشانک‌ها به صورت متن به همراه پیوست فهرست پیوندها
.EX
$ w3m \-B \-o display_link_number=1 > out.txt
.EE
.TP
تبدیل قالب فایل و کدگذاری نویسه‌ها
.EX
$ w3m \-T text/html \-I EUC-JP \-O UTF-8 < foo.html > foo.txt
.EE
.SS شروع بدون ورودی
.TP
خوش‌آمدگویی به کاربران با یک صفحه پیش‌ساخته
.EX
$ w3m \-v
.EE
.\".SH Errors
.SH "محیط (ENVIRONMENT)"
برنامه \fIw3m\fP متغیر محیطی \fBWWW_HOME\fP را به عنوان مقصد جایگزین (fallback) برای استفاده در حالتی که بدون مقصد فراخوانی شود، تشخیص می‌دهد.

اگر متغیر محیطی \fBW3M_DIR\fP روی نام یک دایرکتوری تنظیم شده باشد، \fIw3m\fP فایل‌های کاربری خود را به جای دایرکتوری ~/.w3m در آن ذخیره خواهد کرد.
.SH "فایل‌ها (FILES)"
مکان‌های پیش‌فرض برخی از فایل‌ها در زیر فهرست شده‌اند. این مکان‌ها را می‌توان از طریق متغیر محیطی \fBW3M_DIR\fP تغییر داد.
.TP
\f(CW~/.w3m/bookmark.html\fP
فایل پیش‌فرض نشانک‌ها
.TP
\f(CW~/.w3m/config\fP
فایل پیکربندی تعریف‌شده توسط کاربر؛ بر \f(CW/etc/w3m/config\fP اولویت دارد
.TP
\f(CW~/.w3m/cookie\fP
محل ذخیره کوکی‌ها (cookie jar)؛ هنگام خروج نوشته شده و در آغاز اجرا خوانده می‌شود
.TP
\f(CW~/.w3m/history\fP
تاریخچه مرورگر \- فایل‌ها و URLهای بازدیدشده
.TP
\f(CW~/.w3m/keymap\fP
کلیدهای میانبر تعریف‌شده توسط کاربر؛ بر کلیدهای میانبر پیش‌فرض اولویت دارد
.TP
\f(CW~/.w3m/mailcap\fP
فایل پیکربندی نمایش‌دهنده خارجی
.TP
\f(CW~/.w3m/menu\fP
منوی تعریف‌شده توسط کاربر؛ بر منوی پیش‌فرض اولویت دارد
.TP
\f(CW~/.w3m/mime.types\fP
فایل انواع MIME
.TP
\f(CW~/.w3m/mouse\fP
تنظیمات ماوس تعریف‌شده توسط کاربر
.TP
\f(CW~/.w3m/passwd\fP
فایل نام کاربری و گذرواژه
.TP
\f(CW~/.w3m/pre_form\fP
شامل مقادیر از پیش تعیین‌شده برای پر کردن فرم‌های متداول HTML
.\" .TP
.\" .I $~/.w3m/urimethodmap
.\" ???
.SH "همچنین ببینید (SEE ALSO)"
فایل‌های README و نمونه‌ها را می‌توان در دایرکتوری doc مربوط به نسخه نصب‌شده \fIw3m\fP یافت.
اطلاعات تازه درباره \fIw3m\fP در صفحات وب این پروژه در نشانی زیر در دسترس است:
.UR https://w3m-pager.org
.UE
.SH "قدردانی‌ها (ACKNOWLEDGMENTS)"
برنامه \fIw3m\fP از چندین منبع مختلف کد دریافت کرده است.
کاربران در طول زمان وصله‌ها و پیشنهادهای گوناگونی را به آن اضافه کرده‌اند.
.SH "نویسندگان (AUTHORS)"
Akinori ITO و دیگران.
این نسخه توسط
Rene Kita <mail@rkta.de>
نگهداری می‌شود.
برای ارتباط با توسعه‌دهندگان از <~rkta/w3m@lists.sr.ht> استفاده کنید.