← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/sound-juicer/gutsy

« back to all changes in this revision

Viewing changes to help/sound-juicer/oc/sound-juicer.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-09-17 13:31:17 UTC
  • mfrom: (1.1.21 upstream)
  • Revision ID: james.westby@ubuntu.com-20070917133117-zrglz4qwnetd8tw9
Tags: 2.20.0-1ubuntu1
* Sync with Debian
* New upstream version:
  - Remove a work around now that GStreamer is fixed, and update requirement
* debian/control.in:
  - Build-Depends on liblaunchpad-integration-dev
  - Depends on libgnomevfs2-extra
  - updated Maintainer information
* debian/patches/01_lpi.patch,
  debian/patches/02_autoconf.patch:
  - lpi changes and configure update
* debian/rules:
  - build documentation template

Show diffs side-by-side

added added

removed removed

Lines of Context:
help/sound-juicer/oc/sound-juicer.xml
 
1
<?xml version="1.0" encoding="utf-8"?>
 
2
<!-- -*- indent-tabs-mode: nil -*- -->
 
3
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
 
4
<!ENTITY app "Sound Juicer">
 
5
<!ENTITY application "<application>&app;</application>">
 
6
<!ENTITY appversion "2.10">
 
7
<!ENTITY manrevision "2.10">
 
8
<!ENTITY musicbrainz "<ulink url='http://www.musicbrainz.org/'>MusicBrainz</ulink>">
 
9
]>
 
10
<?gnome-doc-status Version: 2.12
 
11
Status: Draft
 
12
?>
 
13
<article id="index" lang="oc">
 
14
  <articleinfo>
 
15
    <title><application>Sound Juicer</application> Manual</title>
 
16
    
 
17
    <copyright>
 
18
      <year>2003</year>
 
19
      <holder>Mike Hearn (mike@theoretic.com)</holder>
 
20
    </copyright>
 
21
    <copyright>
 
22
      <year>2005</year>
 
23
      <holder>Shaun McCance</holder>
 
24
    </copyright><copyright><year>2007 - ubuntu-l10n-oci@lists.ubuntu.com</year><holder>La còla occitana de revirada d'Ubuntu</holder></copyright>
 
25
    
 
26
    <publisher>
 
27
      <publishername>GNOME Documentation Project</publishername>
 
28
    </publisher>
 
29
 
 
30
    <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="legal.xml"/>
 
31
 
 
32
    <authorgroup>
 
33
      <author>
 
34
        <firstname>Mike</firstname>
 
35
        <surname>Hearn</surname>
 
36
        <email>mike@theoretic.com</email>
 
37
      </author>
 
38
      <author role="maintainer">
 
39
        <firstname>Shaun</firstname>
 
40
        <surname>McCance</surname>
 
41
        <affiliation>
 
42
          <orgname>GNOME Documentation Project</orgname>
 
43
        </affiliation>
 
44
        <email>shaunm@gnome.org</email>
 
45
      </author>
 
46
    </authorgroup>
 
47
 
 
48
    <revhistory>
 
49
      <revision>
 
50
        <revnumber>2.10</revnumber>
 
51
        <date>2005-03-06</date>
 
52
        <revdescription>
 
53
          <para role="author">Shaun McCance</para>
 
54
          <para role="publisher">GNOME Documentation Project</para>
 
55
        </revdescription>
 
56
      </revision>
 
57
      <revision>
 
58
        <revnumber>2.0</revnumber>
 
59
        <date>2003-07-06</date>
 
60
        <revdescription>
 
61
          <para role="author">Mike Hearn <email>mike@theoretic.com</email></para>
 
62
          <para role="publisher">GNOME Documentation Project</para>
 
63
        </revdescription>
 
64
      </revision>
 
65
    </revhistory>
 
66
    <!-- Translators may also add here feedback address for translations -->
 
67
 
 
68
    <abstract role="description">
 
69
      <para>This manual describes the use of Sound Juicer.</para>
 
70
    </abstract>
 
71
  </articleinfo>
 
72
 
 
73
  <section id="intro">
 
74
    <title>Introduccion</title>
 
75
    <anchor id="aboutex"/>
 
76
    <anchor id="notice"/>
 
77
    <indexterm>
 
