W3M(1) General Commands Manual W3M(1)

w3m - مرورگر وب متنی و صفحه‌بند

w3m [OPTION]... [ file | URL ]...

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

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

برای راهنمایی درباره گزینه‌های زمان اجرا، هنگام اجرای w3m کلید “H” را فشار دهید.

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

بدون آرگومان، w3m انتظار داده از ورودی استاندارد را دارد و فرض را بر “text/plain” می‌گذارد، مگر اینکه نوع MIME دیگری توسط کاربر مشخص شود.

اگر هیچ مقصدی و هیچ مقصد جایگزینی تعیین نشود (برای مثال گزینه -v در زیر را ببینید)، w3m با نمایش اطلاعات نحوه استفاده خارج خواهد شد.

گزینه‌های خط فرمان با یک نویسه منفرد “-” مشخص می‌شوند و ممکن است یک آرگومان دریافت کنند.

در صورت مشخص نشدن هیچ مقصد دیگری، از صفحه نشانک‌ها برای راه‌اندازی استفاده می‌کند
منسوخ شده است! استفاده نکنید! به جای آن از -o high-intensity=true استفاده کنید
نمایش تک‌رنگ (monochrome)
غیرفعال کردن پشتیبانی از ماوس
نمایش شماره هر خط
توزیع چندین آرگومان خط فرمان در برگه‌ها (tabs). به طور پیش‌فرض، از یک پشته از بافرها استفاده می‌شود
عرض num پیکسل به ازای هر نویسه. محدوده بین 4.0 تا 32.0، پیش‌فرض 8.0. مقادیر بزرگ‌تر جداول را باریک‌تر می‌کنند. (پیاده‌سازی تأیید نشده است)
ارتفاع num پیکسل به ازای هر خط. محدوده بین 4.0 تا 64.0. (پیاده‌سازی تأیید نشده است)
استفاده از نام بافر به عنوان رشته عنوان ترمینال. با مشخص کردن TERM، سبک پیکربندی عنوان متناسب با آن تنظیم می‌شود
در صورت مشخص نشدن هیچ مقصد دیگری، با یک صفحه پیش‌ساخته به کاربران خوش‌آمد می‌گوید
تغییر وضعیت حالت چرخش جستجو (wrapping)
ترمینال را مقداردهی اولیه/بازنشانی (initialize/deinitialize) نمی‌کند
+num
رفتن به خط num؛ تنها در صورتی مؤثر است که num از تعداد خطوط ترمینال بزرگ‌تر باشد

رندر کردن HTML در خطوطی به طول num نویسه
استفاده از کوکی‌های ذخیره‌شده و پذیرش کوکی‌های جدید، یا عدم انجام هیچ‌کدام
رندر کردن فریم‌ها (frames)
استفاده یا عدم استفاده از نویسه‌های گرافیکی برای رسم حاشیه‌های جدول و فریم در HTML
الحاق string به درخواست HTTP(S). انتظار می‌رود با ساختار سرایند Variable: Value مطابقت داشته باشد
رندر کردن بدنه پیام‌های Usenet بر اساس سرایند “Content-type”
عدم استفاده از پروکسی
استفاده از متد POST برای بارگذاری داده‌های تعریف‌شده در file. ساختار مورد استفاده باید به صورت var1=value1[&var2=value2]... باشد
-4
فقط IPv4. متناظر با dns_order=4 در فایل‌های پیکربندی
-6
فقط IPv6. متناظر با dns_order=6 در فایل‌های پیکربندی
استفاده از گزینه‌های ناامن پیکربندی SSL، نام مستعار برای -o ssl_cipher=ALL:eNULL:@SECLEVEL=0 -o ssl_min_version=all -o ssl_forbid_method= -o ssl_verify_server=0.SS گزینه‌های صفحه‌بند متنی (Text pager options)
تعداد خطوطی که هنگام دریافت متن ساده از stdin به‌طور داخلی نگه‌داری می‌شوند (پیش‌فرض 10,000)
استفاده از نمادگذاری کَرِت (caret notation) برای نمایش نویسه‌های گریز ویژه (مانند نویسه‌های گریز ANSI یا پس‌برهای سبک nroff برای نویسه‌های پررنگ و خط‌کشیده‌زیر) به‌جای پردازش آن‌ها
فشرده‌سازی چندین خط خالی متوالی در یک خط
تنظیم عرض تب روی num ستون. تأثیری روی stdout ندارد

کدگذاری نویسه تعریف‌شده توسط کاربر برای داده‌های ورودی
کدگذاری نویسه تعریف‌شده توسط کاربر برای داده‌های خروجی
تعیین صریح نوع داده ورودی با MIME type

تخلیه صفحه رندر شده در stdout. هنگامی که خروجی به یک فایل یا لوله هدایت شود، به‌طور ضمنی تنظیم می‌شود
تخلیه کد مبدأ صفحه در stdout
تخلیه پاسخ درخواست HEAD برای یک URL در stdout
تخلیه HEAD و کد مبدأ برای یک URL در stdout
تخلیه HEAD، کد مبدأ و اطلاعات اضافی برای یک URL در stdout
نمایش خلاصه‌ای از ویژگی‌های کامپایل‌شده داخلی و گزینه‌های خط فرمان
نمایش تمام گزینه‌های پیکربندی موجود
نمایش نگارش w3m

