diff options
| author | Kris Maglione <maglione.k@gmail.com> | 2008-12-02 13:42:44 -0500 |
|---|---|---|
| committer | Kris Maglione <maglione.k@gmail.com> | 2008-12-02 13:42:44 -0500 |
| commit | 1c153aa97817a2e7451108578cb219ea83b5ab60 (patch) | |
| tree | c93360c3eb9a75b1cc8bfd62f9797899ff6e0a63 /vimperator/locale | |
| parent | 3a8817a560bb2cfd8d79f597ef62e8c6e46ce4da (diff) | |
| download | pentadactyl-1c153aa97817a2e7451108578cb219ea83b5ab60.tar.gz | |
New directory layout.
Diffstat (limited to 'vimperator/locale')
24 files changed, 4481 insertions, 0 deletions
diff --git a/vimperator/locale/en-US/asciidoc.conf b/vimperator/locale/en-US/asciidoc.conf new file mode 100644 index 00000000..a16a4283 --- /dev/null +++ b/vimperator/locale/en-US/asciidoc.conf @@ -0,0 +1,89 @@ +[miscellaneous] + +[glossary] +author=Martin Stubenschrott +email=stubenschrott@gmx.net + +# [header] +# <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" +# "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +# <html> +# <head> +# <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> +# <meta name="generator" content="vimperator" /> +# <link rel="stylesheet" href="xhtml11.css" type="text/css" /> +# <title>{doctitle}</title> +# </head> +# <body> +# <div id="content"> +# <h1>{doctitle}</h1> +# + +[replacements] +LOGO=<center>image:chrome://liberator2/content/vimperator.png[Vimperator]</center> +HEADER=<div style="float: right; padding-top: 10px;"><form action="https://www.paypal.com/cgi-bin/webscr" method="post"><fieldset class="paypal"> <input type="hidden" name="cmd" value="_s-xclick"/> <input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but21.gif" name="submit" alt="Make payments with PayPal - it\'s fast, free and secure!"/> <img alt="" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"/> <input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----MIIHPwYJKoZIhvcNAQcEoIIHMDCCBywCAQExggEwMIIBLAIBADCBlDCBjjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYDVQQKEwtQYXlQYWwgSW5jLjETMBEGA1UECxQKbGl2ZV9jZXJ0czERMA8GA1UEAxQIbGl2ZV9hcGkxHDAaBgkqhkiG9w0BCQEWDXJlQHBheXBhbC5jb20CAQAwDQYJKoZIhvcNAQEBBQAEgYBDDJfc+lXLBSAM9XSWv/ebzG/L7PTqYiIXaWVg8pfinDsfYaAcifcgCTuApg4v/VaZIQ/hLODzQu2EvmjGXP0twErA/Q8G5gx0l197PJSyVXb1sLwd1mgOdLF4t0HmDCdEI9z3H6CMhsb3xVwlfpzllSfCIqzlSpx4QtdzEZGzLDELMAkGBSsOAwIaBQAwgbwGCSqGSIb3DQEHATAUBggqhkiG9w0DBwQI8ZOwn5QkHgaAgZjjtPQxB7Vw2rS7Voap9y+xdVLoczUQ97hw+bOdZLcGykBtfoVjdn76MS51QKjGp1fEmxkqTuQ+Fxv8+OVtHu0QF/qlrhmC3fJBRJ0IFWxKdXS+Wod4615BDaG2X1hzvCL443ffka8XlLSiFTuW43BumQs/O+6Jqsk2hcReP3FIQOvtWMSgGTALnZx7x5c60u/3NSKW5qvyWKCCA4cwggODMIIC7KADAgECAgEAMA0GCSqGSIb3DQEBBQUAMIGOMQswCQYDVQQGEwJVUzELMAkGA1UECBMCQ0ExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC1BheVBhbCBJbmMuMRMwEQYDVQQLFApsaXZlX2NlcnRzMREwDwYDVQQDFAhsaXZlX2FwaTEcMBoGCSqGSIb3DQEJARYNcmVAcGF5cGFsLmNvbTAeFw0wNDAyMTMxMDEzMTVaFw0zNTAyMTMxMDEzMTVaMIGOMQswCQYDVQQGEwJVUzELMAkGA1UECBMCQ0ExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC1BheVBhbCBJbmMuMRMwEQYDVQQLFApsaXZlX2NlcnRzMREwDwYDVQQDFAhsaXZlX2FwaTEcMBoGCSqGSIb3DQEJARYNcmVAcGF5cGFsLmNvbTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAwUdO3fxEzEtcnI7ZKZL412XvZPugoni7i7D7prCe0AtaHTc97CYgm7NsAtJyxNLixmhLV8pyIEaiHXWAh8fPKW+R017+EmXrr9EaquPmsVvTywAAE1PMNOKqo2kl4Gxiz9zZqIajOm1fZGWcGS0f5JQ2kBqNbvbg2/Za+GJ/qwUCAwEAAaOB7jCB6zAdBgNVHQ4EFgQUlp98u8ZvF71ZP1LXChvsENZklGswgbsGA1UdIwSBszCBsIAUlp98u8ZvF71ZP1LXChvsENZklGuhgZSkgZEwgY4xCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJDQTEWMBQGA1UEBxMNTW91bnRhaW4gVmlldzEUMBIGA1UEChMLUGF5UGFsIEluYy4xEzARBgNVBAsUCmxpdmVfY2VydHMxETAPBgNVBAMUCGxpdmVfYXBpMRwwGgYJKoZIhvcNAQkBFg1yZUBwYXlwYWwuY29tggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAgV86VpqAWuXvX6Oro4qJ1tYVIT5DgWpE692Ag422H7yRIr/9j/iKG4Thia/Oflx4TdL+IFJBAyPK9v6zZNZtBgPBynXb048hsP16l2vi0k5Q2JKiPDsEfBhGI+HnxLXEaUWAcVfCsQFvd2A1sxRr67ip5y2wwBelUecP3AjJ+YcxggGaMIIBlgIBATCBlDCBjjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYDVQQKEwtQYXlQYWwgSW5jLjETMBEGA1UECxQKbGl2ZV9jZXJ0czERMA8GA1UEAxQIbGl2ZV9hcGkxHDAaBgkqhkiG9w0BCQEWDXJlQHBheXBhbC5jb20CAQAwCQYFKw4DAhoFAKBdMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTA3MDMyMTIyMzI1OFowIwYJKoZIhvcNAQkEMRYEFCirrvlwYVHQiNEEbM6ikfx9+Dm5MA0GCSqGSIb3DQEBAQUABIGAtbsR8GdCdURLziozXLSdtY+zJZUPPeQFXXy2V1S/3ldiN+pRvd4HI7xz8mOY1UaKJZpwZnOosy9MflL1/hbiEtEyQ2Dm/s4jnTcJng/NjLIZu+0NYxXRJhB+zMJubnMMMjzNrGlqI4F2HAB/bCA1eOJ5B83Of3dA4rk/T/8GoSQ=-----END PKCS7-----"/> </fieldset></form></div>image:chrome://liberator2/content/vimperator.png[Vimperator] +\[count\]=<span class="argument">[count]</span> +\[args\]=<span class="argument">[args]</span> +\[arg\]=<span class="argument">[arg]</span> +\[arg1\]=<span class="argument">[arg1]</span> +\[arg2\]=<span class="argument">[arg2]</span> +\[url\]=<span class="argument">[url]</span> +\[file\]=<span class="argument">[file]</span> +\[value\]=<span class="argument">[value]</span> +\[filter\]=<span class="argument">[filter]</span> +\[regex\]=<span class="argument">[regex]</span> +\[stylesheet\]=<span class="argument">[stylesheet]</span> +\[!\]=<span class="argument">[!]</span> + +# [macros] +# section:Introduction[tag1,tag2] +(?su)(?<!\S)[\\]?\|(?P<attrlist>.+?)\|(?!\+)=section +# help:helptext[href] +(?su)(?<!\S)[\\]?\|(?P<attrlist>.+?)\|(?!\+)=help + +# maximum 3 tags for now +[section-inlinemacro] +<table style="border-bottom: 1px solid silver; width: 100%"> +<tr style="width: 100%"><td style="width: 50%"><h2>{target}</h2></td><td style="width: 50%"> +{3? <a id="{3}"/><span class="tag">{3}</span>} +{2? <a id="{2}"/><span class="tag">{2}</span>} +{1? <a id="{1}"/><span class="tag">{1}</span>} +</td></tr> +</table> + +[help-inlinemacro] +<a href="chrome://liberator/locale/{1}">{target}</a> + +[quotes] +|=tag +||=key +[o]=option +'=option2 +[c]=command +[m]=mapping +[a]=argument +# FIXME: this prevents all asciidoc attribute processing +{|}=argument2 +# FIXME +((|))=#argument2 +[[|]]=argument3 +# disable monospaced text as all our text is monospaced and it causes problems for some things ++= +^= + +[tags] +tag=<span class="tag">|</span> +key=<div class="key">|</div> +option=<span class="option">|</span> +option2=<span class="option">'|'</span> +command=<span class="command">|</span> +mapping=<span class="mapping">|</span> +argument=<span class="argument">|</span> +argument2=<span class="argument">{|}</span> +argument3=<span class="argument">[|]</span> + +[specialwords] +warningwords=Warning: NOTE: Note: + +[warningwords] +<span class="warning">{words}</span> diff --git a/vimperator/locale/en-US/autocommands.txt b/vimperator/locale/en-US/autocommands.txt new file mode 100644 index 00000000..203004e1 --- /dev/null +++ b/vimperator/locale/en-US/autocommands.txt @@ -0,0 +1,88 @@ +HEADER + +|autocommands| + + +Autocommands are a way to automatically execute code when certain events +happen. + +|:au| |:autocmd| + +||:au[tocmd]|| Execute commands automatically on events. +________________________________________________________________________________ +[c]:au[tocmd][c] {event} {pat} {cmd} + +Add {cmd} to the list of commands Vimperator will execute on {event} for a URL matching {pat}: + +* [c]:autocmd[!][c] {events} {pat}: list/remove autocommands filtered by {events} and {pat} +* [c]:autocmd[!][c] {events}: list/remove autocommands matching {events} +* [c]:autocmd[!][c] * {pat}: list/remove autocommands matching {pat} +* [c]:autocmd[!][c]: list/remove all autocommands + +Available {events}: + +`--------------------`---------------------------------------- +*BookmarkAdd* Triggered after a page is bookmarked +*ColorScheme* Triggered after a color scheme has been loaded +*DOMLoad* Triggered when a page's DOM content has fully loaded +*DownloadPost* Triggered when a download has completed +*Fullscreen* Triggered when the browser's fullscreen state changes +*LocationChange* Triggered when changing tabs or when navigating to a new location +*PageLoadPre* Triggered after a page load is initiated. +*PageLoad* Triggered when a page gets (re)loaded/opened +*ShellCmdPost* Triggered after executing a shell command with :!cmd +*VimperatorEnter* Triggered after Firefox starts +*VimperatorLeavePre* Triggered before exiting Firefox, just before destroying each module +*VimperatorLeave* Triggered before exiting Firefox +-------------------------------------------------------------- + +{pat} is a regular expression, use .* if you want to match all URLs. Note: This +differs from Vim which uses a glob rather than a regexp for {pat}. + +The following keywords are available where relevant: + +`--------------`---------------------------------------------- +*<url>* The URL against which the event was selected. +*<title>* The page, bookmark or download title. +*<tab>* The index tab in which the event occurred. +*<tags>* The tags applied to <url>. Only for *BookmarkAdd*. +*<keyword>* The keywords applied to the bookmark. Only for *BookmarkAdd*. +*<icon>* The icon associated with <url>. Only for *BookmarkAdd*. +*<size>* The size of a downloaded file. Only for *DownloadPost*. +*<file>* The target destination of a download. Only for *DownloadPost*. +*<state>* The new fullscreen state. Only for *Fullscreen*. +*<name>* The color scheme name. Only for *ColorScheme*. +-------------------------------------------------------------- + +________________________________________________________________________________ + + +|:doautoa| |:doautoall| +||:doautocmda[ll] {event} [url]|| + +________________________________________________________________________________ +Apply the autocommands matching the specified URL to all buffers. If no [url] +is specified use the current URL. +________________________________________________________________________________ + + +|:do| |:doautocmd| +||:do[autocmd] {event} [url]|| + +________________________________________________________________________________ +Apply the autocommands matching the specified URL to the current buffer. If no +[url] is specified use the current URL. +________________________________________________________________________________ + +section:Examples[autocmd-examples] + +Enable _passthrough_ mode on all Google sites: + + :autocmd LocationChange .* js modes.passAllKeys = /google\.com/.test(buffer.URL) + +Enable _passthrough_ mode on *some* Google sites: + + :autocmd LocationChange .* js modes.passAllKeys = /(www|mail)\.google\.com/.test(buffer.URL) + +Set the filetype to mail when editing email at Gmail: + + :autocmd LocationChange .* :set editor=gvim -f + :autocmd LocationChange mail\.google\.com :set editor=gvim -f -c 'set ft=mail' + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/browsing.txt b/vimperator/locale/en-US/browsing.txt new file mode 100644 index 00000000..7a7554f4 --- /dev/null +++ b/vimperator/locale/en-US/browsing.txt @@ -0,0 +1,347 @@ +HEADER + +|surfing| |browsing| + + +Vimperator overrides nearly all Firefox keys in order to make browsing more +pleasant for Vim users. On the rare occasions when you want to pass a keystroke +to Firefox, or to the web page, and have it retain its original meaning you +have 2 possibilities: + +|pass-through| |<C-z>| |CTRL-Z| + +||CTRL-Z|| +________________________________________________________________________________ +Disable all Vimperator keys except [m]<Esc>[m] and pass them to the next event +handler. This is especially useful, if JavaScript controlled forms like the +RichEdit form fields of Gmail don't work anymore. To exit this mode, press +[m]<Esc>[m]. If you also need to pass [m]<Esc>[m] in this mode to the web page, +prepend it with [m]<C-v>[m]. +________________________________________________________________________________ + +|send-key| |<C-v>| |CTRL-V| + +||CTRL-V|| +________________________________________________________________________________ +If you only need to pass a single key to a JavaScript form field or another +extension prefix the key with [m]<C-v>[m]. Also works to unshadow Firefox +shortcuts like [m]<C-o>[m] which are otherwise hidden in Vimperator. When +Vimperator mode is temporarily disabled with [m]<C-z>[m], [m]<C-v>[m] will pass +the next key to Vimperator instead of the web page. +________________________________________________________________________________ + +section:Opening{nbsp}web{nbsp}pages[opening] + +|o| |:o| |:open| +||:o[pen][!] [arg1], [arg2], ...|| + +||o|| +________________________________________________________________________________ +Open one or more URLs in the current tab. +Multiple URLs can be separated with 'urlseparator' (default: ", " Note that the +space after the comma is required.") +Each token is analyzed and in this order: + +1. Opened as a local file if it is an existing relative or absolute filename. + - [c]:open /etc/fstab[c] shows the file system table. + - [c]:open ../other/foo.html[c] in your home directory opens + [a]/home/other/foo.html[a] +2. Opened with the specified search engine if the token looks like a search + string and the first word is the name of a search engine ([c]:open wikipedia + linus torvalds[c] opens the Wikipedia entry for linus torvalds). The short + name of a search engine is automatically guessed from its name. If you want + to set a custom name, you can change it with [c]:dialog searchengines[c]. +3. Opened with the default search engine or keyword (specified with the + 'defsearch' option) if the first word is no search engine ([c]:open linus + torvalds[c] opens a Google search for linux torvalds). +4. Passed directly to Firefox in all other cases ([c]:open www.osnews.com, + www.slashdot.org[c] opens OSNews in the current, and Slashdot in a new + background tab). + +You can use [c]:open -tags linux torvalds<Tab>[c] to complete bookmarks with +tag "linux" and which contain "torvalds". Note that -tags support is only +available for tab completion, not for the actual command. +The items which are completed on [m]<Tab>[m] are specified in the 'complete' +option. +Without argument, reloads the current page. +Without argument but with [!], reloads the current page skipping the cache. +________________________________________________________________________________ + + +|t| |:t| |:tabopen| |:tabnew| |:tabe| |:tabedit| +||:tabopen[!] [arg1], [arg2], ...|| + +||t|| +________________________________________________________________________________ +Just like help::open[browsing.html#opening], but opens the resulting web page(s) +in a new tab. When used with [!], the 'tabopen' value of the 'activate' option +is negated. +________________________________________________________________________________ + + +|T| + +||T|| +________________________________________________________________________________ +Open one or more URLs in a new tab, based on current location. Works like +[m]t[m], but preselects current URL in the [c]:tabopen[c] query. +________________________________________________________________________________ + + +|:tabd| |:tabduplicate| +||:[count]tabd[uplicate][!]|| + +________________________________________________________________________________ +Duplicates current tab [count] times. Uses 'tabopen' value of the 'activate' to +determine if last cloned tab should be activated. When used with [!], 'tabopen' +value is negated. +________________________________________________________________________________ + + +|O| + +||O|| +________________________________________________________________________________ +Open one or more URLs in the current tab, based on current location. Works +like [m]o[m], but preselects current URL in the [c]:open[c] query. +________________________________________________________________________________ + + +|:winopen| |:wopen| |:winedit| +||:wino[pen][!] [arg1], [arg2], ...|| + +________________________________________________________________________________ +Just like help::open[browsing.html#opening], but opens the resulting web page(s) +in a new window. +________________________________________________________________________________ + + +|<MiddleMouse>| |p| + +||p|| +________________________________________________________________________________ +Open (put) a URL based on the current clipboard contents in the current buffer. +You can also just select (for non-X11 users: copy) some non-URL text, and +search for it with the default search engine or keyword (specified by the +'defsearch' option) with [m]p[m]. +________________________________________________________________________________ + + +|P| + +||P|| +________________________________________________________________________________ +Open (put) a URL based on the current clipboard contents in a new buffer. Works +like [m]p[m], but opens a new tab. + +Whether the new buffer is activated, depends on the 'activate' option. +________________________________________________________________________________ + + +|gP| + +||gP|| +________________________________________________________________________________ +Open (put) a URL based on the current clipboard contents in a new buffer. +Works like [m]P[m], but inverts the 'activate' option. +________________________________________________________________________________ + + +|<C-x>| +||[count]<C-x>|| +________________________________________________________________________________ +Decrements the last number in URL by 1, or by [count] if given. Negative +numbers are not supported, as this not generally useful, so the number cannot +be decremented past 0. +________________________________________________________________________________ + + +|<C-a>| +||[count]<C-a>|| +________________________________________________________________________________ +Increments the last number in URL by 1, or by [count] if given. +________________________________________________________________________________ + + +|\~| + +||\~|| +________________________________________________________________________________ +Open home directory. You can also use the hints and have the probably fastest +file browser on earth. :) +________________________________________________________________________________ + +section:Navigating[navigating] + +|H| |<C-o>| |CTRL-O| |:ba| |:back| +||:[count]ba[ck][!] [url]|| + +||CTRL-o|| +________________________________________________________________________________ +Go [count] pages back in the browser history. +The special version [c]:back![c] goes to the beginning of the browser history. +________________________________________________________________________________ + + +|L| |<C-i>| |CTRL-i| |:fo| |:fw| |:forward| +||:[count]fo[rward][!] [url]|| + +||CTRL-i|| +________________________________________________________________________________ +Go [count] pages forward in the browser history. +The special version [c]:forward![c] goes to the end of the browser history. +________________________________________________________________________________ + + +|:ju| |:jumps| +||:ju[mps]|| +________________________________________________________________________________ +List all jumps aka current tab's history aka session history. + +Current history position is marked with >, jump numbers are counters +to be used with [c]:back[c] (above zero record) or [c]:forward[c] +(below zero record). +________________________________________________________________________________ + + +|gh| +||gh|| +________________________________________________________________________________ +Go home. Opens the homepage in the current tab. +________________________________________________________________________________ + + +|gH| + +||gH|| +________________________________________________________________________________ +Go home in a new tab. Opens the homepage in a new tab. Whether the new tab is +activated or not depends on the 'activate' option. +________________________________________________________________________________ + + +|gu| +||[count]gu|| +________________________________________________________________________________ +Go to [count]th parent directory. + + +[m]2gu[m] on _http://www.example.com/dir1/dir2/file.htm_ opens +_http://www.example.com/dir1/_. +________________________________________________________________________________ + + +|gU| +||gU|| +________________________________________________________________________________ +Go to the root of the web site. + + +[m]gU[m] on _http://www.example.com/dir1/dir2/file.htm_ opens +_http://www.example.com/_. +When browsing a local directory, it goes to the root directory. +________________________________________________________________________________ + +section:Reloading[reloading] + +|r| +||r|| +________________________________________________________________________________ +Force reloading of the current page. +________________________________________________________________________________ + + +|R| +||R|| +________________________________________________________________________________ +Force reloading of the current page skipping the cache. +________________________________________________________________________________ + + +|:re| |:reload| + +||:re[load][!]|| +________________________________________________________________________________ +Reload current page. Forces reloading of the current page. If [!] is +given, skip the cache. +________________________________________________________________________________ + + +|:reloada| |:reloadall| + +||:reloada[ll][!]|| +________________________________________________________________________________ +Reload all pages. Forces reloading of all pages. If [!] is given, skip the cache. +________________________________________________________________________________ + +section:Stopping[stopping] + +|<C-c>| +||<C-c>|| +________________________________________________________________________________ +Stop loading the current web page. +________________________________________________________________________________ + + +|:st| |:stop| +||:st[op]|| +________________________________________________________________________________ +Stop loading. Stop loading current web page. +________________________________________________________________________________ + +section:Writing[writing,save-file] + +|:w| |:write| |:sav| |:saveas| + +||:sav[eas][!] [file]|| +________________________________________________________________________________ +Save current web page to disk. If [file] is omitted, save to the page's +default filename. Existing documents will only be overwritten if [!] is +given. +________________________________________________________________________________ + +section:Quitting[quitting,save-session] + +|:q| |:quit| + +||:q[uit]|| +________________________________________________________________________________ +Quit current tab. If this is the last tab in the window, close the window. If +this was the last window, close Vimperator. When quitting Vimperator, the +session is not stored. +________________________________________________________________________________ + + +|:qa| |:qall| |:quita| |:quitall| + +||:quita[ll]|| +________________________________________________________________________________ +Quit Vimperator. Quit Vimperator, no matter how many tabs/windows are open. +The session is not stored. +________________________________________________________________________________ + + +|:wc| |:wclose| |:winc| |:winclose| +||:winc[lose]|| + +________________________________________________________________________________ +Close window. +________________________________________________________________________________ + + +|:xa| |:xall| |:wq| |:wqa| |:wqall| +||:wqa[ll]|| + +||:xa[ll]|| +________________________________________________________________________________ +Save the session and quit. Quit Vimperator, no matter how many tabs/windows +are open. The session is stored. [c]:wq[c] is different as in Vim, as it +closes the window instead of just one tab by popular demand. Complain on the +mailing list, if you want to change that. +________________________________________________________________________________ + + +|ZQ| +||ZQ|| +________________________________________________________________________________ +Quit and don't save the session. Works like [c]:qall[c]. +________________________________________________________________________________ + + +|ZZ| +||ZZ|| +________________________________________________________________________________ +Quit and save the session. Quit Vimperator, no matter how many tabs/windows +are open. The session is stored. Works like [c]:xall[c]. +________________________________________________________________________________ + +section:The{nbsp}current{nbsp}directory[current-directory] + +|:chd| |:chdir| |:cd| +||:cd [-|path]|| +________________________________________________________________________________ +Change the current directory. [c]:cd -[c] changes to the last directory. +________________________________________________________________________________ + + +|:pw| |:pwd| +||:pw[d]|| +________________________________________________________________________________ +Print the current directory name. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/buffer.txt b/vimperator/locale/en-US/buffer.txt new file mode 100644 index 00000000..2054c460 --- /dev/null +++ b/vimperator/locale/en-US/buffer.txt @@ -0,0 +1,352 @@ +HEADER + +|buffer| |document| + + +Vimperator holds exactly one buffer object for each tab. It is usually an +(X)HTML document with advanced features. + +section:Buffer{nbsp}information[buffer-information] + +|<C-g>| + +||<C-g>|| +________________________________________________________________________________ +Print the current file name. Also shows some additional file information like +file size or the last modified date. +________________________________________________________________________________ + + +|g<C-g>| + +||g<C-g>|| +________________________________________________________________________________ +Print file information. Same as [c]:pa[geinfo][c]. +________________________________________________________________________________ + + +|:pa| |:pageinfo| + +||:pa[geinfo]|| +________________________________________________________________________________ +Show various page information. See [c]:help 'pageinfo'[c] for available options. +________________________________________________________________________________ + + +|gf| + +||gf|| +________________________________________________________________________________ +View source. Opens the source code of the current web site with the internal +editor in the current tab. +________________________________________________________________________________ + + +|gF| + +||gF|| +________________________________________________________________________________ +View source with an external editor. Opens the source code of the current web +site with the external editor specified by the 'editor' option. For now the +external editor must be able to download and open files from a remote URL. +________________________________________________________________________________ + + +|:vie| |:viewsource| +||:vie[wsource][!] [url]|| + +________________________________________________________________________________ +View source code of current document. If [url] is specified then view the +source of that document. When [!] is given, it is opened with the external +editor. +________________________________________________________________________________ + +section:Motion{nbsp}commands[motion,scrolling] + +|^| |0| + +||0|| +________________________________________________________________________________ +Scroll to the absolute left of the document. Unlike in Vim, [m]0[m] and [m]^[m] +work exactly the same way. +________________________________________________________________________________ + + +|$| + +||$|| +________________________________________________________________________________ +Scroll to the absolute right of the document +________________________________________________________________________________ + + +|<Home>| |gg| + +||[count]gg|| +________________________________________________________________________________ +Go to the top of the document. When used with [count] like in [m]35gg[m], it +scrolls to 35% of the document. +________________________________________________________________________________ + + +|<End>| |G| + +||[count]G|| +________________________________________________________________________________ +Go to the end of the document. When used with [count] like in [m]35G[m], it +scrolls to 35% of the document. +________________________________________________________________________________ + + +|N%| + +||{count}%|| +________________________________________________________________________________ +Scroll to {count} percent of the document. +________________________________________________________________________________ + + +|<Left>| |h| + +||[count]h|| +________________________________________________________________________________ +Scroll document to the left. Count is supported: [m]10h[m] will move 10 times as much to the left. + +If the document cannot scroll more, a beep is emitted (unless 'visualbell' is set). +________________________________________________________________________________ + + +|<C-e>| |<Down>| |j| + +||[count]j|| +________________________________________________________________________________ +Scroll document down. Count is supported: [m]10j[m] will move 10 times as much down. + +If the document cannot scroll more, a beep is emitted (unless 'visualbell' is set). +________________________________________________________________________________ + + +|<C-y>| |<Up>| |k| + +||[count]k|| +________________________________________________________________________________ +Scroll document up. Count is supported: [m]10k[m] will move 10 times as much up. + +If the document cannot scroll more, a beep is emitted (unless 'visualbell' is set). +________________________________________________________________________________ + + +|<C-d>| + +||[count]<C-d>|| +________________________________________________________________________________ +Scroll window downwards in the buffer. The number of lines is set by the +'scroll' option which defaults to half a page. If [count] is given 'scroll' is +first set to this value. +________________________________________________________________________________ + + +|<C-u>| + +||[count]<C-u>|| +________________________________________________________________________________ +Scroll window upwards in the buffer. The number of lines is set by the +'scroll' option which defaults to half a page. If [count] is given 'scroll' is +first set to this value. +________________________________________________________________________________ + + +|<Right>| |l| + +||[count]l|| +________________________________________________________________________________ +Scroll document to the right. Count is supported: [m]10l[m] will move 10 times as much to the right. + +If the document cannot scroll more, a beep is emitted (unless 'visualbell' is set). +________________________________________________________________________________ + + +|<S-Space>| |<PageUp>| |<C-b>| + +||[count]<C-b>|| +________________________________________________________________________________ +Scroll up a full page. Scroll window [count] pages Backwards (upwards) in the buffer. +________________________________________________________________________________ + + +|<Space>| |<PageDown>| |<C-f>| + +||[count]<C-f>|| +________________________________________________________________________________ +Scroll down a full page. Scroll window [count] pages Forwards (downwards) in the buffer. +________________________________________________________________________________ + +section:Jumping{nbsp}to{nbsp}elements[jumping] + +|<Tab>| + +||<Tab>|| +________________________________________________________________________________ +Advance keyboard focus to the next element. +________________________________________________________________________________ + + +|<S-Tab>| + +||<S-Tab>|| +________________________________________________________________________________ +Rewind keyboard focus to the previous element. +________________________________________________________________________________ + + +|gi| + +||[count]gi|| +________________________________________________________________________________ +Focus last used input field. If there is no last input field, it focuses the +first input field. When used with [count] it directly jumps to the [count]th input +field. +________________________________________________________________________________ + + +|]f| + +||[count]]f|| +________________________________________________________________________________ +Focus next frame. Transfer keyboard focus to the [count]th next frame in +order. The newly focused frame is briefly colored red. Does not wrap. +________________________________________________________________________________ + + +|[f| + +||[count][f|| +________________________________________________________________________________ +Focus previous frame. Transfer keyboard focus to the [count]th previous frame +in order. The newly focused frame is briefly colored red. Does not wrap. +________________________________________________________________________________ + + +|]]| + +||[count]]]|| +________________________________________________________________________________ +Follow the link labeled \'next' or \'>' if it exists. Useful when browsing +forums or documentation. Change 'nextpattern' to modify its behavior. It +follows relations between files too. +________________________________________________________________________________ + + +|[[| + +||[count][[|| +________________________________________________________________________________ +Follow the link labeled \'prev', \'previous' or \'<' if it exists. Useful when +browsing forums or documentation. Change 'previouspattern' to modify its +behavior. It follows relations between files too. +________________________________________________________________________________ + +section:Zooming[zooming,zoom] + +The zooming commands are dependent on two properties - a zoom range and a +series of levels within that range. + +The absolute value of the page zoom is limited to a value within the configured +zoom range (default: 30% - 300%). The zoom levels are used by +[m]zi[m]/[m]zo[m], and similar commands, to change the zoom value in steps. The +default zoom levels are 30%, 50%, 67%, 80%, 90%, 100%, 110%, 120%, 133%, 150%, +170%, 200%, 240%, 300%. + +The available zoom range can be changed by setting the \'zoom.minPercent' and +\'zoom.maxPercent' Firefox preferences. The zoom levels can be changed using +the \'toolkit.ZoomManager.zoomLevels' preference. Note: The latter is specified +as a list of values between 0 and 1, not as a percentage. + +|+| |zi| + +||[count]zi|| +________________________________________________________________________________ +Enlarge text zoom of current web page. Mnemonic: zoom in +________________________________________________________________________________ + + +|zm| + +||[count]zm|| +________________________________________________________________________________ +Enlarge text zoom of current web page by a larger amount. Mnemonic: zoom more +________________________________________________________________________________ + + +|-| |zo| + +||[count]zo|| +________________________________________________________________________________ +Reduce text zoom of current web page. Mnemonic: zoom out +________________________________________________________________________________ + + +|zr| + +||[count]zr|| +________________________________________________________________________________ +Reduce text zoom of current web page by a larger amount. Mnemonic: zoom reduce +________________________________________________________________________________ + + +|zz| + +||[count]zz|| +________________________________________________________________________________ +Set text zoom value of current web page. Zoom value can be between 30 and 300%. +If it is omitted, text zoom is reset to 100%. +________________________________________________________________________________ + + +|zI| + +||[count]zI|| +________________________________________________________________________________ +Enlarge full zoom of current web page. Mnemonic: zoom in +________________________________________________________________________________ + + +|zM| + +||[count]zM|| +________________________________________________________________________________ +Enlarge full zoom of current web page by a larger amount. Mnemonic: zoom more +________________________________________________________________________________ + + +|zO| + +||[count]zO|| +________________________________________________________________________________ +Reduce full zoom of current web page. Mnemonic: zoom out +________________________________________________________________________________ + + +|zR| + +||[count]zR|| +________________________________________________________________________________ +Reduce full zoom of current web page by a larger amount. Mnemonic: zoom reduce +________________________________________________________________________________ + + +|zZ| + +||[count]zZ|| +________________________________________________________________________________ +Set full zoom value of current web page. Zoom value can be between 30 and +300%. If it is omitted, full zoom is reset to 100%. +________________________________________________________________________________ + + +|:zo| |:zoom| +||:zo[om][!] [value]|| + +||:zo[om][!] +{value} | -{value}|| + +________________________________________________________________________________ +Set zoom value of current web page. [value] can be an absolute value between 30 +and 300% or a relative value if prefixed with "-" or "+". If [value] is +omitted, zoom is reset to 100%. + +Normally this command operates on the text zoom, if used with [!] it operates +on full zoom. +________________________________________________________________________________ + +section:Copying{nbsp}text[copying,yanking] + +When running in X11 the text of the following commands is not only copied to +the clipboard, but also put into the X11 selection, which can be pasted with +the middle mouse button: + +|y| + +||y|| +________________________________________________________________________________ +Yank current location to the clipboard. When running in X11 the location is +also put into the selection, which can be pasted with the middle mouse button. +________________________________________________________________________________ + + +|Y| + +||Y|| +________________________________________________________________________________ +Copy currently selected text to the system clipboard. +________________________________________________________________________________ + +section:Alternate{nbsp}style{nbsp}sheets[alternate-stylesheet] + +Page authors may specify alternate style sheets for an HTML document. Users +can then switch between these various style sheets, selecting their favorite. + +|:pagest| |:pagestyle| +||:pagest[yle] [stylesheet]|| + +________________________________________________________________________________ +Select the author style sheet to apply. If [stylesheet] is not specified the +page's default style sheet is used. + +All author styling can be removed by setting the 'usermode' option. +________________________________________________________________________________ + +// vim: set syntax=asciidoc fdm=marker: diff --git a/vimperator/locale/en-US/cmdline.txt b/vimperator/locale/en-US/cmdline.txt new file mode 100644 index 00000000..72c0ba12 --- /dev/null +++ b/vimperator/locale/en-US/cmdline.txt @@ -0,0 +1,80 @@ +HEADER + +|Command-line-mode| |Command-line| + + +Command-line mode is used to enter Ex commands (":") and text search patterns +("/" and "?"). + +|:| + +||:|| +________________________________________________________________________________ +Start Command-line mode. In Command-line mode, you can perform extended +commands, which may require arguments. +________________________________________________________________________________ + + +section:Command-line{nbsp}editing[cmdline-editing] + +|c_<C-c>| + +||<C-c>|| +________________________________________________________________________________ +Quit command-line mode without executing. +________________________________________________________________________________ + + +|c_<C-]>| + +||<C-]>|| +________________________________________________________________________________ +Expand a command-line abbreviation. +________________________________________________________________________________ + + +|c_<Up>| + +||<Up>|| +________________________________________________________________________________ +Recall the previous command-line from the history list which matches the +current command-line. +________________________________________________________________________________ + + +|c_<Down>| + +||<Down>|| +________________________________________________________________________________ +Recall the next command-line from the history list which matches the current +command-line. +________________________________________________________________________________ + + +|c_<S-Up>| |c_<PageUp>| +||<S-Up>|| + +||<PageUp>|| +________________________________________________________________________________ +Recall the previous command-line from the history list. +________________________________________________________________________________ + + +|c_<S-Down>| |c_<PageDown>| +||<S-Down>|| + +||<PageDown>|| +________________________________________________________________________________ +Recall the next command-line from the history list. +________________________________________________________________________________ + +section:Command-line{nbsp}completion[cmdline-completion] + +|c_<Tab>| + +||<Tab>|| +________________________________________________________________________________ +Complete the word in front of the cursor according to the behavior specified in +'wildmode'. If 'wildmode' contains "list" and there are multiple matches then +the completion menu window is opened. +________________________________________________________________________________ + + +|c_<S-Tab>| + +||<S-Tab>|| +________________________________________________________________________________ +Complete the previous full match when 'wildmode' contains "full". +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/developer.txt b/vimperator/locale/en-US/developer.txt new file mode 100644 index 00000000..770d3858 --- /dev/null +++ b/vimperator/locale/en-US/developer.txt @@ -0,0 +1,87 @@ +HEADER + +section:Writing{nbsp}documentation[writing-docs,documentation] + +For every new feature, writing documentation is _mandatory_ for the patch to +be accepted. The docs are written in +http://www.methods.co.nz/asciidoc/index.html[asciidoc] version 8.x or +newer. The are placed in the _src/locale/en-US/_ directory and compiled with +_make doc_. Please refer to the +http://www.methods.co.nz/asciidoc/userguide.html[asciidoc documentation] above +for details. Usually you can just write text as is, and mostly it will be +interpreted correctly. The only difficult part is to write special sections +like for help::help[various.html#online-help]. + +---------------------------------------------------------------------------------- +|<F1>| |:help| |:h| |help| +||:h[elp] {subject}|| + +||<F1>|| +____________________________________________________________________________ +Open help window. +The default section is shown unless {subject} is specified. +If you need help for a specific topic, try [c]:help overview[c]. +____________________________________________________________________________ +---------------------------------------------------------------------------------- + +is displayed as: + +++++++++++++++++++++++++++++++++++++++++ +<p><span class="hiddentag"><F1></span> <span +class="hiddentag">:help</span> <span class="hiddentag">:h</span> <span +class="hiddentag">help</span> + +<div class="key">:h[elp] <span class="argument">{subject}</span></div><br /> +<div class="key"><F1></div></p> +<div class="quoteblock"> +<div class="quoteblock-content"> +<p>Open help window. +The default section is shown unless <span class="argument">{subject}</span> is specified. +If you need help for a specific topic, try <span class="command">:help overview</span>.</p> +</div></div> ++++++++++++++++++++++++++++++++++++++++ + +Some notes about the code above: + +- *$$|<F1>|$$* defines a _tag_. A tag is written at the right in magenta and let's + you jump to a topic with [c]:help <F1>[c]. Note that you must write it from + right to left, so in the above example $$|help|$$ will be the most left tag, + and $$|<F1>|$$ the most right one. +- *$$||:h[elp] {subject}|| +$$* and *$$||<F1>||$$* define command or mapping + names and are printed on the left side. Note the + at the end of one + command, that indicates a new line. There is no general rule when a new line + is needed and when not, just try it out and see what looks better. +- The actual help code for this command is embedded in at least 4 underscores + (_). This generates a quoteblock and indents the text so it is more clear + that it belongs to the command. +- Wrap things in *$$[c]$$* and they are drawn like a :command. Also *$$[o]$$* + and *$$[m]$$* are available to show options and mappings. +- Any string within \{...\} and $$[arg]$$, $$[url]$$, $$[count]$$ and $$[!]$$ are + automatically drawn in a blue color. + +There are also some additional asciidoc commands specifically for writing +Vimperator documentation: + +- *$$section:Writing{nbsp}documentation[writing-docs,documentation]$$* Creates + a new section like _Writing Documentation_ in this help file with 2 tags. +- *$$help:developer{nbsp}information[developer.html#documentation]$$* creates + a link with text _developer information_ to the tag _documentation_ in + the file _developer.html_. + + +If you don't know in which file/section you should put some documentation, ask +on the mailing list or on #vimperator. Usually help should be grouped together +in logically connected subject areas like +help:opening{nbsp}web{nbsp}pages[browsing.html#opening]. + +section:Generating{nbsp}documentation[generating-docs] + +You can also autogenerate most of the asciidoc help after you have written a +new command, mapping or option. For this, use: + + :echo util.generateHelp(commands.get("addons"), "Extra text") + +Now you can copy the asciidoc text but always make sure it looks OK after +you compile the help file with "make doc", as the auto-generation might +not work correctly for all special cases. + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/eval.txt b/vimperator/locale/en-US/eval.txt new file mode 100644 index 00000000..0aa8c385 --- /dev/null +++ b/vimperator/locale/en-US/eval.txt @@ -0,0 +1,85 @@ +HEADER + +|expression| |expr| |eval| + + +INTRO TO BE WRITTEN... + +|:ec| |:echo| + +||:ec[ho] {expr}|| +________________________________________________________________________________ +Echo the expression. Useful for showing informational messages. Multiple lines +can be separated by \n. {expr} can either be a quoted string, or any +expression which can be fed to eval() like 4+5. You can also view the source +code of objects and functions if the return value of {expr} is an object or +function. +________________________________________________________________________________ + + +|:echoe| |:echoerr| +||:echoe[rr] {expr}|| + +________________________________________________________________________________ +Echo the expression as an error message. Just like [c]:ec[ho][c], but echoes +the result highlighted as ErrorMsg and saves it to the message history. +________________________________________________________________________________ + + +|:echoe| |:echomsg| +||:echom[sg] {expr}|| + +________________________________________________________________________________ +Echo the expression as an infomational message. Just like [c]:ec[ho][c], but +also saves the message in the the message history. +________________________________________________________________________________ + + +|:exe| |:execute| +||:exe[cute] {expr}|| + +________________________________________________________________________________ +Execute the string that results from the evaluation of {expr} as an Ex command. +Example: [c]:execute "source " + io.getRCFile().path[c] sources the appropriate +RC file. + +Note: Unlike Vim this currently only supports a single argument. +________________________________________________________________________________ + + +|:js| |:javas| |:javascript| +||:javas[cript] \\{cmd\\}|| + +||:javascript <<\\{endpattern\\}\n\\{script\\}\n\\{endpattern\\}|| + +||:javascript[!]|| +________________________________________________________________________________ +Run any JavaScript command through eval(). Acts as a JavaScript interpreter by +passing the argument to `eval()`. +[c]:javascript alert("Hello world")[c] shows a dialog box with the text "Hello world". +[c]:javascript <<EOF[c] reads all the lines until a line starting with "EOF" +is found, and interpret them with the JavaScript _eval()_ function. + +The special version [c]:javascript![c] opens the JavaScript console of +Firefox. + +[m]<Tab>[m] completion is available for [c]:javascript {cmd}<Tab>[c] (but not +yet for the [c]:js <<EOF[c] multiline widget). Be aware that Vimperator needs +to run {cmd} through eval() to get the completions, which could have unwanted +side effects. +________________________________________________________________________________ + +// >> To make the syntax highlighting happy + +|:let| +||:let {var-name} [+-.]= {expr1}|| + +||:let {var-name}|| + +||:let|| +________________________________________________________________________________ +Sets or lists a variable. Sets the variable {var-name} to the value of the +expression {expr1}. If no expression is given, the value of the variable is +displayed.Without arguments, displays a list of all variables. +________________________________________________________________________________ + + +|:unl| |:unlet| +||:unl[et][!] {name} ...|| + +________________________________________________________________________________ +Deletes the variable {name}. Several variable names can be given. When used +with [!] no error message is output for non-existing variables. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/gui.txt b/vimperator/locale/en-US/gui.txt new file mode 100644 index 00000000..7587cb9c --- /dev/null +++ b/vimperator/locale/en-US/gui.txt @@ -0,0 +1,90 @@ +HEADER + +|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. + +|: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] +________________________________________________________________________________ + + +|:addo| |:addons| + +||:addo[ns]|| +________________________________________________________________________________ +Show available Browser 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] [firefox-dialog]|| + +________________________________________________________________________________ +Open a Firefox dialog. + +Available dialogs: +`------------------`----------------------------------- +*about* About 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. +________________________________________________________________________________ + + +|: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. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/hints.txt b/vimperator/locale/en-US/hints.txt new file mode 100644 index 00000000..388e3ea3 --- /dev/null +++ b/vimperator/locale/en-US/hints.txt @@ -0,0 +1,61 @@ +HEADER + +|quick-hints| |hints| + + +INTRO TO BE WRITTEN... + +|f| + +||f\\{hint\\}|| +________________________________________________________________________________ +Start QuickHint mode. In QuickHint mode, every hintable item (according to the +'hinttags' XPath query) is assigned a unique number. You can now either type +this number or type any part of the URL which you want to follow, and it is +followed as soon as it can be uniquely identified. Often it can be useful to +combine these techniques to narrow down results with some letters, and then +typing a single digit to make the match unique. Pressing [m]<Leader>[m] +(defaults to [c]:let mapleader = "\"[c]) toggles "escape-mode", where numbers +are treated as normal text. + +[m]<Esc>[m] stops this mode at any time. +________________________________________________________________________________ + + +|F| + +||F\\{hint\\}|| +________________________________________________________________________________ +Start QuickHint mode, but open link in a new tab. Like normal QuickHint mode +(activated with [m]f[m]) but opens the link in a new tab. +________________________________________________________________________________ + + +|extended-hints| + + +|;| + +||;\\{mode\\}\\{hint\\}|| +________________________________________________________________________________ +Start an extended hint mode. ExtendedHint mode is useful, since in this mode +you can yank link locations, open them in a new window or save images. If +you want to yank the location of hint [a]24[a], press [m];y[m] to start +this hint mode. Then press [a]24[a] to copy the hint location. + +{mode} can be either one of: + + +* [m];[m] to focus a link and hover it with the mouse +* [m]?[m] to show information about the element (incomplete) +* [m]a[m] to save its destination (prompting for save location) +* [m]s[m] to save its destination +* [m]o[m] to open its location in the current tab +* [m]t[m] to open its location in a new tab +* [m]b[m] like [m]t[m] but inverts the option whether the tab is activated +* [m]O[m] to open its location in an [c]:open[c] query +* [m]T[m] to open its location in a [c]:tabopen[c] query +* [m]v[m] to view its destination source +* [m]w[m] to open its destination in a new window +* [m]W[m] to open its location in a [c]:winopen[c] query +* [m]y[m] to yank its destination location +* [m]Y[m] to yank its text description + +Hintable elements for all extended hint modes can be set in the +'extendedhinttags' XPath string. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/index.txt b/vimperator/locale/en-US/index.txt new file mode 100644 index 00000000..08bbe20a --- /dev/null +++ b/vimperator/locale/en-US/index.txt @@ -0,0 +1,314 @@ +HEADER + +|index| + + +This file contains a list of all available commands. + +section:Normal{nbsp}mode[normal-index] + +||<C-^>|| Select the alternate tab or the [count]th tab + +||<C-a>|| Increment last number in URL + +||<C-b>|| Scroll up a full page + +||<C-c>|| Stop loading + +||<C-d>|| Scroll window downwards in the buffer + +||<C-f>|| Scroll down a full page + +||<C-g>|| Print the current file name + +||<C-i>|| Go to a newer position in the jump list + +||<C-l>|| Redraw the screen + +||<C-o>|| Go to an older position in the jump list + +||<C-u>|| Scroll window upwards in the buffer + +||<C-v>|| Pass through next key + +||<C-x>|| Decrement last number in URL + +||<C-z>|| Temporarily ignore all Vimperator key bindings + + +||<Esc>|| Focus content + + +||<F1>|| Open help window + + +||<S-Tab>|| Rewind keyboard focus + +||<Tab>|| Advance keyboard focus + + +||0|| Scroll to the absolute left of the document + +||$|| Scroll to the absolute right of the document + + +||A|| Toggle bookmarked state of current URL + +||B|| Show buffer list + +||D|| Delete current buffer, focus tab to the left + +||F|| Start QuickHint mode, but open link in a new tab + +||G|| Go to the end of the document + +||H|| Go back in the browser history + +||L|| Go forward in the browser history + +||M|| Add new QuickMark for current URL + +||N|| Find previous + +||O|| Open one or more URLs, based on current location + +||P|| Open (put) a URL based on the current clipboard contents in a new buffer + +||R|| Reload while skipping the cache + +||T|| Open one or more URLs in a new tab, based on current location + +||Y|| Copy selected text or current word + + +||a|| Open a prompt to bookmark the current URL + +||b|| Open a prompt to switch buffers + +||d|| Delete current buffer + +||f|| Start QuickHint mode + +||h|| Scroll document to the left + +||i|| Start caret mode + +||j|| Scroll document down + +||k|| Scroll document up + +||l|| Scroll document to the right + +||m|| Set mark at the cursor position + +||n|| Find next + +||o|| Open one or more URLs + +||p|| Open (put) a URL based on the current clipboard contents in the current buffer + +||q|| Record a key sequence into a macro + +||r|| Reload current page + +||t|| Open one or more URLs in a new tab + +||u|| Undo closing of a tab + +||y|| Yank current location to the clipboard + + +||;|| Start an extended hint mode + + +||:|| Enter command-line mode + + +||~|| Open home directory + + +||/|| Search forward for a pattern + +||?|| Search backwards for a pattern + +||*|| Find word under cursor + +||#|| Find word under cursor backwards + + +||N%|| Scroll to {count} percent of the document + + +||'|| Jump to the mark in the current buffer + + +||@|| Play a macro + + +||.|| Repeat the last keyboard command + + +||]f|| Focus next frame + +||[f|| Focus previous frame + +||]]|| Follow the link labeled \'next' or \'>' if it exists + +||[[|| Follow the link labeled \'prev', \'previous' or \'<' if it exists + + +||g$|| Go to the last tab + +||g.|| Redisplay the last command output + +||g0|| Go to the first tab + +||g<C-g>|| Print file information + +||gB|| Repeat last :buffer[!] command in reverse direction + +||gF|| View source with an external editor + +||gH|| Open homepage in a new tab + +||gP|| Open (put) a URL based on the current clipboard contents in a new buffer + +||gT|| Go to previous tab + +||gU|| Go to the root of the website + +||gb|| Repeat last :buffer[!] command + +||gf|| View source + +||gg|| Go to the top of the document + +||gh|| Open homepage + +||gi|| Focus last used input field + +||gn|| Jump to a QuickMark in a new tab + +||go|| Jump to a QuickMark + +||gt|| Go to the next tab + +||gu|| Go to parent directory + + +||ZQ|| Quit and don't save the session + +||ZZ|| Quit and save the session + +||zI|| Enlarge full zoom of current web page + +||zM|| Enlarge full zoom of current web page by a larger amount + +||zO|| Reduce full zoom of current web page + +||zR|| Reduce full zoom of current web page by a larger amount + +||zZ|| Set full zoom value of current web page + +||zi|| Enlarge text zoom of current web page + +||zm|| Enlarge text zoom of current web page by a larger amount + +||zo|| Reduce text zoom of current web page + +||zr|| Reduce text zoom of current web page by a larger amount + +||zz|| Set text zoom value of current web page + + +section:Command-line{nbsp}editing[ex-edit-index] + +||<C-c>|| Quit command-line mode without executing + + +||<C-]>|| Expand a command-line abbreviation + + +||<Up>|| Recall the previous command-line from the history list which matches the current command-line + +||<Down>|| Recall the next command-line from the history list which matches the current command-line + + +||<Tab>|| Complete the word in front of the cursor according to the behavior specified in 'wildmode' + +||<S-Tab>|| Complete the previous full match when 'wildmode' contains "full" + + +section:Ex{nbsp}commands[ex-cmd-index,:index] + +||:!|| Run a command + +||:abbreviate|| Abbreviate a key sequence + +||:abclear|| Remove all abbreviations + +||:addons|| Manage available Extensions and Themes + +||:autocmd|| Execute commands automatically on events + +||:back|| Go back in the browser history + +||:bdelete|| Delete current buffer + +||:beep|| Play a system beep + +||:bmark|| Add a bookmark + +||:bmarks|| List or open multiple bookmarks + +||:buffer|| Switch to a buffer + +||:buffers|| Show a list of all buffers + +||:cabbrev|| Abbreviate a key sequence in command-line mode + +||:cabclear|| Remove all abbreviations in command-line mode + +||:cd|| Change the current directory + +||:cmap|| Map a key sequence in command-line mode + +||:cmapclear|| Remove all mappings in command-line mode + +||:cnoremap|| Map a key sequence without remapping keys in command-line mode + +||:colorscheme|| Load a color scheme + +||:comclear|| Delete all user-defined commands + +||:command|| List and define commands + +||:cunabbrev|| Remove an abbreviation in command-line mode + +||:cunmap|| Remove a mapping in command-line mode + +||:delbmarks|| Delete a bookmark + +||:delcommand|| Delete the specified user-defined command + +||:delmacros|| Delete macros + +||:delmarks|| Delete the specified marks + +||:delqmarks|| Delete the specified QuickMarks + +||:delstyle|| Delete any matching styles + +||:dialog|| Open a undefined dialog + +||:doautoall|| Apply the autocommands matching the specified URL to all buffers + +||:doautocmd|| Apply the autocommands matching the specified URL to the current buffer + +||:downloads|| Show progress of current downloads + +||:echo|| Echo the expression + +||:echoerr|| Echo the expression as an error message + +||:echomsg|| Echo the expression as an informational message + +||:emenu|| Execute the specified menu item from the command-line + +||:execute|| Execute the argument as an Ex command + +||:exusage|| List all Ex commands with a short description + +||:finish|| Stop sourcing a script file + +||:forward|| Go forward in the browser history + +||:hardcopy|| Print current document + +||:help|| Display help + +||:highlight|| Style Vimperator + +||:history|| Show recently visited URLs + +||:iabbrev|| Abbreviate a key sequence in insert mode + +||:iabclear|| Remove all abbreviations in insert mode + +||:imap|| Map a key sequence in insert mode + +||:imapclear|| Remove all mappings in insert mode + +||:inoremap|| Map a key sequence without remapping keys in insert mode + +||:iunabbrev|| Remove an abbreviation in insert mode + +||:iunmap|| Remove a mapping in insert mode + +||:javascript|| Run a JavaScript command through eval() + +||:jumps|| Show jumplist + +||:let|| Set or list a variable + +||:loadplugins|| Immediately load all unloaded plugins + +||:macros|| List all macros + +||:map|| Map a key sequence + +||:mapclear|| Remove all mappings + +||:mark|| Mark current location within the web page + +||:marks|| Show all location marks of current web page + +||:messages|| Display previously given messages + +||:mkvimperatorrc|| Write current key mappings and changed options to the config file + +||:nohlsearch|| Remove the search highlighting + +||:noremap|| Map a key sequence without remapping keys + +||:normal|| Execute Normal mode commands + +||:open|| Open one or more URLs in the current tab + +||:optionusage|| List all options with a short description + +||:pageinfo|| Show various page information + +||:pagestyle|| Select the author style sheet to apply + +||:play|| Replay a recorded macro + +||:preferences|| Show Firefox preferences + +||:pwd|| Print the current directory name + +||:qmark|| Mark a URL with a letter for quick access + +||:qmarks|| Show all QuickMarks + +||:quit|| Quit current tab + +||:quitall|| Quit undefined + +||:redraw|| Redraw the screen + +||:reload|| Reload current page + +||:reloadall|| Reload all tab pages + +||:restart|| Force undefined to restart + +||:runtime|| Source the specified file from each directory in 'runtimepath' + +||:saveas|| Save current document to disk + +||:sbclose|| Close the sidebar window + +||:scriptnames|| List all sourced script names + +||:set|| Set an option + +||:setglobal|| Set global option + +||:setlocal|| Set local option + +||:sidebar|| Open the sidebar window + +||:style|| Style Vimperator and web sites + +||:source|| Read Ex commands from a file + +||:stop|| Stop loading + +||:tab|| Execute a command and tell it to output in a new tab + +||:tabdetach|| Detach current tab to its own window + +||:tabduplicate|| Duplicate current tab + +||:tablast|| Switch to the last tab + +||:tabmove|| Move the current tab after tab N + +||:tabnext|| Switch to the next or [count]th tab + +||:tabonly|| Close all other tabs + +||:tabopen|| Open one or more URLs in a new tab + +||:tabprevious|| Switch to the previous tab or go [count] tabs back + +||:tabrewind|| Switch to the first tab + +||:time|| Profile a piece of code or run a command multiple times + +||:unabbreviate|| Remove an abbreviation + +||:undo|| Undo closing of a tab + +||:undoall|| Undo closing of all closed tabs + +||:unlet|| Delete a variable + +||:unmap|| Remove a mapping + +||:version|| Show version information + +||:viewsource|| View source code of current document + +||:viusage|| List all mappings with a short description + +||:winclose|| Close window + +||:winopen|| Open one or more URLs in a new window + +||:wqall|| Save the session and quit + +||:zoom|| Set zoom value of current web page + + +section:Options[option-index] + +||'activate'|| Define when tabs are automatically activated + +||'autodetector'|| set auto detect character encoding + +||'cdpath'|| List of directories searched when executing :cd + +||'complete'|| Items which are completed at the :[tab]open prompt + +||'defsearch'|| Set the default search engine + +||'disabledcssheets'|| Set disabled CSS stylesheets + +||'editor'|| Set the external text editor + +||'errorbells'|| Ring the bell when an error message is displayed + +||'eventignore'|| List of autocommand event names which should be ignored + +||'exrc'|| Allow reading of an RC file in the current directory + +||'extendedhinttags'|| XPath string of hintable elements activated by ';' + +||'fileencoding'|| set the charactor encoding for the current page + +||'focuscontent'|| Try to stay in normal mode after loading a web page + +||'followhints'|| Change the behaviour of [m]<Return>[m] in hint mode + +||'fullscreen'|| Show the current window fullscreen + +||'guioptions'|| Show or hide certain GUI elements like the menu or toolbar + +||'helpfile'|| Name of the main help file + +||'hintmatching'|| How links are matched + +||'hinttags'|| XPath string of hintable elements activated by [m]f[m] and [m]F[m] + +||'hinttimeout'|| Automatically follow non unique numerical hint + +||'history'|| Number of Ex commands and search patterns to store in the command-line history + +||'hlsearch'|| Highlight previous search pattern matches + +||'ignorecase'|| Ignore case in search patterns + +||'incsearch'|| Show where the search pattern matches as it is typed + +||'insertmode'|| Use Insert mode as the default for text areas + +||'laststatus'|| Show the status line + +||'linksearch'|| Limit the search to hyperlink text + +||'loadplugins'|| Load plugin scripts when starting up + +||'messages'|| Number of messages to store in the message history + +||'more'|| Pause the message list window when more than one screen of listings is displayed + +||'newtab'|| Define which commands should output in a new tab by default + +||'nextpattern'|| Patterns to use when guessing the \'next' page in a document sequence + +||'online'|| Set the \'work offline' option + +||'pageinfo'|| Desired info on :pa[geinfo] + +||'popups'|| Where to show requested popup windows + +||'preload'|| Speed up first time history/bookmark completion + +||'previouspattern'|| Patterns to use when guessing the \'previous' page in a document sequence + +||'runtimepath'|| List of directories searched for runtime files + +||'scroll'|| Number of lines to scroll with and commands + +||'shell'|| Shell to use for executing :! and :run commands + +||'shellcmdflag'|| Flag passed to shell when executing :! and :run commands + +||'showmode'|| Show the current mode in the command-line + +||'showstatuslinks'|| Show the destination of the link under the cursor in the status bar + +||'showtabline'|| Control when to show the tab bar of opened web pages + +||'smartcase'|| Override the 'ignorecase' option if the pattern contains uppercase characters + +||'suggestengines'|| Engine Alias which has a feature of suggest + +||'titlestring'|| Change the title of the window + +||'urlseparator'|| Set the separator regexp used to separate multiple URL args + +||'usermode'|| Show current website with a minimal style sheet to make it easily accessible + +||'verbose'|| Define which info messages are displayed + +||'visualbell'|| Use visual bell instead of beeping on errors + +||'wildcase'|| Completion case matching mode + +||'wildignore'|| List of file patterns to ignore when completing files + +||'wildmode'|| Define how command-line completion works + +||'wildoptions'|| Change how command-line completion is done + +||'wordseparators'|| How words are split for hintmatching + + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/intro.txt b/vimperator/locale/en-US/intro.txt new file mode 100644 index 00000000..d2e5f16a --- /dev/null +++ b/vimperator/locale/en-US/intro.txt @@ -0,0 +1,116 @@ +LOGO + ++++<center>+++ +*First there was a Navigator, then there was an Explorer. +Later it was time for a Konqueror. Now it's time for an Imperator, the +VIMperator :)* ++++</center>+++ + +section:Introduction[intro] + +http://vimperator.mozdev.org[Vimperator] is a free browser add-on for Firefox, +which makes it look and behave like the http://www.vim.org[Vim] +text editor. It has similar key bindings, and you could call it a modal +web browser, as key bindings differ according to which mode you are in. + +|warning| + +Warning: +To provide the most authentic Vim experience, the Firefox menubar and toolbar were hidden. + +If you really need them, type: [c]:set guioptions+=mT[c] to get them back. + +If you don't like Vimperator at all, you can uninstall it by typing +[c]:addons[c] and remove/disable it. + +If you like it, but can't remember the shortcuts, press [m]F1[m] or +[c]:help[c] to get this help window back. + +|author| |donation| + +Vimperator was written by mailto:stubenschrott@gmx.net[Martin Stubenschrott]. +If you appreciate my work on Vimperator and want to encourage me working on it +more, you can either send me greetings, patches or make a donation: + +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ +<!-- the PAYPAL code --> +<center> +<form action="https://www.paypal.com/cgi-bin/webscr" method="post"><fieldset class="paypal"> +<input type="hidden" name="cmd" value="_s-xclick"/> +<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but21.gif" name="submit" alt="Make payments with PayPal - it\'s fast, free and secure!"/> +<img alt="" src="https://www.paypal.com/en_US/i/scr/pixel.gif" width="1" height="1"/> +<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----MIIHPwYJKoZIhvcNAQcEoIIHMDCCBywCAQExggEwMIIBLAIBADCBlDCBjjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYDVQQKEwtQYXlQYWwgSW5jLjETMBEGA1UECxQKbGl2ZV9jZXJ0czERMA8GA1UEAxQIbGl2ZV9hcGkxHDAaBgkqhkiG9w0BCQEWDXJlQHBheXBhbC5jb20CAQAwDQYJKoZIhvcNAQEBBQAEgYBDDJfc+lXLBSAM9XSWv/ebzG/L7PTqYiIXaWVg8pfinDsfYaAcifcgCTuApg4v/VaZIQ/hLODzQu2EvmjGXP0twErA/Q8G5gx0l197PJSyVXb1sLwd1mgOdLF4t0HmDCdEI9z3H6CMhsb3xVwlfpzllSfCIqzlSpx4QtdzEZGzLDELMAkGBSsOAwIaBQAwgbwGCSqGSIb3DQEHATAUBggqhkiG9w0DBwQI8ZOwn5QkHgaAgZjjtPQxB7Vw2rS7Voap9y+xdVLoczUQ97hw+bOdZLcGykBtfoVjdn76MS51QKjGp1fEmxkqTuQ+Fxv8+OVtHu0QF/qlrhmC3fJBRJ0IFWxKdXS+Wod4615BDaG2X1hzvCL443ffka8XlLSiFTuW43BumQs/O+6Jqsk2hcReP3FIQOvtWMSgGTALnZx7x5c60u/3NSKW5qvyWKCCA4cwggODMIIC7KADAgECAgEAMA0GCSqGSIb3DQEBBQUAMIGOMQswCQYDVQQGEwJVUzELMAkGA1UECBMCQ0ExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC1BheVBhbCBJbmMuMRMwEQYDVQQLFApsaXZlX2NlcnRzMREwDwYDVQQDFAhsaXZlX2FwaTEcMBoGCSqGSIb3DQEJARYNcmVAcGF5cGFsLmNvbTAeFw0wNDAyMTMxMDEzMTVaFw0zNTAyMTMxMDEzMTVaMIGOMQswCQYDVQQGEwJVUzELMAkGA1UECBMCQ0ExFjAUBgNVBAcTDU1vdW50YWluIFZpZXcxFDASBgNVBAoTC1BheVBhbCBJbmMuMRMwEQYDVQQLFApsaXZlX2NlcnRzMREwDwYDVQQDFAhsaXZlX2FwaTEcMBoGCSqGSIb3DQEJARYNcmVAcGF5cGFsLmNvbTCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAwUdO3fxEzEtcnI7ZKZL412XvZPugoni7i7D7prCe0AtaHTc97CYgm7NsAtJyxNLixmhLV8pyIEaiHXWAh8fPKW+R017+EmXrr9EaquPmsVvTywAAE1PMNOKqo2kl4Gxiz9zZqIajOm1fZGWcGS0f5JQ2kBqNbvbg2/Za+GJ/qwUCAwEAAaOB7jCB6zAdBgNVHQ4EFgQUlp98u8ZvF71ZP1LXChvsENZklGswgbsGA1UdIwSBszCBsIAUlp98u8ZvF71ZP1LXChvsENZklGuhgZSkgZEwgY4xCzAJBgNVBAYTAlVTMQswCQYDVQQIEwJDQTEWMBQGA1UEBxMNTW91bnRhaW4gVmlldzEUMBIGA1UEChMLUGF5UGFsIEluYy4xEzARBgNVBAsUCmxpdmVfY2VydHMxETAPBgNVBAMUCGxpdmVfYXBpMRwwGgYJKoZIhvcNAQkBFg1yZUBwYXlwYWwuY29tggEAMAwGA1UdEwQFMAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAgV86VpqAWuXvX6Oro4qJ1tYVIT5DgWpE692Ag422H7yRIr/9j/iKG4Thia/Oflx4TdL+IFJBAyPK9v6zZNZtBgPBynXb048hsP16l2vi0k5Q2JKiPDsEfBhGI+HnxLXEaUWAcVfCsQFvd2A1sxRr67ip5y2wwBelUecP3AjJ+YcxggGaMIIBlgIBATCBlDCBjjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAkNBMRYwFAYDVQQHEw1Nb3VudGFpbiBWaWV3MRQwEgYDVQQKEwtQYXlQYWwgSW5jLjETMBEGA1UECxQKbGl2ZV9jZXJ0czERMA8GA1UEAxQIbGl2ZV9hcGkxHDAaBgkqhkiG9w0BCQEWDXJlQHBheXBhbC5jb20CAQAwCQYFKw4DAhoFAKBdMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8XDTA3MDMyMTIyMzI1OFowIwYJKoZIhvcNAQkEMRYEFCirrvlwYVHQiNEEbM6ikfx9+Dm5MA0GCSqGSIb3DQEBAQUABIGAtbsR8GdCdURLziozXLSdtY+zJZUPPeQFXXy2V1S/3ldiN+pRvd4HI7xz8mOY1UaKJZpwZnOosy9MflL1/hbiEtEyQ2Dm/s4jnTcJng/NjLIZu+0NYxXRJhB+zMJubnMMMjzNrGlqI4F2HAB/bCA1eOJ5B83Of3dA4rk/T/8GoSQ=-----END PKCS7-----"/> +</fieldset></form> +</center> +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ + +Of course as a believer in free open source software, only make a donation +if you really like Vimperator and the money doesn't hurt - otherwise just use +it, recommend it and like it :) + +section:Help{nbsp}topics[overview] + +- help:Tutorial[tutorial.html]: A quick-start tutorial for new users. +- help:Initialization[starting.html]: How Vimperator starts up, where it reads + the config file... +- help:Browsing[browsing.html]: Basic mappings and commands needed for a + browsing session (how to open a web page or go back in history). +- help:Buffer{nbsp}commands[buffer.html]: Operations on the current document + like scrolling or copying text. +- help:Command-line[cmdline.html]: Command-line editing. +- help:Options[options.html]: A description of all options. +- help:Search{nbsp}commands[pattern.html]: Searching for text in the + current buffer. +- help:Tabs[tabs.html]: Managing your tabbed browsing session. +- help:Hints[hints.html]: Selecting hyperlinks. +- help:Key{nbsp}mapping{nbsp}and{nbsp}abbreviations[map.html]: Defining new key + mappings, abbreviations and user commands. +- help:Expression{nbsp}evaluation[eval.html]: Executing JavaScript. +- help:Marks[marks.html]: Using bookmarks, QuickMarks, history and local marks. +- help:Repeating{nbsp}commands[repeat.html]: Using macros to repeat recurring workflows. +- help:Autocommands[autocommands.html]: Automatically executing code on certain + events. +- help:Print[print.html]: Printing pages. +- help:GUI[gui.html]: Accessing Firefox menus, dialogs and the sidebar. +- help:Styling[styling.html]: Changing the styling of content pages and Vimperator itself. +- help:Messages[message.html]: A description of messages and error messages. +- help:Developer{nbsp}information[developer.html]: How to write docs or + plugins. +- help:Various[various.html]: Other help which didn't fit into any other + category. +- help:Index[index.html]: An index of all commands and options. + +You can also jump directly to the help of a specific command with [c]:help o[c] +or [c]:help :set[c]. + +section:Features[features] + +* Vim-like keybindings ([m]h[m], [m]j[m], [m]k[m], [m]l[m], + [m]gg[m], [m]G[m], [m]0[m], [m]$[m], [m]ZZ[m], [m]<C-f>[m], etc.) +* Ex commands ([c]:quit[c], [c]:open www.foo.com[c], ...) +* Tab completion available for all commands with support for 'longest' matching when set in 'wildmode' +* Hit-a-hint like navigation of links (start with [m]f[m] to follow a link) +* Advanced completion of bookmark and history URLs (searching also in title, not only URL) +* Vim-like statusline with a wget-like progress bar +* Minimal GUI (easily hide useless menubar and toolbar with [c]:set guioptions=[c]) +* Ability to [c]:source[c] JavaScript files, and to use a [a]~/.vimperatorrc[a] file + with syntax highlighting if you install scripts/vimperator.vim +* Easy quick searches ([c]:open foo[c] will search for "foo" in google, + [c]:open ebay terminator[c] will search for "terminator" on ebay) + with support for Firefox keyword bookmarks and search engines +* Count supported for many commands ([m]3<C-o>[m] will go back 3 pages) +* Beep on errors +* Marks support ([m]ma[m] to set mark a on a web page, [m]'a[m] to go there) +* QuickMarks support (quickly go to previously marked web pages with [m]go[m][a]\\{a-zA-Z0-9\\}[a]) +* [c]:map[c] and [c]:command[c] support (and feedkeys() for script writers) +* [c]:time[c] support for profiling +* Move the text cursor and select text with Vim keys and a visual mode +* External editor support +* Macros to replay key strokes +* AutoCommands to execute action on certain events +* A comprehensive help file, explaining all commands, mappings and options. + +section:Contact[contact] + +Please send comments/bug reports/patches to the mailing list, where I will +properly answer any questions. You can also join the #vimperator IRC channel +on irc.freenode.net or check the Wiki for frequently asked questions. Make +sure, you have read the TODO file first, as I am aware of many things which +can be improved when I find time for it or get patches. + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/map.txt b/vimperator/locale/en-US/map.txt new file mode 100644 index 00000000..2e7802cd --- /dev/null +++ b/vimperator/locale/en-US/map.txt @@ -0,0 +1,390 @@ +HEADER + +Key mappings, abbreviations, and user-defined commands. + +section:Key{nbsp}mapping[key-mapping,mapping,macro] + +The key mapping commands can be used to either redefine the standard key +bindings or define new ones. A mapping consists of a key, or sequence of keys, +which are translated to a string of characters. Example: + + :map <F2> :echo new Date().toDateString()<CR> + +will echo the current date to the command-line when [m]<F2>[m] is pressed. + +There are separate key mapping tables for each of the Normal, Insert, +Command-line modes. + +|:map-special-chars| + + +|<Nop>| + +||<Nop>|| +________________________________________________________________________________ +Do nothing. This command is useful for disabling a specific mapping. [c]:map +<C-n> <Nop>[c] will prevent [m]<C-n>[m] from doing anything. +________________________________________________________________________________ + + +|<CR>| |map_return| + +||<CR>|| +________________________________________________________________________________ +Expand to a line terminator in a key mapping. An Ex command in the {rhs} of a +mapping requires a a line terminator after it so that it is executed when the +mapping is expanded. [m]<CR>[m] should be used for this purpose. +________________________________________________________________________________ + + +|<Leader>| |mapleader| + +||<Leader>|| +________________________________________________________________________________ +Expands to the value of the "mapleader" variable in key mapping. If +"mapleader" is unset or empty then "\" is used. Example: + +\{nbsp}[c]:map <Leader>h :echo "Hello"<CR>[c] + +works like + +\{nbsp}[c]:map \h :echo "Hello"<CR>[c] + +but after + +\{nbsp}[c]let mapleader = ","[c] + +it works like + +\{nbsp}[c]:map ,h :echo "Hello"<CR>[c] +________________________________________________________________________________ + + +|:map| +||:map {lhs} {rhs}|| + +||:map {lhs}|| + +||:map|| +________________________________________________________________________________ +Map the key sequence {lhs} to {rhs}. The {rhs} is remapped, allowing for +nested and recursive mappings. + +Warning: Mappings are NOT saved during sessions, make sure you put them in your +vimperatorrc file! +________________________________________________________________________________ + + +|:cm| |:cmap| +||:cmap {lhs} {rhs}|| + +||:cmap {lhs}|| + +||:cmap|| +________________________________________________________________________________ +Map the key sequence {lhs} to {rhs} (in Command-line mode). The {rhs} is +remapped, allowing for nested and recursive mappings. + +Warning: Mappings are NOT saved during sessions, make sure you put them in your +vimperatorrc file! +________________________________________________________________________________ + + +|:im| |:imap| +||:imap {lhs} {rhs}|| + +||:imap {lhs}|| + +||:imap|| +________________________________________________________________________________ +Map the key sequence {lhs} to {rhs} (in insert mode). The {rhs} is remapped, +allowing for nested and recursive mappings. + +Warning: Mappings are NOT saved during sessions, make sure you put them in your +vimperatorrc file! +________________________________________________________________________________ + + +|:mapc| |:mapclear| + +||:mapc[lear]|| +________________________________________________________________________________ +Remove all mappings. All user-defined mappings which were set by [c]:map[c] or +[c]:noremap[c] are cleared. +________________________________________________________________________________ + + +|:cmapc| |:cmapclear| + +||:cmapc[lear]|| +________________________________________________________________________________ +Remove all mappings (in Command-line mode). All user-defined mappings which +were set by [c]:cmap[c] or [c]:cnoremap[c] are cleared. +________________________________________________________________________________ + + +|:imapc| |:imapclear| + +||:imapc[lear]|| +________________________________________________________________________________ +Remove all mappings (in insert mode). All user-defined mappings which were set +by [c]:imap[c] or [c]:inoremap[c] are cleared. +________________________________________________________________________________ + + +|:no| |:noremap| + +||:no[remap] {lhs} {rhs}|| + +||:no[remap] {lhs}|| + +||:no[remap]|| +________________________________________________________________________________ +Map the key sequence {lhs} to {rhs}. No remapping of the {rhs} is performed. +________________________________________________________________________________ + + +|:cno| |:cnoremap| + +||:cno[remap] {lhs} {rhs}|| + +||:cno[remap] {lhs}|| + +||:cno[remap]|| +________________________________________________________________________________ +Map the key sequence {lhs} to {rhs} (in Command-line mode). No remapping of +the {rhs} is performed. +________________________________________________________________________________ + + +|:ino| |:inoremap| + +||:ino[remap] {lhs} {rhs}|| + +||:ino[remap] {lhs}|| + +||:ino[remap]|| +________________________________________________________________________________ +Map the key sequence {lhs} to {rhs} (in insert mode). No remapping of the +{rhs} is performed. +________________________________________________________________________________ + + +|:map-<silent>| + +________________________________________________________________________________ +When the first argument to one of the mapping commands is <silent>, {rhs} +is not echoed to the commandline, nor, for that matter, is anything else +until the command has completed. +________________________________________________________________________________ + + + +|:unm| |:unmap| + +||:unm[ap] {lhs}|| +________________________________________________________________________________ +Remove the mapping of {lhs}. +________________________________________________________________________________ + + +|:cunm| |:cunmap| + +||:cunm[ap] {lhs}|| +________________________________________________________________________________ +Remove the mapping of {lhs} (in Command-line mode). +________________________________________________________________________________ + + +|:iunm| |:iunmap| + +||:iunm[ap] {lhs}|| +________________________________________________________________________________ +Remove the mapping of {lhs} (in insert mode). +________________________________________________________________________________ + +section:Abbreviations[abbreviations] + +|:ab| |:abbreviate| +||:ab[breviate] {lhs} {rhs}|| + +||:ab[breviate] {lhs}|| + +||:ab[breviate]|| +________________________________________________________________________________ +Abbreviate a key sequence. Abbreviate {lhs} to {rhs}. +If only {lhs} given, list that particular abbreviation. +List all abbreviations, if no arguments to are given. +________________________________________________________________________________ + + +|:ca| |:cabbrev| +||:ca[bbrev] {lhs} {rhs}|| + +||:ca[bbrev] {lhs}|| + +||:ca[bbrev]|| +________________________________________________________________________________ +Abbreviate a key sequence for Command-line mode. Same as [c]:ab[reviate][c], +but for Command-line mode only. +________________________________________________________________________________ + + +|:ia| |:iabbrev| +||:ia[bbrev] {lhs} {rhs}|| + +||:ia[bbrev] {lhs}|| + +||:ia[bbrev]|| +________________________________________________________________________________ +Abbreviate a key sequence for Insert mode. Same as [c]:ab[breviate][c], but +for Insert mode only. +________________________________________________________________________________ + + +|:una| |:unabbreviate| +||:una[bbreviate] {lhs}|| + +________________________________________________________________________________ +Remove an abbreviation. +________________________________________________________________________________ + + +|:cuna| |:cunabbrev| +||:cuna[bbrev] {lhs}|| + +________________________________________________________________________________ +Remove an abbreviation for Command-line mode. Same as [c]:una[bbreviate][c], +but for Command-line mode only. +________________________________________________________________________________ + + +|:iuna| |:iunabbrev| +||:iuna[bbrev] {lhs}|| + +________________________________________________________________________________ +Remove an abbreviation for Insert mode. Same as [c]:una[bbreviate][c], but for +Insert mode only. +________________________________________________________________________________ + + +|:abc| |:abclear| + +||:abc[lear]|| +________________________________________________________________________________ +Remove all abbreviations. +________________________________________________________________________________ + + +|:cabc| |:cabclear| + +||:cabc[lear]|| +________________________________________________________________________________ +Remove all abbreviations for Command-line mode. +________________________________________________________________________________ + + +|:iabc| |:iabclear| + +||:iabc[lear]|| +________________________________________________________________________________ +Remove all abbreviations for Insert mode. +________________________________________________________________________________ + +section:User-defined{nbsp}commands[user-commands] + +|:com| |:command| +||:com[mand]|| + +________________________________________________________________________________ +List all user-defined commands. +________________________________________________________________________________ + +||:com[mand] {cmd}|| + +________________________________________________________________________________ +List all user-defined commands that start with {cmd}. +________________________________________________________________________________ + + +||:com[mand][!] [{attr}...] {cmd} {rep}|| + +________________________________________________________________________________ +Define a new user command. The name of the command is {cmd} and its replacement +text is {rep}. The command's attributes are {attr}. If a command with this name +already exists an error is reported unless [!] is specified, in which case the +command is redefined. Unlike Vim, the command may start with a lowercase +letter. + +The command's behavior can be specified by providing attributes when the +command is defined. + +|E175| |E176| |:command-nargs| + +Argument handling + +By default user commands accept no arguments. This can be changed by specifying +the -nargs attribute. + +The valid values are: +`----------`-------------------------------------------------------------------- +*-nargs=0* No arguments are allowed (default) +*-nargs=1* One argument is allowed +*-nargs=** Zero or more arguments are allowed +*-nargs=?* Zero or one argument is allowed +*-nargs=+* One or more argument is allowd +-------------------------------------------------------------------------------- + +|E180| |E181| |:command-complete| + +Argument completion + +Completion for arguments to user defined commands is not available by default. +Completion can be enabled by specifying one of the following arguments to the +-complete option when defining the command. +`----------------`-------------------------------------------------------------- +*altstyle* alternate author style sheets +*bookmark* bookmarks +*buffer* buffers +*color* color schemes +*command* Ex commands +*dialog* Firefox dialogs +*dir* directories +*environment* environment variables +*event* autocommand events +*file* files +*help* help tags +*highlight* highlight groups +*javascript* JavaScript expressions +*macro* named macros +*mapping* user mappings +*menu* menu items +*option* Vimperator options +*preference* Firefox preferences +*search* search engines and keywords +*shellcmd* shell commands +*sidebar* sidebar panels +*url* URLs +*usercommand* user commands +*custom,{func}* custom completion, provided by {func} +-------------------------------------------------------------------------------- + +|E467| |E468| |:command-completion-custom| + +Custom completion + +Custom completion can be provided by specifying the "custom,{func}" argument to +-complete. The {func} is called with one argument, the word being completed, +and should return an array [start, completions]. + +*start* is the index into the word being completed at which the returned values +should be applied and *completions* is a two dimensional array of the form: +\[[arg1, description1], [arg2, description2], ...] + +// TODO: add examples + +|E177| |E178| |:command-count| + +Count handling + +By default user commands do not accept a count. Use the -count attribute if +you'd like to have a count passed to your user command. This will then be +available for expansion as <count> in the argument. + +|:command-bang| + +Special cases + +By default a user command does not have a special version. i.e. a version +executed with the ! modifier. Providing the -bang attribute will enable this +and <bang> will be available in the argument. + +|:command-replacement-text| + +Replacement text + +The replacement text {rep} is scanned for escape sequences and these are +replaced with values from the user entered command-line. The resulting string +is then executed as an Ex command. + +The valid escape sequences are: +`----------`-------------------------------------------------------------------- +*<args>* The command arguments exactly as supplied +*<count>* Any supplied count E.g. 5 +*<bang>* ! if the command was executed with the ! modifier +*<lt>* A literal '<' character to allow for a literal copy of one of the escape sequences. E.g. <lt>args> will expand to a literal <args> +-------------------------------------------------------------------------------- + +"q-" can be prefixed to the escape sequence so that the value is quoted, making +it suitable for expression evaluation. Example: <q-args> +________________________________________________________________________________ + + +|:comc| |:comclear| + +||:comc[lear]|| +________________________________________________________________________________ +Delete all user-defined commands. +________________________________________________________________________________ + + +|:delc| |:delcommand| +||:delc[ommand] {cmd}|| + +________________________________________________________________________________ +Delete the user-defined command {cmd}. +________________________________________________________________________________ + +section:Examples[command-examples] + +Add a :Google command to search via google: + + :command -nargs=* Google open google <args> + +// TODO: add decent examples + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/marks.txt b/vimperator/locale/en-US/marks.txt new file mode 100644 index 00000000..9fc79ad6 --- /dev/null +++ b/vimperator/locale/en-US/marks.txt @@ -0,0 +1,238 @@ +HEADER + +|different-marks| |marks| + + +Vimperator supports a number of different marks: + +- Bookmarks which allow you to mark a web page as one of your favorites for + easy access. +- QuickMarks allow you to define up to 62 (a-zA-Z0-9) web sites (or group of + web sites) which you visit most often. +- Local marks to store the position within a web page. +- History is also a special type of marks, as Vimperator automatically + remembers sites which you have visited in the past. + +section:Bookmarks[bookmarks] + +|a| |:bma| |:bmark| +||:bma[rk][!] [-title=title] [-keyword=kw] [-tags=tag1,tag2] [url]|| + +||a|| +____________________________________________________________________________ +Add a bookmark. + + +The following options are interpreted: + +- -title="custom title" (short option: -t) +- -tags=comma,separated,tag,list (short option: -T) +- -keyword=keyword (short option: -k) + +If [!] is present, a new bookmark is always added. Otherwise, the first +bookmark matching [url] is updated. +When creating a new bookmark, if [-title] isn't given, either the web page's +title or URL is used. You can omit the optional [url] argument, so just do +[c]:bmark[c] to bookmark the currently loaded web page with a default title and +without any tags. +____________________________________________________________________________ + + +|A| + +||A|| +________________________________________________________________________________ +Toggle bookmarked state of current URL. Add/remove a bookmark for the current +location, depending if it already is bookmarked or not. In contrast to the +[c]:bmark[c] command, the bookmark is just _starred_ which means it is placed +in the _Unfiled Bookmarks Folder_ instead of the bookmarks menu. +________________________________________________________________________________ + + +|:bmarks| +||:bmarks[!] [filter]|| + +________________________________________________________________________________ +List or open multiple bookmarks. Open the message window at the bottom of the +screen with all bookmarks which match [filter] either in the title or URL. + +The special version [c]:bmarks![c] works the same as [c]:bmarks[c] except it +opens all the found bookmarks in new tabs. + +Filter can also contain the following options: + +-tags=comma,separated,tag,list + +________________________________________________________________________________ + + +|:delbm| |:delbmarks| +||:delbm[arks] [url]|| + +________________________________________________________________________________ +Delete a bookmark. Deletes *all* bookmarks which match the [url]. +If omitted, [url] defaults to the URL of the current buffer. Use [m]<Tab>[m] +key on a string to complete the URL which you want to delete. + +The following options WILL be interpreted in the future: + +* [!] a special version to delete ALL bookmarks +________________________________________________________________________________ + +section:History[history] + +|<C-o>| + +||[count]<C-o>|| +________________________________________________________________________________ +Go to an older position in the jump list. The jump list is just the browser +history for now. +________________________________________________________________________________ + + +|<C-i>| + +||[count]<C-i>|| +________________________________________________________________________________ +Go to a newer position in the jump list. The jump list is just the browser +history for now. +________________________________________________________________________________ + + +|<M-Left>| |<A-Left>| |H| + +||[count]H|| +________________________________________________________________________________ +Go back in the browser history. Count is supported: [m]3H[m] goes back 3 steps. +________________________________________________________________________________ + + +|<M-Right>| |<A-Right>| |L| + +||[count]L|| +________________________________________________________________________________ +Go forward in the browser history. Count is supported: [m]3L[m] goes forward 3 steps. +________________________________________________________________________________ + + +|:ba| |:back| +||:[count]ba[ck][!] [url]|| + +________________________________________________________________________________ +Go back in the browser history. Count is supported, [c]:3back[c] goes back 3 +pages in the browser history. + +The special version [c]:back![c] goes to the beginning of the browser history. +________________________________________________________________________________ + + +|:fw| |:fo| |:forward| +||:[count]fo[rward][!] [url]|| + +________________________________________________________________________________ +Go forward in the browser history. Count is supported, [c]:3forward[c] goes +forward 3 pages in the browser history. The special version [c]:forward![c] +goes to the end of the browser history. +________________________________________________________________________________ + + +|:hs| |:hist| |:history| +||:hist[ory][!] [filter]|| + +________________________________________________________________________________ +Show recently visited URLs. Open the message window at the bottom of the +screen with all history items which match [filter] either in the title or URL. +The special version [c]:history![c] works the same as [c]:history[c] except +it opens all the found items in new tabs. +________________________________________________________________________________ + +section:QuickMarks[quickmarks] + +|go| + +||go\\{a-zA-Z0-9\\}|| +________________________________________________________________________________ +Jump to a QuickMark in the current tab. Open any QuickMark in the current tab. +You can mark any URLs with [m]M{a-zA-Z0-9}[m]. These QuickMarks are persistent +across browser sessions. +________________________________________________________________________________ + + +|gn| + +||gn\\{a-zA-Z0-9\\}|| +________________________________________________________________________________ +Jump to a QuickMark in a new tab. Works like [m]go{a-zA-Z0-9}[m] but opens the +QuickMark in a new tab. Whether the new tab is activated or not depends on the +'activate' option. + +Mnemonic: Go in a new tab. [m]gt[m] would make more sense but is already +taken. +________________________________________________________________________________ + + +|M| + +||M\\{a-zA-Z0-9\\}|| +________________________________________________________________________________ +Add new QuickMark for current URL. You can go to a marked URL in the current +tab with [m]go{a-zA-Z0-9}[m] or in a new tab with [m]gn{a-zA-Z0-9}[m]. These +QuickMarks are persistent across browser sessions. +________________________________________________________________________________ + + +|:delqm| |:delqmarks| +||:delqm[arks] {marks}|| + +||:delqm[arks]!|| +________________________________________________________________________________ +Delete the specified QuickMarks. QuickMarks are presented as a list. + +Examples: + +* [c]:delqmarks Aa b p[c] deletes QuickMarks A, a, b and p + +* [c]:delqmarks b-p[c] deletes all QuickMarks in the range b to p + +* [c]:delqmarks![c] deletes all QuickMarks + +________________________________________________________________________________ + + +|:qma| |:qmark| +||:qma[rk] {a-zA-Z0-9} [url]|| + +________________________________________________________________________________ +Mark a URL with a letter for quick access. You can also mark whole groups like this: + +[c]:qmark f http://forum1.com, http://forum2.com, imdb some artist[c] +________________________________________________________________________________ + + +|:qmarks| +||:qmarks [arg]|| +________________________________________________________________________________ +Show all QuickMarks. If [arg] is specified then limit the list to those QuickMarks mentioned. +________________________________________________________________________________ + +section:Local{nbsp}marks[localmarks] + +|m| + +||m\\{a-zA-Z\\}|| +________________________________________________________________________________ +Set mark at the cursor position. Marks a-z are local to the buffer, whereas +A-Z are valid between buffers. +________________________________________________________________________________ + + +|\`| |\'| + +||\'\\{a-zA-Z\\}|| +________________________________________________________________________________ +Jump to the mark in the current buffer. Marks a-z are local to the buffer, +whereas A-Z are valid between buffers. +________________________________________________________________________________ + + +|:delm| |:delmarks| +||:delm[arks] {marks}|| + +||:delm[arks]!|| +________________________________________________________________________________ +Delete the specified marks. Marks are presented as a list. + +Examples: + +* [c]:delmarks Aa b p[c] deletes marks A, a, b and p + +* [c]:delmarks b-p[c] deletes all marks in the range b to p + +* [c]:delmarks![c] deletes all marks for the current buffer + +________________________________________________________________________________ + + +|:ma| |:mark| +||:ma[rk] {a-zA-Z}|| +________________________________________________________________________________ +Mark current location within the web page. +________________________________________________________________________________ + + +|:marks| + +||:marks [arg]|| +________________________________________________________________________________ +Show all location marks of current web page. If [arg] is specified then limit the list to those marks mentioned. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/message.txt b/vimperator/locale/en-US/message.txt new file mode 100644 index 00000000..2f0125e5 --- /dev/null +++ b/vimperator/locale/en-US/message.txt @@ -0,0 +1,22 @@ +HEADER + +|message-history| + + +Vimperator stores all info and error messages in a message history. The type of +info messages output can be controlled by the 'verbose' option. + +|:mes| |:messages| + +||:mes[sages]|| +________________________________________________________________________________ +Display previously given messages. +________________________________________________________________________________ + + +|g.| + +||g.|| +________________________________________________________________________________ +Redisplay the last command output. Only the most recent command's output is +available. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/options.txt b/vimperator/locale/en-US/options.txt new file mode 100644 index 00000000..55aee76c --- /dev/null +++ b/vimperator/locale/en-US/options.txt @@ -0,0 +1,797 @@ +HEADER + +|options| + + +Vimperator has a number of internal variables and switches which can be set to +achieve special effects. These options come in 5 forms: +`------------`----------------------------------------- +*boolean* can only be on or off +*number* has a numeric value +*string* has a string value +*charlist* like a string but with unique characters +*stringlist* a comma-separated list of strings +------------------------------------------------------- + +section:Setting{nbsp}options[set-option,E764] + +|:set| |:se| + +||:se[t]|| +____ +Show all options that differ from their default value. +____ + +||:se[t] all|| +____ +Show all options. Show all options. +____ + +|E518| |E519| +||:se[t] {option}?|| +____ +Show value of {option}. +____ + +||:se[t] {option}|| +____ +Toggle option: set, switch it on. + +Number option: show value. + +String option: show value. +____ + +||:se[t] no((option))|| + +____ +Toggle option: Reset, switch it off. +____ + +||:se[t] {option}!|| + +||:se[t] inv((option))|| + +____ +Toggle option: Invert value. +____ + +||:se[t] inv((option))={value}|| + +____ +For list options, toggle the specified values. +____ + +|:set-default| +||:se[t] {option}&|| +____ +Reset option to its default value. +____ + +||:se[t] all&|| +____ +Set all options to their default value. +____ + +|:set-args| |E487| |E521| +||:se[t] {option}={value}|| + +____ +Set string or number option to {value}. + +For numeric options the value must be given in decimal. +The old value can be inserted by typing [m]<Tab>[m]. +____ + +|:set+=| +||:se[t] {option}+={value}|| + +____ +Add the {value} to a number option, or append the +{value} to a string option. When the option is a +comma separated list, a comma is added, unless the +value was empty. +If the option is a list of flags, superfluous flags +are removed. When adding a flag that was already +present the option value doesn't change. +____ + +|:set^=| +||:se[t] {option}^={value}|| + +____ +Multiply the {value} to a number option, or prepend +the {value} to a string option. When the option is a +comma separated list, a comma is added, unless the +value was empty. +____ + +|:set-=| +||:se[t] {option}-={value}|| + + +____ +Subtract the {value} from a number option, or remove +the {value} from a string option, if it is there. +If the {value} is not found in a string option, there +is no error or warning. When the option is a comma +separated list, a comma is deleted, unless the option +becomes empty. +When the option is a list of flags, {value} must be +exactly as they appear in the option. Remove flags +one by one to avoid problems. +____ + +|:setlocal| |:setl| +||:setl[ocal]|| + +||:setl[ocal] all|| + +||:setl[ocal] {option}?|| + +||:setl[ocal] {option}|| + +||:setl[ocal] no{option}|| + +||:setl[ocal] inv{option}|| + +||:setl[ocal] {option}&|| + +||:setl[ocal] all&|| + +||:setl[ocal] {option}={value}|| + +||:setl[ocal] {option}+={value}|| + +||:setl[ocal] {option}^={value}|| + +||:setl[ocal] {option}-={value}|| + + +____ +The same as [c]:set[c] command, but operates on local for current +tab options only. See [c]:set[c] for details. +____ + +|:setglobal| |:setg| +||:setg[lobal]|| + +||:setg[lobal] all|| + +||:setg[lobal] {option}?|| + +||:setg[lobal] {option}|| + +||:setg[lobal] no{option}|| + +||:setg[lobal] inv{option}|| + +||:setg[lobal] {option}&|| + +||:setg[lobal] all&|| + +||:setg[lobal] {option}={value}|| + +||:setg[lobal] {option}+={value}|| + +||:setg[lobal] {option}^={value}|| + +||:setg[lobal] {option}-={value}|| + + +____ +The same as [c]:set[c] command, but operates on global options only. +See [c]:set[c] for details. +____ + + +|expand-environment-var| |expand-env| |:set_env| + + +Environment variables are expanded for path options like 'cdpath' and +'runtimepath'. The variable notation is _$VAR_ (terminated by a non-word +character) or _$\\{VAR}_. _%VAR%_ is also supported on Windows. + +section:Setting{nbsp}Firefox{nbsp}options[firefox-options] + +Most Firefox options are not touched/overridden by Vimperator. In order to set +any of these preferences use either of the following: + +|:prefs| |:preferences| +||:pref[erences]|| +________________________________________________________________________________ +Show Browser Preferences + +You can change the browser preferences from this dialog. Be aware that not +all Firefox preferences work, because Vimperator overrides some key +bindings and changes Firefox's GUI. +________________________________________________________________________________ + + +|:prefs!| |:preferences!| +||:pref[erences]!|| +________________________________________________________________________________ +Opens about:config in the current tab where you can change advanced Firefox +preferences. +________________________________________________________________________________ + + +|:set-!| +||:se[t]! {preference}={value}|| + +________________________________________________________________________________ +Change any Firefox {preference} (those in the about:config window). You can also +reset/delete those preferences with [c]:set! {preference}&[c]. +________________________________________________________________________________ + +section:List{nbsp}of{nbsp}options[list-options] + +|\'act'| |\'activate'| +||'activate' 'act'|| stringlist (default: "homepage,quickmark,tabopen,paste") +____ +Define when tabs are automatically activated. Available items: + +`-----------`-------------------------------- +*homepage* [m]gH[m] mapping +*quickmark* [m]go[m] and [m]gn[m] mappings +*tabopen* [c]:tabopen[!][c] command +*paste* [m]P[m] and [m]gP[m] mappings +--------------------------------------------- + +____ + + +|\'cd'| |\'cdpath'| +||'cdpath' 'cd'|| string (default: black) +____ +List of directories searched when executing the :cd command. This is only used +for relative paths, if an absolute path is specified then the option is +ignored. +____ + + +|\'cpt'| |\'complete'| +||'complete' 'cpt'|| charlist (default: sfl) +____ +Items which are completed at the [c]:[tab]open[c] prompt. Available items: + +`---`-------------------------------------------------------------------------------- +*s* Search engines and keyword URLs +*f* Local files +*l* Firefox location bar entries (bookmarks and history sorted in an intelligent way) +*b* Bookmarks +*S* Suggest engines +------------------------------------------------------------------------------------- + +The order is important, so [c]:set complete=bs[c] would list bookmarks first, +and then any available quick searches. +____ + + +|\'ds'| |\'defsearch'| +||'defsearch' 'ds'|| string (default: "google") +____ +Sets the default search engine. +The default search engine name is used in the [c]:[tab]open [arg][c] command if +[[arg]] neither looks like a URL or like a specified search engine/keyword. + +This means, it you set 'defsearch' to "youtube", then [c]:open arnold +schwarzenegger[c] will be exactly the same as [c]:open youtube arnold +schwarzenegger[c]. Therefore, you need to add a keyword or search engine +"youtube" first. +____ + + +|\'editor'| |i_<Ctrl-i>| +||'editor'|| string (default: "gvim -f") +____ +Set the external text editor. +Sets the editor to run when [m]<C-i>[m] is pressed in INSERT and TEXTAREA +modes. + +Warning: Vimperator will not behave correctly if the editor forks its own +process, such as with gvim without the -f argument. +____ + +|\'noex'| |\'noexrc'| |\'ex'| |\'exrc'| +||'exrc' 'ex'|| boolean (default: off) +____ +Allow reading of an RC file in the current directory. This file is sourced in +addition to, and after, your default RC file. +____ + +|\'eht'| |\'extendedhinttags'| +||'extendedhinttags' 'eht'|| string +____ +(default: +++//*[@onclick or @onmouseover +or @onmousedown or @onmouseup or @oncommand or @class='lk' or @class='s'] | +//input[not(@type='hidden')] | //a | //area | //iframe | //textarea | //button +| //select | //xhtml:*[@onclick or @onmouseover or @onmousedown or @onmouseup +or @oncommand or @class='lk' or @class='s'] | +//xhtml:input[not(@type='hidden')] | //xhtml:a | //xhtml:area | //xhtml:iframe +| //xhtml:textarea | //xhtml:button | //xhtml:select+++) + +The XPath string of hintable elements activated by [m];[m]. +____ + + +|\'noeb'| |\'noerrorbells'| |\'eb'| |\'errorbells'| +||'errorbells' 'eb'|| boolean (default: off) +____ +Ring the bell when an error message is displayed. +____ + + +|\'ei'| |\'eventignore'| +||'eventignore'|| stringlist (default: "") +____ +A list of autocommand event names which should be ignored. If the list contains +the value "all" then all events are ignored. +____ + + +|\'nofc'| |\'nofocuscontent'| |\'fc'| |\'focuscontent'| +||'focuscontent' 'fc'|| boolean (default: off) +____ +Focus the content after a page has loaded. This is useful, if you always +want to stay in normal mode when browsing between web sites. When "on", it +blurs any textbox which often is automatically focused on page load. +If you usually like 'focuscontent' but sometimes you'd like to focus the +first input field, you can use [m]gi[m] to jump to it. +____ + + +|\'nofs'| |\'nofullscreen'| |\'fs'| |\'fullscreen'| +||'fullscreen' 'fs'|| boolean (default: off) +____ +Show the current window fullscreen. Also hide certain GUI elements like the +statusline. +____ + + +|\'go'| |\'guioptions'| +||'guioptions' 'go'|| charlist (default: "") +____ +Show or hide certain GUI elements like the menu or toolbar. Supported characters: + +`---`----------- +*m* Menubar +*T* Toolbar +*b* Bookmark bar +*n* Tab number +*N* Tab number over image +---------------- + +You can also hide the tab bar with [c]:set showtabline=0[c]. +____ + + +|\'hf'| |\'helpfile'| +||'helpfile' 'hf'|| string (default: "intro.html") +____ +Name of the main help file. This is the tail component of the chrome URL as +displayed in the status line when viewing the page. +____ + + +|\'hm'| |\'hintmatching'| +||'hintmatching' 'hm'|| string (default: contains) +____ + +Change the hint matching algorithm during hint mode. Possible values: + +`--------------------`------------------------------------------------------------------------------------------------------------------------------- +*contains* The typed characters are split on whitespace, and these character groups have to match anywhere inside the text of the link. +*wordstartswith* The typed characters are matched with the beginning of the first word (see 'wordseparators') in the link as long as possible. If no matches occur in the current word, then the matching is continued at the beginning of the next word. The words are worked through in the order they appear in the link. If the typed characters contain spaces, then the characters are split on whitespace. These character groups are then matched with the beginning of the words, beginning at the first one and continuing with the following words in the order they appear in the link. +*firstletters* Behaves like wordstartswith, but non matching words aren't overleaped. +*custom* Delegate to a custom function: liberator.plugins.customHintMatcher(hintString) +----------------------------------------------------------------------------------------------------------------------------------------------------- + +____ + + +|\'fh'| |\'followhints'| +||'followhints' 'fh'|| number (default: 0) +____ + +Change the behaviour of [m]<Return>[m] in hint mode. Possible values: + +`---------`---------------------------------------------------------- +*0* Follow the first hint as soon as typed text uniquely identifies it. + Follow the selected hint on [m]<Return>[m]. +*1* Follow the selected hint on [m]<Return>[m]. +*2* Follow the selected hint on [m]<Return>[m] only it's been [m]<Tab>[m]-selected. +--------------------------------------------------------------------- + +____ + + +|\'ht'| |\'hinttags'| +||'hinttags' 'ht'|| string +____ +(default: +++//*[@onclick or @onmouseover or @onmousedown or @onmouseup or +@oncommand or @class='lk' or @class='s'] | //input[not(@type='hidden')] | //a +| //area | //iframe | //textarea | //button | //select | //xhtml:*[@onclick or +@onmouseover or @onmousedown or @onmouseup or @oncommand or @class='lk' or +@class='s'] | //xhtml:input[not(@type='hidden')] | //xhtml:a | //xhtml:area | +//xhtml:iframe | //xhtml:textarea | //xhtml:button | //xhtml:select+++) + +XPath string of hintable elements activated by [m]f[m] and [m]F[m] +____ + + +|\'hto'| |\'hinttimeout'| +||'hinttimeout' 'hto'|| number (default: 0) +____ +Automatically follow non unique numerical hint after 'hinttimeout' +milliseconds. + +Set to 0 (the default) to only follow numeric hints after pressing +[m]<Return>[m] or when the hint is unique. +____ + + +|\'hi'| |\'history'| +||'history' 'hi'|| number (default: 500) +____ +Number of Ex commands and search patterns to store in the command-line history. +____ + + +|\'nohls'| |\'nohlsearch'| |\'hls'| |\'hlsearch'| +||'hlsearch' 'hls'|| boolean (default: off) +____ +Highlight previous search pattern matches +____ + + +|\'noic'| |\'noignorecase'| |\'ic'| |\'ignorecase'| +||'ignorecase' 'ic'|| boolean (default: on) +____ +Ignore case in search patterns. +____ + + +|\'nois'| |\'noincsearch'| |\'is'| |\'incsearch'| +||'incsearch' 'is'|| boolean (default: on) +____ +Show where the search pattern matches as it is typed. + +Note: Incremental searching currently only works in the forward direction. +____ + + +|\'noim'| |\'noinsertmode'| |\'im'| |\'insertmode'| +||'insertmode' 'im'|| boolean (default: on) +____ +Use Insert mode as the default for text areas. +Makes Vimperator work in a way that Insert mode is the default mode for text areas. +Useful if you want to use Vimperator as a modeless editor, keeping the known Firefox interface for editing text areas. +____ + + +|\'ls'| |\'laststatus'| +||'laststatus' 'ls'|| number (default: 2) +____ +Determines when the last window will have a status line. Possible values: + +`---`--------------------------------- +*0* Never +*1* Only if there are multiple windows +*2* Always +-------------------------------------- + +Note: laststatus=1 not implemented yet. +____ + + +|\'nolks'| |\'nolinksearch'| |\'lks'| |\'linksearch'| +||'linksearch' 'lks'|| boolean (default: off) +____ +Limit the search to hyperlink text. +This includes (X)HTML elements with an "href" atrribute and XLink "simple" links. +____ + + +|\'nolpl'| |\'lpl'| |\'noloadplugins'| |\'loadplugins'| +||'loadplugins' 'lpl'|| boolean (default on) +____ +Load plugin scripts when starting up. +____ + + +|\'msgs'| |\'messages'| +||'messages' 'msgs'|| number (default: 100) +____ +Number of messages to store in the message history. +____ + + +|\'nomore'| |\'more'| +||'more'|| boolean (default: on) +____ +Pause the message list window when more than one screen of listings is displayed +____ + + +|\'nextpattern'| +||'nextpattern'|| stringlist +____ +(default: \bnext,^>$,^(>>|»)$,^(>|»),(>|»)$,\bmore\b) + +Patterns to use when guessing the 'next' page in a document sequence. +Each pattern, in order, is matched against all links in the page with the first match being used. +The patterns are case insensitive regular expressions. +____ + + +|\'newtab'| +||'newtab'|| stringlist (default: "") +____ +Define which Ex commands output the result in a new tab automatically. You can +also use [c]:tab command[c] to manually output a command in a new tab. + +The possible values: +`------------`--------------------------------------------- +*all* All commands +*addons* [c]:addo[ns][c] command +*downloads* [c]:downl[oads][c] command +*help* [c]:h[elp][c] command +*javascript* [c]:javascript![c] or [c]:js![c] command +*prefs* [c]:pref[erences]![c] or [c]:prefs![c] command +----------------------------------------------------------- + +____ + + +|\'noonline'| |\'online'| +||'online'|| boolean (default on) +____ +Show and set the \'work offline' behavior. +____ + + +|\'pageinfo' \'pa'| +||'pageinfo' 'pa'|| +charlist (default: gfm) +____ +Desired info on [c]:pa[geinfo][c]. Available items: + +.--------`---------------- +*g* General info +*f* Feeds +*m* Meta tags +-------------------------- + +The order matters. +____ + + +|\'pps'| |\'popups'| +||'popups' 'pps'|| number (default: 1) +____ +Define where to show requested popup windows. +Does not apply to windows which are opened by middle clicking a link, +they always open in a new tab. Possible values: + +.---`------------------------------------------------------------------------------------------------ +*0* Force to open in the current tab (Warning: this can stop some web sites from working correctly!) +*1* Always open in a new tab +*2* Open in a new window if it has a specific requested size (default in Firefox) +*3* Always open in a new window +*4* Open in the same tab unless it has a specific requested size +----------------------------------------------------------------------------------------------------- + +Note: This option does not change the popup blocker of Firefox in any way. +____ + + +|\'nopreload'| |\'preload'| +||'preload' 'nopreload'|| boolean (default: on) +____ +Speed up first time history/bookmark completion + +History access can be quite slow for a large history. +Vimperator maintains a cache to speed it up significantly on subsequent access. +In order to also speed up first time access, it is cached at startup, if this option is set (recommended). +____ + + +//|\'pvh'| |\'previewheight'| +//||'previewheight' 'pvh'|| number (default: 10) +//____ +//Default height for preview window +// +//Value must be between 1 and 50. If the value is too high, completions may cover the command-line. Close the preview window with :pclose. +//Note: Option currently disabled +//____ + +|\'previouspattern'| +||'previouspattern'|| stringlist +____ +(default: \bprev|previous\b,^<$,^(<<|«)$,^(<|«),(<|«)$) + +Patterns to use when guessing the 'previous' page in a document sequence +Each pattern, in order, is matched against all links in the page with the first match being used. +The patterns are case insensitive regular expressions. +____ + + +|\'rtp'| |\'runtimepath'| +||'runtimepath' 'rtp'|| stringlist +____ +(default: Unix, Mac: "\~/.vimperator", Windows: "\~/vimperator") + +List of directories searched for runtime files: + +macros/ + +plugin/ + + +Example: [c]:set runtimepath=\~/myvimperator,\~/.vimperator[c] + +This will search for plugins in both "\~/myvimperator/plugin" and +"\~/.vimperator/plugin" +____ + + +|\'scr'| |\'scroll'| +||'scroll' 'scr'|| number (default: 0) +____ +Number of lines to scroll with C-u and C-d commands. +The number of lines scrolled defaults to half the window size. +When a [count] is specified to the [m]<C-u>[m] or [m]<C-d>[m] commands this is +used to set the value of 'scroll' and also used for the current command. The +value can be reset to half the window height with [c]:set scroll=0[c]. +____ + + +|\'shell'| |\'sh'| +||'shell' 'sh'|| string (default: on) +____ +Show the current mode in the command-line. +____ + + +|\'shellcmdflag'| |\'shcf'| +||'shellcmdflag' 'shcf'|| string (default: $SHELL or "sh", Win32: "cmd.exe") +____ +Shell to use for executing :! and :run commands. +____ + + +|\'nosmd'| |\'noshowmode'| |\'smd'| |\'showmode'| +||'showmode' 'smd'|| boolean (default: "-c", Win32: "/c") +____ +Flag passed to shell when executing :! and :run commands. + +E.g. bash -c gvim +____ + + +|\'ssli'| |\'showstatuslinks'| +||'showstatuslinks' 'ssli'|| number (default: 1) +____ +Show the destination of the link under the cursor in the status bar +Also links which are focused by keyboard commands like [m]<Tab>[m] are shown. Possible values: + +.---`-------------------------------------- +*0* Don't show link destination +*1* Show the link in the status line +*2* Show the link in the command-line +------------------------------------------- + +____ + + +|\'stal'| |\'showtabline'| +||'showtabline' 'stal'|| number (default: 2) +____ +Control when to show the tab bar of opened web pages. Possible values: + +.---`-------------------------------------- +*0* Never show tab bar +*1* Show tab bar only if more than one tab is open +*2* Always show tab bar +------------------------------------------- + +____ + + +|\'noscs'| |\'nosmartcase'| |\'scs'| |\'smartcase'| +||'smartcase' 'scs'|| boolean (default: on) +____ +Override the 'ignorecase' option if the pattern contains uppercase characters. +This is only used if the 'ignorecase' option is set. +____ + + +|\'suggestengines'| +||'suggestengines' || stringlist (default: "google") +____ +Set the search engines which can be used for completion suggestions. +Add "S" to the 'complete' option if you want use this feature. + +Warning: This feature could make tab-completion slower because it needs to +wait for changes, so use it only if you have a fast internet connection. +____ + + +|\'titlestring'| +||'titlestring'|| string (default: "Vimperator") +____ +Change the title of the browser window. +Vimperator changes the browser title from "Title of web page - Mozilla Firefox" to +"Title of web page - Vimperator". + +If you don't like that, you can restore it with: [c]:set titlestring=Mozilla +Firefox[c]. +____ + + +|\'noum'| |\'nousermode'| |\'um'| |\'usermode'| +||'usermode' 'um'|| boolean (default: off) +____ +Show current website with a minimal style sheet to make it easily accessible. +Note that this is a local option for now, later it may be split into a global and :setlocal part +____ + + +|\'urlseparator'| +||'urlseparator'|| string (default: ",\s") +____ +Set the separator regexp used to separate multiple URL args. Multiple +arguments can be specified for :open, and similar commands, using this regexp +as the separator. Using whitespace alone is not generally useful since it is +often contained in a single argument. E.g. [c]:open linus torvalds[c] should +perform a single search for the key words "linus" and "torvalds" +____ + + +|\'verbose', \'vbs'| +||'verbose' 'vbs'|| number (default: 0) +____ +Define which info messages are displayed. +When bigger than zero, Vimperator will give messages about what it is doing. +These can be viewed at any time with the [c]:messages[c] command. The highest +value is 15, being the most verbose mode. + +TODO: list levels and associated messages +____ + + +|\'novb'| |\'novisualbell'| |\'vb'| |\'visualbell'| +||'visualbell' 'vb'|| boolean (default: off) +____ +Use visual bell instead of beeping on errors. The visualbell style is +controlled by [c]:hi Bell[c]. If no bell is desired use [c]:set t_vb=[c] together with +this option. +____ + + +|\'wildcase'| |\'wic'| +||'wildcase' 'wic'|| string (default: "smart") +____ +Defines how completions are matched with regard to character case. + +`---------------`------------------------ +"smart" Case is significant when capital letters are typed +"match" Case is always significant +"ignore" Case is never significant +----------------------------------------- + +____ + + +|\'wildignore'| |\'wig'| +||'wildignore' 'wig'|| stringlist (default: "") +____ +List of file patterns to ignore when completing files. E.g. to ignore object +files and Vim swap files [c]:set wildignore=.*\.o,\..*\.s[a-z]\\{2}[c] + +Note: Unlike Vim each pattern is a regexp rather than a glob. +____ + + +|\'wim'| |\'wildmode'| +||'wildmode' 'wim'|| stringlist (default: "list:full") +____ +Define how command-line completion works. +It is a comma-separated list of parts, where each part specifies +what to do for each consecutive use of the completion key. +The first part specifies the behavior for the first use of the completion key, +the second part for the second use, etc. + +These are the possible values for each part: +`---------------`------------------------ +"" Complete only the first match. +"full" Complete the next full match. After the last, the original string is used. +"longest" Complete till the longest common string. +"list" When more than one match, list all matches. +"list:full" When more than one match, list all matches and complete first match. +"list:longest" When more than one match, list all matches and complete till the longest common string. \ + When there is only a single match, it is fully completed regardless of the case. +----------------------------------------- + +____ + + +|\'wop'| |\'wildoptions'| +||'wildoptions' 'wop'|| stringlist (default: "") +____ +A list of words that change how command-line completion is done. + +Possible words: +`--------`------------------------------- +*auto* Automatically show completions while you are typing. +*sort* Always sort the completion list, overriding the 'complete' option. +----------------------------------------- + +____ + + +|\'wsp'| |\'wordseparators'| + +||'wordseparators' 'wsp'|| string +____ +(default: [\.,!\?:;/\\"\^\$%&§\(\)\[\]\\{\\}<>#\\*\+\\|=~ _\\-]) + +A regexp which defines the word separators which are used for the +'hintmatching' types "wordstartswith" and "firstletters" to split the words in +the text of a link. +____ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/pattern.txt b/vimperator/locale/en-US/pattern.txt new file mode 100644 index 00000000..8f80e410 --- /dev/null +++ b/vimperator/locale/en-US/pattern.txt @@ -0,0 +1,70 @@ +HEADER + +|text-search-commands| + + +Vimperator provides a Vim-like interface to Firefox's standard text search +functionality. There is no support for using regular expressions in search +commands as Firefox does not provide native regexp support. It is unlikely +that this will ever be available. + +|/| + +||/\\{pattern\\}[/]<CR>|| + +________________________________________________________________________________ +Search forward for the first occurrence of {pattern}. + +If "\c" appears anywhere in the pattern the whole pattern is handled as though +'ignorecase' is on. "\C" forces case-sensitive matching for the whole pattern. + +If "\l" appears in the pattern only the text of links is searched for a +match as though 'linksearch' is on. "\L" forces the entire page to be searched +for a match. +________________________________________________________________________________ + + +|?| + +||?{pattern}[?]<CR>|| + +________________________________________________________________________________ +Search backwards for {pattern}. + +{pattern} can use the same modifiers as for [m]/[m]. + + +Note: incremental searching currently only works in the forward direction. +________________________________________________________________________________ + + +|n| + +||n|| +________________________________________________________________________________ +Find next. Repeat the last search 1 time (until count is supported). +________________________________________________________________________________ + + +|N| + +||N|| +________________________________________________________________________________ +Find previous. Repeat the last search 1 time (until count is supported) in the +opposite direction. +________________________________________________________________________________ + + +|\*| + +||\*|| +________________________________________________________________________________ +Search forward for the next word under the cursor. +________________________________________________________________________________ + + +|\#| + +||\#|| +________________________________________________________________________________ +Search backward for the previous word under the cursor. +________________________________________________________________________________ + + +|:noh| |:nohlsearch| + +||:noh[lsearch]|| +________________________________________________________________________________ +Remove the search highlighting. The document highlighting is turned back on +when another search command is used or the 'hlsearch' option is set. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/print.txt b/vimperator/locale/en-US/print.txt new file mode 100644 index 00000000..aad69e18 --- /dev/null +++ b/vimperator/locale/en-US/print.txt @@ -0,0 +1,25 @@ +HEADER + +|printing| + + +|:ha| |:hardcopy| + +||:ha[rdcopy][!]|| +________________________________________________________________________________ +Print current document. Open a GUI dialog where you can select the printer, +number of copies, orientation, etc. When used with [!], the dialog is skipped +and the default printer used. +________________________________________________________________________________ + +section:Firefox{nbsp}printing{nbsp}dialogs[firefox-print-dialogs] + +The "Print Preview" and "Page Setup" dialogs can be opened via the :dialog command + + :dialog printpreview + +and + + :dialog printsetup + +respectively. + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/repeat.txt b/vimperator/locale/en-US/repeat.txt new file mode 100644 index 00000000..cb699a0e --- /dev/null +++ b/vimperator/locale/en-US/repeat.txt @@ -0,0 +1,143 @@ +HEADER + +|repeat| + + +Vimperator can repeat a number of commands and record macros. + +section:Macros[macros,complex-repeat] + +|q| +||q {0-9a-zA-Z}|| + +____________________________________________________________________________ +Record a key sequence into a macro. +Available macros are {0-9a-zA-Z} (uppercase to append). +Type [m]q[m] to stop recording. +____________________________________________________________________________ + + +|:macros| +||:mac[ros] [args]|| + +________________________________________________________________________________ +List recorded macros matching the optional regular expression [args]. If no +regexp is given, list all macros. +________________________________________________________________________________ + + +|:delmac| |:delmacros| +||:delmac[ros] {args}|| + +||:delmac[ros]!|| +________________________________________________________________________________ +Delete recorded macros matching the regular expression [args]. If [!] is given +all macros are deleted. +________________________________________________________________________________ + + +|@| |:play| +||:pl[ay] {arg}|| + +||[count]@{arg}|| +____________________________________________________________________________ +Plays the contents of macro with name {arg} [count] times. The [m]@[m] mapping +only accepts {0-9a-z} as {arg}. +____________________________________________________________________________ + + +|@@| +||[count]@@|| +____________________________________________________________________________ +Replay the last executed macro [count] times. +____________________________________________________________________________ + + +|.| +||[count].| +____________________________________________________________________________ +Repeat the last keyboard mapping [count] times. Note that, unlike in Vim, this +does not apply solely to editing commands, mainly because Vimperator doesn't +have them. +____________________________________________________________________________ + + +section:Using{nbsp}scripts[using-scripts] + +|:so| |:source| +||:so[urce][!] {file}|| + +________________________________________________________________________________ +Read Ex commands, JavaScript, or CSS from {file}. You can either source files +which mostly contain Ex commands like [c]map < gt[c] and put JavaScript code +within a: + +-------------------------------------------------------------------------------- +js <<EOF +hello = function () { + alert("Hello world"); +} +EOF +-------------------------------------------------------------------------------- +Or you can alternatively source a file which ends in _.js_. These files are +automatically sourced as pure JavaScript files. + +Note: In both cases you must add functions to the global window object like +shown above, functions written as: +-------------------------------------------------------------------------------- +function hello2() { + alert("Hello world"); +} +-------------------------------------------------------------------------------- +are only available within the scope of the script. + +The _.vimperatorrc_ file in your home directory and any files in +_\~/.vimperator/plugin/_ are always sourced at startup. \~ is supported as a +shortcut for the _$HOME_ directory. If [!] is specified, errors are not +printed. +________________________________________________________________________________ + + +|:lpl| |:loadplugins| +||:loadplugins|| + +________________________________________________________________________________ +Load all unloaded plugins immediately. This is useful both for sourcing new +plugins without restarting vimperator, and making sure that a plugin is loaded +so that you can use its commands from your vimperatorrc. +________________________________________________________________________________ + + +|:ru| |:runtime| +||:runt[ime][!]| {file} ...|| + +________________________________________________________________________________ +Source the specified file from each directory in 'runtimepath'. Example: + +[c]:runtime plugin/foobar.vimp[c] + +Only the first found file is sourced. When [!] is given, all found files are +sourced. +________________________________________________________________________________ + + +|:scrip| |:scriptnames| +||:scrip[tnames]|| + +________________________________________________________________________________ +List all sourced script names, in the order they were first sourced. +________________________________________________________________________________ + + +|:fini| |:finish| +||:fini[sh]|| + +________________________________________________________________________________ +Stop sourcing a script file. This can only be called from within a Vimperator +script file. +________________________________________________________________________________ + +section:Profiling[profile,profiling] + +|:time| +||:[count]time[!] {code|:command}|| + +________________________________________________________________________________ +Profile a piece of code or a command. Run {code} [count] times (default 1) +and returns the elapsed time. {code} is always passed to JavaScript's eval(), +which might be slow, so take the results with a grain of salt. + +If {code} starts with a [c]:[c], it is executed as a Vimperator command. + +Use the special version with [!] if you just want to run any command multiple +times without showing profiling statistics. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/starting.txt b/vimperator/locale/en-US/starting.txt new file mode 100644 index 00000000..618820ba --- /dev/null +++ b/vimperator/locale/en-US/starting.txt @@ -0,0 +1,57 @@ +HEADER + +Vimperator does not yet read any command-line options. When it does, they will +be documented here. + +section:Initialization[initialization,startup] + +At startup Vimperator sources a user RC file, containing Ex commands, and any +JavaScript files found in the plugin directory. The RC file may be named +[a].vimperatorrc[a] or [a]\_vimperatorrc[a]. The search order is: + +* Unix and Mac: [a]\~/.vimperatorrc[a] then [a]\~/_vimperatorrc[a] +* Windows - [a]\~/_vimperatorrc[a] then [a]\~/.vimperatorrc[a] + +If 'exrc' is set then any RC file in the current directory is also sourced. + +The plugin directory can be in any of the directories in 'runtimepath'. Using +the default value of 'runtimepath' this would be: + +* Unix and Mac - [a]\~/.vimperator/plugin[a] +* Windows - [a]\~/vimperator/plugin[a] + +All directories in 'runtimepath' are searched for plugins and they are are all +loaded. + +Plugins will not be sourced if 'noloadplugins' is set. + +The user's \'$HOME'(~) directory is determined as follows: + +* Unix and Mac - _$HOME_ is used. +* Windows - if _%HOME%_ is set then this is used, otherwise _%USERPROFILE%_ or finally +_%HOMEDRIVE%%HOMEPATH%_. + +_$VIMPERATOR_HOME_ can be used to override the calculated _$HOME_ directory. + +section:Saving{nbsp}settings[save-settings] + +|:mkv| |:mkvimperatorrc| +||:mkv[imperatorrc][!] [file]|| + +________________________________________________________________________________ +Write current key mappings and changed options to [file]. If no [file] is +specified then _~/.vimperatorrc_ is written unless this file already exists. The +special version [c]:mkvimperatorrc![c] will overwrite [file] if it exists. + +Warning: this differs from Vim's behavior which defaults to writing the file +in the current directory. +________________________________________________________________________________ + +section:Restarting[restarting] + +|:res| |:restart| + +||:res[tart]|| +________________________________________________________________________________ +Force the browser to restart. Useful when installing extensions. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/styling.txt b/vimperator/locale/en-US/styling.txt new file mode 100644 index 00000000..0d62cf40 --- /dev/null +++ b/vimperator/locale/en-US/styling.txt @@ -0,0 +1,111 @@ +HEADER + +|styling| + + +Vimperator allows you to style both the browser and any web pages you view. All +styling is specified via CSS. Although you may style any user interface element +via the [c]:style[c] command, most Vimperator elements can be styled with the +[c]:highlight[c] command, for convenience. + +|E185| |:colo| |:colorscheme| + +||:colo[rscheme] {name}|| + +________________________________________________________________________________ +Load a color scheme. {name} is found by searching the 'runtimepath' for the +first file matching colors/{name}.vimp. + +The ColorScheme autocommand is triggered after the color scheme has been +sourced. +________________________________________________________________________________ + +|:hi| |:highlight| + +||:hi[light][!] [-append] {group}[{selector}] [{css}]|| + +________________________________________________________________________________ +Highlight {group} with {css}. Normally, {css} is checked for +valid syntax before it's applied. Once you're certain it's +valid, [!] will override the check, to speed Vimperator startup. +{selector} can be any valid CSS selector, such as [c]:hover[c], and +if provided will restrict the match to matching elements. + +Valid groups are: +`------------------`----------------------------------- +*Bell* Vimperator's visual bell +*Boolean* A JavaScript Boolean object +*CompDesc* The description column of the completion list +*CompIcon* The favicon of a completion row +*CompItem* A completion row +*CompLess* The indicator shown when completions may be scrolled up +*CompMore* The indicator shown when completions may be scrolled down +*CompResult* The result column of the completion list +*CompTitle* Completion row titles +*ErrorMsg* Error messages +*Filter* The matching text in a completion list +*FrameIndicator* The indicator shown when a new frame is selected +*Function* A JavaScript Function object +*Hint* A hint indicator. See [c]:help hints[c]. +*HintActive* The hint element which will be selected on <Enter> +*HintElem* The element which a hint refers to. +*HintImage* The indicator which floats above hinted images. +*Indicator* +*InfoMsg* Information messages +*Keyword* A bookmark keyword for a URL +*LineNr* The line number of an error +*Message* +*ModeMsg* The mode indicator in the command line +*MoreMsg* The indicator that there is more text to view +*NonText* +*Normal* Normal text in the command line +*Null* A JavaScript Null object +*Number* A JavaScript Number object +*Object* A JavaScript Object +*Question* A prompt for a decision +*Search* Highlighted search results in a web page +*StatusLine* The status bar +*StatusLineBroken* The status bar for a broken web page +*StatusLineSecure* The status bar for a secure web page +*String* A JavaScript String object +*TabClose* The close button of a browser tab +*TabIcon* The icon of a browser tab +*TabIconNumber* The number of a browser tab, over its icon +*TabNumber* The number of a browser tab, next to its icon +*TabText* The text of a browser tab +*Tag* A bookmark tag for a URL +*Title* The title of a listing, including [c]:bmarks[c], [c]:jumps[c] +*URL* A URL +*WarningMsg* A warning message +------------------------------------------------------- + +Every invocation completely replaces the styling of any previous invocation, +unless [-append] (short option: -a) is provided, in which case, {css} is +appended to its current value. If {css} is not provided and [!] is, any +styles matching {group} are listed. If neither {css} nor [!] is provided, the +style for {group} is reset to its default value. +________________________________________________________________________________ + +|:sty| |:style| + +||:sty[le][!] [-name={name}] [-append] {filter} [{css}]|| + +________________________________________________________________________________ +Add CSS styles to the browser or to web pages. {filter} is a +comma separated list of URLs to match. URLs ending with [c]*[c] +are matched as prefixes, URLs not containing any [c]:[c] or +[c]/[c] characters are matched as domains. If {name} (short +option: [c]-n[c]) is provided, any existing style with the same +name is overridden, and the style may later be deleted using +{name}. If -append (short option: -a) is provided along with -name, +{css} and {filter} are appended to its current value. + +If {css} isn't provided, matching styles are listed. +________________________________________________________________________________ + +|:dels| |:delstyle| + +||:dels[tyle] [-name={name}] [-index={index}] [{filter}] [{css}]|| + +________________________________________________________________________________ +Delete any matching styles. If {filter} is provided, only matching elements of +the filter are disabled. For instance, a filter [c]mozilla.org[c], given a +style for [c]www.google.com,mozilla.org[c], will result in a style for +[c]www.google.com[c]. The available options are: + + - -name: The name provided to [c]:style[c] (short option: -n) + - -index: For unnamed styles, the index listed by [c]:style[c] (short option: -i) +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/tabs.txt b/vimperator/locale/en-US/tabs.txt new file mode 100644 index 00000000..3e3f38ae --- /dev/null +++ b/vimperator/locale/en-US/tabs.txt @@ -0,0 +1,210 @@ +HEADER + +|tabs| + + +Tabs are used to be able to view many web pages at the same time. Each tab +contains exactly one buffer - multiple buffers per tab are not supported. As a +result many buffer and tab commands are interchangeable. + +section:Listing{nbsp}tabs[listing-tabs] + +|B| |:tabs| |:ls| |:files| |:buffers| +||:buffers [filter]|| + +||B|| +________________________________________________________________________________ +Show a list of buffers (=tabs) matching [filter]. Without [filter] list all +tabs. +________________________________________________________________________________ + +section:Opening{nbsp}tabs[listing-tabs] + +|:tab| + +||:tab {cmd}|| +________________________________________________________________________________ +Execute {cmd} and tell it to output in a new tab. Works only for commands that +support it, currently: + +* [c]:tab help[c] +* [c]:tab prefs[!][c] +* [c]:tab addons[c] +* [c]:tab downloads[c] +________________________________________________________________________________ + + +|:tabd| |:tabduplicate| +||:[count]tab[duplicate]|| + +________________________________________________________________________________ +Duplicate the current tab and switch to the duplicate. If [count] is given, +duplicate the tab [count] times. +________________________________________________________________________________ + +//TODO: should the tab commands be moved back here? +See help::open[browsing.html#opening] for other ways to open new tabs. + +section:Changing{nbsp}tabs[changing-tabs] + +|gb| + +||[count]gb|| +________________________________________________________________________________ +Repeat last [c]:buffer[!][c] command. This is useful to quickly jump between +buffers which have a similar URL or title. +________________________________________________________________________________ + + +|gB| + +||[count]gB|| +________________________________________________________________________________ +Repeat last [c]:buffer[!][c] command in reverse direction. Just like [m]gb[m] +but in the other direction. +________________________________________________________________________________ + + +|<C-PageDown>| |<C-Tab>| |<C-n>| |gt| + +||[count]gt|| +________________________________________________________________________________ +Go to the next tab. Cycles to the first tab, when the last is selected. + +Count is supported: [m]3gt[m] goes to the third tab. +________________________________________________________________________________ + + +|<C-PageUp>| |<C-S-Tab>| |<C-p>| |gT| + +||[count]gT|| +________________________________________________________________________________ +Go {count} pages back. Wraps around from the first tab to the last tab. + +Count is supported: [m]3gT[m] goes three tabs back. +________________________________________________________________________________ + + +|<C-6>| |<C-^>| + +||[count]<C-^>|| +________________________________________________________________________________ +Select the alternate tab or the [count]th tab. The alternate tab is the last +selected tab. This provides a quick method of toggling between two tabs. +________________________________________________________________________________ + + +|b| |:b| |:buffer| +||:[count]b[uffer][!] {url|index}|| + +||b|| +________________________________________________________________________________ +Go to the specified buffer from the buffer list. Argument can be either the +buffer index or the full URL. + +If argument is neither a full URL nor an index but uniquely identifies a +buffer, it is selected. With [!] the next buffer matching the argument is +selected, even if it cannot be identified uniquely. Use [m]b[m] as a +shortcut to open this prompt. + +If argument is [a]#[a], the alternate buffer will be selected (see [m]<C-^>[m]). +________________________________________________________________________________ + + +|g^| |g0| |:bf| |:bfirst| |:br| |:brewind| |:tabfir| |:tabfirst| |:tabr| |:tabrewind| +||:tabr[ewind]|| + +||:tabfir[st]|| + +||:br[ewind]|| + +||:bf[irst]|| + +||g0|| + +||g^|| +________________________________________________________________________________ +Switch to the first tab. +________________________________________________________________________________ + + +|g$| |:bl| |:blast| |:tabl| |:tablast| +||:tabl[ast]|| + +||:bl[ast]|| + +||g$|| +________________________________________________________________________________ +Switch to the last tab. +________________________________________________________________________________ + + +|:tabde| |:tabdetach| + +||:tabde[tach]|| +________________________________________________________________________________ +Detach the current tab, and open it in its own window. +________________________________________________________________________________ + + +|:tabm| |:tabmove| +||:tabm[ove] [N]|| + +||:tabm[ove][!] +N | -N|| + +________________________________________________________________________________ +Move the current tab to a position after tab N. When N is 0, the current tab +is made the first one. Without N the current tab is made the last one. N can +also be prefixed with "+" or "-" to indicate a relative movement. If [!] is +specified the movement wraps around the start or end of the tab list. +________________________________________________________________________________ + + +|:bn| |:bnext| |:tn| |:tnext| |:tabn| |:tabnext| +||:[count]tabn[ext] [count]|| + +||:[count]tn[ext] [count]|| + +||:[count]bn[ext] [count]|| + +________________________________________________________________________________ +Switch to the next or [count]th tab. Cycles to the first tab when the last is +selected and {count} is not specified. +________________________________________________________________________________ + + +|:tabo| |:tabonly| +||:tabo[nly]|| +________________________________________________________________________________ +Close all other tabs. +________________________________________________________________________________ + + +|:bN| |:bNext| |:bp| |:bprevious| |:tN| |:tNext| |:tabN| |:tabNext| |:tp| |:tprevious| |:tabp| |:tabprevious| + +||:[count]tabp[revious] [count]|| + +||:[count]tp[revious] [count]|| + +||:[count]tabN[ext] [count]|| + +||:[count]bp[revious] [count]|| + +||:[count]bN[ext] [count]|| + +________________________________________________________________________________ +Switch to the previous tab or go [count] tabs back. Wraps around from the +first tab to the last tab. +________________________________________________________________________________ + + + +section:Closing{nbsp}tabs[closing-tabs] + +|d| |:tabc| |:tabclose| |:bun| |:bunload| |:bw| |:bwipeout| |:bd| |:bdelete| +||:[count]bd[elete][!] [arg]|| + +||[count]d|| +________________________________________________________________________________ +Delete current buffer (=tab). Count is supported, [c]:2bd[c] removes two tabs +and the one to the right is selected. Afterwards, the tab to the right of the +deleted one is selected. + +When used with [arg], remove all tabs which contain [arg] in the hostname. +[!] forces this command to also search for [arg] in the full URL and also +the title of the tab. Use with care. +________________________________________________________________________________ + + +|D| +||[count]D|| +________________________________________________________________________________ +Like [m]d[m] but selects the tab to the left of the deleted tab. +________________________________________________________________________________ + + +|u| |:u| |:undo| +||:[count]u[ndo] [url]|| + +||[count]u|| +________________________________________________________________________________ +Undo closing of a tab. If a count is given, don't close the last but the +[count]th last tab. With [url] restores the tab matching the URL. +________________________________________________________________________________ + + +|:undoa| |:undoall| + +||:undoa[ll]|| +________________________________________________________________________________ +Undo closing of all closed tabs. Firefox stores up to 10 closed tabs, even +after a browser restart. +________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/tutorial.txt b/vimperator/locale/en-US/tutorial.txt new file mode 100644 index 00000000..8eeb10b2 --- /dev/null +++ b/vimperator/locale/en-US/tutorial.txt @@ -0,0 +1,254 @@ +HEADER + +// Initial revision: Sun Jun 8 10:07:05 UTC 2008 (penryu) + ++++<center>+++ +*This is a quickstart tutorial to help get new users up and running in +Vimperator. It is not indented as a full reference explaining all features.* ++++</center>+++ + +section:Quick-start{nbsp}tutorial[tutorial] + +If you've started using Vimperator from scratch (i.e., without any +customization), you should be looking at this help page in a relatively +bare-looking window. The menubar, navigation bar, and bookmark bars are +hidden. In case you missed the notice in the help:Introduction[intro.html], +you can regain these by issuing the command + + :set go+=mTb<CR> + +where [m]<CR>[m] represents pressing the <Enter> or <Return> key. +If you're a veteran Vim user, this may look familiar. It should. + +However, in this author's opinion, the best way to get familiar with +Vimperator is to leave these disabled for now. (The above action can be +reversed with [c]:set go=<CR>[c]) You can look at the entry for +[o]guioptions[o] in help:options[options.html] for more information on this. + +section:Vimperator's{nbsp}modal{nbsp}interface[modal] + +Vimperator's power, like Vim's, comes from it's modal interface. Keys have +different meanings depending on which mode the browser is in. Vimperator has +several modes, but the 2 most important are ``normal'' mode and +``command-line'' mode. + +When Vimperator starts, it is in normal mode by default. This is probably +where you will spend the majority of your time. + +The other core mode of Vimperator, command-line mode, can be entered from +normal mode by typing a \':' (colon). You will frequently see Vimperator +commands start with a \':', indicating that what follows is a command. + +To return to normal mode command-line mode, type [m]<Esc>[m]. Pressing +[m]<Esc>[m] will also return you to normal mode from most other modes in +Vimperator. + +section:Getting{nbsp}help[getting-help] + +Vim is a great editor but it's not much of a web browser. So even seasoned +Vim users will probably have to look at Vimperator documentation sooner or +later. Most of the documentation for Vimperator's features are easily found +using the [c]:help[c] command. For example, you can find help on the +[c]:help[c] command by typing + + :help :help<CR> + +Similarly, help on configurable options is available with [c]:help +'{option_name}'[c]. (Note the single quotes around the option name as in Vim.) +Information on all available options is, predictably, [c]:help options[c]. + +and you can find out about the [m]gt[m] and [m]gT[m] mapping with + + :help gt<CR> + :help gT<CR> + +Finally, in addition to the help system itself, [c]:exusage[c] and +[c]:viusage[c] are useful quick-reference commands. + +section:Mouseless[living-mouseless] + +*-- or how I learned to stop worrying and love the 80+ buttons I already have.* + +The efficiency of Vimperator, as with the legendary editor it was inspired by, +relies on the user being able to keep his fingers on the keyboard where they +can do the most good. While there are some areas where the mouse is clearly +superior at, such as GUI design or some games, Vimperator acts on the +assumption that the web browser doesn't have to be one of those. + +Here are some areas where the mouse is typically considered indisposable, and +how Vimperator challenges this preconception. + +section:Scrolling[keyboard-scrolling] + +Scrolling the browser window is done with simple keystrokes: + + * [m]j[m]/[m]k[m] -- + scroll window down/up by one line, respectively + * [m]h[m]/[m]l[m] -- + scroll window left/right + * [m]<Space>[m]/[m]<C-b>[m] -- + scroll down/up by one page + * [m]<C-d>[m]/[m]<C-u>[m] -- + scroll down/up by 1/2 page + +Your standard buttons ([m]<Up>[m]/[m]<Down>[m]/[m]<PgUp>[m]/[m]<PgDn>[m]) will +also work as expected. + +section:History{nbsp}and{nbsp}tabs[history-navigation,tab-navigation] + +History navigation (e.g., ``Back'', ``Forward'') are done similarly to +scrolling. + + * [m]<C-o>[m]/[m]<C-i>[m] -- + move Back/Forward in the current window/tab's history, respectively + +Move between tabs using these keystrokes which may also be familiar to tabbing +Vimmers. + + * [m]gt[m]/[m]<C-n>[m] -- + go to the next tab + * [m]gT[m]/[m]<C-p>[m] -- + go to the previous tab + * [m]g0[m]/[m]g$[m] -- + go to the first/last tab + * [m]d[m] -- + close the active tab (delete the buffer) + +To open a web page in a new tab, use the [c]:tabopen {url}[c]. To open a URL +in the current tab, use [c]:open[c]. The normal mode +mappings [m]t[m] and [m]o[m], respectively, map to these commands, so the +following pairs sequences are equivalent: + + :open my.webmail.com<CR> + omy.webmail.com<CR> + + :tabopen vimperator.mozdev.org<CR> + tvimperator.mozdev.org<CR> + +section:Some{nbsp}hints{nbsp}about{nbsp}surfing...[hints-tutorial] + +So now you can navigate around in Vimperator. But wait... how do you *open* a +page or tab linked in a web page? How do you ``click'' on all those links +without your tailed friend? + +The answer is ``hints''. Activating hints displays a number next to every +link Vimperator can find. To follow the link, simply type the number +corresponding to the hint, a white number inside a red square by default. + +For text links, there's an additional shortcut; you can type some text +contained in the link and Vimperator will search all the links it can find and +only hint the matching links, further narrowing down the list. If the text +you type uniquely identifies any given link, Vimperator will follow that link +immediately without any further user input. + +Whichever way you choose to indicate your target link, once Vimperator has +highlighted the link you want, simply hit [m]<Enter>[m] to open it. + +The most common hint mode is called help:QuickHint{nbsp}mode[various.html,f]. +To activate QuickHint mode, press either [m]f[m] or [m]F[m]. The lower-case +[m]f[m] will open the resulting link in the current tab, while the upper-case +[m]F[m] will open it in a new tab. + +To test it, try this link: http://vimperator.mozdev.org/[Vimperator Homepage]. +Activate QuickHint mode with [m]f[m] or [m]F[m] to highlight all currently +visible links. Then start typing the text of the link. The link should be +uniquely identified soon, and Vimperator will open it. Once you're done, +remember to use [m]<C-o>[m] (``History Back'') or [m]d[m] (``Delete Buffer'') +to return here, depending on which key you used to activate QuickHint mode. + +section:Common{nbsp}issues[common-issues] + +Say you get half-way done typing in a new URL, only to remember that you've +already got that page open in the previous tab. Your command-line might look +something like this: + + :open my.partial.url/fooba + +You can exit the command-line and access the already loaded page with the +following: + + <Esc>gT + +section:Saving{nbsp}for{nbsp}posterity{nbsp}-{nbsp}vimperatorrc[vimperatorrc] + +Once you get Vimperator set up with your desired options, maps, and +commands, you'll probably want them to be available the next time you +open Vimperator. Continuing the Vim theme, this is done with a +vimperatorrc file. + +To save your current settings and allow them to be loaded automatically +next time you start Vimperator, issue the [c]:mkv[c] command. + +This will create the file *$HOME/.vimperatorrc* containing your settings. +It is a simple text file, just like a vimrc file and can be easily +edited to suit your preferences. + +section:Find{nbsp}the{nbsp}exit{nbsp}nearest{nbsp}you[quitting-without-menus] + +Vimperator supports all of Vim's classic methods of exiting. + + * [c]:xall[c] -- command to quit and save the current browsing + session for next time; the default. + * [c]:qall[c] -- command to quit _without_ saving the session + * [m]ZZ[m] -- normal mode mapping equivalent to [c]:xall[c] + * [m]ZQ[m] -- normal mode mapping equivalent to [c]:qall[c] + +section:Where{nbsp}did{nbsp}Firefox{nbsp}go?[whither-firefox] + +You might feel pretty disoriented now. Don't worry. This is still Firefox +underneath. Here are some ways Vimperator allows Firefox to shine through. +See the [c]:help[c] for these commands and mappings for more information on +how to make the best use of them. + + * [c]:dialog[c] -- + To access some of Firefox's many dialog windows, you can use the + [c]:dialog[c] command. See [c]:help :dialog[c]. + * [c]:bmarks[c] -- + Vimperator provides a new interface to bookmarks, but they're still your + standard Firefox bookmarks under the hood. [c]:bmark[c] will add a new + bookmark, while [c]:bmarks[c] will list the bookmarks currently defined. + * [c]:history[c] -- + It's exactly what it sounds like. This command will display a colorized, + scrollable and clickable list of the locations in Vimperator's history. + * [c]:emenu[c] -- + Access the Firefox menus through the Vimperator command-line. + + +Feel free to explore at this point. If you use the [c]:tabopen[c] command, +remember to use the [m]gt[m]/[m]gT[m] mappings to get back to this page. If +using the [c]:open[c] command, use the history keys (e.g., [m]H[m]) to return. +If you get hopelessly lost, just type [c]:help<CR>[c] and click the +``Tutorial'' link to return. + + +// TODO: other sections? + + +section:Get{nbsp}me{nbsp}out{nbsp}of{nbsp}here![removal] + +If you've given it a fair shot and determined ... TODO + +The Vimperator way to do this is with the command [c]:addons[c]. Issuing this +command brings up the Firefox Add-ons dialog window; you can then remove it as +normal, selecting Vimperator from the list and clicking (yes, clicking) +*Uninstall*. + +Alternatively, you can do this the old-fashioned way: re-enable the menubar, +as above, with [c]:set go+=m[c], and select *Add-ons* from the *Tools* menu. + + +section:I'm{nbsp}interested...but{nbsp}lost![support] + +Vimperator has an energetic and growing user base. If you've run into a +problem that you can't seem to solve with Vimperator, or if you think you might +have found a bug, please let us know! There is support available on the +http://vimperator.cutup.org/index.php?title=Main_Page[wiki], or in the +#vimperator IRC channel on http://freenode.net/[freenode]. + +If you have any feature requests or (even better) offers to help, we'd love to +hear from you as well. Developers work on Vimperator whenever possible, but +we are neither infinite nor omnipotent; please bear with us. If you can't +wait for us to get around to it, rest assured patches are welcome! See +the help:Developer[developer.html] page for more information. + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/various.txt b/vimperator/locale/en-US/various.txt new file mode 100644 index 00000000..941364ba --- /dev/null +++ b/vimperator/locale/en-US/various.txt @@ -0,0 +1,118 @@ +HEADER + +section:Various{nbsp}commands[various] + +|:beep| + +||:beep|| +________________________________________________________________________________ +Play a system beep. +________________________________________________________________________________ + + +|<C-l>| |CTRL-L| |:redr| |:redraw| + +||:redr[aw]|| +____ +Redraws the screen. Useful to update the screen halfway executing a script or function. +____ + +|:norm| |:normal| +||:norm[al][!] {commands}|| + +________________________________________________________________________________ +Execute Normal mode commands {commands}. This makes it possible to execute +Normal mode commands typed on the command-line. {commands} is executed like it +is typed. If the [!] is given, mappings will not be used. {commands} should be +a complete command. {commands} cannot start with a space. Put a 1 (one) before +it, 1 space is one space. +________________________________________________________________________________ + + +|:run| |:!| + +||:!{cmd}|| +________________________________________________________________________________ +Run a command. Runs {cmd} through system() and displays its output. Any \'!' in +{cmd} is replaced with the previous external command. But not when there is a +backslash before the \'!', then that backslash is removed. + +Warning: Input redirection (< foo) not done, also do not run commands which +require stdin or it will hang Firefox! +________________________________________________________________________________ + + +|:ve| |:version| + +||:ve[rsion][!]|| +________________________________________________________________________________ +Show version information. You can show the Firefox version page with +[c]:version![c]. +________________________________________________________________________________ + +section:Online{nbsp}help[online-help] + +|<F1>| |:help| |:h| |help| +||:h[elp] [a][subject][a]|| + +||<F1>|| +________________________________________________________________________________ +Open help window. The default page, as specified by 'helpfile' is shown unless +[a][subject][a] is specified. If you need help for a specific topic, try +[c]:help overview[c]. +____________________________________________________________________________ + + +|:exu| |:exusage| + +||:exu[sage][!]|| +________________________________________________________________________________ +Show help on Ex commands. If [!] is given then the help is listed in the +command output window. +________________________________________________________________________________ + + +|:optionu| |:optionusage| + +||:optionu[sage][!]|| +________________________________________________________________________________ +Show help on options. If [!] is given then the help is listed in the command +output window. +________________________________________________________________________________ + + +|:viu| |:viusage| + +||:viu[sage][!]|| +________________________________________________________________________________ +Show help on Normal mode commands. If [!] is given then the help is listed in +the command output window. +________________________________________________________________________________ + + +|42| + + +What is the meaning of life, the universe and everything? +Douglas Adams, the only person who knew what this question really was about is +now dead, unfortunately. So now you might wonder what the meaning of death +is... + + +section:Uncategorized{nbsp}help[uncategorized] + +|<C-[>| |<Esc>| + +||<Esc>|| +________________________________________________________________________________ +Focus content. Exits any command-line or hint mode and returns to browser +mode. Also focuses the web page, in case a form field has focus and eats +our key presses. +________________________________________________________________________________ + + +|<Insert>| |i| + +||i|| +________________________________________________________________________________ +Start caret mode. This mode resembles the Vim normal mode where you see a text +cursor and can move around. If you want to select text in this mode, press +[m]v[m] to start its Visual mode. +________________________________________________________________________________ + + +//|:pc| |:pclose| + +//||:pc[lose]|| +//________________________________________________________________________________ +//Close preview window on bottom of screen. +//________________________________________________________________________________ + +// vim: set syntax=asciidoc: diff --git a/vimperator/locale/en-US/xhtml11.css b/vimperator/locale/en-US/xhtml11.css new file mode 100644 index 00000000..0244ce35 --- /dev/null +++ b/vimperator/locale/en-US/xhtml11.css @@ -0,0 +1,337 @@ +/* keep the mozdev header */
+@import url(http://www.mozdev.org/skin/color/mozdev2k.css);
+
+/*
+ CSS stylesheet for XHTML produced by DocBook XSL stylesheets.
+ Tested with XSL stylesheets 1.61.2, 1.67.2
+*/
+
+span.strong {
+ font-weight: bold;
+}
+
+a {
+ color: #4A708B;
+ text-decoration: none;
+}
+
+body blockquote {
+ margin-top: .75em;
+ line-height: 1.5;
+ margin-bottom: .75em;
+}
+
+html body {
+ /*margin: 1em 5% 1em 5%;*/
+ margin: auto;
+ padding-left: 25px;
+ padding-right: 25px;
+ line-height: 1.2;
+ font-family: -moz-fixed;
+ max-width: 800px;
+}
+
+body div {
+ margin: 0;
+}
+
+h1, h2, h3, h4, h5, h6,
+div.toc p b,
+div.list-of-figures p b,
+div.list-of-tables p b,
+div.abstract p.title
+{
+ color: #527bbd;
+}
+
+div.toc p:first-child,
+div.list-of-figures p:first-child,
+div.list-of-tables p:first-child,
+div.example p.title
+{
+ margin-bottom: 0.1em;
+}
+
+body h1 {
+ margin: .0em 0 0 -4%;
+ line-height: 1.3;
+ border-bottom: 1px solid silver;
+}
+
+body h2 {
+ /* necessary, because we put h2 into tables */
+ margin-top: 20px !important;
+ margin-bottom: 0px !important;
+ line-height: 1.3;
+ /*border-bottom: 1px solid silver;*/
+}
+
+body h3 {
+ margin: .8em 0 0 -3%;
+ line-height: 1.3;
+}
+
+body h4 {
+ margin: .8em 0 0 -3%;
+ line-height: 1.3;
+}
+
+body h5 {
+ margin: .8em 0 0 -2%;
+ line-height: 1.3;
+}
+
+body h6 {
+ margin: .8em 0 0 -1%;
+ line-height: 1.3;
+}
+
+body hr {
+ border: none; /* Broken on IE6 */
+}
+div.footnotes hr {
+ border: 1px solid silver;
+}
+
+div.navheader th, div.navheader td, div.navfooter td {
+ font-size: 0.9em;
+ font-weight: bold;
+ color: #527bbd;
+}
+div.navheader img, div.navfooter img {
+ border-style: none;
+}
+div.navheader a, div.navfooter a {
+ font-weight: normal;
+}
+div.navfooter hr {
+ border: 1px solid silver;
+}
+
+body td {
+ line-height: 1.2
+}
+
+body th {
+ line-height: 1.2;
+}
+
+ol {
+ line-height: 1.2;
+}
+
+ul, body dir, body menu {
+ line-height: 1.2;
+}
+
+html {
+ margin: 0;
+ padding: 0;
+}
+
+body h1, body h2, body h3, body h4, body h5, body h6 {
+ margin-left: 0
+}
+
+body pre {
+ margin: 0.5em 10% 0.5em 1em;
+ line-height: 1.2;
+ color: navy;
+}
+
+tt.literal, code.literal {
+ color: navy;
+}
+
+
+.programlisting, .screen, .listingblock {
+ border: 1px solid silver;
+ background: #f4f4f4;
+ margin: 0.5em 10% 0.5em 0;
+ padding: 0.5em 1em;
+}
+
+div.sidebar {
+ background: #ffffee;
+ margin: 1.0em 10% 0.5em 0;
+ padding: 0.5em 1em;
+ border: 1px solid silver;
+}
+div.sidebar * { padding: 0; }
+div.sidebar div { margin: 0; }
+div.sidebar p.title {
+ margin-top: 0.5em;
+ margin-bottom: 0.2em;
+}
+
+div.bibliomixed {
+ margin: 0.5em 5% 0.5em 1em;
+}
+
+#footer {
+ margin: 15px;
+ text-align: center;
+ color: gray;
+}
+
+div.glossary dt {
+ font-weight: bold;
+}
+div.glossary dd p {
+ margin-top: 0.2em;
+}
+
+dl {
+ margin: .8em 0;
+ line-height: 1.2;
+}
+
+dt {
+ margin-top: 0.5em;
+}
+
+dt span.term {
+ font-style: italic;
+}
+
+div.variablelist dd p {
+ margin-top: 0;
+}
+
+div.itemizedlist li, div.orderedlist li {
+ margin-left: -0.8em;
+ margin-top: 0.5em;
+}
+
+ul, ol {
+ list-style-position: outside;
+}
+
+div.sidebar ul, div.sidebar ol {
+ margin-left: 2.8em;
+}
+
+div.itemizedlist p.title,
+div.orderedlist p.title,
+div.variablelist p.title
+{
+ margin-bottom: -0.8em;
+}
+
+div.revhistory table {
+ border-collapse: collapse;
+ border: none;
+}
+div.revhistory th {
+ border: none;
+ color: #527bbd;
+}
+div.revhistory td {
+ border: 1px solid silver;
+}
+
+/* Keep TOC and index lines close together. */
+div.toc dl, div.toc dt,
+div.list-of-figures dl, div.list-of-figures dt,
+div.list-of-tables dl, div.list-of-tables dt,
+div.indexdiv dl, div.indexdiv dt
+{
+ line-height: normal;
+ margin-top: 0;
+ margin-bottom: 0;
+}
+
+/*
+ Table styling does not work because of overriding attributes in
+ generated HTML.
+*/
+div.table table,
+div.informaltable table
+{
+ margin-left: 0;
+ margin-right: 5%;
+ margin-bottom: 0.8em;
+}
+div.informaltable table
+{
+ margin-top: 0.4em
+}
+div.table thead,
+div.table tfoot,
+div.table tbody,
+div.informaltable thead,
+div.informaltable tfoot,
+div.informaltable tbody
+{
+ /* No effect in IE6. */
+ border-top: 2px solid #527bbd;
+ border-bottom: 2px solid #527bbd;
+}
+div.table thead, div.table tfoot,
+div.informaltable thead, div.informaltable tfoot
+{
+ font-weight: bold;
+}
+
+div.mediaobject img {
+ border: 1px solid silver;
+ margin-bottom: 0.8em;
+}
+div.figure p.title,
+div.table p.title
+{
+ margin-top: 1em;
+ margin-bottom: 0.4em;
+}
+
+@media print {
+ div.navheader, div.navfooter { display: none; }
+}
+
+/* my additions */
+span.tag, span.hiddentag {
+ font-weight: bold;
+ color: rgb(255, 0, 255); /* magenta */
+ padding-left: 15px;
+ float: right;
+}
+/* inside a table cell means this tag is part of a section */
+td span.tag {
+ padding-top: 25px !important;
+}
+
+div.key {
+ color: rgb(255, 0, 255); /* magenta */
+ min-width: 120px; /* with 20px padding actually 140px */
+ /*padding-bottom: 5px;*/
+ padding-right: 20px;
+ float: left;
+}
+span.warning {
+ font-weight: bold;
+ color: red;
+}
+fieldset.paypal {
+ border: none;
+}
+
+.argument {
+ color: #6A97D4;
+}
+.command {
+ font-weight: bold;
+ color: #632610;
+ white-space: nowrap;
+}
+.mapping {
+ font-weight: bold;
+ color: #102663;
+}
+.option {
+ font-weight: bold;
+ color: #106326;
+}
+.quoteblock {
+ margin-left: 140px;
+ padding-bottom: 10px;
+}
|