نام (NAME)

Luakit - مرورگر وب سریع و سبک مبتنی بر WebKit با قابلیت توسعه از طریق Lua

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

luakit [گزینه] [نشانی‌وب]

توضیحات (DESCRIPTION)

Luakit یک چارچوب مرورگر وب با قابلیت شخصی‌سازی بالا، مبتنی بر موتور محتوای وب WebKit و ابزارگان +GTK است. این مرورگر بسیار سریع بوده، از طریق Lua قابل توسعه است و تحت مجوز GNU GPLv3 منتشر می‌شود. این ابزار عمدتاً کاربران حرفه‌ای، توسعه‌دهندگان و تمام افرادی را هدف قرار داده است که مایل‌اند کنترل دقیق و کاملی بر رفتار و رابط کاربری مرورگر وب خود داشته باشند.

حالت‌ها (Modes)

Luakit می‌تواند در حالت‌های گوناگونی اجرا شود که نحوه تعامل کاربر با مرورگر را مشخص می‌کنند.

حالت عادی (Normal mode): حالت پیش‌فرضی است که هنگام راه‌اندازی Luakit فعال می‌شود. در این حالت می‌توانید نشانی‌های وب (URI) را بارگذاری کنید، برگه‌ها و پنجره‌ها را باز کنید، به حالت‌های دیگر بروید و غیره.
حالت همگانی (All mode): یک فراحالت (meta-mode) ویژه که کلیدهای میان‌بر آن در تمام حالت‌ها در دسترس هستند.
حالت درج (Insert mode): هنگام انتخاب فیلدهای فرم، Luakit وارد حالت درج می‌شود که به شما امکان می‌دهد بدون فعال‌سازی تصادفی کلیدهای میان‌بر حالت عادی، در فیلدهای فرم متن وارد کنید.
حالت گذر مستقیم (Passthrough mode): Luakit تمام رویدادهای صفحه‌کلید را مستقیماً به WebView منتقل می‌کند تا زمانی که کاربر کلید Escape را فشار دهد. این حالت برای استفاده از میان‌برهای خود صفحه وب مفید است.
حالت دستور (Command mode): برای وارد کردن دستورات. هر عملی در Luakit یک دستور است، بنابراین از اینجا می‌توانید هر کاری را انجام دهید.
حالت لوآ (Lua mode): اجرای دستورات دلخواه Lua در محیط Luakit.

اسکریپت‌های کاربر (Userscripts)

Luakit با استفاده از اسکریپت‌های کاربری نوشته‌شده به زبان Lua بسیار قابل توسعه است. این اسکریپت‌ها ممکن است حالت‌های بیشتری ارائه دهند. برخی از آن‌ها به صورت پیش‌فرض تعبیه شده‌اند. برای استفاده از امکانات هر اسکریپت، باید آن را بارگذاری کنید. برای جزئیات بیشتر به بخش پیکربندی (CONFIGURATION) مراجعه کنید.

گزینه‌ها (OPTIONS)

گزینه‌های راهنما (Help options)

-h, --help: نمایش گزینه‌های راهنما.
--help-all: نمایش تمام گزینه‌های راهنما.
--help-gtk: نمایش گزینه‌های راهنمای +GTK.

گزینه‌های برنامه (Application options)

-k, --check: بررسی فایل پیکربندی و خروج.
-c, --config=فایل: فایل پیکربندی مورد استفاده.
-n, --nonblock: انشعاب (Fork) اجرای Luakit به پس‌زمینه.
-U, --nounique: نادیده گرفتن اتصال‌های libunique.
-u, --uri=نشانی‌وب: نشانی(های) وب برای بارگذاری در هنگام راه‌اندازی.
-v, --verbose: چاپ خروجی اشکال‌زدایی.
-V, --version: چاپ نسخه و خروج.
--display=DISPLAY: نمایشگر X مورد استفاده.

کلیدهای میان‌بر (KEYBINDINGS)

Luakit کاملاً با صفحه‌کلید قابل استفاده است. کلیدهای پیش‌فرض برای کاربران Emacs و Vim آشنا خواهد بود؛ با این وجود بسیاری از میان‌برهای صفحه‌کلید و ماوس با مرورگرهای وب محبوب مشترک هستند.

فشردن کلید : اعلان خط فرمان را باز می‌کند. می‌توانید دستورات را از آنجا وارد کنید. می‌توانید فهرست کلیدهای میان‌بر فعلی را در صفحه راهنمای Luakit با دستور

: :help

مشاهده کنید.

برخی کلیدها نگارش با حروف بزرگ دارند که رفتار متفاوتی خواهند داشت. برخی با اسکریپت‌های کاربر ارائه می‌شوند، بنابراین برای استفاده از آن‌ها باید اسکریپت مربوطه بارگذاری شده باشد. در ادامه فهرستی از برخی کلیدهای پیش‌فرض مهم آمده است:

ZZ: خروج و ذخیره نشست.
ZQ: خروج بدون ذخیره نشست.
o, O: باز کردن نشانی‌های وب مشخص‌شده. در صورت استفاده از حروف بزرگ، نشانی وب فعلی ویرایش می‌شود.
t, T: باز کردن نشانی‌های وب مشخص‌شده در برگه جدید. در صورت استفاده از حروف بزرگ، نشانی وب فعلی ویرایش می‌شود.
w, W: باز کردن نشانی‌های وب مشخص‌شده در پنجره جدید. در صورت استفاده از حروف بزرگ، نشانی وب فعلی ویرایش می‌شود.

<Left>, <Down>, <Up>, <Right>
h, j, k, l

پیمایش عمودی و افقی صفحه.

<Home>, <End>
gg, G

رفتن به ابتدای / انتهای صفحه.

[count]%: رفتن به درصد [count] از صفحه.
f, F: ورود به حالت دنبال کردن (Follow mode). از اعداد یا متن برای باز کردن پیوندهای مربوطه استفاده کنید. از کلیدهای جهت‌نما برای پیمایش بین پیوندها استفاده کنید. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود. نیازمند اسکریپت کاربری follow است.
i: ورود به حالت درج. در برخی موارد ممکن است فیلدهای فرم کاراکترها را دریافت نکنند؛ برای درج درست کاراکترها یک کلید جهت‌نما را فشار دهید.
gi: ورود به حالت درج در اولین فیلد فرم. نیازمند اسکریپت کاربری go_input است.
<F11>: تغییر حالت تمام‌صفحه.
+, -: تغییر میزان بزرگ‌نمایی.
=: بازنشانی میزان بزرگ‌نمایی به مقدار پیش‌فرض.
p, P: باز کردن نشانی وب از کلیپ‌بورد. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود.
y: کپی کردن نشانی وب فعلی در کلیپ‌بورد.
<Ctrl>x, <Ctrl>a: کاهش / افزایش آخرین عدد در نشانی وب. این قابلیت برای رشته‌های گفتگو در انجمن‌ها یا وب‌سایت‌های شماره‌دار مفید است.
H, L: حرکت به عقب / جلو در تاریخچه مرورگر.

<Ctrl><Shift><Tab>, <Ctrl><Tab>
<Ctrl><PageDown>, <Ctrl><PageUp>
gT, gt

رفتن به برگه قبلی / بعدی.

<Alt>[0-9]: رفتن به برگه شماره #، که در آن # عددی بین 0 تا 9 است.
<, >: تغییر ترتیب برگه‌ها. نیازمند اسکریپت کاربری taborder است.
[count]d: بستن [count] برگه.
u: بازیابی آخرین برگه بسته‌شده.
gy: تکثیر برگه فعلی.
gh, gH: باز کردن صفحه خانگی. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود.
r, R: بارگذاری مجدد صفحه فعلی. در صورت استفاده از حروف بزرگ، حافظه موقت (Cache) نادیده گرفته می‌شود.
<Ctrl>c: توقف بارگذاری صفحه فعلی.
<Ctrl>z: ورود به حالت گذر مستقیم (Passthrough mode). از ESC برای بازگشت به حالت عادی استفاده کنید.
M[a-zA-Z0-9]: تخصیص نشانی وب فعلی به نشانک سریع (Quickmark) شماره #، که در آن # یک حرف ASCII یا یک رقم است. نیازمند اسکریپت کاربری quickmarks است.
go[a-zA-Z0-9], gn[a-zA-Z0-9], gw[a-zA-Z0-9]: باز کردن نشانک سریع مشخص‌شده در برگه فعلی / برگه جدید / پنجره جدید. نیازمند اسکریپت کاربری quickmarks است.
B: افزودن نشانی وب فعلی به بوک‌مارک‌ها.
gb, gB: باز کردن مدیریت بوک‌مارک‌ها. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود.
/, ?: جستجو / جستجوی معکوس برای یک رشته در صفحه فعلی.
n, N: یافتن نتیجه بعدی / قبلی جستجو.

دستورات (COMMANDS)

تمام میان‌برها در واقع به دستورات ارجاع دارند. با این حال برخی دستورات به طور پیش‌فرض میان‌بر متناظر ندارند. اگر اسکریپت کاربری completion استفاده شود، می‌توانید با فشردن کلید <TAB> دستورات را به صورت خودکار کامل کنید. مجدداً برای دریافت فهرست کامل باید فایل‌های پیکربندی را بررسی کنید. عملکردهای موجود فعلی را می‌توان در نمای راهنما مشاهده کرد که با دستور :help قابل باز شدن است.

در ادامه چند دستور مهم ذکر شده است:

:bookmarks: نمایش و جستجو در بوک‌مارک‌ها.
:downloads: باز کردن صفحه بارگیری‌ها که تمام بارگیری‌ها را همراه با وضعیت آن‌ها نمایش می‌دهد.
:dump: دانلود و ذخیره صفحه فعلی.
:save: ذخیره کامل صفحه به عنوان یک فایل واحد mhtml.
:help: نمایش تمام دستورات و میان‌برها همراه با توضیحات آن‌ها. صفحه راهنما همچنین شامل جزئیاتی در مورد حالت‌ها است.
:history: نمایش و جستجو در تاریخچه مرور.
:inspect: راه‌اندازی بازرس وب (WebKit inspector). از :inspect! برای غیرفعال کردن استفاده کنید.
:nohlsearch: غیرفعال کردن هایلایت نتایج جستجو.
:qmarks: نمایش فهرست نشانک‌های سریع (Quickmarks).
:tabhistory: نمایش تاریخچه برگه‌ها.
:view-source: نمایش کد منبع صفحه. از :view-source! برای بستن آن استفاده کنید.

فایل‌ها (FILES)

Luakit فایل‌های پیکربندی را به ترتیب اولویت از پوشه‌های زیر بارگذاری می‌کند:

: $XDG_CONFIG_HOME/luakit
: $XDG_CONFIG_DIRS/luakit

فایل‌های پیکربندی پیش‌فرض:

binds.lua: کلیدهای میان‌بر صفحه‌کلید و ماوس.
globals.lua: پیکربندی عمومی، مانند صفحه خانگی، موتورهای جستجو، عامل کاربر (User Agent)، ویژگی‌های مربوط به هر دامنه و سیاست کوکی‌ها.
modes.lua: تمام حالت‌های پیش‌فرض در این فایل تعریف می‌شوند.
rc.lua: فایل‌های اصلی پیکربندی. تمام فایل‌های دیگر از این فایل بارگذاری می‌شوند.
theme.lua,: تعریف رنگ‌ها و پوسته.
webview.lua: موارد مربوط به WebKit.
window.lua: رفتار نوار وضعیت، پنجره‌ها و برگه‌ها.

اسکریپت‌های کاربری تعبیه‌شده از مسیر $XDG_DATA_DIRS/luakit/lib بارگذاری می‌شوند.

تمام فایل‌های مربوط به وب‌گردی در $XDG_DATA_HOME/luakit ذخیره می‌شوند. همه این موارد در صورت نیاز و عدم وجود ایجاد خواهند شد. بسته به اسکریپت‌های کاربری مورد استفاده، ممکن است فایل‌های زیر موجود باشند:

bookmarks.db: پایگاه داده SQLite3 شامل فهرست کامل بوک‌مارک‌های شما. اگر می‌خواهید بوک‌مارک‌های خود را میان سیستم‌های مختلف همگام‌سازی کنید، کافی است این فایل را به اشتراک بگذارید. در صورتی که فایل در پوشه مورد نیاز ذخیره نشده باشد، می‌توانید از یک پیوند نمادین (Symbolic link) استفاده کنید.
cookies.db: این فایل شامل تمام جزئیات لازم برای پیگیری وضعیت شما توسط وب‌سایت‌ها مانند اطلاعات ورود به حساب کاربری است. در صورتی که از رایانه شخصی خود استفاده نمی‌کنید، پس از اتمام وب‌گردی این فایل را حذف کنید.
history.db: تاریخچه وب‌گردی شما. در صورتی که از رایانه شخصی خود استفاده نمی‌کنید، پس از پایان مرور وب این فایل را پاک کنید.
quickmarks: یک فایل متنی ساده که نشانک‌های سریع شما را ذخیره می‌کند. ساختار آن بسیار ساده است: هر خط یک نشانک سریع است؛ کاراکتر اول میان‌بر نشانک سریع بوده و می‌تواند یکی از [a-zA-Z0-9] باشد؛ کاراکتر دوم یک فاصله است؛ و بخش باقیمانده نشانی وب (URI) است.

پیکربندی (CONFIGURATION)

اگر نمی‌خواهید به پیکربندی پیش‌فرض بسنده کنید و می‌خواهید از انعطاف‌پذیری و قابلیت توسعه Luakit بهره‌مند شوید، می‌توانید آن را به طور کامل از طریق فایل‌های پیکربندی Lua شخصی‌سازی کنید.

اگر نمی‌خواهید از ابتدا شروع کنید، می‌توانید از فایل‌های پیکربندی پیش‌فرض استفاده کرده و آن‌ها را متناسب با نیاز خود تغییر دهید. از دستور زیر برای کپی کردن فایل پیکربندی به پوشه خانگی خود استفاده کنید:

cp -r $XDG_CONFIG_DIRS/luakit $XDG_CONFIG_HOME

اکنون می‌توانید فایل‌های جدید را ویرایش کنید. پیکربندی باید بسیار سرراست باشد، حتی اگر آشنایی زیادی با Lua نداشته باشید.

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

Luakit عمدتاً توسط Mason Larobina <mason.larobina@gmail.com> توسعه داده شده است. سایر مشارکت‌کنندگان در فایل AUTHORS فهرست شده‌اند.

این صفحه راهنما توسط Pierre Neidhardt <ambrevar@gmail.com> نوشته شده است.