نام (NAME)

qutebrowser - مرورگری صفحه‌کلیدمحور و شبیه به vim مبتنی بر Python و Qt.

خلاصه دستور (SYNOPSIS)

qutebrowser [-OPTION [...]] [:COMMAND [...]] [URL [...]]

توضیحات (DESCRIPTION)

برنامهٔ qutebrowser یک مرورگر با تمرکز بر صفحه‌کلید و رابط کاربری گرافیکی کمینه‌گرا (مینیمال) است. این مرورگر بر پایهٔ Python و Qt توسعه یافته و یک نرم‌افزار آزاد تحت پروانهٔ GPL است.

این نرم‌افزار از مرورگرها و افزونه‌های دیگری همچون dwb و Vimperator/Pentadactyl الهام گرفته شده است.

توجه داشته باشید که دستورها و تنظیمات qutebrowser در این صفحهٔ راهنما توضیح داده نشده‌اند، بلکه در راهنمای تعبیه‌شده در خودِ qutebrowser قرار دارند - برای نمایش آن از دستور «:help» استفاده کنید.

گزینه‌ها (OPTIONS)

آرگومان‌های موضعی (positional arguments)

:command

دستورهایی برای اجرا هنگام راه‌اندازی.

URL

نشانی‌های وب (URL) برای باز شدن هنگام راه‌اندازی (ورودی خالی به‌عنوان جداکنندهٔ پنجره عمل می‌کند).

گزینه‌ها (options)

-h, --help

نمایش این پیام راهنما و خروج.

-B BASEDIR, --basedir BASEDIR

دایرکتوری پایه برای تمام ذخیره‌سازی‌ها.

-C CONFIG, --config-py CONFIG

مسیر فایل config.py.

-V, --version

نمایش نسخه و خروج.

-s OPTION VALUE, --set OPTION VALUE

اعمال یک پیکربندی موقت برای این نشست (session).

-r SESSION, --restore SESSION

بازیابی یک نشست نام‌گذاری‌شده.

-R, --override-restore

عدم بازیابی نشست، حتی اگر نشستی برای بازیابی وجود داشته باشد.

--target {auto,tab,tab-bg,tab-silent,tab-bg-silent,window,private-window}

نحوهٔ باز شدن نشانی‌های وب در صورتی که یک نمونه از qutebrowser از قبل در حال اجرا باشد.

--backend {webkit,webengine}

تعیین موتور زیرساخت (backend) مورد استفاده.

--qt-wrapper {PyQt6,PyQt5}

تعیین پوشش‌دهندهٔ Qt (wrapper) مورد استفاده. این مورد را می‌توان از طریق متغیر محیطی QUTE_QT_WRAPPER نیز تنظیم کرد. اگر هر دو تنظیم شده باشند، آرگومان خط فرمان اولویت خواهد داشت.

--desktop-file-name DESKTOP_FILE_NAME

تنظیم نام پایهٔ مدخل دسکتاپ (desktop entry) برای این برنامه. برای تنظیم app_id تحت Wayland استفاده می‌شود. ببینید: https://doc.qt.io/qt-6/qguiapplication.html#desktopFileName-prop

--untrusted-args

علامت‌گذاری تمام آرگومان‌های پس از آن به‌عنوان غیرقابل‌اعتماد، که تضمین می‌کند آن‌ها نشانی وب/عبارت‌های جستجو هستند (نه پرچم‌ها یا دستورها).

آرگومان‌های اشکال‌زدایی (debug arguments)

-l {critical,error,warning,info,debug,vdebug}, --loglevel {critical,error,warning,info,debug,vdebug}

بازنویسی سطح گزارش‌گیری (loglevel) پیکربندی‌شده برای کنسول.

--logfilter LOGFILTER

فهرستی جداشده با کاما از مواردی که باید در لاگ اشکال‌زدایی روی خروجی استاندارد (stdout) ثبت شوند.

--loglines LOGLINES

تعداد خطوط لاگ اشکال‌زدایی برای نگهداری در حافظهٔ رم (-1: نامحدود).

-d, --debug

فعال‌سازی گزینه‌های اشکال‌زدایی.

--json-logging

خروجی دادن خطوط گزارش در قالب JSON (یک شیء در هر خط).

--nocolor

غیرفعال‌سازی گزارش‌گیری رنگی.

--force-color

اجبار به گزارش‌گیری رنگی.

--nowindow

