Add a chapter on managing clips in the custom clips library

include/adding-3rd-party-clip-libraries.html

@@ -0,0 +1,48 @@
+<p>
+	You can add as many sample library locations as you like and easily
+	switch between them. To do that:
+</p>
+
+<ol>
+	<li>
+		In the <dfn>Clips</dfn> tab of the sidebar, click the top drop-down list and choose <kbd class="menu">Edit</kbd>.
+
+		<figure class="right">
+		  <img src="/images/clips-locations-in-the-dropdown-list.png" alt="Clips' locations in the 		drop-down list">
+		  <figcaption>
+		    Clips' locations in the drop-down list
+		  </figcaption>
+		</figure>
+	</li>
+	<li>
+		In the newly opened dialog called <dfn>Edit Sample Library Path</dfn> click <kbd class="button">Add</kbd> and locate the folder that contains samples. If there are subfolders, choose the parent folder that contains them all.
+	</li>
+	<li>
+		Repeat for all other sample libraries.
+	</li>
+	<li>
+		Click <kbd class="button">OK</kbd> to apply changes.
+	</li>
+</ol>
+
+<p>
+	Alternatively, you can drop a folder from a file manager into the list
+	of clips in the Clips browser. This will add a new clip library location
+	stored across sessions.
+</p>
+
+<p>
+	Now when you click the drop-down list at the top of <dfn>Clips</dfn>, you will see all the paths you added.
+</p>
+
+<figure class="right">
+  <img src="/images/clips-locations-in-the-dropdown-list.png" alt="Clips' locations in the drop-down list">
+  <figcaption>
+    Clips' locations in the drop-down list
+  </figcaption>
+</figure>
+
+
+<p>
+	Should you need to delete any path you previously added, open the <dfn>Edit Sample Library Path</dfn> dialog again, select the path and click <kbd class="button">Delete</kbd>.
+</p>

include/clips-in-the-editor.html

@@ -0,0 +1,42 @@
+<p>
+	There are two main uses for the Clips browser in the Editor window:
+</p>
+
+<ol>
+	<li>Reusing existing clips</li>
+	<li>Creating new clips from content in the timeline</li>
+</ol>
+
+<h2>Reusing existing clips</h2>
+
+<p>
+	You have two options how to reuse a clip in the Editor.
+</p>
+
+<ol>
+	<li>
+		Add to an existing track. Dragging and dropping a clip from the browser
+		on an existing track will add this clip to a location on the timeline
+		where you released the mouse button, snapping options apply. Audio clips
+		can only be placed on audio tracks, MIDI clips can only be placed on MIDI
+		tracks. Additionally, placing a single-channel (mono) clip
+		on a multi-channel track will create a clip where only one channel
+		is filled with the content of the original clip, the rest of the channels will be silent.
+	</li>
+	<li>
+		Create a new track. Dragging and dropping a clip below the bottom track
+		will create a new track from the clip and name it after the clip's file name.
+		Ardour will make a few judgements based on clip properties: the track will
+		contain as many channels as the audio file has. And for a MIDI clip, Ardour
+		will automatically add the "preview" virtual instrument of choice
+		to the processor box.
+	</li>
+</ol>
+
+<h2>Creating new clips</h2>
+
+<p>
+	You can create new clips for further reuse in the Editor window. Please see
+	the <a href="@@managing-custom-clips">Managing Custom Clips</a> page
+	for more detail.
+</p>

include/clips-overview.html

