Removed link to MIDI on Linux page in Mackie Control setup page.

[ardour-manual] / include / using-the-ableton-push-2.html

diff --git a/include/using-the-ableton-push-2.html b/include/using-the-ableton-push-2.html
index d3b9fd303c59a13e4dce2536e4edb0f1a4e687b9..daed433037d535ca69bfc265419de7000056b4b2 100644 (file)
--- a/include/using-the-ableton-push-2.html
+++ b/include/using-the-ableton-push-2.html
@@ -1,11 +1,15 @@
 
-<p>
-  <img alt="the Ableton Push 2 surface" src="/images/push2-main.jpg">
-</p>
+<figure>
+  <img src="/images/push2-main.jpg" alt="The Ableton Push 2 surface">
+  <figcaption>
+    The Ableton Push 2 surface
+  </figcaption>
+</figure>
+
 <p>
   Since version 5.4, Ardour has had extensive support for the Ableton
   Push2. This is an expensive but beautifully engineered control
-  surface primarily targetting the workflow found in Ableton's Live
+  surface primarily targeting the workflow found in Ableton's Live
   software and other similar tools such as Bitwig. As of version 5.4,
   Ardour does not offer the same kind of workflow, so we have designed
   our support for the Push 2 around mixing and editing and musical
@@ -24,6 +28,27 @@
   system, and will appear in any of the lists of possible MIDI ports
   in both Ardour and other similar software.
 </p>
+<div class="note">
+  <p>
+    Linux does not provide normal users access to arbitrary USB
+    devices by default (this is a security measure). To give yourself
+    access to the Push2, you need to create a file in
+    the <code>/etc/udev/rules.d</code> folder (directory). The name of
+    the should be something like "50-Ableton-Push2.rules" (the only
+    critical parts are that it ends in ".rules" and is unique). The
+    file should contain the following single line:
+  </p>
+  <p>
+  <verb>
+    SUBSYSTEM=="usb", ATTR{idVendor}=="2982", ATTR{idProduct}=="1967", MODE="0666", GROUP="audio"
+  </verb>
+  </p>
+  <p>
+  Note that you will need to be member of the group named in the
+  "GROUP" property ("audio" in the example above). 
+  </p>
+</div>
+
 <p>
   To connect the Push 2 to Ardour, open the Preferences dialog, and
   then click on "Control Surfaces". Click on the "Enable" button
@@ -44,11 +69,15 @@
   aftertouch or polyphonic pressure messages. You can alter this
   setting via the Push 2 GUI, accessed by double-clicking on the "Push
   2" entry in the control surfaces list.
-<p>
-<img alt="the Push 2 configuration dialog"
-     src="/images/push2-gui.png">
 </p>
 
+<figure>
+  <img src="/images/push2-gui.png" alt="The Push 2 configuration dialog">
+  <figcaption>
+    The Push 2 configuration dialog
+  </figcaption>
+</figure>
+
 <h2>Basic Concepts</h2>
 <p>
   With the Push 2 support in Ardour 5.4, you can do the following
@@ -99,10 +128,14 @@
   them, the video display and the 8 buttons below that are combined to
   provide a global view of the session mix.
 </p>
-<p>
-  <img alt="global mix mode on Push2 screen"
-       src="/images/push2-globalmix.png">
-</p>
+
+<figure>
+  <img src="/images/push2-globalmix.png" alt="Global mix mode on Push2 screen">
+  <figcaption>
+    Global mix mode on Push2 screen
+  </figcaption>
+</figure>
+
 <p>
   The upper buttons are labelled by text in the video display just
   below them. Pressing one of the buttons changes the function of the
@@ -231,10 +264,14 @@
   Press the Scale button to enter Scale mode. The display will look
   like this:
 </p>
-<p>
-  <img alt="track mix mode on Push2 screen"
-       src="/images/push2-scale.png">
-</p>
+
+<figure>
+  <img src="/images/push2-scale.png" alt="Track mix mode on Push2 screen">
+  <figcaption>
+    Track mix mode on Push2 screen
+  </figcaption>
+</figure>
+
 <p>
   In the center, 37 scales are presented. Scroll through them by
   either using the cursor/arrow keys to the lower right of the
@@ -354,7 +391,7 @@
     <tr><th>Master (top right) knob</th>
     <td>
       This knob controls the gain/volume of Ardour's main output. If
-      the session has a monitor saec
+      the session has a monitor section.
     </td></tr>
   </table>
 </p>