- This is a quickstart tutorial to help new users get up and running
+ This is a quick-start tutorial to help new users get up and running
in &dactyl.appName;. It is not intended as a full reference explaining all
features.
@@ -31,14 +30,14 @@
where represents pressing the
or key. If you're a veteran Vim user, this
- may look familiar. It should.
+ should look familiar.
However, in this author's opinion, the best way to get familiar with
- &dactyl.appName; is to leave these disabled for now. (The above action can be
- reversed with ) You can look at the entry
- for guioptions in options for more information on this.
+ &dactyl.appName; is to leave these disabled for now. (The above action can
+ be reversed with ) You can have a
+ look at the guioptions help entry for more information on this.
&dactyl.appName;'s modal interface
@@ -47,7 +46,7 @@
&dactyl.appName;'s power, like Vim's, comes from its modal interface. Keys have
different meanings depending on which mode the browser is in. &dactyl.appName; has
several modes, but the 2 most important are Normal mode and
- Command Line mode.
+ Command Line mode (see modes for the full picture).
@@ -62,9 +61,9 @@
- To return to Normal mode from Command Line mode, type . Pressing
- will also return you to Normal mode from most other modes in
- &dactyl.appName;.
+ To return to Normal mode from Command Line mode, type .
+ Pressing will also return you to Normal mode from most
+ other &dactyl.appName; modes.
Getting help
@@ -103,7 +102,7 @@
Mouseless
-â or how I learned to stop worrying and love the 80+ buttons I already have.
+â or how I learned to stop worrying and love the 80+ buttons I already have.
The efficiency of &dactyl.appName;, as with the legendary editor it was inspired by,
@@ -133,7 +132,7 @@
scroll window left/right
-
/
+
/
scroll down/up by one page
@@ -151,20 +150,24 @@
History and tabs
- History navigation (e.g., Back, Forward) are done similarly to
+ History navigation (e.g., Back, Forward) is done similarly to
scrolling.
+
H/L
+
+ move back/forward in the current tab's history
+
/
- move Back/Forward in the current window/tab's history, respectively
+ move back/forward in the current tab's jump list
- Move between tabs using these keystrokes which may also be familiar to tabbing
- Vimmers.
+ Move between tabs using these keystrokes which may also be familiar to
+ tabbing Vimmers:
@@ -187,7 +190,7 @@
- To open a web page in a new tab, use the :tabopen url. To open a URL in
+ To open a web page in a new tab, use :tabopen url. To open a URL in
the current tab, use :open. The Normal mode mappings t and o,
respectively, map to these commands, so the following pairs of sequences are
equivalent:
@@ -210,9 +213,10 @@
- The answer is hints. Activating hints displays a number next to every link
- &dactyl.appName; can find. To follow the link, simply type the number corresponding
- to the hint.
+ The answer is hints. Activating hints displays a number next to
+ every link (or other element, depending on the mode) &dactyl.appName; can
+ find. To act on the element (e.g., follow or save a link), simply type
+ the number corresponding to the hint.
@@ -225,7 +229,7 @@
Whichever way you choose to indicate your target link, once &dactyl.appName; has
- highlighted the link you want, simply hit to open it.
+ highlighted the link you want, simply hit to open it.
@@ -234,39 +238,27 @@
upper-case F will open it in a new tab.
+
+ Extended hint modes, started by ; or g;, provide a richer way
+ to interact with various elements, not limited to following links.
+
+
To test it, try this link: &dactyl.appName; Homepage.
Activate Hints mode with f or F to highlight all currently
visible links. Then start typing the text of the link. The link should be
uniquely identified soon, and &dactyl.appName; will open it. Once you're
- done, remember to use (History Back) or d
+ done, remember to use H (History Back) or d
(Delete Buffer) to return here, depending on which key you used to
activate Hints mode.
-
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:
-
-
-
-
-
Saving for posterityâpentadactylrc
+
Saving for posterityâpentadactylrc
Once you get &dactyl.appName; set up with your desired options, maps, and commands,
you'll probably want them to be available the next time you open &dactyl.appName;.
- Continuing the Vim theme, this is done with a pentadactylrc file.
+ Continuing the Vim theme, this is done with a pentadactylrc file.
@@ -289,11 +281,11 @@
:xall
- command to quit and save the current browsing session for next time; the default.
+ quit and save the current browsing session for next time; the default
-
:qall
+
:exit
- command to quit without saving the session
+ quit without saving the session
ZZ
@@ -301,17 +293,17 @@
ZQ
- Normal mode mapping equivalent to :qall
+ Normal mode mapping equivalent to :exit
Where did &dactyl.host; go?
- You might feel pretty disoriented now. Don't worry. This is still &dactyl.host;
- underneath. Here are some ways &dactyl.appName; allows &dactyl.host; to shine through. See
- the :help for these commands and mappings for more information on how to
- make the best use of them.
+ You might feel pretty disoriented now. Don't worry. This is still
+ &dactyl.host; underneath. Here are some ways &dactyl.appName; allows
+ &dactyl.host; to shine through (see the :help for these commands
+ and mappings for more information on how to make the best use of them):
@@ -338,11 +330,9 @@
- Feel free to explore at this point. If you use the :tabopen command,
- remember to use the gt/gT mappings to get back to this page. If
- using the :open command, use the history keys (e.g., H) to return.
- If you get hopelessly lost, just type :help and click the
- Tutorial link to return.
+ Feel free to explore at this point. If you get hopelessly lost, just type
+ :help and click the Quick-start tutorial
+ link to return here.
@@ -350,30 +340,35 @@
Get me out of here!
- If you've given it a fair shot and determined ⦠TODO
+ If you've given it a fair shot and determined that &dactyl.appName; is not
+ for you after all, you might want to disable it.
- The &dactyl.appName; way to do this is with the command :addons. Issuing this
- command brings up the &dactyl.host; Add-ons dialog window; you can then remove it as
- normal, selecting &dactyl.appName; from the list and clicking (yes, clicking)
- Uninstall.
+ The &dactyl.appName; way to do this is with the command :addons,
+ which displays a list of all installed extensions. You can use hints or
+ mouse to click on Off or Del to disable or remove
+ &dactyl.appName;, respectively.
Alternatively, you can do this the old-fashioned way: re-enable the menubar,
- as above, with m, and select Add-ons from the Tools menu.
+ as above, with m, and select Add-ons
+ from the Tools menu. You can also use :dialog addons to
+ get to the interface.
I'm interested⦠but lost!
- &dactyl.appName; has an energetic and growing user base. If you've run into a problem
- that you can't seem to solve with &dactyl.appName;, or if you think you might have
- found a bug, please let us know! There is support available on the
- wiki
+ &dactyl.appName; has an energetic and growing user base. If you've run into
+ a problem that you can't seem to solve with &dactyl.appName;, or if you
+ think you might have found a bug, please let us know! There is support
+ available on the mailing list
+ (mirrored on Gmane)
or in the #pentadactyl IRC
- channel on OFTC.
+ channel on OFTC. See also
+ contact.
@@ -381,7 +376,7 @@
hear from you as well. Developers work on &dactyl.appName; 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
- developer page for more information.
+ developer page for more information.