78
      <primary>Sound Juicer</primary>
 
79
      <secondary>Manual</secondary>
 
80
      <tertiary>sound-juicer</tertiary>
 
81
    </indexterm>
 
82
 
 
83
    <para><application>Sound Juicer</application> is a simple and clean CD ripping tool. It allows you
 
84
    to extract the audio from audio compact discs and convert them into audio
 
85
    files that your computer can understand and play.  <application>Sound Juicer</application> can also
 
86
    play the audio tracks directly from the CD, allowing you to preview the
 
87
    CD before ripping it.</para>
 
88
 
 
89
    <para><application>Sound Juicer</application> is designed to be easy to use, and to work with little
 
90
    user intervention.  When you start <application>Sound Juicer</application>, it will examine the CD in
 
91
    the drive and try to locate information about the audio tracks using the
 
92
    freely-available <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink> service.</para>
 
93
 
 
94
    <informalfigure>
 
95
      <screenshot>
 
96
        <mediaobject>
 
97
          <imageobject>
 
98
            <imagedata fileref="figures/startup.png" format="PNG"/>
 
99
          </imageobject>
 
100
          <textobject>
 
101
            <phrase><application>Sound Juicer</application> on startup</phrase>
 
102
          </textobject>
 
103
        </mediaobject>
 
104
      </screenshot>
 
105
    </informalfigure>
 
106
  </section>
 
107
 
 
108
  <section id="track-data">
 
109
    <title>Entering Track Data</title>
 
110
 
 
111
    <para>When you insert an audio CD, <application>Sound Juicer</application> will automatically retrieve
 
112
    the track data from <ulink url="http://www.musicbrainz.org/">MusicBrainz</ulink>.  MusicBrainz is a free service that provides
 
113
    a database of data for most published CDs.  <application>Sound Juicer</application> uses the CD's serial
 
114
    number and the positions and lengths of the tracks to match against CD in the
 
115
    MusicBrainz database.</para>
 
116
 
 
117
    <para>Occasionally, more than one CD will have the same layout.  If more than
 
118
    one CD is found, <application>Sound Juicer</application> will present a dialog allowing you to choose
 
119
    which CD data to use.  If the wrong CD is detected, or if MusicBrainz does
 
120
    not contain any matching CDs, you will have to enter the track information
 
121
    manually.</para>
 
122
 
 
123
    <para>The top of the window contains text boxes for the title, artist, and
 
124
    genre of the CD.  Below that is a list of the audio track on the CD.  You
 
125
    can set the track title and artist for each track.  <application>Sound Juicer</application> uses this
 
126
    information to name the files and folders where your music is stored.  The
 
127
    track and album information is also encoded directly into the audio files.
 
128
    Many music players, including portable devices, use this information to
 
129
    organize and display the audio files.</para>
 
130
 
 
131
    <para>To edit the title of a track, first select the track, then click
 
132
    on the title.  When you have finished entering the title, press the
 
133
    <keycap>Enter</keycap> key on your keyboard, or click outside the
 
134
    title.</para>
 
135
 
 
136
    <para>When you edit the artist for the CD, the artist for each track is
 
137
    automatically updated.  Most CDs are by a single artist, and this feature
 
138
    saves you the time of entering the artist for each track.</para>
 
139
 
 
140
    <para>Some CDs, however, are compilations of songs by different artists.
 
141
    For these CDs, you will have to enter the artist for each track.  To set
 
142
    the artist for a track, first select the track, then click on the artist.
 
143
    You can set the artist for the CD to a value like "Various" or simply
 
144
    leave it blank, depending on how you prefer to organize your music.</para>
 
145
 
 
146
    <para>MusicBrainz unfortunately does not provide genre data, but
 
147
    <application>Sound Juicer</application> includes several stock genres:
 
148
    </para>
 
149
 
 
150
    <anchor id="genres"/>
 
151
    <itemizedlist>
 
152
      <listitem><para>Embient</para></listitem>
 
153
      <listitem><para>Blues</para></listitem>
 
154
      <listitem><para>Classic</para></listitem>
 
155
      <listitem><para>País</para></listitem>
 
156
      <listitem><para>Dance</para></listitem>
 
