[musicians-guide] added some files for Qtractor, and revised opening paragraphs for tutorial of same

Christopher Antila crantila at fedoraproject.org
Mon Jul 4 06:24:29 UTC 2011


commit 6cdd5c68649fda65a4d207acb382ffec20696a17
Author: Christopher Antila <crantila at fedoraproject.org>
Date:   Mon Jul 4 02:15:11 2011 -0400

    added some files for Qtractor, and revised opening paragraphs for tutorial of same

 en-US/Book_Info.xml                                |   40 ++++++------
 en-US/Qtractor.xml                                 |   71 ++++++++++++++------
 en-US/Revision_History.xml                         |   18 +++++-
 .../Qtractor/FMG-Qtractor-MIDI-Recording.flac      |  Bin 0 -> 44682092 bytes
 4 files changed, 88 insertions(+), 41 deletions(-)
---
diff --git a/en-US/Book_Info.xml b/en-US/Book_Info.xml
index 97e6881..a8147c6 100644
--- a/en-US/Book_Info.xml
+++ b/en-US/Book_Info.xml
@@ -4,28 +4,28 @@
 %BOOK_ENTITIES;
 ]>
 <bookinfo id="book-Musicians_Guide-Musicians_Guide">
-  <title>Musicians' Guide</title>
-  <subtitle>Audio creation and music software in Fedora Linux</subtitle>
-  <!-- Haydn: <subtitle>A guide to Fedora Linux's audio creation and music capabilities, written in a new and special way.</subtitle> -->
-  <productname>Fedora Draft Documentation</productname>
-  <pubsnumber>0</pubsnumber> <!-- N.B.: I have no idea why this is here, but the book doesn't work without it -CRA -->
-  <edition>15.9.3</edition>
+	<title>Musicians' Guide</title>
+	<subtitle>Audio creation and music software in Fedora Linux</subtitle>
+	<!-- Haydn: <subtitle>A guide to Fedora Linux's audio creation and music capabilities, written in a new and special way.</subtitle> -->
+	<productname>Fedora Draft Documentation</productname>
+	<pubsnumber>0</pubsnumber> <!-- N.B.: I have no idea why this is here, but the book doesn't work without it -CRA -->
+	<edition>15.9.3</edition>
   
-  <abstract>
-    <para>
-      This document explores some audio creation and music activities possible with Fedora Linux. Computer audio concepts are explained, and a selection of programs are demonstrated with tutorials that show their typical usage.
-    </para>
-  </abstract>
+	<abstract>
+		<para>
+			is document explores some audio creation and music activities possible with Fedora Linux. Computer audio concepts are explained, and a selection of programs are demonstrated with tutorials that show their typical usage.
+		</para>
+	</abstract>
   
-  <corpauthor>
-    <inlinemediaobject>
-      <imageobject>
-	<imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
-      </imageobject>
-    </inlinemediaobject>
-  </corpauthor>
+	<corpauthor>
+		<inlinemediaobject>
+			<imageobject>
+				<imagedata fileref="Common_Content/images/title_logo.svg" format="SVG" />
+			</imageobject>
+		</inlinemediaobject>
+	</corpauthor>
   
-  <xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
-  <xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Common_Content/Legal_Notice.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
+	<xi:include href="Author_Group.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
 </bookinfo>
 
diff --git a/en-US/Qtractor.xml b/en-US/Qtractor.xml
index 772d270..e82bb57 100644
--- a/en-US/Qtractor.xml
+++ b/en-US/Qtractor.xml
@@ -132,9 +132,9 @@
 	</section> <!-- Ends "Configuration" Section --> <!--    Qtractor-Configuration-    -->
 	
 	<section id="sect-Musicians_Guide-Qtractor-Using">
-		<title>Using Qtractor</title>
+		<title>Use Qtractor</title>
 		<para>
-			The "Tutorial" section teaches you how to use Qtractor by example.  This section is designed to serve as a reference while you complete the tutorial, and for refreshing your memory afterwards.
+			The "Tutorial" section teaches you how to use Qtractor by example. This section is designed to serve as a reference while you complete the tutorial, and for refreshing your memory afterwards.
 		</para>
 		
 		<section id="sect-Musicians_Guide-Qtractor-Using-Blue_Place_Markers">
@@ -229,7 +229,7 @@
 		</section>
 		
 		<section id="sect-Musicians_Guide-Qtractor-Using-Exporting_Audio_and_MIDI_Together">
-			<title>Exporting a Whole File (Audio and MIDI Together)</title>
+			<title>Export a Whole File (Audio and MIDI Together)</title>
 			<para>
 				Qtractor can export all of a session's audio clips as one audio file, but it cannot export the MIDI clips directly into that audio file.  This is because Qtractor does not synthesize audio from MIDI signals, but uses an external MIDI synthesizer to do this.  Thankfully, there is a relatively simple way to overcome this, allowing both audio and MIDI to be exported in the same audio file: use Qtractor to record the audio signal produced by the MIDI synthesizer.  This procedure only works if you use a MIDI synthesizer (like <application>FluidSynth</application>) which outputs its audio signal to JACK.
 				<orderedlist>