استفاده از file به‌جای فایل پیش‌فرض bookmark.html
استفاده از file به‌جای فایل پیکربندی پیش‌فرض
اصلاح یک مورد پیکربندی با یک مقدار مشخص؛ بدون option=value، معادل -show-option است
استفاده از حالت اشکال‌زدایی (فقط برای اشکال‌زدایی)
ثبت سرآیندهای ارتباطات HTTP در فایل ~/.w3m/request.log

گزینه‌های آزمایشی ممکن است در آینده تغییر کنند یا حتی حذف شوند. ارسال بازخورد به نویسنده برنامه بسیار مورد استقبال است.

بازیابی نشست
استفاده از file به‌جای فایل کوکی پیش‌فرض
استفاده از file به‌جای فایل نشست پیش‌فرض

اگر -R داده شود، w3m یک نشست را از فایل نشست بازیابی خواهد کرد. اگر هیچ فایل نشستی با -session ارائه نشود، از فایل نشست پیش‌فرض استفاده می‌شود. هنگام خروج از w3m، فایل نشست پیش‌فرض پس از بازیابی نشست حذف خواهد شد. اگر یک فایل نشست داده شده باشد، حذف نخواهد شد. اگر نشانی‌های URL یا فایل‌ها به‌عنوان پارامتر داده شده باشند، پس از بازیابی نشست بارگذاری شده و به اولین زبانه اضافه خواهند شد. اگر -N و -R داده شوند، نشست قبلی همان‌طور که هست بازیابی می‌شود و هر بافر جدید در زبانه‌های جداگانه باز خواهد شد. نکته: مدیریت نشست هنوز یک ویژگی آزمایشی است و ممکن است در آینده تغییر کند!

ترکیب قطعه‌کدهای HTML و پیش‌نمایش صفحه
$ cat header.html footer.html | w3m -T text/html
مقایسه دو فایل با استفاده از زبانه‌ها
$ w3m -N config.old config

نمایش محتوای وب در ترمینال تک‌رنگ
$ w3m -M http://w3m.sourceforge.net
نمایش تصاویر تعبیه‌شده
$ w3m -o auto_image=TRUE http://w3m.sourceforge.net
نمایش محتوا از Usenet
$ w3m -m nntp://news.aioe.org/comp.os.linux.networking
بارگذاری داده‌ها برای یک URL با استفاده از روش POST
$ w3m -post - http://example.com/form.php <<<'a=0&b=1'
تبدیل یک فایل HTML به متن ساده با طول خط مشخص
$ w3m -cols 40 foo.html > foo.txt
خروجی گرفتن از صفحه نشانک‌ها به صورت متن به همراه پیوست فهرست پیوندها
$ w3m -B -o display_link_number=1 > out.txt
تبدیل قالب فایل و کدگذاری نویسه‌ها
$ w3m -T text/html -I EUC-JP -O UTF-8 < foo.html > foo.txt

خوش‌آمدگویی به کاربران با یک صفحه پیش‌ساخته
$ w3m -v

برنامه w3m متغیر محیطی WWW_HOME را به عنوان مقصد جایگزین (fallback) برای استفاده در حالتی که بدون مقصد فراخوانی شود، تشخیص می‌دهد.

اگر متغیر محیطی W3M_DIR روی نام یک دایرکتوری تنظیم شده باشد، w3m فایل‌های کاربری خود را به جای دایرکتوری ~/.w3m در آن ذخیره خواهد کرد.

مکان‌های پیش‌فرض برخی از فایل‌ها در زیر فهرست شده‌اند. این مکان‌ها را می‌توان از طریق متغیر محیطی W3M_DIR تغییر داد.

~/.w3m/bookmark.html
فایل پیش‌فرض نشانک‌ها
~/.w3m/config
فایل پیکربندی تعریف‌شده توسط کاربر؛ بر /etc/w3m/config اولویت دارد
~/.w3m/cookie
محل ذخیره کوکی‌ها (cookie jar)؛ هنگام خروج نوشته شده و در آغاز اجرا خوانده می‌شود
~/.w3m/history
تاریخچه مرورگر - فایل‌ها و URLهای بازدیدشده
~/.w3m/keymap
کلیدهای میانبر تعریف‌شده توسط کاربر؛ بر کلیدهای میانبر پیش‌فرض اولویت دارد
~/.w3m/mailcap
فایل پیکربندی نمایش‌دهنده خارجی
~/.w3m/menu
منوی تعریف‌شده توسط کاربر؛ بر منوی پیش‌فرض اولویت دارد
~/.w3m/mime.types
فایل انواع MIME
~/.w3m/mouse
تنظیمات ماوس تعریف‌شده توسط کاربر
~/.w3m/passwd
فایل نام کاربری و گذرواژه
~/.w3m/pre_form
شامل مقادیر از پیش تعیین‌شده برای پر کردن فرم‌های متداول HTML

فایل‌های README و نمونه‌ها را می‌توان در دایرکتوری doc مربوط به نسخه نصب‌شده w3m یافت. اطلاعات تازه درباره w3m در صفحات وب این پروژه در نشانی زیر در دسترس است: https://w3m-pager.org

برنامه w3m از چندین منبع مختلف کد دریافت کرده است. کاربران در طول زمان وصله‌ها و پیشنهادهای گوناگونی را به آن اضافه کرده‌اند.

Akinori ITO و دیگران. این نسخه توسط Rene Kita <mail@rkta.de> نگهداری می‌شود. برای ارتباط با توسعه‌دهندگان از <~rkta/w3m@lists.sr.ht> استفاده کنید.

2025-06-07 w3m 0.5.6