157
      <listitem><para>Electronica</para></listitem>
 
158
      <listitem><para>Folk       </para></listitem>
 
159
      <listitem><para>Funk</para></listitem>
 
160
      <listitem><para>Jazz</para></listitem>
 
161
      <listitem><para>Latin</para></listitem>
 
162
      <listitem><para>Pop        </para></listitem>
 
163
      <listitem><para>Rap</para></listitem>
 
164
      <listitem><para>Reggae</para></listitem>
 
165
      <listitem><para>Rock</para></listitem>
 
166
      <listitem><para>Soul</para></listitem>
 
167
      <listitem><para>Spoken Word</para></listitem>
 
168
    </itemizedlist>
 
169
 
 
170
  </section>
 
171
 
 
172
  <section id="extracting">
 
173
    <title>Extracting</title>
 
174
    <anchor id="using"/>
 
175
 
 
176
    <para>By default, <application>Sound Juicer</application> will extract all of the tracks on the CD
 
177
    to audio files.  If you do not wish to extract all of the tracks, you can
 
178
    control which tracks are extracted using the check boxes in the first column
 
179
    of the track listing.  Only the tracks you have selected will be extracted.
 
180
    </para>
 
181
 
 
182
    <para>You can also use the <menuchoice><guimenu>Edit</guimenu>
 
183
    <guimenuitem>Select All</guimenuitem></menuchoice> and <menuchoice>
 
184
    <guimenu>Edit</guimenu><guimenuitem>Deselect All</guimenuitem>
 
185
    </menuchoice> menu items to select all or none of the tracks to
 
186
    be extracted.</para>
 
187
 
 
188
    <para>When you have entered all the information you need, click on the
 
189
    <guibutton>Extract</guibutton> button, or press <keycombo><keycap>Ctrl</keycap>
 
190
    <keycap>Enter</keycap></keycombo>.  <application>Sound Juicer</application> will begin reading the audio
 
191
    from the CD and saving it to files on your computer.  By default, the audio
 
192
    files are stored under the <filename>Music</filename> folder in your home
 
193
    folder.</para>
 
194
 
 
195
    <para>When you begin extracting, the <guibutton>Extract</guibutton> button
 
196
    will change to a <guibutton>Stop</guibutton> button.  You can click this
 
197
    button at any time to stop extracting.</para>
 
198
 
 
199
    <para><application>Sound Juicer</application> indicates which track it is currently extracting by
 
200
    displaying an icon next to the track number.  You can also see the total
 
201
    prograss and estimated time left in the status bar at the bottom of the
 
202
    window.</para>
 
203
 
 
204
    <para>Extracting a CD can take a long time, depending on the speed of your
 
205
    computer.  You can safely minimize <application>Sound Juicer</application> or move to another workspace
 
206
    to continue using your computer while the audio is being extracted.</para>
 
207
  </section>
 
208
 
 
209
  <section id="playing">
 
210
    <title>Playing</title>
 
211
 
 
212
    <para><application>Sound Juicer</application> allows you to play the tracks on your CD directly.
 
213
    To begin playing the CD, simply click the <guibutton>Play</guibutton>
 
214
    button, or press <keycombo><keycap>Ctrl</keycap><keycap>P</keycap>
 
215
    </keycombo>.  To play a particular track, select that track and click
 
216
    <guibutton>Play</guibutton>, or simple double-click the track.</para>
 
217
 
 
218
    <para>When <application>Sound Juicer</application> is playing a CD, the <guibutton>Play</guibutton>
 
219
    button changes to a <guibutton>Pause</guibutton> button.  You can click
 
220
    this at any time to pause the playing, and click <guibutton>Play</guibutton>
 
221
    again to continue playing where you left off.</para>
 
222
 
 
223
    <para>While playing, <application>Sound Juicer</application> displays a progress bar showing the
 
224
    position on the entire CD that is being played.  To skip to another part
 
225
    of the CD, drag the handle along the progress bar.</para>
 
226
  </section>
 
227
 
 
228
  <section id="preferences">
 
229
    <title>Preferéncias</title>
 
230
 
 
231
    <para>The preferences window allows you to control:</para>
 
232
 
 
233
    <itemizedlist>
 
