.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" Luakit man page. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .ds appname Luakit .ds cmdname luakit .ds manname LUAKIT .ds version 2.4.0 .ds year 2012 .ds date \*[year]-10-10 .ds appauthors Mason Larobina .ds manauthors Pierre Neidhardt . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TH \*[manname] 1 "\*[date]" "\*[appname] \*[version]" "دستورات کاربری" . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "نام (NAME)" \*[appname] \- مرورگر وب سریع و سبک مبتنی بر WebKit با قابلیت توسعه از طریق Lua . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "خلاصه دستور (SYNOPSIS)" . .SY \*[cmdname] .RI [ گزینه ] " " [ نشانی‌وب ] .YS . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "توضیحات (DESCRIPTION)" \*[appname] یک چارچوب مرورگر وب با قابلیت شخصی‌سازی بالا، مبتنی بر موتور محتوای وب WebKit و ابزارگان +GTK است. این مرورگر بسیار سریع بوده، از طریق Lua قابل توسعه است و تحت مجوز GNU GPLv3 منتشر می‌شود. این ابزار عمدتاً کاربران حرفه‌ای، توسعه‌دهندگان و تمام افرادی را هدف قرار داده است که مایل‌اند کنترل دقیق و کاملی بر رفتار و رابط کاربری مرورگر وب خود داشته باشند. . .SS "حالت‌ها (Modes)" \*[appname] می‌تواند در حالت‌های گوناگونی اجرا شود که نحوه تعامل کاربر با مرورگر را مشخص می‌کنند. .TP .B "حالت عادی (Normal mode)" حالت پیش‌فرضی است که هنگام راه‌اندازی \*[appname] فعال می‌شود. در این حالت می‌توانید نشانی‌های وب (URI) را بارگذاری کنید، برگه‌ها و پنجره‌ها را باز کنید، به حالت‌های دیگر بروید و غیره. .TP .B "حالت همگانی (All mode)" یک فراحالت (meta-mode) ویژه که کلیدهای میان‌بر آن در تمام حالت‌ها در دسترس هستند. .TP .B "حالت درج (Insert mode)" هنگام انتخاب فیلدهای فرم، \*[appname] وارد حالت درج می‌شود که به شما امکان می‌دهد بدون فعال‌سازی تصادفی کلیدهای میان‌بر حالت عادی، در فیلدهای فرم متن وارد کنید. .TP .B "حالت گذر مستقیم (Passthrough mode)" \*[appname] تمام رویدادهای صفحه‌کلید را مستقیماً به WebView منتقل می‌کند تا زمانی که کاربر کلید Escape را فشار دهد. این حالت برای استفاده از میان‌برهای خود صفحه وب مفید است. .TP .B "حالت دستور (Command mode)" برای وارد کردن دستورات. هر عملی در \*[appname] یک دستور است، بنابراین از اینجا می‌توانید هر کاری را انجام دهید. .TP .B "حالت لوآ (Lua mode)" اجرای دستورات دلخواه Lua در محیط \*[appname]. . .SS "اسکریپت‌های کاربر (Userscripts)" \*[appname] با استفاده از اسکریپت‌های کاربری نوشته‌شده به زبان Lua بسیار قابل توسعه است. این اسکریپت‌ها ممکن است حالت‌های بیشتری ارائه دهند. برخی از آن‌ها به صورت پیش‌فرض تعبیه شده‌اند. برای استفاده از امکانات هر اسکریپت، باید آن را بارگذاری کنید. برای جزئیات بیشتر به بخش .B "پیکربندی (CONFIGURATION)" مراجعه کنید. . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "گزینه‌ها (OPTIONS)" .SS "گزینه‌های راهنما (Help options)" .TP .BR -h ", " --help نمایش گزینه‌های راهنما. .TP .BR --help-all نمایش تمام گزینه‌های راهنما. .TP .BR --help-gtk نمایش گزینه‌های راهنمای +GTK. . .SS "گزینه‌های برنامه (Application options)" .TP .BR -k ", " --check بررسی فایل پیکربندی و خروج. .TP .BR -c ", " --config = \fIفایل\fR فایل پیکربندی مورد استفاده. .TP .BR -n ", " --nonblock انشعاب (Fork) اجرای \*[appname] به پس‌زمینه. .TP .BR -U ", " --nounique نادیده گرفتن اتصال‌های libunique. .TP .BR -u ", " --uri = \fIنشانی‌وب\fR نشانی(های) وب برای بارگذاری در هنگام راه‌اندازی. .TP .BR -v ", " --verbose چاپ خروجی اشکال‌زدایی. .TP .BR -V ", " --version چاپ نسخه و خروج. .TP .BR --display = \fIDISPLAY\fR نمایشگر X مورد استفاده. . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "کلیدهای میان‌بر (KEYBINDINGS)" \*[appname] کاملاً با صفحه‌کلید قابل استفاده است. کلیدهای پیش‌فرض برای کاربران Emacs و Vim آشنا خواهد بود؛ با این وجود بسیاری از میان‌برهای صفحه‌کلید و ماوس با مرورگرهای وب محبوب مشترک هستند. .P فشردن کلید .B : اعلان خط فرمان را باز می‌کند. می‌توانید دستورات را از آنجا وارد کنید. می‌توانید فهرست کلیدهای میان‌بر فعلی را در صفحه راهنمای \*[appname] با دستور .IP .B :help .P مشاهده کنید. .P برخی کلیدها نگارش با حروف بزرگ دارند که رفتار متفاوتی خواهند داشت. برخی با اسکریپت‌های کاربر ارائه می‌شوند، بنابراین برای استفاده از آن‌ها باید اسکریپت مربوطه بارگذاری شده باشد. در ادامه فهرستی از برخی کلیدهای پیش‌فرض مهم آمده است: . .TP .B ZZ خروج و ذخیره نشست. .TP .B ZQ خروج بدون ذخیره نشست. . .TP .BR o ", " O باز کردن نشانی‌های وب مشخص‌شده. در صورت استفاده از حروف بزرگ، نشانی وب فعلی ویرایش می‌شود. .TP .BR t ", " T باز کردن نشانی‌های وب مشخص‌شده در برگه جدید. در صورت استفاده از حروف بزرگ، نشانی وب فعلی ویرایش می‌شود. .TP .BR w ", " W باز کردن نشانی‌های وب مشخص‌شده در پنجره جدید. در صورت استفاده از حروف بزرگ، نشانی وب فعلی ویرایش می‌شود. .P .BR ", " ", " ", " .br .BR h ", " j ", " k ", " l .RS 7 پیمایش عمودی و افقی صفحه. .RE .P .BR ", " .br .BR gg ", " G .RS 7 رفتن به ابتدای / انتهای صفحه. .RE .TP .BR [count]% رفتن به درصد [count] از صفحه. .TP .BR f ", " F ورود به حالت دنبال کردن (Follow mode). از اعداد یا متن برای باز کردن پیوندهای مربوطه استفاده کنید. از کلیدهای جهت‌نما برای پیمایش بین پیوندها استفاده کنید. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود. نیازمند اسکریپت کاربری .I follow است. .TP .BR i ورود به حالت درج. در برخی موارد ممکن است فیلدهای فرم کاراکترها را دریافت نکنند؛ برای درج درست کاراکترها یک کلید جهت‌نما را فشار دهید. .TP .BR gi ورود به حالت درج در اولین فیلد فرم. نیازمند اسکریپت کاربری .I go_input است. .TP .BR تغییر حالت تمام‌صفحه. .TP .BR + ", " - تغییر میزان بزرگ‌نمایی. .TP .BR = بازنشانی میزان بزرگ‌نمایی به مقدار پیش‌فرض. .TP .BR p ", " P باز کردن نشانی وب از کلیپ‌بورد. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود. .TP .BR y کپی کردن نشانی وب فعلی در کلیپ‌بورد. .TP .BR x ", " a کاهش / افزایش آخرین عدد در نشانی وب. این قابلیت برای رشته‌های گفتگو در انجمن‌ها یا وب‌سایت‌های شماره‌دار مفید است. .TP .BR H ", " L حرکت به عقب / جلو در تاریخچه مرورگر. .P .BR ", " .br .BR ", " .br .BR gT ", " gt .RS 7 رفتن به برگه قبلی / بعدی. .RE .TP .BR [0-9] رفتن به برگه شماره #، که در آن # عددی بین 0 تا 9 است. .TP .BR < ", " > تغییر ترتیب برگه‌ها. نیازمند اسکریپت کاربری .I taborder است. .TP .BR [count]d بستن [count] برگه. .TP .BR u بازیابی آخرین برگه بسته‌شده. .TP .BR gy تکثیر برگه فعلی. .TP .BR gh ", " gH باز کردن صفحه خانگی. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود. .TP .BR r ", " R بارگذاری مجدد صفحه فعلی. در صورت استفاده از حروف بزرگ، حافظه موقت (Cache) نادیده گرفته می‌شود. .TP .BR c توقف بارگذاری صفحه فعلی. .TP .BR z ورود به حالت گذر مستقیم (Passthrough mode). از ESC برای بازگشت به حالت عادی استفاده کنید. .TP .BR M[a-zA-Z0-9] تخصیص نشانی وب فعلی به نشانک سریع (Quickmark) شماره #، که در آن # یک حرف ASCII یا یک رقم است. نیازمند اسکریپت کاربری .I quickmarks است. .TP .BR go[a-zA-Z0-9] ", " gn[a-zA-Z0-9] ", " gw[a-zA-Z0-9] باز کردن نشانک سریع مشخص‌شده در برگه فعلی / برگه جدید / پنجره جدید. نیازمند اسکریپت کاربری .I quickmarks است. .TP .BR B افزودن نشانی وب فعلی به بوک‌مارک‌ها. .TP .BR gb ", " gB باز کردن مدیریت بوک‌مارک‌ها. در صورت استفاده از حروف بزرگ، در برگه جدید باز می‌شود. .TP .BR / ", " ? جستجو / جستجوی معکوس برای یک رشته در صفحه فعلی. .TP .BR n ", " N یافتن نتیجه بعدی / قبلی جستجو. . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "دستورات (COMMANDS)" تمام میان‌برها در واقع به دستورات ارجاع دارند. با این حال برخی دستورات به طور پیش‌فرض میان‌بر متناظر ندارند. اگر اسکریپت کاربری .I completion استفاده شود، می‌توانید با فشردن کلید دستورات را به صورت خودکار کامل کنید. مجدداً برای دریافت فهرست کامل باید فایل‌های پیکربندی را بررسی کنید. عملکردهای موجود فعلی را می‌توان در نمای راهنما مشاهده کرد که با دستور .B :help قابل باز شدن است. .P در ادامه چند دستور مهم ذکر شده است: .TP .B :bookmarks نمایش و جستجو در بوک‌مارک‌ها. .TP .B :downloads باز کردن صفحه بارگیری‌ها که تمام بارگیری‌ها را همراه با وضعیت آن‌ها نمایش می‌دهد. .TP .B :dump دانلود و ذخیره صفحه فعلی. .TP .B :save ذخیره کامل صفحه به عنوان یک فایل واحد mhtml. .TP .B :help نمایش تمام دستورات و میان‌برها همراه با توضیحات آن‌ها. صفحه راهنما همچنین شامل جزئیاتی در مورد حالت‌ها است. .TP .B :history نمایش و جستجو در تاریخچه مرور. .TP .B :inspect راه‌اندازی بازرس وب (WebKit inspector). از \fB:inspect!\fR برای غیرفعال کردن استفاده کنید. .TP .B :nohlsearch غیرفعال کردن هایلایت نتایج جستجو. .TP .B :qmarks نمایش فهرست نشانک‌های سریع (Quickmarks). .TP .B :tabhistory نمایش تاریخچه برگه‌ها. .TP .B :view-source نمایش کد منبع صفحه. از \fB:view-source!\fR برای بستن آن استفاده کنید. . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "فایل‌ها (FILES)" .\" TODO: fix indentation. \*[appname] فایل‌های پیکربندی را به ترتیب اولویت از پوشه‌های زیر بارگذاری می‌کند: .IP .I $XDG_CONFIG_HOME/luakit .IP .I $XDG_CONFIG_DIRS/luakit .P فایل‌های پیکربندی پیش‌فرض: .TP .I binds.lua کلیدهای میان‌بر صفحه‌کلید و ماوس. .TP .I globals.lua پیکربندی عمومی، مانند صفحه خانگی، موتورهای جستجو، عامل کاربر (User Agent)، ویژگی‌های مربوط به هر دامنه و سیاست کوکی‌ها. .TP .I modes.lua تمام حالت‌های پیش‌فرض در این فایل تعریف می‌شوند. .TP .I rc.lua فایل‌های اصلی پیکربندی. تمام فایل‌های دیگر از این فایل بارگذاری می‌شوند. .TP .I theme.lua, تعریف رنگ‌ها و پوسته. .TP .I webview.lua موارد مربوط به WebKit. .TP .I window.lua رفتار نوار وضعیت، پنجره‌ها و برگه‌ها. .P اسکریپت‌های کاربری تعبیه‌شده از مسیر \fI$XDG_DATA_DIRS/luakit/lib\fR بارگذاری می‌شوند. .P تمام فایل‌های مربوط به وب‌گردی در \fI$XDG_DATA_HOME/luakit\fR ذخیره می‌شوند. همه این موارد در صورت نیاز و عدم وجود ایجاد خواهند شد. بسته به اسکریپت‌های کاربری مورد استفاده، ممکن است فایل‌های زیر موجود باشند: .TP .I bookmarks.db پایگاه داده SQLite3 شامل فهرست کامل بوک‌مارک‌های شما. اگر می‌خواهید بوک‌مارک‌های خود را میان سیستم‌های مختلف همگام‌سازی کنید، کافی است این فایل را به اشتراک بگذارید. در صورتی که فایل در پوشه مورد نیاز ذخیره نشده باشد، می‌توانید از یک پیوند نمادین (Symbolic link) استفاده کنید. .TP .I cookies.db این فایل شامل تمام جزئیات لازم برای پیگیری وضعیت شما توسط وب‌سایت‌ها مانند اطلاعات ورود به حساب کاربری است. در صورتی که از رایانه شخصی خود استفاده نمی‌کنید، پس از اتمام وب‌گردی این فایل را حذف کنید. .TP .I history.db تاریخچه وب‌گردی شما. در صورتی که از رایانه شخصی خود استفاده نمی‌کنید، پس از پایان مرور وب این فایل را پاک کنید. .TP .I quickmarks یک فایل متنی ساده که نشانک‌های سریع شما را ذخیره می‌کند. ساختار آن بسیار ساده است: هر خط یک نشانک سریع است؛ کاراکتر اول میان‌بر نشانک سریع بوده و می‌تواند یکی از [a-zA-Z0-9] باشد؛ کاراکتر دوم یک فاصله است؛ و بخش باقیمانده نشانی وب (URI) است. . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "پیکربندی (CONFIGURATION)" اگر نمی‌خواهید به پیکربندی پیش‌فرض بسنده کنید و می‌خواهید از انعطاف‌پذیری و قابلیت توسعه \*[appname] بهره‌مند شوید، می‌توانید آن را به طور کامل از طریق فایل‌های پیکربندی Lua شخصی‌سازی کنید. .P اگر نمی‌خواهید از ابتدا شروع کنید، می‌توانید از فایل‌های پیکربندی پیش‌فرض استفاده کرده و آن‌ها را متناسب با نیاز خود تغییر دهید. از دستور زیر برای کپی کردن فایل پیکربندی به پوشه خانگی خود استفاده کنید: .IP .EX cp -r $XDG_CONFIG_DIRS/luakit $XDG_CONFIG_HOME .EE .P اکنون می‌توانید فایل‌های جدید را ویرایش کنید. پیکربندی باید بسیار سرراست باشد، حتی اگر آشنایی زیادی با Lua نداشته باشید. . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .SH "نویسندگان (AUTHORS)" \*[appname] عمدتاً توسط \*[appauthors] توسعه داده شده است. سایر مشارکت‌کنندگان در فایل .I AUTHORS فهرست شده‌اند. . .P این صفحه راهنما توسط \*[manauthors] نوشته شده است.