Move copyright license to help book.
[enjoyable.git] / Enjoyable Help / pgs / mappings.html
index c6d8af4..6a49461 100644 (file)
@@ -1,49 +1,92 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+          "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-       <title>Discover Sample App</title>
-       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
-       <link href="../sty/ref.css" rel="stylesheet" type="text/css"/>
-       <link href="../sty/task_bulleted.css" rel="stylesheet" type="text/css"/>
-</head>
+  <head>
+    <title>Application Mappings</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+    <meta name="robots" content="anchors" />
+    <link href="../sty/default.css"
+          rel="stylesheet"
+          type="text/css"
+          media="all"/>
+  </head>
+  
+  <body>
+    <a name="mappings"></a>
+    
+    <div id="navbox">
+      <div id="navleftbox">
+        <a class="navlink_left"
+           href="help:anchor='home' bookID='Enjoyable Help'">
+          Home
+        </a>
+      </div>
+    </div>
+    
+    <div id="headerbox">
+      <div id="iconbox">
+        <img id="iconimg"
+             src="../gfx/Icon.png"
+             alt="Icon"
+             height="32" width="32"/>
+      </div>
+      <h1>Application Mappings</h1>
+    </div>
 
-<body id="apple-pd">
-               
-<div id="navbox">
-<a name="mappings"></a>
+    <p>
+      You can make many different mappings and switch between them
+      easily.  To open the list of mappings click the button at the
+      top-left or press ⌘L.
+    </p>
 
-<div id="navleftbox">
-<a class="navlink_left" href="help:anchor='access' bookID='Enjoyable Help'">Home</a>
-</div>
-</div>
+    <p>
+      Click on a mapping to switch to it. Create a new mapping with
+      the + button or by typing ⌘N. Delete the current mapping with
+      the - button or ⌘⌫. Rename a mapping by double-clicking on it or
+      pressing Return while it's selected.
+    </p>
 
-<div id="headerbox">
-<div id="iconbox">
-<img id="iconimg"
-     src="../gfx/AppIcon32.png"
-     alt="$APPNAME$$ Icon"
-     height="32" width="32"/>
-</div>
-<div id="pagetitle">
-  <h1>Manage Application Mappings</h1>
-</div>
-</div>
+    <p>
+      You can also switch mappings with the <b>Mappings</b> menu, with
+      Enjoyable's dock menu, or by pressing ⌘1 through ⌘9.
+    </p>
 
-<h3><a name="dynamic"></a>Changing Dynamically</h3>
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas auctor leo in lorem dapibus eu tincidunt lacus viverra. Integer auctor tortor vel mauris pellentesque ultricies. Nulla lobortis, leo in facilisis cursus, elit felis viverra orci, ac luctus tellus sapien vel lectus. Aliquam ac accumsan risus. Nullam posuere, lectus commodo vestibulum luctus, mauris quam porta velit, ut pretium purus quam eu lacus. Nam in dui a sapien viverra euismod. Proin vel mauris nisi, sed tincidunt mi. Phasellus id ligula vitae mauris dapibus suscipit. Sed id erat nunc, in ultricies arcu.
+    <p>
+      Switching mappings can also be mapped to an input. Select the
+      input you wish to use and then choose a mapping from
+      the <b>Switch to mapping</b> option. For example, you could have
+      one mapping for a game's menu and another for its main screen
+      and switch between them in-game without returning to Enjoyable.
+    </p>
 
-Nulla semper, magna non aliquam fringilla, turpis est convallis tortor, ut blandit elit orci nec elit. Phasellus id urna justo, a tristique mauris. Morbi sed nulla et lacus facilisis posuere et a purus. Morbi a dui quam. Nunc luctus ipsum ut purus sollicitudin cursus. Nulla facilisi. In vestibulum orci eu nunc euismod ut iaculis lacus commodo. Sed leo dolor, sagittis eu vulputate eget, accumsan eu leo.
+    <h3><a name="automatic"></a>Automatic Switching</h3>
+    <p>
+      If you name a mapping after an application it will be
+      automatically chosen when you switch to that application. The
+      name of an application is usually shown on the dock when you
+      hover your mouse over it. If you don't know the name of the
+      application you want to create a mapping for, create a mapping
+      with the name <kbd>@Application</kbd> (note the <kbd>@</kbd> at
+      the start). The mapping will automatically be renamed for the
+      next application you switch to while it's enabled.
+    </p>
 
-Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas auctor leo in lorem dapibus eu tincidunt lacus viverra. Integer auctor tortor vel mauris pellentesque ultricies. Nulla lobortis, leo in facilisis cursus, elit felis viverra orci, ac luctus tellus sapien vel lectus. Aliquam ac accumsan risus. Nullam posuere, lectus commodo vestibulum luctus, mauris quam porta velit, ut pretium purus quam eu lacus. Nam in dui a sapien viverra euismod. Proin vel mauris nisi, sed tincidunt mi. Phasellus id ligula vitae mauris dapibus suscipit. Sed id erat nunc, in ultricies arcu.
-
-Nulla semper, magna non aliquam fringilla, turpis est convallis tortor, ut blandit elit orci nec elit. Phasellus id urna justo, a tristique mauris. Morbi sed nulla et lacus facilisis posuere et a purus. Morbi a dui quam. Nunc luctus ipsum ut purus sollicitudin cursus. Nulla facilisi. In vestibulum orci eu nunc euismod ut iaculis lacus commodo. Sed leo dolor, sagittis eu vulputate eget, accumsan eu leo.
-
-
-
-<h3><a name="automatic"></a>Automatic Switching</h3>
-
-<h3><a name="sharing"></a>Sharing Mappings</h3>
-
-</body>
+    <h3><a name="sharing"></a>Import and Export</h3>
+    <p>
+      Mappings can be exported and shared with other people. To export
+      your current mapping choose <b>Mappings > Export…</b> or press ⌘S and
+      save the file. This file can be shared with anyone; it doesn't
+      contain any personal information other than the product IDs of
+      the input devices you used and what you mapped them to.
+    </p>
+    <p>
+      To import a mapping choose <b>Mappings > Import…</b> or press
+      ⌘O and select the file you want to import. Mapping files end
+      with <kbd>.enjoyable</kbd> (the default), <kbd>.json</kbd>,
+      or <kbd>.txt</kbd>. If the imported mapping conflicts with one
+      you already made, you can choose to merge the two mappings or
+      create a new one with the same name.
+    </p>
+    </body>
 </html>