diff --git a/common/components/protocols.js b/common/components/protocols.js index 4de60567..3566f3d4 100644 --- a/common/components/protocols.js +++ b/common/components/protocols.js @@ -38,7 +38,7 @@ function makeChannel(url, orig) return channel; } function fakeChannel(orig) - makeChannel("chrome://does/not/exist/in/any/reasonable/configuration", orig); + makeChannel("chrome://liberator/content/does/not/exist", orig); function redirect(to, orig) { let html = .toXMLString(); @@ -94,9 +94,9 @@ function Liberator() { this.wrappedJSObject = this; - this.__defineGetter__("helpNamespaces", function () NAMESPACES ? NAMESPACES.slice() : null); + this.__defineGetter__("helpNamespaces", function () this.NAMESPACES ? this.NAMESPACES.slice() : null); this.__defineSetter__("helpNamespaces", function (namespaces) { - if (!NAMESPACES) + if (!this.NAMESPACES) parseHelpTags(namespaces); }); @@ -112,6 +112,7 @@ function Liberator() return result; } + this.httpGet = httpGet; function httpGet(url) { try @@ -126,8 +127,9 @@ function Liberator() const self = this; this.HELP_TAGS = {}; - this.FILE_MAP = { all: "chrome://liberator/locale/all.xml" }; - var NAMESPACES = null; + this.FILE_MAP = {}; + this.OVERLAY_MAP = {}; + this.NAMESPACES = null; var HELP_FILES = null; function XSLTProcessor(sheet) @@ -139,23 +141,34 @@ function Liberator() function findHelpFile(file) { - for each (let namespace in NAMESPACES) + let result = []; + for each (let namespace in self.NAMESPACES) { let url = ["chrome://", namespace, "/locale/", file, ".xml"].join(""); let res = httpGet(url); - if (res && res.responseXML.documentElement.localName == "document") - return [url, res.responseXML]; + if (res) + { + if (res.responseXML.documentElement.localName == "document") + self.FILE_MAP[file] = url; + if (res.responseXML.documentElement.localName == "overlay") + self.OVERLAY_MAP[file] = url; + if (res.responseXML.documentElement.localName == "document") + result = [url, res.responseXML]; + } } - return [] + return result; } function parseHelpTags(namespaces) { HELP_FILES = []; - NAMESPACES = Array.slice(namespaces); + self.NAMESPACES = Array.slice(namespaces); + + findHelpFile("all"); + const XSLT = XSLTProcessor("chrome://liberator/content/help.xsl"); self.HELP_TAGS.all = "all"; - for each (let namespace in NAMESPACES) + for each (let namespace in self.NAMESPACES) { let files = xpath( httpGet("chrome://" + namespace + "/locale/all.xml").responseXML, @@ -163,8 +176,9 @@ function Liberator() for each (let file in files) { let [url, doc] = findHelpFile(file.value); - if (doc) - self.FILE_MAP[file.value] = url; + if (!doc) + continue; + self.FILE_MAP[file.value] = url; doc = XSLT.transformToDocument(doc); for (let elem in xpath(doc, "//liberator:tag/text()")) self.HELP_TAGS[elem.textContent] = file.value; @@ -193,7 +207,7 @@ Liberator.prototype = { defaultPort: -1, allowPort: function (port, scheme) false, protocolFlags: 0 - | nsIProtocolHandler.URI_IS_UI_RESOURCE + | nsIProtocolHandler.URI_LOADABLE_BY_ANYONE | nsIProtocolHandler.URI_IS_LOCAL_RESOURCE, newURI: function (spec, charset, baseURI) @@ -213,8 +227,9 @@ Liberator.prototype = { { case "help": let url = this.FILE_MAP[uri.path.replace(/^\/|#.*/g, "")]; - if (!url) - break; + return makeChannel(url, uri); + case "help-overlay": + url = this.OVERLAY_MAP[uri.path.replace(/^\/|#.*/g, "")]; return makeChannel(url, uri); case "help-tag": let tag = uri.path.substr(1); diff --git a/common/content/bookmarks.js b/common/content/bookmarks.js index 6b927273..246805d3 100644 --- a/common/content/bookmarks.js +++ b/common/content/bookmarks.js @@ -77,14 +77,23 @@ function Bookmarks() //{{{ function loadBookmark(node) { - let uri = util.newURI(node.uri); - let keyword = bookmarksService.getKeywordForBookmark(node.itemId); - let tags = taggingService.getTagsForURI(uri, {}) || []; - let bmark = new Bookmark(node.uri, node.title, node.icon && node.icon.spec, keyword, tags, node.itemId); + try + { + let uri = util.newURI(node.uri); + let keyword = bookmarksService.getKeywordForBookmark(node.itemId); + let tags = taggingService.getTagsForURI(uri, {}) || []; + let bmark = new Bookmark(node.uri, node.title, node.icon && node.icon.spec, keyword, tags, node.itemId); - bookmarks.push(bmark); + bookmarks.push(bmark); - return bmark; + return bmark; + } + catch (e) + { + liberator.dump("Failed to create bookmark for URI: " + node.uri); + liberator.reportError(e); + return null; + } } function readBookmark(id) diff --git a/common/content/help.xsl b/common/content/help.xsl index e2e7f896..628fed6d 100644 --- a/common/content/help.xsl +++ b/common/content/help.xsl @@ -8,7 +8,7 @@ xmlns:str="http://exslt.org/strings" extension-element-prefixes="str"> - + @@ -121,6 +121,9 @@ + + + @@ -133,6 +136,16 @@ + +
+ + + +
+ + @@ -142,18 +155,18 @@ - - + + - + - + - - + + @@ -163,25 +176,25 @@ - + - + - + - + diff --git a/common/content/overlay.xsl b/common/content/overlay.xsl index 4e4dd393..b6a21ec1 100644 --- a/common/content/overlay.xsl +++ b/common/content/overlay.xsl @@ -8,8 +8,8 @@ xmlns:str="http://exslt.org/strings" extension-element-prefixes="str"> - - + + @@ -17,15 +17,15 @@ - + - + - - + + @@ -35,25 +35,25 @@ - + - + - + - + diff --git a/common/content/style.js b/common/content/style.js index a70e6446..79919e8d 100644 --- a/common/content/style.js +++ b/common/content/style.js @@ -155,7 +155,7 @@ Highlights.prototype.CSS = html:ol display: block; list-style: outside decimal; HelpListItem,liberator|li display: list-item; margin-left: 1.5em; HelpNote,liberator|note display: block; margin: 1em 0em; diff --git a/common/locale/en-US/autocommands.xml b/common/locale/en-US/autocommands.xml index a2f72585..b99cef10 100644 --- a/common/locale/en-US/autocommands.xml +++ b/common/locale/en-US/autocommands.xml @@ -88,9 +88,9 @@ 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' + +:autocmd LocationChange .* :set editor=gvim -f +:autocmd LocationChange mail\\.google\\.com :set editor=gvim -f -c 'set ft=mail' diff --git a/muttator/content/liberator.dtd b/muttator/content/liberator.dtd index 7f32162f..6fd966aa 100644 --- a/muttator/content/liberator.dtd +++ b/muttator/content/liberator.dtd @@ -1,6 +1,13 @@ + +%liberatorBranding; + + + + + diff --git a/muttator/locale/en-US/autocommands.xml b/muttator/locale/en-US/autocommands.xml new file mode 100644 index 00000000..f420fbea --- /dev/null +++ b/muttator/locale/en-US/autocommands.xml @@ -0,0 +1,38 @@ + + + + + + + +
+
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
+
&liberator.appname;Enter
Triggered after &liberator.host; starts
+
&liberator.appname;LeavePre
Triggered before exiting &liberator.host;, just before destroying each module
+
&liberator.appname;Leave
Triggered before exiting &liberator.host;
+ +
FolderLoad
Triggered after switching folders in &liberator.host;
+
+ +
+
<url>
The URL against which the event was selected.
+
<title>
The page, bookmark or download title.
+
<doc>
The document for which the event occurred. Only for DOMLoad, PageLoad and PageLoadPre.
+
<tab>
The tab in which the event occurred. Only for DOMLoad, PageLoad and PageLoadPre.
+
<size>
The size of a downloaded file. Only for DownloadPost.
+
<file>
The target destination of a download. Only for DownloadPost.
+
<name>
The name of the item. Only for ColorScheme and Sanitize.
+
+ + + + diff --git a/muttator/locale/en-US/gui.xml b/muttator/locale/en-US/gui.xml new file mode 100644 index 00000000..458ca0ec --- /dev/null +++ b/muttator/locale/en-US/gui.xml @@ -0,0 +1,30 @@ + + + + + + + +
+
about
About &liberator.host;
+
addons
Manage Add-ons
+
addressbook
Address book
+
checkupdates
Check for updates
+
console
JavaScript console
+
dominspector
DOM Inspector
+
downloads
Manage Downloads
+
openfile
Open the file selector dialog
+
pageinfo
Show information about the current page
+
pagesource
View page source
+
preferences
Show &liberator.host; preferences dialog
+
printsetup
Setup the page size and orientation before printing
+
print
Show print dialog
+
saveframe
Save frame to disk
+
savepage
Save page to disk
+
+ + + + diff --git a/muttator/locale/en-US/intro.txt b/muttator/locale/en-US/intro.txt deleted file mode 100644 index 34b28bb7..00000000 --- a/muttator/locale/en-US/intro.txt +++ /dev/null @@ -1,112 +0,0 @@ -LOGO - -+++
+++ -*All mail clients suck. Mutt just sucks less. This one just sucks less than -mutt.* -+++
+++ - -section::Introduction[intro] - -http://vimperator.org/muttator[Muttator] is a free browser add-on for -Thunderbird, 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 mail -client, as key bindings differ according to which mode you are in. - -|warning| + -Warning: -To provide the most authentic Vim experience, the Thunderbird 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 Muttator 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| + -Muttator was written by mailto:stubenschrott@vimperator.org[Martin Stubenschrott]. -If you appreciate my work on Muttator and want to encourage me working on it -more, you can either send me greetings, patches or make a donation: - -NOTE: If this link does not work, go to http://vimperator.org/muttator and -click the donation button there, because Thunderbird seems to have a problem -when this link is inside an e-mail (which this help screen actually is). - -++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -
-
- - - - -
-
-++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ - -Of course as a believer in free open source software, only make a donation -if you really like Muttator and the money doesn't hurt -- otherwise just use -it, recommend it and like it :) - -section::Help{nbsp}topics[overview] - -//TO BE WRITTEN... - -For now use [c]:viusage![c], [c]:exusage![c] and [c]:optionusage![c] to find -out about available mappings, commands and options. When in Message mode -(activated by [m]i[m]), most mappings from Vimperator are available. - -// - 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:Motion{nbsp}commands[motion.html]: How to efficiently scroll in -// Vimperator. -// - help:Options[options.html]: A description of all options. -// - help:Tabs[tabs.html]: Manage your tabbed browsing session. -// - help:Marks[marks.html]: Usage of bookmarks, QuickMarks, and history. -// - help:Repeating{nbsp}commands[repeat.html]: Usage of macros to repeat -// recurring workflows. -// - help:Autocommands[autocommands.html]: Automatically execute code on ceratain -// events. -// - 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. - -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][m], etc.) -* Ex-commands ([c]:quit[c], [c]:goto Inbox[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) -* Minimal GUI (easily hide useless menubar and toolbar with - [c]:set guioptions=f[c]) -* Ability to [c]:source[c] JavaScript files, and to use a [a]~/.muttatorrc[a] - file with syntax highlighting if you install - http://code.google.com/p/vimperator-labs/issues/detail?id=51[muttator.vim] -* Count supported for many commands ([m]3[m] will go back 3 messages) -* Beep on errors -* [c]:map[c] support (and feedkeys() for script writers) -* [c]:time[c] support for profiling -* Many other vimperator features are available when in -- MESSAGE -- mode - -// * A comprehensive help file, explaining all commands, mappings and options. - -section::Contact[contact] - -Please send comments/bug reports/patches to the mailing list, where we will -properly answer any questions. You can also join the -+++#vimperator+++ IRC channel -on http://www.freenode.net/[Freenode] or check the -http://code.google.com/p/vimperator-labs/w/list?q=label%3Aproject-muttator[Wiki] -for -http://code.google.com/p/vimperator-labs/wiki/MuttatorFAQ[frequently asked -questions (FAQ)]. Make sure, you have read the -http://vimperator-labs.googlecode.com/hg/muttator/TODO[TODO] file first, as we -are aware of many things which can be improved when we find time for it or -receive patches. - -// vim: set filetype=asciidoc: diff --git a/muttator/locale/en-US/intro.xml b/muttator/locale/en-US/intro.xml new file mode 100644 index 00000000..98500c9a --- /dev/null +++ b/muttator/locale/en-US/intro.xml @@ -0,0 +1,393 @@ + + + + + + + + + + +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 :) + + +

Introduction

+ +&liberator.appname; is a free browser add-on for &liberator.host;, +which makes it look and behave like the +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. + + + To provide the most authentic Vim experience, the &liberator.host; menubar and toolbar are hidden. + + +

If you really need them, type: :set guioptions+=mT to get them back.

+

+ If you don't like &liberator.appname; at all, you can uninstall it by typing + :extdelete &liberator.appname; or :extdisable &liberator.appname; to disable it. +

+

+ If you like it but can't remember the shortcuts, then press + or :help to get this help window back. +

+ +author donaton sponsor +

+ &liberator.appname; was initially written by + Martin + Stubenschrott but has found many other + contributors + in the meanwhile. If you appreciate the work on &liberator.appname; and want to + encourage us working on it more, you can send us greetings, patches, or + donations (thanks a lot to + these + people + who already did): +

+ + + + + + + +

+ If you prefer getting some nice products for your money, you can also support + us by buying some cool + merchandise like + t-shirts or mugs. Of course, as we believe in free, open source software, only + support us financially if you really like &liberator.appname; and the money doesn't hurt + — otherwise just use it, recommend it, and like it :) +

+ +

Help topics

+ +
    +
  1. + Quick-start tutorial: + A quick-start tutorial for new users. +
    2. +
  2. + Starting &liberator.appname;: + How &liberator.appname; starts up, where it reads the config file… +
    3. +
  3. + Browsing: + Basic mappings and commands needed for a browsing session (how to open + a web page or go back in history). +
    4. +
  4. + Buffer: + Operations on the current document like scrolling or copying text. +
    5. +
  5. + Command-line mode: + Command-line editing. +
    6. +
  6. + Insert mode: + Insert-mode editing. +
    7. +
  7. + Options: + A description of all options. +
    8. +
  8. + Text search commands: + Searching for text in the current buffer. +
    9. +
  9. + Tabs: + Managing your tabbed browsing session. +
    10. +
  10. + Hints: + Selecting hyperlinks and other page elements. +
    11. +
  11. + Key mappings, abbreviations, and user-defined commands: + Defining new key mappings, abbreviations and user commands. +
    12. +
  12. + Expression evaluation: + Executing JavaScript. +
    13. +
  13. + Marks: + Using bookmarks, QuickMarks, history and local marks. +
    14. +
  14. + Repeating commands: + Using macros to repeat recurring workflows. +
    15. +
  15. + Automatic commands: + Automatically executing code on certain events. +
    16. +
  16. + Printing: + Printing pages. +
    17. +
  17. + &liberator.appname;'s GUI: + Accessing &liberator.host; menus, dialogs and the sidebar. +
    18. +
  18. + Styling the GUI and web pages: + Changing the styling of content pages and &liberator.appname; itself. +
    19. +
  19. + Error and informational messages: + A description of messages and error messages. +
    20. +
  20. + Developer information: + How to write docs or plugins. +
    21. +
  21. + Various commands: + Other help which didn't fit into any other category. +
    22. +
  22. + Index: + An index of all commands and options. +
    23. +
+ +

+You can also jump directly to the help of a specific command with :help o +or :help :set. +

+ +

Features

+ +
    +
  • Vim-like keybindings (h, j, k, l, gg, G, 0, $, ZZ, , etc.)
    • +
  • Ex commands (:quit, :open www.foo.com, …)
    • +
  • Tab completion available for all commands with support for "longest" matching when set in 'wildmode'
    • +
  • Hit-a-hint like navigation of links (start with f 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 :set guioptions=)
    • +
  • Ability to :source JavaScript files, and to use a ~/.vimperatorrc file with syntax highlighting if you install vimperator.vim
    • +
  • Easy quick searches (:open foo will search for "foo" in google, :open ebay terminator will search for "terminator" on ebay) with support for &liberator.host; keyword bookmarks and search engines
    • +
  • Count supported for many commands (3 will go back 3 pages)
    • +
  • Beep on errors
    • +
  • Marks support (ma to set mark a on a web page, 'a to go there)
    • +
  • QuickMarks support (quickly go to previously marked web pages with goa-zA-Z0-9)
    • +
  • :map and :command support (and feedkeys() for script writers)
    • +
  • :time 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 actions on certain events
    • +
  • A comprehensive help system, explaining all commands, mappings and options
    • +
+ +

Contact

+ +

+ Please send comments/bug reports/patches to the mailing list, where we will + properly answer any questions. You can also join the + #vimperator IRC channel + on Freenode or check the + Wiki for + + frequently asked questions (FAQ) + . Make sure, you have read the TODO file first, as we are aware of many + things which can be improved when we find time for it or receive patches. +

+ + + + + +All mail clients suck. Mutt just sucks less. This one just sucks less than +mutt. + + +

Introduction

+ +http://vimperator.org/muttator[&liberator.appname;] is a free browser add-on for +&liberator.hostapp;, 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 mail +client, as key bindings differ according to which mode you are in. + +|warning| + +Warning: +To provide the most authentic Vim experience, the &liberator.hostapp; menubar and toolbar were hidden. + +If you really need them, type: :set guioptions+=mT to get them back. + +If you don't like &liberator.appname; at all, you can uninstall it by typing +:addons and remove/disable it. + +If you like it, but can't remember the shortcuts, press F1 or +:help to get this help window back. + +|author| |donation| + +&liberator.appname; was written by mailto:stubenschrott@vimperator.org[Martin Stubenschrott]. +If you appreciate my work on &liberator.appname; and want to encourage me working on it +more, you can either send me greetings, patches or make a donation: + +NOTE: If this link does not work, go to http://vimperator.org/muttator and +click the donation button there, because &liberator.hostapp; seems to have a problem +when this link is inside an e-mail (which this help screen actually is). + + + +Of course as a believer in free open source software, only make a donation +if you really like &liberator.appname; and the money doesn't hurt -- otherwise just use +it, recommend it and like it :) + +

Help topics

+ +
    +
  1. + Starting &liberator.appname;: + How &liberator.appname; starts up, where it reads the config file… +
    2. +
  2. + Browsing: + Basic mappings and commands needed for a browsing session (how to open + a web page or go back in history). +
    3. +
  3. + Buffer: + Operations on the current document like scrolling or copying text. +
    4. +
  4. + Command-line mode: + Command-line editing. +
    5. +
  5. + Insert mode: + Insert-mode editing. +
    6. +
  6. + Options: + A description of all options. +
    7. +
  7. + Text search commands: + Searching for text in the current buffer. +
    8. +
  8. + Tabs: + Managing your tabbed browsing session. +
    9. +
  9. + Hints: + Selecting hyperlinks and other page elements. +
    10. +
  10. + Key mappings, abbreviations, and user-defined commands: + Defining new key mappings, abbreviations and user commands. +
    11. +
  11. + Expression evaluation: + Executing JavaScript. +
    12. +
  12. + Marks: + Using bookmarks, QuickMarks, history and local marks. +
    13. +
  13. + Repeating commands: + Using macros to repeat recurring workflows. +
    14. +
  14. + Automatic commands: + Automatically executing code on certain events. +
    15. +
  15. + Printing: + Printing pages. +
    16. +
  16. + &liberator.appname;'s GUI: + Accessing &liberator.host; menus, dialogs and the sidebar. +
    17. +
  17. + Styling the GUI and web pages: + Changing the styling of content pages and &liberator.appname; itself. +
    18. +
  18. + Error and informational messages: + A description of messages and error messages. +
    19. +
  19. + Developer information: + How to write docs or plugins. +
    20. +
  20. + Various commands: + Other help which didn't fit into any other category. +
    21. +
  21. + Index: + An index of all commands and options. +
    22. +
+ + + +For now use :viusage!, :exusage! and :optionusage! to find +out about available mappings, commands and options. When in Message mode +(activated by i), most mappings from &liberator.appname; are available. + + +You can also jump directly to the help of a specific command with +:help o or :help :set. + +

Features

+ +
    +
  • Vim-like keybindings (h, j, k, l, + gg, G, 0, $, ZZ, , etc.) +
    • +
  • Ex-commands (:quit, :goto Inbox, ...)
    • +
  • + Tab completion available for all commands with support for "longest" + matching when set in 'wildmode' +
    • +
  • Hit-a-hint like navigation of links (start with f to follow a link)
    • +
  • + Minimal GUI (easily hide useless menubar and toolbar with :set + guioptions=f) +
    • +
  • + Ability to :source JavaScript files, and to use a + [a]~/.muttatorrc[a] file with syntax highlighting if you install + http://code.google.com/p/vimperator-labs/issues/detail?id=51[muttator.vim] +
    • +
  • Count supported for many commands (3 will go back 3 messages)
    • +
  • Beep on errors
    • +
  • :map support (and feedkeys() for script writers)
    • +
  • :time support for profiling
    • +
  • Many other vimperator features are available when in -- MESSAGE -- mode
    • +
  • A comprehensive help file, explaining all commands, mappings and options.
    • +
+ +

Contact

+ +Please send comments/bug reports/patches to the mailing list, where we will +properly answer any questions. You can also join the +#vimperator IRC channel +on Freenode or check the +Wiki +for + + frequently asked questions (FAQ). +Make sure, you have read the +TODO +file first, as we are aware of many things which can be improved when we find +time for it or receive patches. + + + diff --git a/vimperator/locale/en-US/autocommands.xml b/vimperator/locale/en-US/autocommands.xml index 3874f7be..f117874d 100644 --- a/vimperator/locale/en-US/autocommands.xml +++ b/vimperator/locale/en-US/autocommands.xml @@ -19,9 +19,9 @@
PrivateMode
Triggered when private mode is activated or deactivated
Sanitize
Triggered when privata data are sanitized
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
+
&liberator.appname;Enter
Triggered after &liberator.host; starts
+
&liberator.appname;LeavePre
Triggered before exiting &liberator.host;, just before destroying each module
+
&liberator.appname;Leave
Triggered before exiting &liberator.host;
diff --git a/vimperator/locale/en-US/intro.xml b/vimperator/locale/en-US/intro.xml index 7c9db8b4..be023b1d 100644 --- a/vimperator/locale/en-US/intro.xml +++ b/vimperator/locale/en-US/intro.xml @@ -53,11 +53,7 @@ web browser, as key bindings differ according to which mode you are in. who already did):

- - - - - +

If you prefer getting some nice products for your money, you can also support diff --git a/vimperator/locale/en-US/tutorial.xml b/vimperator/locale/en-US/tutorial.xml index c6b43358..ee8bb6fa 100644 --- a/vimperator/locale/en-US/tutorial.xml +++ b/vimperator/locale/en-US/tutorial.xml @@ -287,7 +287,7 @@ -

Where did &liberator.host; go?

+

Where did &liberator.host; go?

You might feel pretty disoriented now. Don't worry. This is still &liberator.host; diff --git a/xulmus/locale/en-US/intro.xml b/xulmus/locale/en-US/intro.xml index efb71702..008fec7e 100644 --- a/xulmus/locale/en-US/intro.xml +++ b/xulmus/locale/en-US/intro.xml @@ -40,14 +40,8 @@ text editor. or make a donation:

- -
-
- - - -
-
+ +

Of course as a believer in free open source software, only make a donation if you really like &liberator.appname; and the money