@@ -283,50 +283,81 @@
    \midi { }
 }
 ]]></programlisting>
-					You can import LilyPond's MIDI output by clicking 'Track > Import Tracks > MIDI' in Qtractor.
+You can import <application>LilyPond</application> MIDI output in <application>Qtractor</application>. Choose <menuchoice><guimenu>Track</guimenu><guisubmenu>Import Tracks</guisubmenu><guimenuitem>MIDI</guimenuitem></menuchoice>.
 				</para>
 			</section>
 		</section>
 	</section> <!-- Ends "Using Qtractor" Section --> <!--    Qtractor-Using-    -->
 	
 	<section id="sect-Musicians_Guide-Qtractor-Tutorial">
-		<title>Creating a MIDI Composition (Tutorial)</title>
+		<title>Create a MIDI Composition (Tutorial)</title>
 		<para>
-			We've created a demonstration of what a first-time user might try for their first project with Qtractor.  The following sequences demonstrate the decision-making, and the various features that could be learned.  This does not attempt to show a generic method for creation, but rather the specific way that I created a new composition with the inspiration stated below.
+			We created a demonstration of a project that a first-time user might try in <application>Qtractor</application>.  The tutorial sequence explain our decisions and various application features that we used. We do not attempt to give you a generic way to create music, but rather a specific way that we used our inspiration to help use create a new musical work.
 		</para>
 		
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Inspiration">
 			<title>Inspiration</title>
 			<para>
-				The goal of this demonstration is to illustrate a particular strength of Qtractor: combining audio and MIDI tracks.  I decided to start with a portion of one of my favourite compositions, and to compose a MIDI-based "alter-ego" to go along with it.  The piece is listed below in "Requirements."
+				This tutorial demonstrates a particular strength of <application>Qtractor</application>: combine audio and MIDI tracks in one project. We started this tutorial with a part of one of our favourite musical works. Then we created a MIDI-based "alter-ego" to accompany the favourite work.
 			</para>
 			<para>
-				Since that particular movement is a "theme and variations" movement, it starts with a theme, then continues with varied versions of that theme.  The theme is in two parts, each of which is repeated once.  Beethoven uses several compositional techniques that are typical of his time period, and achieves a consistently similar, but consistently new, movement.
+				The audio recording contains a "theme and variations" movement, so the recording begins with a theme, then continues with modified versions of the theme. The theme has two parts, both repeated once. The original composer used several standard compositional techniques of their time period, so the music sounds similarly throughout, but constantly changes in subtle ways.
 			</para>
 			<para>
-				We are no longer bound by the aesthetic rules of Beethoven's time.  We are also using a very different style of notation with Qtractor - the matrix editor does not even resemble standard Western musical notation.
+				We are not required to follow the aesthetic rules that Beethoven followed. Some people think we cannot possibly follows the aesthetic rules that Beethoven followed. If we create new music for solo piano, we are already aware of 150 years' worth of music that stretched Beethoven's aesthetic rules. In this tutorial, we use the matrix editor in <application>Qtractor</application>, which does not resemble conventional Western musical notation&mdash;we cannot hope to achieve a similar result. This tutorial explores the artistic possibilities of a combination of early 19th century chamber music and early 21st century electronic music.
 			</para>
 			<para>
-				Another interesting aspect of this piece is that, unless you have access to the same audio recording that I used, you will not be able to experience the piece as I do.  Playing the MIDI alone gives a completely different experience, and it is one that I knew would happen.  This sort of "mix-and-match" approach to music-listening is more common than you might think, but rarely is it done in such an active way; normally, the "extra sound" of listening to music is provided by traffic, machines like furnaces and microwave ovens, and even people in a concert hall or auditorium with you.  The fact that my audio files cannot be legally re-distributed forced me to add a conscious creative decision into every listening of the piece.
+				Finally, we encountered problems when we prepared this tutorial because we cannot distribute the audio recording that we used to create the MIDI component. Therefore, you will probably use a different audio recording than we used. Even when you follow our directions precisely, your result will be quite different from our result.
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Requirements">
 			<title>Files for the Tutorial</title>
 			<para>
 				<itemizedlist>