عدم نمایش پنجرهٔ اصلی.

-T, --temp-basedir

استفاده از یک دایرکتوری پایهٔ موقت.

--no-err-windows

عدم نمایش هرگونه پنجرهٔ خطا (برای tests/smoke.py استفاده می‌شود).

--qt-arg NAME VALUE

ارسال یک آرگومان همراه با مقدار به Qt. برای مثال، برای تعیین اندازه و موقعیت پنجره می‌توانید این دستور را اجرا کنید: --qt-arg geometry 650x555+200+300

--qt-flag QT_FLAG

ارسال یک آرگومان به Qt به‌عنوان پرچم (flag).

-D DEBUG_FLAGS, --debug-flag DEBUG_FLAGS

ارسال نام قابلیت اشکال‌زدایی جهت فعال‌سازی.

فایل‌ها (FILES)

•~/.config/qutebrowser/config.py: فایل پیکربندی.

•~/.config/qutebrowser/autoconfig.yml: پیکربندی انجام‌شده از طریق رابط گرافیکی (GUI).

•~/.config/qutebrowser/quickmarks: نشانک‌های سریع ذخیره‌شده.

•~/.local/share/qutebrowser/: اطلاعات گوناگون وضعیت برنامه.

•~/.cache/qutebrowser/: داده‌های موقت.

توجه داشته باشید که qutebrowser از مشخصات دایرکتوری پایهٔ XDG پیروی می‌کند - اگر XDG_CONFIG_HOME، XDG_DATA_HOME یا XDG_CACHE_HOME در محیط سیستم تنظیم شده باشند، دایرکتوری‌های پیکربندی‌شده در آن‌ها به‌جای مقادیر پیش‌فرض فوق استفاده خواهند شد.

گزارش باگ‌ها (BUGS)

باگ‌ها در سیستم ردیابی اشکالات GitHub در نشانی https://github.com/qutebrowser/qutebrowser/issues پیگیری می‌شوند.

اگر باگی پیدا کردید، از دستور داخلی :report برای ایجاد یک گزارش باگ حاوی تمام اطلاعات لازم استفاده کنید.

در صورت تمایل، می‌توانید به‌جای آن به فهرست پستی qutebrowser@lists.qutebrowser.org بنویسید.

برای گزارش باگ‌های امنیتی، لطفاً با security@qutebrowser.org تماس بگیرید (یا در صورت نیاز به رمزگذاری GPG، با شناسهٔ GPG معادل 0x916EB0C8FD55A072 به me@the-compiler.org پیام دهید).

همچنین می‌توانید یک آسیب‌پذیری را از طریق قابلیت گزارش خصوصی GitHub ارسال نمایید.

کپی‌رایت و تکثیر (COPYRIGHT)

این برنامه یک نرم‌افزار آزاد است: شما می‌توانید تحت شرایط «پروانهٔ عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط بنیاد نرم‌افزارهای آزاد، چه نسخهٔ ۳ این پروانه یا (به انتخاب خودتان) هر نسخهٔ بالاتر، آن را بازتوزیع کرده و/یا تغییر دهید.

این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هیچ‌گونه ضمانت؛ حتی بدون ضمانت ضمنیِ قابلیت فروش یا تناسب با یک هدف خاص. برای جزئیات بیشتر به پروانهٔ عمومی همگانی گنو مراجعه کنید.

شما باید به همراه این برنامه یک نسخه از پروانهٔ عمومی همگانی گنو را دریافت کرده باشید. در غیر این صورت، https://www.gnu.org/licenses را مشاهده کنید.

منابع (RESOURCES)

•وبگاه: https://www.qutebrowser.org

•فهرست پستی: qutebrowser@lists.qutebrowser.org / https://listi.jpberlin.de/mailman/listinfo/qutebrowser

•فهرست پستی فقط اعلان: qutebrowser-announce@lists.qutebrowser.org / https://listi.jpberlin.de/mailman/listinfo/qutebrowser-announce

•آی‌آرسی (IRC): #qutebrowser در Libera Chat (چت تحت وب، از طریق Matrix)

•گیت‌هاب: https://github.com/qutebrowser/qutebrowser

نویسندگان (AUTHORS)

برنامهٔ qutebrowser توسط Freya Bruhin نوشته شده است. اسامی تمام مشارکت‌کنندگان را می‌توان در فایل README توزیع‌شده با qutebrowser یافت.