Difference between revisions of "Luakit"

From ArchWiki
Jump to: navigation, search
m (Basic usage: Quit commands.)
m (Basic usage: Input fields + fixes)
Line 24: Line 24:
  
 
Press {{keypress|:}} to access the command prompt. You can do nearly everything from there.
 
Press {{keypress|:}} to access the command prompt. You can do nearly everything from there.
 +
Use {{keypress|Tab}} to autocomplete commands.
 +
 
To quit, use the {{ic|quit}} command, or the {{keypress|Ctrl+Z}}{{keypress|Q}} shortcut.
 
To quit, use the {{ic|quit}} command, or the {{keypress|Ctrl+Z}}{{keypress|Q}} shortcut.
 
You can also close the browser while remembering the session (i.e. restoring the tabs) by using the {{ic|writequit}} command instead, or the {{keypress|Ctrl+Z}}{{keypress|Z}} shortcut.
 
You can also close the browser while remembering the session (i.e. restoring the tabs) by using the {{ic|writequit}} command instead, or the {{keypress|Ctrl+Z}}{{keypress|Z}} shortcut.
Line 35: Line 37:
 
* Use {{keypress|f}} to display the index of all visible links. Enter the appropriate number to open the link.
 
* Use {{keypress|f}} to display the index of all visible links. Enter the appropriate number to open the link.
 
* Use {{keypress|F}} instead to open link in a new tab.
 
* Use {{keypress|F}} instead to open link in a new tab.
 
 
 
 
* Press {{keypress|Ctrl+t}} to open a new tab, {{keypress|Ctrl+w}} to close it.
 
* Press {{keypress|Ctrl+t}} to open a new tab, {{keypress|Ctrl+w}} to close it.
 
* Switch from one tab to another with {{keypress|gt}}  and {{keypress|gT}}, or {{keypress|Ctrl+Page Up}}  and {{keypress|Ctrl+Page Down}}.
 
* Switch from one tab to another with {{keypress|gt}}  and {{keypress|gT}}, or {{keypress|Ctrl+Page Up}}  and {{keypress|Ctrl+Page Down}}.
 +
* You can switch to a specific tab with {{keypress|Alt+number}}.
 
* Reorder the tabs with {{keypress|<}}  and {{keypress|>}}.
 
* Reorder the tabs with {{keypress|<}}  and {{keypress|>}}.
 +
 +
=== Input fields ===
 +
 +
Many webpages have editable elements like dropdown lists, checkboxes, text fields and so one. While they work perfectly with the mouse, you may encounter some troubles using the ''follow'' commands.
 +
In such a case, pressing the arrow keys may help.
  
 
=== Bookmarks ===
 
=== Bookmarks ===
  
If enabled (default configuration), bookmarks can be used from within Lua.
+
If enabled (default configuration), bookmarks can be used from within Luakit.
 
* The {{ic|:bookmarks}} command opens the bookmarks page. (Shortcut: {{keypress|gb}}).
 
* The {{ic|:bookmarks}} command opens the bookmarks page. (Shortcut: {{keypress|gb}}).
 
* The {{ic|:bookmark uri group}} command adds the specified URI to the specified group in the bookmarks.
 
* The {{ic|:bookmark uri group}} command adds the specified URI to the specified group in the bookmarks.

Revision as of 16:30, 13 May 2012

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Luakit is an extremely fast, lightweight and flexible web browser using the webkit engine. It is customizable through lua scripts and fully usable with keyboard only.

Installing

The luakit package can be found in the official repositories and can be installed with pacman.

You can also use the git version available from the [AUR].

Configuration

With the Unix philosophy in mind, Luakit is entirely customizable through its configuration files. Those files are written in the Lua scripting language, thus allowing virtually unlimited features. First, copy the configuration files to your $XDG_CONFIG_HOME folder:

cp  -r $XDG_CONFIG_DIRS/luakit $XDG_CONFIG_HOME

Now you can edit any of these files to make your brower fit your needs. Even if you do not know much about Lua, the configuration is quiet simple and well commented enough to make it straightforward.

Basic usage

Note: Most of the shortcuts are viewable and customizable from binds.lua.

Press Template:Keypress to access the command prompt. You can do nearly everything from there. Use Template:Keypress to autocomplete commands.

To quit, use the quit command, or the Template:KeypressTemplate:Keypress shortcut. You can also close the browser while remembering the session (i.e. restoring the tabs) by using the writequit command instead, or the Template:KeypressTemplate:Keypress shortcut.

Browsing

Input fields

Many webpages have editable elements like dropdown lists, checkboxes, text fields and so one. While they work perfectly with the mouse, you may encounter some troubles using the follow commands. In such a case, pressing the arrow keys may help.

Bookmarks

If enabled (default configuration), bookmarks can be used from within Luakit.

  • The :bookmarks command opens the bookmarks page. (Shortcut: Template:Keypress).
  • The :bookmark uri group command adds the specified URI to the specified group in the bookmarks.

Bookmakrs are stored in a simple plain text file: $XDG_DATA_HOME/luakit/bookmarks. Each line is a link. It is composed of 2 fields:

$XDG_DATA_HOME/luakit/bookmarks
link    group   
Warning: Each field is followed by a tabulation. If you insert space instead, the link will not be properly bookmarked.

Groups and links are alphabetically sorted, so there is no need to do it manually.