glfs/gnome/add/sound-juicer.xml
Manuel Canales Esparcia e7307aa1ca Typo fix. Gnome.
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5380 af4574ff-66df-0310-9fd7-8a98e5e911e0
2005-12-08 20:29:35 +00:00

176 lines
6.5 KiB
XML

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY sound-juicer-download-http "http://ftp.gnome.org/pub/gnome/sources/sound-juicer/&gnome-version;/sound-juicer-&sound-juicer-version;.tar.bz2">
<!ENTITY sound-juicer-download-ftp "ftp://ftp.gnome.org/pub/gnome/sources/sound-juicer/&gnome-version;/sound-juicer-&sound-juicer-version;.tar.bz2">
<!ENTITY sound-juicer-md5sum "e7e873cc77a002eb0d9c4cf502bd343d">
<!ENTITY sound-juicer-size "573 KB">
<!ENTITY sound-juicer-buildsize "9.1 MB">
<!ENTITY sound-juicer-time "0.2 SBU">
]>
<sect1 id="sound-juicer" xreflabel="Sound Juicer-&sound-juicer-version;">
<?dbhtml filename="sound-juicer.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
<keywordset>
<keyword role="package">sound-juicer-&sound-juicer-version;.tar</keyword>
<keyword role="ftpdir">sound-juicer</keyword>
</keywordset>
</sect1info>
<title>Sound Juicer-&sound-juicer-version;</title>
<indexterm zone="sound-juicer">
<primary sortas="a-Sound-Juicer">Sound Juicer</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Sound Juicer</title>
<para>The <application>Sound Juicer</application> package contains the
<command>sound-juicer</command> program, a simple and clean CD ripping
tool. This is useful for extracting the audio tracks from audio compact
discs and converting them into audio files. It can also play the audio
tracks directly from the CD, allowing you to preview the CD before ripping
it. <application>Sound Juicer</application> is designed to be easy to use,
and to work with little user intervention. When you start
<command>sound-juicer</command> it will examine the CD in the drive and try
to locate information about the audio tracks using the MusicBrainz
service.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&sound-juicer-download-http;"/></para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&sound-juicer-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &sound-juicer-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &sound-juicer-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &sound-juicer-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &sound-juicer-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">Sound Juicer Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="gnome-media"/>,
<xref linkend="gst-plugins"/> and
<xref linkend="libmusicbrainz"/></para>
<note>
<para>At a minimum you should have the following plugins configured into
the GStreamer Plug-ins: cdparanoia, vorbisenc, flacenc, wavenc,
gnomevfssink and if you plan on encoding into MP3 format, lame. You can
easily determine if you have the necessary plugins configured by using
the <command>gst-inspect</command> program. Here is an example:</para>
<screen><userinput>gst-inspect | grep cdparanoia</userinput></screen>
</note>
</sect2>
<sect2 role="installation">
<title>Installation of Sound Juicer</title>
<para>Install <application>Sound_Juicer</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=`pkg-config --variable=prefix ORBit-2.0` \
--localstatedir=/var/lib --sysconfdir=/etc/gnome &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para><parameter>--localstatedir=/var/lib</parameter>: This switch
puts <application>ScrollKeeper</application> files in
<filename class="directory">/var/lib/scrollkeeper</filename> instead of
<filename class="directory">$GNOME_PREFIX/var/scrollkeeper</filename>.</para>
<para><parameter>--sysconfdir=/etc/gnome</parameter>: This switch
puts configuration files in <filename class="directory">/etc/gnome</filename>
instead of <filename class="directory">$GNOME_PREFIX/etc</filename>.</para>
</sect2>
<sect2 role="configuration">
<title>Configuring Sound Juicer</title>
<sect3 id="sound-juicer-config">
<title>Configuration Information</title>
<para>Configuration is accomplished by using the
<quote>Preferences</quote> drop-down menu option. For information on how
to configure <command>sound-juicer</command> to use
<application>LAME</application> as the default encoding method (creating
MP3 files as the default) see the <application>Sound Juicer</application>
Help section.</para>
</sect3>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>sound-juicer</seg>
<seg>none</seg>
<seg>/etc/gnome/gconf/gconf.xml.defaults/apps/sound-juicer,
/etc/gnome/gconf/gconf.xml.defaults/schemas/apps/sound-juicer,
$GNOME_PREFIX/share/gnome/help/sound-juicer,
$GNOME_PREFIX/share/omf/sound-juicer and
$GNOME_PREFIX/share/sound-juicer</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="sound-juicer-prog">
<term><command>sound-juicer</command></term>
<listitem>
<para>is a graphical CD extraction (ripping) tool based on
GNOME-2 and GStreamer.</para>
<indexterm zone="sound-juicer sound-juicer-prog">
<primary sortas="b-sound-juicer">sound-juicer</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>