| W3M(1) | General Commands Manual | W3M(1) |
نام (NAME)
w3m - مرورگر وب متنی و صفحهبند
خلاصه دستور (SYNOPSIS)
w3m [OPTION]... [ file | URL ]...
توضیحات (DESCRIPTION)
دستور w3m یک مرورگر متنی است که میتواند صفحات وب محلی یا دوردست و همچنین سایر اسناد را نمایش دهد. این ابزار قادر به پردازش جدولها و فریمهای (frames) HTML است، اما جاوااسکریپت (JavaScript) و شیوهنامههای آبشاری (CSS) را نادیده میگیرد. همچنین w3m میتواند به عنوان یک صفحهبند (pager) برای فایلهای متنی که به عنوان آرگومان مشخص شدهاند یا از طریق ورودی استاندارد فرستاده شدهاند، و به عنوان یک مرورگر دایرکتوری با کاربرد عمومی عمل کند.
دستور w3m محتوای خود را در بافرها یا برگهها (tabs) سازماندهی میکند و امکان ناوبری آسان میان آنها را فراهم میسازد. با نصب افزونهی w3m-img، دستور w3m میتواند تصاویر گرافیکی درونخطی را در صفحات وب نمایش دهد. و هر زمان که قابلیتهای رندر HTML در w3m پاسخگوی نیازهای شما نباشد، نشانی اینترنتی (URL) مقصد را میتوان تنها با یک دستور به یک مرورگر گرافیکی سپرد.
برای راهنمایی درباره گزینههای زمان اجرا، هنگام اجرای w3m کلید “H” را فشار دهید.
آرگومانها (ARGUMENTS)
هنگامی که یک یا چند آرگومان خط فرمان داده شود، w3m مقاصد را بر اساس نوع محتوا پردازش میکند. برای وب، w3m این اطلاعات را از سرایندهای HTTP به دست میآورد؛ برای مسیرهای نسبی یا مطلق در سیستمفایل، به نام فایلها اتکا میکند.
بدون آرگومان، w3m انتظار داده از ورودی استاندارد را دارد و فرض را بر “text/plain” میگذارد، مگر اینکه نوع MIME دیگری توسط کاربر مشخص شود.
اگر هیچ مقصدی و هیچ مقصد جایگزینی تعیین نشود (برای مثال گزینه -v در زیر را ببینید)، w3m با نمایش اطلاعات نحوه استفاده خارج خواهد شد.
گزینهها (OPTIONS)
گزینههای خط فرمان با یک نویسه منفرد “-” مشخص میشوند و ممکن است یک آرگومان دریافت کنند.
گزینههای عمومی (General options)
- -B
- در صورت مشخص نشدن هیچ مقصد دیگری، از صفحه نشانکها برای راهاندازی استفاده میکند
- -H
- منسوخ شده است! استفاده نکنید! به جای آن از -o high-intensity=true استفاده کنید
- -M
- نمایش تکرنگ (monochrome)
- -no-mouse
- غیرفعال کردن پشتیبانی از ماوس
- -num
- نمایش شماره هر خط
- -N
- توزیع چندین آرگومان خط فرمان در برگهها (tabs). به طور پیشفرض، از یک پشته از بافرها استفاده میشود
- -ppc num
- عرض num پیکسل به ازای هر نویسه. محدوده بین 4.0 تا 32.0، پیشفرض 8.0. مقادیر بزرگتر جداول را باریکتر میکنند. (پیادهسازی تأیید نشده است)
- -ppl num
- ارتفاع num پیکسل به ازای هر خط. محدوده بین 4.0 تا 64.0. (پیادهسازی تأیید نشده است)
- -title, -title=TERM
- استفاده از نام بافر به عنوان رشته عنوان ترمینال. با مشخص کردن TERM، سبک پیکربندی عنوان متناسب با آن تنظیم میشود
- -v
- در صورت مشخص نشدن هیچ مقصد دیگری، با یک صفحه پیشساخته به کاربران خوشآمد میگوید
- -W
- تغییر وضعیت حالت چرخش جستجو (wrapping)
- -X
- ترمینال را مقداردهی اولیه/بازنشانی (initialize/deinitialize) نمیکند
- +num
- رفتن به خط num؛ تنها در صورتی مؤثر است که num از تعداد خطوط ترمینال بزرگتر باشد
گزینههای مرورگر (Browser options)
- -cols num
- رندر کردن HTML در خطوطی به طول num نویسه
- استفاده از کوکیهای ذخیرهشده و پذیرش کوکیهای جدید، یا عدم انجام هیچکدام
- -F
- رندر کردن فریمها (frames)
- -graph, -no-graph
- استفاده یا عدم استفاده از نویسههای گرافیکی برای رسم حاشیههای جدول و فریم در HTML
- -header string
- الحاق string به درخواست HTTP(S). انتظار میرود با ساختار سرایند Variable: Value مطابقت داشته باشد
- -m
- رندر کردن بدنه پیامهای Usenet بر اساس سرایند “Content-type”
- -no-proxy
- عدم استفاده از پروکسی
- -post file
- استفاده از متد POST برای بارگذاری دادههای تعریفشده در file. ساختار مورد استفاده باید به صورت var1=value1[&var2=value2]... باشد
- -4
- فقط IPv4. متناظر با dns_order=4 در فایلهای پیکربندی
- -6
- فقط IPv6. متناظر با dns_order=6 در فایلهای پیکربندی
- -insecure
- استفاده از گزینههای ناامن پیکربندی 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)
- -l num
- تعداد خطوطی که هنگام دریافت متن ساده از stdin بهطور داخلی نگهداری میشوند (پیشفرض 10,000)
- -r
- استفاده از نمادگذاری کَرِت (caret notation) برای نمایش نویسههای گریز ویژه (مانند نویسههای گریز ANSI یا پسبرهای سبک nroff برای نویسههای پررنگ و خطکشیدهزیر) بهجای پردازش آنها
- -s
- فشردهسازی چندین خط خالی متوالی در یک خط
- -t num
- تنظیم عرض تب روی num ستون. تأثیری روی stdout ندارد
گزینههای نوع داده/کدگذاری (Data type/encoding options)
- -I charset
- کدگذاری نویسه تعریفشده توسط کاربر برای دادههای ورودی
- -O charset
- کدگذاری نویسه تعریفشده توسط کاربر برای دادههای خروجی
- -T type
- تعیین صریح نوع داده ورودی با MIME type
گزینههای خروجی داده به همراه خروج فوری (Options for data output, followed by immediate exit)
- -dump
- تخلیه صفحه رندر شده در stdout. هنگامی که خروجی به یک فایل یا لوله هدایت شود، بهطور ضمنی تنظیم میشود
- -dump_source
- تخلیه کد مبدأ صفحه در stdout
- -dump_head
- تخلیه پاسخ درخواست HEAD برای یک URL در stdout
- -dump_both
- تخلیه HEAD و کد مبدأ برای یک URL در stdout
- -dump_extra
- تخلیه HEAD، کد مبدأ و اطلاعات اضافی برای یک URL در stdout
- -help
- نمایش خلاصهای از ویژگیهای کامپایلشده داخلی و گزینههای خط فرمان
- -show-option
- نمایش تمام گزینههای پیکربندی موجود
- -version
- نمایش نگارش w3m
گزینههای رونویسی تنظیمات و منابع پیشفرض (Options for overriding default settings and resources)
- -bookmark file
- استفاده از file بهجای فایل پیشفرض bookmark.html
- -config file
- استفاده از file بهجای فایل پیکربندی پیشفرض
- -o option=value
- اصلاح یک مورد پیکربندی با یک مقدار مشخص؛ بدون option=value، معادل -show-option است
- -debug
- استفاده از حالت اشکالزدایی (فقط برای اشکالزدایی)
- -reqlog
- ثبت سرآیندهای ارتباطات HTTP در فایل ~/.w3m/request.log
گزینههای آزمایشی (Experimental options)
گزینههای آزمایشی ممکن است در آینده تغییر کنند یا حتی حذف شوند. ارسال بازخورد به نویسنده برنامه بسیار مورد استقبال است.
- -R
- بازیابی نشست
- استفاده از file بهجای فایل کوکی پیشفرض
- -session file
- استفاده از file بهجای فایل نشست پیشفرض
مدیریت نشست (SESSION MANAGEMENT)
اگر -R داده شود، w3m یک نشست را از فایل نشست بازیابی خواهد کرد. اگر هیچ فایل نشستی با -session ارائه نشود، از فایل نشست پیشفرض استفاده میشود. هنگام خروج از w3m، فایل نشست پیشفرض پس از بازیابی نشست حذف خواهد شد. اگر یک فایل نشست داده شده باشد، حذف نخواهد شد. اگر نشانیهای URL یا فایلها بهعنوان پارامتر داده شده باشند، پس از بازیابی نشست بارگذاری شده و به اولین زبانه اضافه خواهند شد. اگر -N و -R داده شوند، نشست قبلی همانطور که هست بازیابی میشود و هر بافر جدید در زبانههای جداگانه باز خواهد شد. نکته: مدیریت نشست هنوز یک ویژگی آزمایشی است و ممکن است در آینده تغییر کند!
مثالها (EXAMPLES)
کاربرد مشابه صفحهبند (Pager-like usage)
- ترکیب قطعهکدهای HTML و پیشنمایش صفحه
-
$ cat header.html footer.html | w3m -T text/html
- مقایسه دو فایل با استفاده از زبانهها
-
$ w3m -N config.old config
کاربرد مشابه مرورگر (Browser-like usage)
- نمایش محتوای وب در ترمینال تکرنگ
-
$ 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
محیط (ENVIRONMENT)
برنامه w3m متغیر محیطی WWW_HOME را به عنوان مقصد جایگزین (fallback) برای استفاده در حالتی که بدون مقصد فراخوانی شود، تشخیص میدهد.
اگر متغیر محیطی W3M_DIR روی نام یک دایرکتوری تنظیم شده باشد، w3m فایلهای کاربری خود را به جای دایرکتوری ~/.w3m در آن ذخیره خواهد کرد.
فایلها (FILES)
مکانهای پیشفرض برخی از فایلها در زیر فهرست شدهاند. این مکانها را میتوان از طریق متغیر محیطی 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
همچنین ببینید (SEE ALSO)
فایلهای README و نمونهها را میتوان در دایرکتوری doc مربوط به نسخه نصبشده w3m یافت. اطلاعات تازه درباره w3m در صفحات وب این پروژه در نشانی زیر در دسترس است: https://w3m-pager.org
قدردانیها (ACKNOWLEDGMENTS)
برنامه w3m از چندین منبع مختلف کد دریافت کرده است. کاربران در طول زمان وصلهها و پیشنهادهای گوناگونی را به آن اضافه کردهاند.
نویسندگان (AUTHORS)
Akinori ITO و دیگران. این نسخه توسط Rene Kita <mail@rkta.de> نگهداری میشود. برای ارتباط با توسعهدهندگان از <~rkta/w3m@lists.sr.ht> استفاده کنید.
| 2025-06-07 | w3m 0.5.6 |