234
      <listitem><para>Which CD drive <application>Sound Juicer</application> uses, if you have more than
 
235
      one drive,</para></listitem>
 
236
      <listitem><para>Where the extracted audio files are placed on your
 
237
      computer, and</para></listitem>
 
238
      <listitem><para>Which file format and codec is used for the extracted
 
239
      audio files.</para></listitem>
 
240
    </itemizedlist>
 
241
 
 
242
    <informalfigure>
 
243
      <screenshot>
 
244
        <mediaobject>
 
245
          <imageobject>
 
246
            <imagedata fileref="figures/prefs.png" format="PNG"/>
 
247
          </imageobject>
 
248
          <textobject>
 
249
            <phrase>Preferences window</phrase>
 
250
          </textobject>
 
251
        </mediaobject>
 
252
      </screenshot>
 
253
    </informalfigure>
 
254
 
 
255
    <section id="prefs-drive">
 
256
      <title>Selecting a CD Drive</title>
 
257
 
 
258
      <para>If you have multiple CD drives in your computer, the drop-down list
 
259
      labelled <guilabel>CD drive</guilabel> allows you to select which drive to
 
260
      use.  The check box <guibutton>Eject when finished</guibutton> allows you
 
261
      to control whether <application>Sound Juicer</application> will eject the CD from the drive when it
 
262
      has finished extracting the audio files.</para>
 
263
    </section>
 
264
 
 
265
    <section id="prefs-naming">
 
266
      <title>Naming Audio Files</title>
 
267
 
 
268
      <para>The <guilabel>Music Folder</guilabel> drop-down list allows you to
 
269
      select which folder to store your audio files in.  Select one of the
 
270
      folders from the list, or choose <guilabel>Other</guilabel> to select
 
271
      another folder with the file chooser.  By default, files are placed
 
272
      under the <filename>Music</filename> folder in your home folder.</para>
 
273
 
 
274
      <para>The <guilabel>Track Names</guilabel> section allows you to control
 
275
      how the files and folders are named.  <application>Sound Juicer</application> can store audio files
 
276
      in seperate folders, helping you keep your music organized.  You can
 
277
      choose how these folders are created and named using the <guilabel>Folder
 
278
      hierarchy</guilabel> drop-down list.  By default,  <application>Sound Juicer</application> creates
 
279
      a folder for the album artist and a subfolder for the album.</para>
 
280
 
 
281
      <para>Use the <guilabel>File name</guilabel> drop-down list to select
 
282
      how the audio files are named.  By default, <application>Sound Juicer</application> uses the track
 
283
      number followed by a hyphen and the track title.</para>
 
284
 
 
285
      <para>Select the <guibutton>Strip special characters</guibutton> check
 
286
      box to make <application>Sound Juicer</application> remove or replace characters such as spaces and
 
287
      punctuation in the filenames.  This is useful if you plan to put the audio
 
288
      files onto a portable device or another computer which has more limitations
 
289
      on file names.</para>
 
290
 
 
291
      <note><para>Even when <guibutton>Strip special characters</guibutton>
 
292
      is not selected, <application>Sound Juicer</application> will remove the <literal>/</literal>
 
293
      character from filenames.  This character cannot be used in any
 
294
      filenames on UNIX, Linux, and similar systems.</para></note>
 
295
    </section>
 
296
 
 
297
    <section id="prefs-format">
 
298
      <title>Selecting a Format</title>
 
299
 
 
300
      <para>You can select which audio file format <application>Sound Juicer</application> uses to store
 
301
      your tracks on your computer.  There are a number of available formats,
 
302
      each with its own advantages.  The available formats on your computer
 
303
      may vary, but the following choices are usually available:</para>
 
304
 
 
305
      <variablelist>
 
306
        <varlistentry>
 
307
          <term>CD Quality, Lossy (Ogg Vorbis audio)</term>
 
308
          <listitem>
 
309
            <para>This option is selected by default.
 
310
            <ulink url="http://www.vorbis.org/">Ogg Vorbis</ulink>, like other
 
311
            lossy audio formats (such as MP3 and AAC) discards some information
 
312
            from the original audio data.  Although the audio file is not a
 
313
            perfect replica of the CD audio, the differences are often not
 
