[rhythmbox/mallard-help] Modified Rhythmbox help pages.
- From: Sindhu S <sindhus src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [rhythmbox/mallard-help] Modified Rhythmbox help pages.
- Date: Mon, 25 Mar 2013 15:43:26 +0000 (UTC)
commit 29ff19af8953396b4e1ace64014ab6222e3d0b85
Author: Sindhu S <sindhus live in>
Date: Sun Mar 24 19:42:11 2013 +0530
Modified Rhythmbox help pages.
Stubbed pages not ready for user view.
Added pages ready for user view to Makefile.am
Included legal.xml license where required.
Added new content to crossfade.page, repeat-music.page,
volume-controls.page and play-queue.page.
Reflowed paragraphs where necessary.
..._manage-coverart.page => _manage-coverart.stub} | 0
help/C/{_plugins.page => _plugins.stub} | 0
help/C/{_search.page => _search.stub} | 0
help/C/{_sort.page => _sort.stub} | 0
help/C/{_sync.page => _sync.stub} | 0
...rmat.page => convert-cd-to-digital-format.stub} | 0
help/C/crossfade.page | 71 +
help/C/fdl-appendix.xml | 668 -------
...port-a-playlist.page => import-a-playlist.stub} | 0
help/C/{import-errors.page => import-errors.stub} | 0
help/C/increase-decrease-volume.page | 27 -
help/C/index.docbook | 1859 --------------------
help/C/intro.page | 6 +-
help/C/{itunes-import.page => itunes-import.stub} | 0
help/C/{jamendo.page => jamendo.stub} | 0
help/C/license.page | 57 -
help/C/{magnatune.page => magnatune.stub} | 0
help/C/{music.page => music.stub} | 0
...-music-network.page => play-music-network.stub} | 0
help/C/play-queue.page | 191 ++-
...m-music-tagging.page => pro-music-tagging.stub} | 0
...library.page => prob-music-not-in-library.stub} | 0
...em-playing-mp3s.page => prob-playing-mp3s.stub} | 0
...ync-with-ipod.page => prob-sync-with-ipod.stub} | 0
help/C/remove-gap-between-songs.page | 39 -
...library.page => remove-music-from-library.stub} | 0
help/C/repeat-music.page | 51 +-
help/C/shortcut-keys.page | 3 -
help/C/{shuffle-music.page => shuffle-music.stub} | 0
help/C/volume-controls.page | 39 +
help/C/{what-is-daap.page => what-is-daap.stub} | 0
.../{what-is-librefm.page => what-is-librefm.stub} | 0
help/Makefile.am | 39 +-
33 files changed, 337 insertions(+), 2713 deletions(-)
---
diff --git a/help/C/_manage-coverart.page b/help/C/_manage-coverart.stub
similarity index 100%
rename from help/C/_manage-coverart.page
rename to help/C/_manage-coverart.stub
diff --git a/help/C/_plugins.page b/help/C/_plugins.stub
similarity index 100%
rename from help/C/_plugins.page
rename to help/C/_plugins.stub
diff --git a/help/C/_search.page b/help/C/_search.stub
similarity index 100%
rename from help/C/_search.page
rename to help/C/_search.stub
diff --git a/help/C/_sort.page b/help/C/_sort.stub
similarity index 100%
rename from help/C/_sort.page
rename to help/C/_sort.stub
diff --git a/help/C/_sync.page b/help/C/_sync.stub
similarity index 100%
rename from help/C/_sync.page
rename to help/C/_sync.stub
diff --git a/help/C/convert-cd-to-digital-format.page b/help/C/convert-cd-to-digital-format.stub
similarity index 100%
rename from help/C/convert-cd-to-digital-format.page
rename to help/C/convert-cd-to-digital-format.stub
diff --git a/help/C/crossfade.page b/help/C/crossfade.page
new file mode 100644
index 0000000..6987475
--- /dev/null
+++ b/help/C/crossfade.page
@@ -0,0 +1,71 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="crossfade">
+
+ <info>
+ <link type="guide" xref="index#rb-music"/>
+ <desc>Enable gapless playback</desc>
+ <revision pkgversion="3.8" version="0.6" date="2013-01-12" status="draft"/>
+ <credit type="author">
+ <name>Jim Campbell</name>
+ <email>jwcampbell gmail com</email>
+ </credit>
+ </info>
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+
+ <title>Remove gap between tracks during playback</title>
+
+ <p>Most tracks include brief periods of silence at the end of each song, and
+ there are sometimes brief periods of silence at the beginning of a song, too.
+ Reducing or removing these periods of silence is called <em>Gapless
+ Playback</em>.</p>
+
+ <section id="enable-crossfade">
+ <title>Enable Gapless Playback</title>
+
+ <p>To enable <em>Gapless Playback</em> in <app>Rhythmbox</app>:</p>
+
+ <steps>
+ <item>
+ <p>Locate the settings icon to the right most corner of
+ <app>Rhythmbox</app>, next to the icon for
+ <link xref="volume-controls"/>. From the menu, select
+ <guiseq><gui style="menuitem">Preferences</gui>
+ <gui style="tab">Playback</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Select <gui style="checkbox">Crossfade between tracks</gui>.
+ <app>Rhythmbox</app> is now set to overlap the few final playback
+ duration of a song with the initial playback duration of a song.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="custom-crossfade">
+ <title>Customize Gapless Playback Duration</title>
+
+ <p>To change the amount of time that the tracks overlap:</p>
+
+ <steps>
+ <item>
+ <p>From the settings icon, select <guiseq>
+ <gui style="menuitem">Preferences</gui>
+ <gui style="tab">Playback</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Once you can have enabled
+ <gui style="checkbox">Crossfade between tracks</gui>, you can move the
+ <gui style="button">Crossface Duration (Seconds)</gui> slider to the
+ left or right. As you move the slider, <app>Rhythmbox</app> will display
+ the length of the overlap in seconds.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <note style="important">
+ <p>For will need to restart <app>Rhythmbox</app> for these settings to
+ take effect.</p></note>
+
+</page>
diff --git a/help/C/import-a-playlist.page b/help/C/import-a-playlist.stub
similarity index 100%
rename from help/C/import-a-playlist.page
rename to help/C/import-a-playlist.stub
diff --git a/help/C/import-errors.page b/help/C/import-errors.stub
similarity index 100%
rename from help/C/import-errors.page
rename to help/C/import-errors.stub
diff --git a/help/C/intro.page b/help/C/intro.page
index a8b07dd..9ab83b4 100644
--- a/help/C/intro.page
+++ b/help/C/intro.page
@@ -14,11 +14,7 @@
<name>Jim Campbell</name>
<email>jwcampbell gmail com</email>
</credit>
- <license>
- <p>
- Creative Commons Share Alike 3.0
- </p>
- </license>
+
</info>
<title>Introduction</title>
diff --git a/help/C/itunes-import.page b/help/C/itunes-import.stub
similarity index 100%
rename from help/C/itunes-import.page
rename to help/C/itunes-import.stub
diff --git a/help/C/jamendo.page b/help/C/jamendo.stub
similarity index 100%
rename from help/C/jamendo.page
rename to help/C/jamendo.stub
diff --git a/help/C/magnatune.page b/help/C/magnatune.stub
similarity index 100%
rename from help/C/magnatune.page
rename to help/C/magnatune.stub
diff --git a/help/C/music.page b/help/C/music.stub
similarity index 100%
rename from help/C/music.page
rename to help/C/music.stub
diff --git a/help/C/play-music-network.page b/help/C/play-music-network.stub
similarity index 100%
rename from help/C/play-music-network.page
rename to help/C/play-music-network.stub
diff --git a/help/C/play-queue.page b/help/C/play-queue.page
index 4041a48..d66ba9f 100644
--- a/help/C/play-queue.page
+++ b/help/C/play-queue.page
@@ -4,6 +4,8 @@
<info>
<link type="guide" xref="index#rb-music" group="one"/>
+ <link type="seealso" xref="shortcut-keys"/>
+ <link type="seealso" xref="remove-music-from-library"/>
<desc>What is and how to use it.</desc>
<revision pkgversion="3.0" version="0.1" date="2010-07-19" status="draft"/>
<revision pkgversion="3.0" version="0.1" date="2010-07-27" status="review"/>
@@ -11,51 +13,170 @@
<name>Milo Casagrande</name>
<email>milo ubuntu com</email>
</credit>
- <license>
- <p>
- Creative Commons Share Alike 3.0
- </p>
- </license>
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
</info>
<title>Play Queue</title>
- <p>
- The <gui>Play Queue</gui> is a special
- <link xref="playlists-what-is">playlist</link>: it controls the play
- order of your songs in the <link xref="music"><gui>Music</gui></link> library.
- </p>
- <p>
- With the <gui>Play Queue</gui> you can temporally change what songs are
- being played by <app>Rhythmbox</app>: when one songs end, the first one
- found in the <gui>Play Queue</gui> will be played.
- </p>
- <p>
- Once all songs in the <gui>Play Queue</gui> have been played,
- normal playback will be resumed.
- </p>
-
- <section id="play-queue-add" style="2column">
- <title>Add songs to the play queue</title>
+ <p>The <gui>Play Queue</gui> is an inbuilt
+ <link xref="playlists-what-is">playlist</link>. It is a collated view of
+ tracks being added from the <link xref="music"><gui>Music</gui></link>,
+ <gui>Podcast</gui> libraries, user created and automated playlists. Tracks
+ are played in the order queued. You can also change order of tracks
+ queued.</p>
+
+ <section id="play-queue-add">
+ <title>Populate the <gui>Play Queue</gui></title>
+
+ <p>You can add tracks to the <gui>Play Queue</gui> in the following
+ ways:</p>
+
<steps>
+ <title>To add tracks using <app>Rhthmbox</app> context menu:</title>
<item>
- <p>
- Right-click on the desired track.
- </p>
+ <p>Right click on the desired track.</p>
</item>
<item>
- <p>
- Select <gui style="menuitem">Add to Play Queue</gui>.
- </p>
+ <p>Select <gui style="menuitem">Add to Play Queue</gui>.</p>
</item>
</steps>
- <p>
- You can add tracks from your <gui>Music</gui> and <gui>Podcasts</gui>
- libraries.
- </p>
- <p>
- Once a track has been played, it is removed from the <gui>Play Queue</gui>.
- </p>
+
+ <steps>
+ <title>You also add tracks by using the playlist toolbar. To add tracks:</title>
+ <item>
+ <p>Select the desired track from the desired playlist.</p>
+ </item>
+ <item>
+ <p>Select <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Copy</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>Click <gui>Play Queue</gui>, select
+ <guiseq><gui style="menu">Edit</gui>
+ <gui style="menuitem">Paste</gui></guiseq>. Your tracks have now been
+ added to the <gui>Play Queue</gui>.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <note style="tip">
+ <p>To select multiple tracks at once, hold down <key>Ctrl</key> and select
+ the tracks. Once you have selected the tracks, release the <key>Ctrl</key>
+ key.</p>
+ </note>
+
+ <section id="remove-play-queue">
+ <title>Remove tracks from the <gui>Play Queue</gui></title>
+
+ <p>You can remove particular tracks or clear the <gui>Play Queue</gui>
+ entirely.</p>
+
+ <steps>
+ <title>To remove selected tracks:</title>
+ <item>
+ <p>Select the desired track.</p>
+ </item>
+ <item>
+ <p>Right click on the selected track.</p>
+ </item>
+ <item>
+ <p>Select <gui style="menuitem">Remove from Play Queue</gui>.</p>
+ </item>
+ </steps>
+
+ <steps>
+ <title>To clear tracks from the <gui>Play Queue</gui>:</title>
+ <item>
+ <p>In the playlist toolbar, click <gui style="button">Clear</gui>.</p>
+ </item>
+ </steps>
+ </section>
+
+ <section id="reorder-play-queue">
+ <title>Rearrange the <gui>Play Queue</gui></title>
+
+ <p><app>Rhythmbox</app> can re-arrange the tracks in the
+ <gui>Play Queue</gui> in random order called
+ <gui style="button">Shuffle</gui> in addition, it also allows you to
+ re-arrange the order of tracks queued manually one track at a time.</p>
+
+ <steps>
+ <title>To shuffle the <gui>Play Queue</gui>:</title>
+ <item>
+ <p>In the <gui>Play Queue</gui> view, click <gui style="button">Shuffle</gui>.</p>
+ </item>
+ </steps>
+
+ <steps>
+ <title>To change the order of tracks by hand:</title>
+ <item>
+ <p>In the <gui>Play Queue</gui> view, select the desired track.</p>
+ </item>
+ <item>
+ <p>Click and drag any of the selected track to any location in the
+ <gui>Play Queue</gui>.</p>
+ </item>
+ </steps>
+
+ <note>
+ <p>If you have selected multiple tracks and they are not adjacent
+ then moving their position to reorder will have them become adjacent to
+ other select tracks upon re-ordering.</p>
+ </note>
+
+ <note style="important">
+ <p>Once a track has been played, it is removed from the
+ <gui>Play Queue</gui>.</p>
+ </note>
+ </section>
+
+ <section id="save-playlist">
+ <title>Save tracks to a playlist</title>
+
+ <p>To save queued tracks in the <gui>Play Queue</gui> as a playlist:</p>
+
+ <steps>
+ <item>
+ <p>From the playlist toolbar, select
+ <guiseq><gui style="menu">Playlist</gui>
+ <gui style="menuitem">Save to File…</gui></guiseq>.</p>
+ </item>
+ <item>
+ <p>In the <gui>Save Playlist</gui> dialog window, input the desired
+ name for the playlist. Optionally, you may browse to the desired
+ directory for the playlist to be saved onto.</p>
+ </item>
+ <item>
+ <p>Playlists by default are saved with the extension,
+ <code>.pls</code>. To save using any other format, consider reading <link
xref="playlists-type"/>.</p>
+ </item>
+ <item>
+ <p>Click <gui style="button">Save</gui> to save the playlist.</p>
+ </item>
+ </steps>
+
+ </section>
+
+ <section id="sidepane-play-queue">
+ <title>View <gui>Play Queue</gui> in the sidepane</title>
+
+ <p>To view the queued tracks from the <gui>Play Queue</gui> in the
+ <app>Rhythmbox</app> sidepane:</p>
+
+ <steps>
+ <item>
+ <p>From the settings icon, select
+ <guiseq><gui style="menu">View</gui>
+ <gui style="menuitem">Play Queue in Side Pane</gui></guiseq>.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>You can hide or view the <gui>Play Queue</gui> in the
+ <app>Rhythmbox</app> sidepane by pressing
+ <keyseq><key>Ctrl</key><key>K</key></keyseq>.</p>
+ </note>
</section>
</page>
diff --git a/help/C/problem-music-tagging.page b/help/C/pro-music-tagging.stub
similarity index 100%
rename from help/C/problem-music-tagging.page
rename to help/C/pro-music-tagging.stub
diff --git a/help/C/music-not-in-library.page b/help/C/prob-music-not-in-library.stub
similarity index 100%
rename from help/C/music-not-in-library.page
rename to help/C/prob-music-not-in-library.stub
diff --git a/help/C/problem-playing-mp3s.page b/help/C/prob-playing-mp3s.stub
similarity index 100%
rename from help/C/problem-playing-mp3s.page
rename to help/C/prob-playing-mp3s.stub
diff --git a/help/C/problem-sync-with-ipod.page b/help/C/prob-sync-with-ipod.stub
similarity index 100%
rename from help/C/problem-sync-with-ipod.page
rename to help/C/prob-sync-with-ipod.stub
diff --git a/help/C/remove-music-from-library.page b/help/C/remove-music-from-library.stub
similarity index 100%
rename from help/C/remove-music-from-library.page
rename to help/C/remove-music-from-library.stub
diff --git a/help/C/repeat-music.page b/help/C/repeat-music.page
index b4e44d5..ec65d43 100644
--- a/help/C/repeat-music.page
+++ b/help/C/repeat-music.page
@@ -2,26 +2,41 @@
type="topic" style="task"
id="repeat-music">
-<info>
- <link type="guide" xref="index#rb-music"/>
- <desc>Play the first song in your collection after you've reached the last
- song.</desc>
- <revision pkgversion="3.8" version="0.3" date="2013-01-12" status="stub"/>
- <credit type="author">
- <name>Jim Campbell</name>
- <email>jwcampbell gmail com</email>
- </credit>
-</info>
+ <info>
+ <link type="guide" xref="index#rb-music"/>
+ <link type="seealso" xref="shortcut-keys"/>
+ <desc>Play the first song in your collection after you've reached the last
+ song.</desc>
+ <revision pkgversion="3.8" version="0.3" date="2013-01-12" status="stub"/>
+ <credit type="author">
+ <name>Jim Campbell</name>
+ <email>jwcampbell gmail com</email>
+ </credit>
+ </info>
+ <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
-<!-- This is a WIP -->
+ <title>Repeat your music</title>
-<title>Repeat your music</title>
+ <p><app>Rhythmbox</app> stops playback after all tracks have been played from the <gui>Music</gui>
library. However, you can set <app>Rhythmbox</app> to repeat tracks. To set repeatition of tracks:</p>
- <p><app>Rhythmbox</app> can either repeat a series of songs, or can repeat
- just one song.</p>
-
- <p>To force <app>Rhythmbox</app> to repeat music, click the <gui>Repeat</gui>
- icon in the toolbar. You can also select <guiseq><gui>Control</gui><gui>Repeat
- </gui></guiseq>, or press <keyseq><key>Ctrl</key><key>R</key></keyseq>.</p>
+ <steps>
+ <item>
+ <p>Click on <gui style="button">Repeat</gui> icon in the
+ <app>Rhythmbox</app> toolbar.</p>
+ </item>
+ </steps>
+
+ <note style="important">
+ <p>If you have <link xref="shuffle-music">
+ <gui style="button">Shuffle</gui></link> mode enabled along with
+ <gui style="button">Repeat</gui> then, <app>Rhythmbox</app> will play all
+ tracks in the <gui>Play Queue</gui> in random order. Once all tracks have
+ been played, <app>Rhythmbox</app> will repeat tracks from the <gui>Play Queue</gui> by playing them
again, randomly.</p>
+ </note>
+
+ <note style="tip">
+ <p>You can also repeat tracks by pressing
+ <keyseq><key>Ctrl</key><key>R</key></keyseq>.</p>
+ </note>
</page>
diff --git a/help/C/shortcut-keys.page b/help/C/shortcut-keys.page
index 3445f3f..8843da2 100644
--- a/help/C/shortcut-keys.page
+++ b/help/C/shortcut-keys.page
@@ -24,9 +24,6 @@
with the mouse and menus. The following tables list all of <app>Rhythmbox's
</app> shortcut keys.</p>
- <!-- For the sake of appearance, I have not used the <keyseq> feature to
- display key sequences in the tables. -->
-
<table rules="rows" frame="top bottom" ui:expanded="yes">
<title>Shortcuts for playing music</title>
<thead>
diff --git a/help/C/shuffle-music.page b/help/C/shuffle-music.stub
similarity index 100%
rename from help/C/shuffle-music.page
rename to help/C/shuffle-music.stub
diff --git a/help/C/volume-controls.page b/help/C/volume-controls.page
new file mode 100644
index 0000000..a02a9d0
--- /dev/null
+++ b/help/C/volume-controls.page
@@ -0,0 +1,39 @@
+<page xmlns="http://projectmallard.org/1.0/";
+ type="topic" style="task"
+ id="volume-controls">
+
+<info>
+ <link type="guide" xref="index#rb-music"/>
+ <link type="seealso" xref="shortcut-keys"/>
+ <desc>Make your music sound louder or quieter.</desc>
+ <revision pkgversion="3.8" version="0.8" date="2012-12-15" status="draft"/>
+ <credit type="author">
+ <name>Jim Campbell</name>
+ <email>jwcampbell gmail com</email>
+ </credit>
+</info>
+
+<title>Volume Controls</title>
+
+ <p>To set volume of <app>Rhythmbox</app> playback:</p>
+
+ <steps>
+ <item>
+ <p>Locate the volume icon that is placed at the right hand
+ side of <app>Rhythmbox</app>.</p>
+ </item>
+ <item>
+ <p>Click the <gui style="button">volume</gui> icon, a vertical slider
+ will appear. Drag the pointer on the slider to increase or decrease the
+ volume. Moving the slider upwards increases the volume; moving the
+ slider downwards decreases the volume. Alternatively, you can press
+ <gui style="button">+</gui> in the volume slider to increase the volume
+ and <gui style="button">-</gui> to decrease the volume.</p>
+ </item>
+ </steps>
+
+ <note style="tip">
+ <p>You can also use a keyboard shortcut to change the volume. Press <keyseq><key>Ctrl</key><key>Up
Arrow</key></keyseq> to increase the volume, or press <keyseq><key>Ctrl</key><key>Down Arrow</key></keyseq>
to decrease the volume.</p>
+ </note>
+
+</page>
diff --git a/help/C/what-is-daap.page b/help/C/what-is-daap.stub
similarity index 100%
rename from help/C/what-is-daap.page
rename to help/C/what-is-daap.stub
diff --git a/help/C/what-is-librefm.page b/help/C/what-is-librefm.stub
similarity index 100%
rename from help/C/what-is-librefm.page
rename to help/C/what-is-librefm.stub
diff --git a/help/Makefile.am b/help/Makefile.am
index 1a7bb82..fc1f911 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -1,7 +1,43 @@
@YELP_HELP_RULES@
HELP_ID = rhythmbox
-HELP_FILES = fdl-appendix.xml index.docbook legal.xml
+HELP_FILES = \
+ _manage-tags.page \
+ crossfade.page \
+ index.page \
+ intro.page \
+ lastfm-manage.page \
+ lastfm-signin.page \
+ lastfm.page \
+ legal.xml \
+ music-import.page \
+ overview.page \
+ play-queue.page \
+ playlists-automatic-create.page \
+ playlists-automatic.page \
+ playlists-save-to-file.page \
+ playlists-standard-create.page \
+ playlists-standard.page \
+ playlists-type.page \
+ playlists-what-is.page \
+ podcast-add.page \
+ podcast-change-check.page \
+ podcast-change-download.page \
+ podcast-listen.page \
+ podcast.page \
+ prob-playlist-empty.page \
+ prob-resolve-host.page \
+ prob-unable-connect.page \
+ radio-stations-add.page \
+ radio-stations-edit.page \
+ radio-stations-listen.page \
+ radio-stations.page \
+ radio-what-is.page \
+ rate-a-song.page \
+ repeat-music.page \
+ shortcut-keys.page \
+ shortcut-lirc.page \
+ volume-controls.page
HELP_MEDIA = \
figures/rb-iradio-main.png \
figures/rb-notification-area-menu.png \
@@ -16,5 +52,4 @@ HELP_MEDIA = \
figures/rb-volume-changer.png \
figures/rb-window.png \
figures/rb-window-small.png
-
HELP_LINGUAS = cs da de es el eu fr gl it ja oc pt ro ru sl sv uk zh_CN
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
