CHA(1) General Commands Manual CHA(1)

cha - مرورگر وب متنی Chawan برای محیط ترمینال

cha [گزینه‌ها] [نشانی(ها) یا فایل(ها)...]

مرورگر Chawan یک مرورگر وب متنی است. از آن می‌توان به عنوان یک پیجر (pager) یا مرورگری برای وب، (S)FTP، پروتکل‌های gopher، gemini یا مرور فایل‌های محلی استفاده کرد. این مرورگر HTML و CSS را درک می‌کند و در صورت فعال‌سازی توسط کاربر، می‌تواند کدهای جاوااسکریپت را نیز اجرا کرده و تصاویر را نمایش دهد (در ترمینال‌هایی که از پروتکل تصویر Sixel یا Kitty پشتیبانی می‌کنند).

همچنین می‌توان از Chawan به عنوان یک نمایش‌دهنده اسناد متنی عمومی مطابق توضیحات cha-mailcap(5) یا به عنوان نمایش‌دهنده صفحات راهنمای حاوی پیوند با استفاده از mancha(1) استفاده کرد.

این سند نحوه فراخوانی Chawan را توضیح می‌دهد. برای مشاهده فهرستی از کلیدهای میانبر پیش‌فرض، عبارت cha about:chawan را وارد کنید. برای توضیحات دقیق درباره قالب پیکربندی، به cha-config(5) مراجعه فرمایید.

هنگام فراخوانی، Chawan تلاش می‌کند تمام نشانی‌ها یا فایل‌های ارائه‌شده در آرگومان‌ها را باز کند. اگر هیچ نشانی‌ای با موفقیت باز نشود، Chawan به‌طور خودکار خارج می‌شود.

همچنین اگر فایلی از طریق پایپ (pipe) ارسال شود، Chawan می‌تواند بدون مشخص کردن فایل راه‌اندازی شود. در این حالت، می‌توانید نوع محتوا را با استفاده از سوییچ -T تعیین کنید.

تمامی گزینه‌های خط فرمان دارای حالت‌های کوتاه (مانند -d) و حالت‌های بلند (مانند --dump) هستند.

حالت‌های بلند باید با دو خط تیره آغاز شوند؛ هنگامی که فقط یک خط تیره ارائه شود، هر حرف به عنوان یک گزینه کوتاه جداگانه تجزیه می‌شود.

در حالت کوتاه، تعیین مقادیر آرگومان‌ها بدون فاصله نیز معتبر است. برای نمونه، -obuffer.images=true معتبر است.

تغییر موقت شیوه‌نامه (stylesheet) کاربر. اگر در حال حاضر از یک شیوه‌نامه کاربری استفاده می‌شود، شیوه‌نامه داده‌شده به انتهای آن افزوده خواهد شد.
راه‌اندازی در حالت بدون واسط گرافیکی و تعاملی (headless) و چاپ متوالی فایل‌های بازشده در خروجی استاندارد (stdout). اگر خروجی استاندارد یک tty نباشد (مانند زمان هدایت خروجی cha از طریق پایپ)، این گزینه به‌طور ضمنی فعال می‌شود.
چاپ نسخه‌ای خلاصه از این صفحه راهنما و سپس خروج.
ارسال گزینه‌های پیکربندی موقت. این گزینه قالب پیکربندی توضیح داده‌شده در cha-config(5) را می‌پذیرد، بنابراین رشته ارسالی باید یک عبارت معتبر TOML باشد.

برای سهولت در تعیین پارامترهای رشته‌ای، کلمات کلیدی بدون کوتیشن ناشناخته به رشته تبدیل می‌شوند. بنابراین این دستور کار می‌کند:

--opt display.color-mode=eight-bit.

با این حال، نمادها و کلماتی که با یک عدد شروع می‌شوند همچنان باید درون علامت نقل‌قول (کوتیشن) قرار گیرند؛ یعنی برای خنثی کردن پردازش شل، باید دو بار آن‌ها را کوت کنید.