-				<listitem><para>A recording of the second movement from Beethoven's Piano Sonata No.23, "Appassionata," either:
-					<itemizedlist>
-					<listitem><para><citetitle>Mutopia</citetitle> at <ulink url="http://www.mutopiaproject.org/cgibin/make-table.cgi?searchingfor=appassionata" /> (MIDI synthesizer recording with LilyPond sheet music)</para></listitem>
-					<listitem><para><citetitle>MusOpen</citetitle> at <ulink url="http://www.musopen.com/music.php?type=piece&amp;id=309" /> (live recording)</para></listitem>
-					<listitem><para>The recording I used, played by Rudolf Serkin, available on the "Sony" label.</para></listitem>
-					</itemizedlist>
-					</para></listitem>
-				<listitem><para>You need to use FluidSynth, covered in <xref linkend="chap-Musicians_Guide-FluidSynth" />.</para></listitem>
+					<listitem>
+						<para>
+							A recording of the second movement from Beethoven's Piano Sonata No.23, "Appassionata," either:
+								<itemizedlist>
+									<listitem>
+										<para>
+											<citetitle>Mutopia</citetitle> at <ulink url="http://www.mutopiaproject.org/cgibin/make-table.cgi?searchingfor=appassionata" /> (MIDI synthesizer recording with LilyPond sheet music),
+										</para>
+									</listitem>
+									<listitem>
+										<para>
+											<citetitle>SoundCloud</citetitle> at <ulink url="http://soundcloud.com/waltereegho/beethoven-sonata-no-23-in-f-minor-op-57-appassionata-ii-andante-con-moto-09" /> (live recording), or
+										</para>
+									</listitem>
+									<listitem>
+										<para>
+											<!-- The recording I used, played by Rudolf Serkin, available on the "Sony" label. -->
+											A commercial recording.
+										</para>
+									</listitem>
+								</itemizedlist>
+						</para>
+					</listitem>
+					<listitem><para>You must use <application>FluidSynth</application>, covered in <xref linkend="chap-Musicians_Guide-FluidSynth" />.</para></listitem>
+					<listitem>
+						<para>
+							Download a recording of the MIDI portion of this tutorial from <ulink url="http://docs.fedoraproject.org/en-US/Fedora/&PRODVER;/html/Musicians_Guide/files/Qtractor/FMG-Qtractor-MIDI-Recording.flac" />.
+						</para>
+					</listitem>
+					<listitem>
+						<para>
+							Listen to a recording of the MIDI portion combined with the audio portion of this tutorial at <ulink url="http://soundcloud.com/fedoraproject/fmg-qtractor-export" />.
+						</para>
+					</listitem>
+					<listitem>
+						<para>
+							Listen to a similar project that uses a different section of this musical work, at <ulink url="http://soundcloud.com/bradbreeck/beethoven-piano-sonata-no-23" />.
+						</para>
+					</listitem>
 				</itemizedlist>
 			</para>
 		</section>
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Getting_Qtractor_Ready">
-			<title>Getting Qtractor Ready</title>
+			<title>Get Qtractor Ready</title>
 			<para>
 				<orderedlist>
 				<listitem><para>Open QjackCtl, and start JACK.</para></listitem>
@@ -543,7 +574,7 @@
 		<section id="sect-Musicians_Guide-Qtractor-Tutorial-Measures_139_to_158">
 			<title>Qtractor's Measures 139 to 158</title>
 			<para>
-				There are no new techniques used in this section.\
+				There are no new techniques used in this section.
 			</para>
 			<para>
 				We maintained two-beat spacing of primary notes, and began with only two/three registers.  The lowest register is just an occasional reinforcement of the uppermost, as in the audio file at this point.  We used copy-and-pasting to create the quickly-moving middle line.
diff --git a/en-US/Revision_History.xml b/en-US/Revision_History.xml
index 8224144..de587da 100644
--- a/en-US/Revision_History.xml
+++ b/en-US/Revision_History.xml
@@ -350,6 +350,22 @@
 				</revdescription>
 			</revision>
 			
+			<revision>
+				<revnumber>15.9.4</revnumber>
+				<date>???????????????????????????????</date>
+				<author>
+					<firstname>Christopher</firstname>
+					<surname>Antila</surname>
+					<email>crantila at fedoraproject.org</email>
+				</author>
+				<revdescription>
+					<simplelist>
+					  <member>Adjusted all Guide hyperlinks to use the "PRODVER" entity, so they will be automatically updated.</member>
+					  <member>Added links to Qtractor tutorial recordings and revised opening paragraphs of tutorial.</member>
+					</simplelist>
+				</revdescription>
+			</revision>
+			
 			<!-- NOTE: When adding a revision above, be sure to update the <edition> tag in "Book_Info.xml" -->
 			
 			<!--
@@ -376,10 +392,10 @@
 			<!-- Fedora 16 (LilyPond) -->
 			<!-- TODO: Bug 710333 ("Section 12.6 Needs to Be Rewritten") -->
 			<!-- TODO: Bug 710334 ("Section 12.7 Needs to Be Rewritten") -->
-			<!-- TODO: Bug 710336 ("Section 13 Integration with Section 12") -->
 			<!-- TODO: Bug 665664 ("LilyPond Example Scores Are Incomplete") -->
 			<!-- TODO: Introduction: is "ooolilypond" gone or replaced? -->
 			<!-- TODO: Revise the LilyPond introductory chapters -->
+			<!-- DONE: Bug 710336 ("Section 13 Integration with Section 12") -->
 			
 			<!-- Fedora 16 (Qthings) -->
 			<!-- QA: Bug 670540 ("Qsynth's MIDI driver... ") -->
diff --git a/en-US/files/Qtractor/FMG-Qtractor-MIDI-Recording.flac b/en-US/files/Qtractor/FMG-Qtractor-MIDI-Recording.flac
new file mode 100644
index 0000000..dd238c0
Binary files /dev/null and b/en-US/files/Qtractor/FMG-Qtractor-MIDI-Recording.flac differ


More information about the docs-commits mailing list