314
            distinguishable to most listeners.  As a result, lossy formats
 
315
            tend to have very small file sizes.</para>
 
316
 
 
317
            <para>The Ogg Vorbis format is the default lossy format used in
 
318
            <application>Sound Juicer</application>.  Ogg Vorbis is an open format, developed by the
 
319
            <ulink url="http://xiph.org/">Xiph.Org Foundation</ulink>, which
 
320
            tends to produce smaller file sizes and higher quality audio than
 
321
            many other lossy formats.  While it is not as widespread as the
 
322
            older MP3 format, most music software can play Ogg Vorbis files,
 
323
            and many hardware players have incorporated support.</para>
 
324
 
 
325
            <para>Xiph.Org maintains lists of <ulink url="http://wiki.xiph.org/index.php/VorbisSoftwarePlayers">software
 
326
            players</ulink>, <ulink url="http://wiki.xiph.org/index.php/PortablePlayers">portable
 
327
            hardware players</ulink>, and <ulink url="http://wiki.xiph.org/index.php/StaticPlayers">static hardware
 
328
            players</ulink> which support Ogg Vorbis.</para>
 
329
          </listitem>
 
330
        </varlistentry>
 
331
 
 
332
        <varlistentry>
 
333
          <term>CD Quality, Lossless (FLAC audio)</term>
 
334
          <listitem>
 
335
            <para>The <ulink url="http://flac.sourceforge.net/">FLAC</ulink>
 
336
            audio format is a lossless format.  No audio data is lost when
 
337
            converting to FLAC, even though it compresses audio files by as
 
338
            much as 70%.  FLAC and other lossless formats are popular in
 
339
            cases where high fidelity audio is needed, but files need to be
 
340
            compressed to save disk space and network transfer times.</para>
 
341
          </listitem>
 
342
        </varlistentry>
 
343
 
 
344
        <varlistentry>
 
345
          <term>Voice (WAV audio)</term>
 
346
          <listitem>
 
347
            <para>The Voice output profile produces low-quality mono audio
 
348
            files.  You may wish to select this for lectures, books on tape,
 
349
            and other spoken word CDs, where the loss in audio quality is
 
350
            less important.</para>
 
351
          </listitem>
 
352
        </varlistentry>
 
353
      </variablelist>
 
354
 
 
355
      <para>You can click the <guibutton>Edit Profiles</guibutton> button to
 
356
      edit the available audio formats.  The profile editor dialog provides
 
357
      direct access to the audio conversion.  Profiles are defined with
 
358
      <application>GStreamer</application> pipelines.
 
359
      <application>GStreamer</application> is the underlying multimedia
 
360
      library used by <application>Sound Juicer</application> and other multimedia applications.
 
361
      A full explanation of audio profiles is outside the scope of this
 
362
      document.</para>
 
363
 
 
364
      <tip>
 
365
        <para>If you need to store tracks in the MP3 format (for example,
 
366
        if your portable music player only supports MP3 and not Ogg Vorbis),
 
367
        you will need to create a new profile.  To do this, click on
 
368
        <guibutton>Edit Profiles</guibutton>, click <guibutton>New</guibutton>,
 
369
        and name the profile <userinput>MP3</userinput>.</para>
 
370
 
 
371
        <para>Select the MP3 profile and click the <guibutton>Edit</guibutton>
 
372
        button.  Set <guilabel>GStreamer Pipeline</guilabel> to
 
373
        <literallayout><userinput>audio/x-raw-int,rate=44100,channels=2 ! lame name=enc vbr=0 bitrate=192 ! id3v2mux</userinput></literallayout></para>
 
374
 
 
375
        <para>Set the <guilabel>File Extension</guilabel> to
 
376
        <userinput>mp3</userinput>, and select the <guibutton>Active</guibutton>
 
377
        check box.  You will have to restart <application>Sound Juicer</application> to see the new
 
378
        audio profile.</para>
 
379
 
 
380
        <para>This profile uses the <application>LAME</application> MP3 encoder,
 
381
        so you will need to have the GStreamer LAME plugin installed.</para>
 
382
      </tip>
 
383
    </section>
 
384
  </section>
 
385
 
 
386
  <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="fdl-appendix.xml"/>
 
387
  
 
388
</article>