اجرای رشته ارائه‌شده به عنوان اسکریپت جاوااسکریپت، یا اجرای فایل جاوااسکریپت مشخص‌شده. اگر پسوند فایل .mjs باشد، به عنوان یک ماژول ES اجرا می‌شود.
چاپ اطلاعات مربوط به نسخه مرورگر و سپس خروج.
جایگزینی مسیر پیش‌فرض جستجوی پیکربندی. هر دو مسیر مطلق و نسبی مجاز هستند.
بازنویسی و تغییر مجموعه نویسه‌های (character set) تمام فایل‌های ورودی. زمانی کاربرد دارد که Chawan مجموعه نویسه‌های ورودی را به اشتباه تشخیص دهد.

(اگر این اتفاق زیاد رخ می‌دهد، تغییر فهرست پیش‌فرض تشخیص نویسه‌های ورودی یعنی encoding.document-charset را در تنظیمات مد نظر قرار دهید.)

اجبار خروجی تک‌رنگ (monochrome). فرمت‌بندی متن (بولد، ایتالیک و غیره) تحت تأثیر قرار نمی‌گیرد. این گزینه یک میانبر برای -o display.color-mode=monochrome است.
بازنویسی و تعیین مجموعه نویسه‌های خروجی. این گزینه یک میانبر برای -o encoding.display-charset=charset است.
بازنویسی و تعیین نوع محتوای (content type) تمام فایل‌های ورودی. زمانی مفید است که نوع محتوا از روی پسوند فایل قابل حدس زدن نباشد، یا هنگام خواندن فایلی غیر از متن ساده (non-plaintext) از ورودی استاندارد (stdin).
هنگامی که هیچ فایل یا نشانی اینترنتی ارائه نشده باشد، به جای چاپ صفحه راهنما، صفحه‌ای را که در start.visual-home مشخص شده باز می‌کند.
--
تفسیر تمام آرگومان‌های بعدی به عنوان فایل. برای نمونه، می‌توانید فایلی با نام -o را با دستور cha -- -o باز کنید.

برخی از متغیرهای محیطی توسط Chawan خوانده شده و مورد استفاده قرار می‌گیرند.

در صورت تنظیم، پیکربندی پیش‌فرض فایل‌های موقت را درون این دایرکتوری ذخیره می‌کند (و در غیر این صورت در /tmp/cha-tmp-user ذخیره می‌شوند).
هنگامی که تنظیم شده باشند، Chawan به‌طور پیش‌فرض در حالت بصری (visual mode) راه‌اندازی شده و صفحه‌ای را که توسط یکی از این متغیرها مشخص شده باز می‌کند. متغیر HTTP_HOME بر WWW_HOME اولویت دارد.
در صورت تنظیم، دایرکتوری پیکربندی را به مسیر مشخص‌شده تغییر می‌دهد.
هنگامی که روی 24bit یا truecolor تنظیم شده باشد، و گزینه پیکربندی display.color-mode روی auto باشد، Chawan حالت رنگ را روی رنگ واقعی (true color) تنظیم می‌کند.
توسط Chawan برای انطباق با رفتارهای خاص ترمینال استفاده می‌شود. در صورت عدم تنظیم، مقدار پیش‌فرض آن xterm خواهد بود.
برای تعیین ویرایشگر مورد استفاده در زمانی که گزینه پیکربندی external.editor تنظیم نشده باشد به کار می‌رود.
هنگامی که تشخیص اندازه پنجره با شکست مواجه شود، به عنوان مقادیر جایگزین (fallback) استفاده می‌شوند.

mancha(1), cha-config(5), cha-mailcap(5), cha-mime.types(5), cha-cgi(5), cha-urimethodmap(5), cha-protocols(7), cha-image(7), cha-css(7), cha-troubleshooting(7), cha-terminal(7)