summaryrefslogtreecommitdiff
path: root/common/locale/en-US/marks.xml
diff options
context:
space:
mode:
Diffstat (limited to 'common/locale/en-US/marks.xml')
-rw-r--r--common/locale/en-US/marks.xml353
1 files changed, 353 insertions, 0 deletions
diff --git a/common/locale/en-US/marks.xml b/common/locale/en-US/marks.xml
new file mode 100644
index 00000000..084cc64b
--- /dev/null
+++ b/common/locale/en-US/marks.xml
@@ -0,0 +1,353 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<?xml-stylesheet type="text/xsl" href="chrome://liberator/content/help.xsl"?>
+
+<!DOCTYPE document SYSTEM "chrome://liberator/content/liberator.dtd">
+
+<document
+ name="marks"
+ title="&liberator.appname; Marks"
+ xmlns="http://vimperator.org/namespaces/liberator"
+ xmlns:html="http://www.w3.org/1999/xhtml">
+<h1 tag="different-marks marks">Marks</h1>
+
+<p>
+ Vimperator supports a number of different marks:
+</p>
+
+<ul>
+ <li>Bookmarks which allow you to mark a web page as one of your favorites for easy access.</li>
+ <li>QuickMarks allow you to define up to 62 (a-zA-Z0-9) web sites (or groups of web sites) which you visit most often.</li>
+ <li>Local marks to store the position within a web page.</li>
+ <li>History is also a special type of marks, as Vimperator automatically remembers sites which you have visited in the past.</li>
+</ul>
+
+<h1 tag="bookmarks">Bookmarks</h1>
+
+<item>
+ <tags>a :bma :bmark</tags>
+ <spec>:bma[rk][!] <oa>-title=title</oa> <oa>-keyword=kw</oa> <oa>-tag=tag1,tag2</oa> <oa>url</oa></spec>
+ <spec>a</spec>
+ <description>
+ <p>Add a bookmark.</p>
+
+ <p>The following options are interpreted:</p>
+
+ <ul>
+ <li>-title="custom title" (short option: -t)</li>
+ <li>-tag=comma,separated,tag,list (short option: -T)</li>
+ <li>-keyword=keyword (short option: -k)</li>
+ </ul>
+
+ <p>
+ If [!] is present, a new bookmark is always added. Otherwise, the first
+ bookmark matching <oa>url</oa> is updated.
+ </p>
+
+ <p>
+ When creating a new bookmark, if <oa>-title</oa> isn't given, either the web
+ page's title or URL is used. You can omit the optional <oa>url</oa> argument, so
+ just do <ex>:bmark</ex> to bookmark the currently loaded web page with a default
+ title and without any tags.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>A</tags>
+ <spec>A</spec>
+ <description>
+ <p>
+ Toggle bookmarked state of current URL. Add/remove a bookmark for the current
+ location, depending on if it is already bookmarked or not. In contrast to the
+ <ex>:bmark</ex> command, the bookmark is just <em>starred</em> which means it is placed
+ in the <em>Unfiled Bookmarks Folder</em> instead of the bookmarks menu.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:bmarks</tags>
+ <spec>:bmarks[!] <oa>filter</oa></spec>
+ <description>
+ <p>
+ List or open multiple bookmarks. Open the message window at the bottom of the
+ screen with all bookmarks which match <oa>filter</oa> either in the title or
+ URL. You can then use extended hint commands like <k>;o</k> to open the desired
+ bookmark.
+ </p>
+
+ <p>
+ The special version <ex>:bmarks!</ex> works the same as <ex>:bmarks</ex> except it
+ opens all the found bookmarks in new tabs.
+ </p>
+
+ <p>Filter can also contain the following options:</p>
+
+ <ul>
+ <li>-tag=comma,separated,tag,list (short option: -T)</li>
+ <li>-max=N (short options: -m)</li>
+ </ul>
+ </description>
+</item>
+
+<item>
+ <tags>:delbm :delbmarks</tags>
+ <spec>:delbm[arks] <oa>url</oa></spec>
+ <spec>:delbm[arks]!</spec>
+ <description>
+ <p>
+ Delete a bookmark. Deletes *all* bookmarks which match the <oa>url</oa>. If
+ omitted, <oa>url</oa> defaults to the URL of the current buffer. Use <k name="Tab"/>
+ key on a string to complete the URL which you want to delete.
+ </p>
+
+ <p>If ! is specified then all bookmarks will be deleted.</p>
+ </description>
+</item>
+<!-- TODO: why is this duplicated in browsing? -->
+<h1 tag="history">History</h1>
+
+<item>
+ <tags><![CDATA[<C-o>]]></tags>
+ <spec><![CDATA[[count]<C-o>]]></spec>
+ <description>
+ <p>
+ Go to an older position in the jump list. The jump list is just the browser
+ history for now. If <oa>count</oa> is specified go back <oa>count</oa> pages.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags><![CDATA[<C-i>]]></tags>
+ <spec><![CDATA[[count]<C-i>]]></spec>
+ <description>
+ <p>
+ Go to a newer position in the jump list. The jump list
+ is just the browser history for now. If <oa>count</oa>
+ is specified go forward <oa>count</oa> pages.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags><![CDATA[<M-Left> <A-Left> H]]></tags>
+ <spec>[count]H</spec>
+ <description>
+ <p>Go back in the browser history. If <oa>count</oa> is specified go back <oa>count</oa> pages.</p>
+ </description>
+</item>
+
+<item>
+ <tags><![CDATA[<M-Right> <A-Right> L]]></tags>
+ <spec>[count]L</spec>
+ <description>
+ <p>
+ Go forward in the browser history. If <oa>count</oa> is specified go forward <oa>count</oa>
+ pages.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:ba :back</tags>
+ <spec>:[count]ba[ck] <oa>url</oa></spec>
+ <spec>:[count]ba[ck]!</spec>
+ <description>
+ <p>
+ Go back in the browser history. If <oa>count</oa> is specified go back <oa>count</oa> pages.
+ </p>
+ <p>
+ The special version <ex>:back!</ex> goes to the beginning of the browser history.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:fw :fo :forward</tags>
+ <spec>:[count]fo[rward] <oa>url</oa></spec>
+ <spec>:[count]fo[rward]!</spec>
+ <description>
+ <p>
+ Go forward in the browser history. If <oa>count</oa> is specified go forward <oa>count</oa>
+ pages.
+ </p>
+ <p>
+ The special version <ex>:forward!</ex> goes to the end of the browser history.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:hs :hist :history</tags>
+ <spec>:hist[ory][!] <oa>filter</oa></spec>
+ <description>
+ <p>
+ Show recently visited URLs. Open the message window at the bottom of the screen
+ with all history items which match <oa>filter</oa> either in the title or URL.
+ </p>
+
+ <p>
+ The special version <ex>:history!</ex> works the same as <ex>:history</ex> except
+ it opens all the found items in new tabs.
+ </p>
+
+ <p>Filter can also contain the following options:</p>
+
+ <ul>
+ <li>-max=N (short options: -m)</li>
+ </ul>
+ </description>
+</item>
+
+<h1 tag="quickmarks">QuickMarks</h1>
+
+<item>
+ <tags>go</tags>
+ <spec>a-zA-Z0-9</spec>
+ <description>
+ <p>
+ Jump to a QuickMark in the current tab. Open any QuickMark in the current tab.
+ You can mark any URLs with <k>M</k><a>a-zA-Z0-9</a>. These QuickMarks are
+ persistent across browser sessions.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>gn</tags>
+ <spec>a-zA-Z0-9</spec>
+ <description>
+ <p>
+ Jump to a QuickMark in a new tab. Works like
+ <k>go</k><a>a-zA-Z0-9</a> but opens the QuickMark in a
+ new tab. Whether the new tab is activated or not depends
+ on the <o>activate</o> option.
+ </p>
+ <p>
+ Mnemonic: Go in a new tab. <k>gt</k> would make more
+ sense but is already taken.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>M</tags>
+ <spec>a-zA-Z0-9</spec>
+ <description>
+ <p>
+ Add new QuickMark for current URL. You can go to a
+ marked URL in the current tab with
+ <k>go</k><a>a-zA-Z0-9</a> or in a new tab with
+ <k>gn</k><a>a-zA-Z0-9</a>. These QuickMarks are
+ persistent across browser sessions.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:delqm :delqmarks</tags>
+ <spec>marks</spec>
+ <spec>:delqm[arks]!</spec>
+ <description>
+ <p>Delete the specified QuickMarks. QuickMarks are presented as a list.</p>
+
+ <p>Examples:</p>
+
+ <ul>
+ <li><ex>:delqmarks Aa b p</ex> deletes QuickMarks A, a, b and p</li>
+ <li><ex>:delqmarks b-p</ex> deletes all QuickMarks in the range b to p</li>
+ <li><ex>:delqmarks!</ex> deletes all QuickMarks</li>
+ </ul>
+ </description>
+</item>
+
+<item>
+ <tags>:qma :qmark</tags>
+ <spec>a-zA-Z0-9</spec>
+ <description>
+ <p>
+ Mark a URL with a letter for quick access. You can also mark whole groups
+ like this:
+ </p>
+
+ <p>
+ <ex>:qmark f http://forum1.com, http://forum2.com, imdb some artist</ex>
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:qmarks</tags>
+ <spec>:qmarks <oa>arg</oa></spec>
+ <description>
+ <p>
+ Show all QuickMarks. If <oa>arg</oa> is specified then
+ limit the list to those QuickMarks mentioned.
+ </p>
+ </description>
+</item>
+<h1 tag="localmarks">Local marks</h1>
+
+<item>
+ <tags>m</tags>
+ <spec>a-zA-Z</spec>
+ <description>
+ <p>
+ Set mark at the cursor position. Marks a-z are local to the buffer, whereas
+ A-Z are valid between buffers.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>` '</tags>
+ <spec>a-zA-Z</spec>
+ <description>
+ <p>
+ Jump to the mark. Marks a-z are local to the buffer, whereas A-Z are valid
+ between buffers.
+ </p>
+ </description>
+</item>
+
+<item>
+ <tags>:delm :delmarks</tags>
+ <spec>marks</spec>
+ <spec>:delm[arks]!</spec>
+ <description>
+ <p>Delete the specified marks. Marks are presented as a list.</p>
+
+ <p>Examples:</p>
+
+ <ul>
+ <li><ex>:delmarks Aa b p</ex> deletes marks A, a, b and p</li>
+ <li><ex>:delmarks b-p</ex> deletes all marks in the range b to p</li>
+ <li><ex>:delmarks!</ex> deletes all marks for the current buffer</li>
+ </ul>
+
+ </description>
+</item>
+
+<item>
+ <tags>:ma :mark</tags>
+ <spec>a-zA-Z</spec>
+ <description>
+ <p>Mark current location within the web page.</p>
+ </description>
+</item>
+
+<item>
+ <tags>:marks</tags>
+ <spec>:marks <oa>arg</oa></spec>
+ <description>
+ <p>
+ Show all location marks of the current web page. If
+ <oa>arg</oa> is specified then limit the list to those
+ marks mentioned.
+ </p>
+ </description>
+</item>
+</document>
+
+<!-- vim:se sts=4 sw=4 et: -->