heading::Vimperator's{nbsp}GUI[gui]

Although Vimperator offers the most frequently used Firefox functionality via
Ex and Normal mode commands there may be times when directly accessing the GUI
is required. There are commands for accessing the menu system, standard dialogs
and the sidebar.

section::Menus[menu]

|:emenu| +
||:emenu {menu}||
________________________________________________________________________________
Execute {menu} from the command line. This command provides command-line access
to all menu items available from the main Firefox menubar. {menu} is a
hierarchical path to the menu item with each submenu separated by a period.
E.g. [c]:emenu File.Open File...[c]
________________________________________________________________________________

section::Dialogs[dialogs]

|:addo| |:addons| +
||:addo[ns]||
________________________________________________________________________________
Show available Firefox Extensions and Themes.
You can add/remove/disable browser extensions from this dialog.
Be aware that not all Firefox extensions work, because Vimperator overrides
some key bindings and changes Firefox's GUI.
________________________________________________________________________________


|:dia| |:dialog|
||:dia[log] [a][firefox-dialog][a]|| +
________________________________________________________________________________
Open a Firefox dialog.

Available dialogs:

[frame="topbot",grid="none",cols="1,4"]
|===============================================================================
|*about*           |About Mozilla Firefox
|*addbookmark*     |Add bookmark for the current page
|*addons*          |Manage Add-ons
|*bookmarks*       |List your bookmarks
|*checkupdates*    |Check for updates
|*cleardata*       |Clear private data
|*cookies*         |List your cookies
|*console*         |JavaScript console
|*customizetoolbar*|Customize the Toolbar
|*dominspector*    |DOM Inspector
|*downloads*       |Manage Downloads
|*history*         |List your history
|*import*          |Import Preferences, Bookmarks, History, etc. from other browsers
|*openfile*        |Open the file selector dialog
|*pageinfo*        |Show information about the current page
|*pagesource*      |View page source
|*places*          |Places Organizer: Manage your bookmarks and history
|*preferences*     |Show Firefox preferences dialog
|*printpreview*    |Preview the page before printing
|*printsetup*      |Setup the page size and orientation before printing
|*print*           |Show print dialog
|*saveframe*       |Save frame to disk
|*savepage*        |Save page to disk
|*searchengines*   |Manage installed search engines
|*selectionsource* |View selection source
|===============================================================================
________________________________________________________________________________


|:dl| |:downl| |:downloads| +
||:downl[oads]||
________________________________________________________________________________
Show progress of current downloads. Open the original Firefox download dialog
in a new tab. Here, downloads can be paused, canceled and resumed.
________________________________________________________________________________

section::Add-ons[extensions,add-ons]

|:exta| |:extadd| +
||:exta[dd] {file}||
________________________________________________________________________________
Install an extension. {file} is an extension XPInstall file (*.xpi).
________________________________________________________________________________


|:extde| |:extdelete| +
||:extde[lete] {extension}|| +
||:extde[lete]!||
________________________________________________________________________________
Uninstall an extension. {extension} is the extension's name. When [!] is given
all extensions are uninstalled.
________________________________________________________________________________


|:extd| |:extdisable| +
||:extd[isable] {extension}|| +
||:extd[isable]!||
________________________________________________________________________________
Disable an extension. {extension} is the extension's name. When [!] is given
all extensions are disabled.
________________________________________________________________________________


|:exte| |:extenable| +
||:exte[nable] {extension}|| +
||:exte[nable]!||
________________________________________________________________________________
Enable an extension. {extension} is the extension's name. When [!] is given all
extensions are enabled.
________________________________________________________________________________


|:extens| |:extensions| +
||:extens[ions]||
________________________________________________________________________________
List all installed extensions.
________________________________________________________________________________

|:exto| |:extoptions| +
|:extp| |:extpreferences| +
||:exto[ptions][!] {extension}|| +
||:extp[references][!] {extension}|| +
________________________________________________________________________________
Open the preferences dialog for an extension. If [!] is given, open a dialog,
otherwise open a buffer. See also 'newtab'.
________________________________________________________________________________

section::Sidebar[sidebar]

|:sbcl| |:sbclose| +
||:sbcl[ose]||
________________________________________________________________________________
Close the sidebar window.
________________________________________________________________________________


|:sbope| |:sbopen| |:sb| |:sbar| |:sideb| |:sidebar| +
||:sidebar {name}||
________________________________________________________________________________
Open the sidebar window. {name} is any of the menu items listed under the
standard Firefox View->Sidebar menu. Add-ons, Preferences and Downloads are
also available in the sidebar.
________________________________________________________________________________

section::Status{nbsp}line[status-line,status-bar]

The status line appears at the bottom of each window. The 'laststatus' option
can be used to specify when the status line appears.

The status line contains several fields that provide information about the
state of the current buffer. These are, in order:

* URL: The URL of the currently loaded page. While the page is loading progress
  messages are also output to this field.
* History and bookmark status ([+-❤]): The position of the current page in
  the tab's session history; + and - indicate that it's possible to move
  backwards and forwards through the history respectively. ❤ indicates that
  the current page is bookmarked.
* Tab index ([N/M]): N is the index of the currently selected tab and M is the
  total number of tabs in the current window.
* Vertical scroll: The vertical scroll percentage of the current buffer. This
  is a percentage or Top for 0% and Bot for 100%.
* Security: The security information button is displayed when appropriate as
  per Firefox. The color of the status bar also changes to reflect the current
  security status of the loaded page.
    - black - the site's identity is unverified and the connection is unencrypted
    - blue - the site's domain has been verified and the connection is encrypted
    - green - the site's domain and owner have been fully verified via an
      Extended Validation certificate and the connection is encrypted
* Extensions: Any extension buttons that would normally be installed to the
  Firefox status bar are appended to the end of the status line.

section::Toolbars[toolbar]

|:tbs| |:tbshow| |:toolbars| |:toolbarshow| +
||:toolbarshow {name}||
________________________________________________________________________________
Shows the named toolbar.
________________________________________________________________________________

|:tbh| |:tbhide| |:toolbarh|  |:toolbarhide| +
||:toolbarhide {name}||
________________________________________________________________________________
Hides the named toolbar.
________________________________________________________________________________

|:tbt| |:tbtoggle| |:toolbart| |:toolbartoggle| +
||:toolbartoggle {name}||
________________________________________________________________________________
Toggles the named toolbar.
________________________________________________________________________________

// vim: set filetype=asciidoc: