Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdebase@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 142 insertions, 0 deletions

diff --git a/doc/userguide/playing-audiocds.docbook b/doc/userguide/playing-audiocds.docbook
new file mode 100644
index 000000000..3f96a6056
--- /dev/null
+++ b/doc/userguide/playing-audiocds.docbook
@@ -0,0 +1,142 @@
+<sect1 id="audio-cd">
+<sect1info>
+<author>
+<personname>
+<firstname>Deepak</firstname>
+<surname>Sarda</surname>
+</personname>
+<email>[email protected]</email>
+</author>
+</sect1info>
+
+<title>Audio CD Ripping in &kde;</title>
+
+<para>The conventional way of ripping Audio CDs to MP3 or Ogg files is to
+use a standalone program such as <trademark class="registered"><application>iTunes</application></trademark>, Winamp or &kde;'s own
+<application>KAudioCreator</application>. But if we stick to conventions,
+where's the fun?! So in this article, I am going to show you how to feel
+elite by ripping your CDs in the, umm.. elite way. ;-) </para>
+
+<sect2 id="audio-cd-ingredients">
+<title>Ingredients</title>
+
+<para>What do we need to be cool? Vanilla &kde;, without any extra
+ingredients, will be able to rip your CDs. But to encode them, you'll need
+to install the relevant codecs. At the moment, Ogg Vorbis, MP3 and FLAC formats
+are supported. To enable encoding to these formats, you'll have to install
+libogg, lame and flac respectively. How exactly you install these depends on
+your distribution: take a look at their documentation to find out how.</para>
+
+<para>Once you have your favourite codec(s) installed, open &kcontrolcenter; and navigate your way to <menuchoice><guimenu>Sound &amp;
+Multimedia</guimenu><guimenuitem>Audio CDs</guimenuitem></menuchoice>
+and configure the settings on the various tabs to your liking. You can leave
+everything in the default state if you so wish, but it's helpful to take a
+look so you at least know what's on offer. Again, take a look at
+<menuchoice><guimenu>Sound &amp; Multimedia</guimenu><guimenuitem>CDDB
+Retrieval</guimenuitem></menuchoice> and change anything that's not to your
+liking. <acronym>CDDB</acronym>, in case you didn't know, stands for CD DataBase (or Compact
+Disc DataBase in it's more free flowing form). This functionality enables
+&kde; to retrieve the Artist/Album/Track information about your CDs from the
+Internet. This metadata is also used to write tags to the MP3 or Ogg files
+that you'll be encoding your CDs to anytime now. </para>
+
+
+<mediaobject>
+<imageobject>
+<imagedata format="PNG" fileref="ripsettings.png"/>
+</imageobject>
+</mediaobject>
+
+</sect2>
+
+<sect2 id="audio-cd-recipe">
+<title>Recipe</title>
+
+<para>Without further delay, let's get down to the business of being cool.
+First, pop in the CD you want to rip (obviously!). Next, fire up a
+&konqueror; window and open the <guilabel>Services</guilabel> tab on the Navigation panel. The
+Navigation panel sits on the left side of the window, as shown in the
+screenshot below. If it's not visible, you can produce it out of thin air by
+pressing the magic <keycap>F9</keycap> key.</para>
+
+
+<mediaobject>
+<imageobject>
+<imagedata format="PNG" fileref="services.png"/>
+</imageobject>
+</mediaobject>
+
+
+<para>Now click on Audio CD Browser and in a few seconds, you'll see a lot
+of folders which you can start browsing. If it's taking some time to show
+anything, it's because it's trying to fetch information about the CD from
+the CDDB database you configured earlier. </para>
+
+<para>In the screenshot below, you can see the contents of the Ogg Vorbis
+folder. It shows all the songs in the Ogg format; it even shows their file
+size! But, you and I both know that audio CDs don't contain Ogg tracks. So
+what exactly is happening here?</para>
+
+
+<mediaobject>
+<imageobject>
+<imagedata format="PNG" fileref="oggfolder.png"/>
+</imageobject>
+</mediaobject>
+
+
+<para>All the folders you see under Audio CD Browser are virtual folders.
+They show contents of the CD through different filters, so to speak. When
+you open the Ogg Vorbis folder, you are actually seeing the contents of the
+CD <emphasis>as if</emphasis> it were stored in the Ogg format. You can go through the other
+folders and you'll find MP3, flac and wav representations of the CD's
+contents. You can even see the approximate file sizes when encoded in the
+various formats. </para>
+
+
+<para>So how do we rip and encode the CD? I think you can guess the answer
+by now. Just decide which format you wish to rip to, open that folder, and
+copy and paste those files in your target folder. That's it! &kde; will start
+ripping and encoding the files on the fly! If you copy any of the files in
+the <guilabel>Full CD</guilabel> folder, you'll be ripping the entire CD as
+one continuous stream. </para>
+
+
+<mediaobject>
+<imageobject>
+<imagedata format="PNG" fileref="rip.png"/>
+</imageobject>
+</mediaobject>
+
+
+<!-- Add links to "further reading" here -->
+<itemizedlist>
+<title>Related Information</title>
+<listitem><para>The <application>amaroK</application> website at
+<ulink url="http://amarok.sf.net">http://amarok.sf.net</ulink> has the
+latest news and information about <application>amaroK</application>.</para>
+</listitem>
+</itemizedlist>
+
+<!-- TODO: Add a link to the full audiocd documentation as soon as -->
+<!-- it's fixed :-) -->
+</sect2>
+</sect1>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: xml
+sgml-omittag:nil
+sgml-shorttag:nil
+sgml-namecase-general:nil
+sgml-general-insert-case:lower
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:0
+sgml-indent-data:true
+sgml-parent-document:("index.docbook" "book" "sect1")
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->