@@ -0,0 +1,97 @@
+<p>
+	The <dfn>Clips</dfn> browser provides a way to easily reuse little pieces
+	of music across sessions. You can also drop audio and MIDI clips on a
+	timeline in the <a href="@@clips-in-the-editor">Editor window</a> or use
+	them in trigger slots in the <a href="@@clips-in-the-cue-window">Cue window</a>.
+</p>
+
+<h2>Clips Browser Interface</h2>
+
+<p>
+	In the Editor window, the Clips browser is part of the Editor sidebar
+	and thus can be hidden from the main window. In the Cue window, the Clips
+	browser is an essential part of the workflow and is always visible.
+</p>
+
+<figure class="right">
+  <img src="/images/clips-browser.png" width="400px" alt="The Clips browser">
+  <figcaption>
+    The Clips browser
+  </figcaption>
+</figure>
+
+<p>
+	The Clips browser has three main parts:
+</p>
+
+<ol>
+	<li>Selector of clip library locations</li>
+	<li>List of clips, with a treeview where necessary</li>
+	<li>Preview options</li>
+</ol>
+
+<h2>Library Locations</h2>
+
+<p>
+	The <dfn>Clips</dfn> browser is capable of handling multiple locations
+	of clips and loops. There are several types of locations suported by the
+	browser:
+</p>
+
+<ol>
+	<li>
+		<dfn>Ardour Bundled Content</dfn>: these are all the audio and MIDI
+		files shipped along with an official Ardour build.
+	</li>
+	<li>
+		<dfn>Custom folder</dfn>: it's a single user-defined location
+		on a local or remote disk that you can write to. The folder is defined
+		on the <kbd class="menu">Triggering</kbd> page of the
+		<kbd class="menu">Preferences</kbd> dialog and is preserved across
+		sessions.
+	</li>
+	<li>
+		<dfn>Additional locations</dfn>: typically those are locations where
+		you store existing clips/loops libraries acquired elsewhere. You can
+		have as many as you like, please see <a href="@@adding-3rd-party-clip-libraries">Adding 3rd Party Clip Libraries</a> chapter for more info. These locations
+		are also preserved across sessions.
+	</li>
+	<li>
+		<dfn>Other locations</dfn>: this is a one-off access to a location
+		where clips and loops are stored. This location is not preserved across
+		sessions.
+	</li>
+</ol>
+
+<h2>List of Clips</h2>
+
+<p>
+	The Clips browser will provide access to all supported media file types
+	available in a selected location. Typically those would be, WAV, FLAC,
+	and MID files.
+</p>
+
+<p>
+	If there are subfolders in the clip library's folder, the Clips browser
+	will display them using as a tree view. The browser will also lazy-load
+	subfolders: instead of loading the entire list of all supported files
+	in the library location, it will only display top-level folders and load
+	their content when you start expanding subfolders you are interested in.
+</p>
+
+<h2>Preview Options</h2>
+
+<p>
+	The preview section has simple playback controls as well as an option
+	to automatically play back a clip when you click it in the list.
+	For MIDI clips, you can also select a virtual instrument (Ardour defaults
+	to ACE Reasonable Synth).
+</p>
+
+<p>
+	When playing a clip, Ardour will automatically pause the transport
+	and resume playback when the clip playback is done. Ardour will also
+	use the audition channel for playback, so you can control the preview
+	volume using the monitor level control in the
+	<a href="@@monitor-section">Monitor</a> section of the <dfn>Mixer</dfn>.
+</p>

include/managing-custom-clips.html

@@ -0,0 +1,63 @@
+<h2 id="managing-custom-clips">Managing the custom clips folder</h2>
+
+<p>
+	As of version 7.0, Ardour does not provide a way to reorganize clips in the
+	main custom folder. For the time being, it is suggested to use a file manager
+	to manage the folder.
+</p>
+
+<p>
+	As all the clips you already added to the project have been copied, you do
+	not need to close Ardour to reorganize clips in the custom clips folder. Feel
+	free to create new subfolders and move files around. All the changes will be
+	reflected in the clips browser after you switch to another folder and back.
+</p>
+
+<p>
+	You do not need a fast drive for custom clips folders. Playing back a
+	short clip will have little impact on the performance, and copying a file into
+	the project should be likewise fast even from a hard disk. You can even use
+	a network drive to store and access all your clips and loops.
+</p>
+
+<h2 id="adding-custom-clips">Adding custom clips</h2>
+
+<p>
+	There are three major ways to add new clips to your custom <dfn>Clips</dfn>
+	folder.
+</p>
+
+<ol>
+	<li>
+		In the Editor window, drag a region from the list of regions to the
+		Clips tab. The Clips tab should have the custom clips folder opened
+		at the time.
+	</li>
+	<li>
+		In the Editor window, use the right-click menu to bounce a region
+		or a range to the Clips library. You can bounce either processed
+		(with all effects) or unprocessed (sans all effects) version of the
+		audio data. The option  to bouce to the clips library will be available
+		in the bounce dialog. Additionally, if the track in question is visible
+		in the Cue window, you can automatically insert a bounced clip into the
+		slot of a particular scene for that track.
+	</li>
+	<li>
+		You can use the file manager to navigate to the location of the custom
+		clips library and place audio and/or MIDI files there.
+	</li>
+</ol>
+
+<p>Changes will take effect in Ardour once you switch to another folder and back.</p>
+
+<h2 id="removing-custom-clips">Removing custom clips</h2>
+
+<ol>
+	<li>Use a file manager to navigate to your main custom clips folder.</li>
+	<li>Locate the file you do not need any more, remove it to the trash bin.</li>
+</ol>
+
+<p>
+	Likewise, changes will take effect in Ardour once you switch to another
+	folder and back.
+</p>