[totem/mallard-documentation] Add new pages for Totem help.



commit 18419b1f36c50ce0f6f0385087da2dae06ff615c
Author: Marta Bogdanowicz <majus85 gmail com>
Date:   Wed Sep 26 19:25:13 2012 +0200

    Add new pages for Totem help.

 help/C/adjustment-sound.page          |   13 +++-
 help/C/adjustment-view.page           |   67 ++++++++++++++
 help/C/figures/totem-main-window.png  |  Bin 46802 -> 58755 bytes
 help/C/file-open.page                 |   15 ++--
 help/C/file-save.page                 |   11 ++-
 help/C/introduction.page              |    4 +-
 help/C/navigation.page                |    8 +-
 help/C/playing-DVD.page               |   57 ++++++++++++
 help/C/playing-order.page             |   49 +++++++++++
 help/C/plugins.page                   |   32 +++++++
 help/C/sidebar.page                   |  152 ++++++++++++++++----------------
 help/C/supported-formats.page         |   41 +++++++++
 help/C/troubleshooting-Audio-CD.page  |   31 +++++++
 help/C/troubleshooting-DVD.page       |   33 +++++++
 help/C/troubleshooting-subtitles.page |   60 +++++++++++++
 help/Makefile.am                      |   38 +++++---
 16 files changed, 502 insertions(+), 109 deletions(-)
---
diff --git a/help/C/adjustment-sound.page b/help/C/adjustment-sound.page
index 6b6b5a7..d341102 100644
--- a/help/C/adjustment-sound.page
+++ b/help/C/adjustment-sound.page
@@ -29,7 +29,7 @@
       louder.</p>
     </item>
     <item>
-       <p>Click <guiseq><gui style="menu">Sound</gui>
+       <p>Select <guiseq><gui style="menu">Sound</gui>
        <gui style="menuitem">Volume Down</gui></guiseq> to make the sound
        quieter.</p>
     </item>
@@ -46,6 +46,17 @@
     anywayâ</p>
   </comment>
 
+  <comment>
+    <cite date="2012-09-26">Marta Bogdanowicz</cite>
+    <p>The volume button is greyed out only then, when none media file is played
+    in Totem. If you open any file you will be able to use this button. I didn't
+    give any information about it, because opening or adding files is the first
+    thing that people usually do. As to the languages: I left them here, because
+    they are the part of menu <gui>Sound</gui>.However I wasn't able to use this
+    option. I may only suppose that it concerns changng the voice-over while
+    watching a movie. Am I right?</p>
+  </comment>
+
 <!--  <p>-->
 <!--  Click <guiseq><gui style="menu">Sound</gui>-->
 <!--  <gui style="menuitem">Languages</gui></guiseq> and select the language.-->
diff --git a/help/C/adjustment-view.page b/help/C/adjustment-view.page
new file mode 100644
index 0000000..6d17800
--- /dev/null
+++ b/help/C/adjustment-view.page
@@ -0,0 +1,67 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="adjustment-view">
+
+  <info>
+    <link type="guide" xref="index#application-adjustment"/>
+    <desc>Adjust view while playing media files.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Adjust view</title>
+
+  <p>
+  <app>Totem</app> allows you to adjust view by:
+  </p>
+
+  <terms>
+    <item>
+      <title><code>Fitting window to movie</code></title>
+        <p>Select <guiseq><gui style="menu">View</gui>
+        <gui style="menuitem">Fit window to movie</gui></guiseq> and:</p>
+          <list>
+            <item>
+              <p><gui>Resize 1:2</gui> - resize to half of the original video
+              size.</p>
+            </item>
+            <item>
+              <p><gui>Resize 1:1</gui> - resize to the original video size.</p>
+            </item>
+            <item>
+              <p><gui>Resize 2:1</gui> - resize to double the original video
+              size.</p>
+            </item>
+          </list>
+    </item>
+    <item>
+      <title><code>Zooming in</code></title>
+        <p>Select <guiseq><gui style="menu">View</gui>
+        <gui style="menuitem">Zoom In</gui></guiseq> or click
+        <keyseq><key>Ctrl</key><key>Z</key></keyseq>. </p>
+    </item>
+    <item>
+      <title><code>Setting aspect ratio</code></title>
+        <p>Select <guiseq><gui style="menu">View</gui>
+        <gui style="menuitem">Aspect Ratio</gui></guiseq> and choose among:</p>
+          <list>
+            <item><p><gui>Auto</gui></p></item>
+            <item><p><gui>Square</gui></p></item>
+            <item><p><gui>4:3 (TV)</gui></p></item>
+            <item><p><gui>16:9 (Widescreen)</gui></p></item>
+            <item><p><gui>2.11:1 (DVB)</gui></p></item>
+          </list>
+    </item>
+  </terms>
+  <note style="info">
+    <p>Aspect ratio is the proportion between width and height. This option
+    allows you to force different aspect ratio to be used for displaying movie.
+    </p>
+  </note>
+
+</page>
diff --git a/help/C/figures/totem-main-window.png b/help/C/figures/totem-main-window.png
index 03bbc00..1934964 100644
Binary files a/help/C/figures/totem-main-window.png and b/help/C/figures/totem-main-window.png differ
diff --git a/help/C/file-open.page b/help/C/file-open.page
index 166260f..457fa64 100644
--- a/help/C/file-open.page
+++ b/help/C/file-open.page
@@ -4,7 +4,7 @@
 
   <info>
     <link type="guide" xref="index#playing-media"/>
-    <desc>Start watching a movie or listetning to the music.</desc>
+    <desc>Start watching a movie or listening to the music.</desc>
     <credit type="author">
       <name>Marta Bogdanowicz</name>
       <email>majus85 gmail com</email>
@@ -16,8 +16,7 @@
 
   <title>Open a file</title>
 
-  <p>
-  Open video or audio file in <app>Totem Movie Player</app>, in one of the 
+  <p>Open video or audio file in <app>Totem Movie Player</app>, in one of the
   following ways:</p>
 
   <list>
@@ -31,10 +30,10 @@
           the bottom of file chooser <app>Totem</app> offers you such options
           as:</p>
             <list>
-              <item><p>All files</p></item>
-              <item><p>Supported files</p></item>
-              <item><p>Audio files</p></item>
-              <item><p>Video files</p></item>
+              <item><p><gui>All files</gui></p></item>
+              <item><p><gui>Supported files</gui></p></item>
+              <item><p><gui>Audio files</gui></p></item>
+              <item><p><gui>Video files</gui></p></item>
             </list>
         </note>
     </item>
@@ -48,7 +47,7 @@
     <item>
       <p>Click <guiseq><gui style="menu">Movie</gui>
       <gui style="menuitem">Play Disc</gui></guiseq> to start watching movie or
-      listetning to the music from CD or DVD.</p>
+      listening to the music from CD or DVD.</p>
         <note>
           <p>Option <gui style="menuitem">Play Disc</gui> will show up only
           then, when you put CD or DVD to your disc drive.</p>
diff --git a/help/C/file-save.page b/help/C/file-save.page
index dfcd2fa..17ecdab 100644
--- a/help/C/file-save.page
+++ b/help/C/file-save.page
@@ -17,8 +17,9 @@
   <title>Save a copy of a file</title>
 
   <p>
-  <app>Totem</app> allows you to save a copy of the used file. Do this in the
-  following way:
+  <app>Totem</app> allows you to save a copy of the used file in other
+  localization on your hard drive or on a pendrive. Do this in the following
+  way:
   </p>
 
   <steps>
@@ -34,7 +35,11 @@
     <item>
       <p>Confirm your choice by clicking <gui>Save</gui>.</p>
     </item>
-
   </steps>
 
+  <note style="warning">
+    <p>Notice that you are not allowed to save a copy of a file which is
+    protected like, for example, movie from the original DVD.</p>
+  </note>
+
 </page>
diff --git a/help/C/introduction.page b/help/C/introduction.page
index 814f92e..dbedfe8 100644
--- a/help/C/introduction.page
+++ b/help/C/introduction.page
@@ -25,8 +25,8 @@
   <title>Introduction</title>
 
   <p><app>Totem Movie Player</app> is an application for playing media, it can
-  play video, as well as audio. You can use it to watch movies, listen to music
-  or create playlists.</p>
+  play video, as well as audio. You can use it to watch movies, listen
+  to music, create playlists or stream media from the Internet.</p>
 
   <note style="advanced">
     <p><app>Totem</app> is based on <gui>GStreamer</gui>, a plugin-based
diff --git a/help/C/navigation.page b/help/C/navigation.page
index c356a91..37116ca 100644
--- a/help/C/navigation.page
+++ b/help/C/navigation.page
@@ -36,16 +36,16 @@
       <keyseq><key>Alt</key><key>Left</key></keyseq>.</p>
     </item>
     <item>
-      <p>Play media, or pause them. You may also use keyboard shortcut
+      <p>Play media or pause them. You may also use keyboard shortcut
       <keyseq><key>Ctrl</key><key>Space</key></keyseq> or click
       <guiseq><gui style="menu">Movie</gui>
       <gui style="menuitem">Play/Pause</gui></guiseq>.</p>
     </item>
     <item>
       <p>Play next chapter or movie. The same result you will achieve by
-      clicking <guiseq><gui style="menu">Movie</gui>
-      <gui style="menuitem">Play/Pause</gui></guiseq> or <keyseq><key>Alt</key>
-      <key>Right</key></keyseq>.</p>
+      selecting <guiseq><gui style="menu">Go</gui>
+      <gui style="menuitem">Next Chapter/Movie</gui></guiseq> or
+      <keyseq><key>Alt</key><key>Right</key></keyseq>.</p>
     </item>
     <item>
       <p>View the fullscreen. Do the same by clicking <key>F11</key> or
diff --git a/help/C/playing-DVD.page b/help/C/playing-DVD.page
new file mode 100644
index 0000000..10b8831
--- /dev/null
+++ b/help/C/playing-DVD.page
@@ -0,0 +1,57 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="playing-DVD">
+
+  <info>
+    <link type="guide" xref="index#playing-media"/>
+    <link type="seealso" xref="navigation"/>
+    <link type="seealso" xref="keyboard-shortcuts"/>
+    <desc>Play media files from DVD or VCD.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Play DVD or VCD</title>
+
+  <p>
+  Insert DVD in your disc drive and select <guiseq><gui style="menu">Movie</gui>
+  <gui style="menuitem">Play Disc</gui></guiseq>. The menu of DVD will appear on
+  the dispaly area of <app>Totem</app>. Apart from this you may use
+  <gui style="menu">Go</gui> menu to navigate while watching movie:
+  </p>
+
+  <list>
+    <item>
+      <p>Select <gui style="menuitem">DVD Menu</gui> or click
+      <keyseq><key>Ctrl</key><key>M</key></keyseq> to view main menu of a DVD.
+      Customize language and subtitles or view scene index or special features.
+      </p>
+    </item>
+    <item>
+      <p>Select <gui style="menuitem">Title Menu</gui> to choose the language of
+      the DVD's interface.</p>
+    </item>
+    <item>
+      <p>Select <gui style="menuitem">Audio Menu</gui> and choose the spoken
+      language of the movie.</p>
+    </item>
+    <item>
+      <p>Select <gui style="menuitem">Angle Menu</gui>.</p>
+    </item>
+    <item>
+      <p>Select <gui style="menuitem">Chapter Menu</gui> or click
+      <keyseq><key>Ctrl</key><key>C</key></keyseq> to view scene index.</p>
+    </item>
+  </list>
+
+  <comment>
+    <cite date="2012-09-26">Marta Bogdanowicz</cite>
+    <p>I have no idea what this Angle menu is.</p>
+  </comment>
+
+</page>
diff --git a/help/C/playing-order.page b/help/C/playing-order.page
new file mode 100644
index 0000000..7546c18
--- /dev/null
+++ b/help/C/playing-order.page
@@ -0,0 +1,49 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="playing-order">
+
+  <info>
+    <link type="guide" xref="index#playing-media"/>
+    <link type="seealso" xref="playlist"/>
+    <desc>Set an order of plaing media.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Repeat and schuffle mode</title>
+
+  <p>
+  <app>Totem</app> allows you to set an order of playing files, which are on a
+  playlist. Create your compilation of media files by following the instructions
+  on <link xref="playlist"/> page and then choose one of the following modes:
+  </p>
+
+  <terms>
+    <item>
+      <title><code>Repeat Mode</code></title>
+      <p>Select <guiseq><gui>Edit</gui><gui>Repeat Mode</gui></guiseq>. The
+      compilation of media file, that your playlist consists of, will be palyed
+      all the time, in the order that you have set.</p>
+    </item>
+    <item>
+      <title><code>Schuffle Mode</code></title>
+      <p>Select <guiseq><gui>Edit</gui><gui>Schuffle Mode</gui></guiseq>. Your
+      playlist will be played in the random sequence. <app>Totem</app> will
+      stop playing, when all media files are played once.</p>
+    </item>
+  </terms>
+
+  <note style="tip">
+    <p>Select both options to play media files on your playlist all the time,
+    but in the random order.
+    </p>
+  </note>
+
+  <p>Disable mentioned above options in the same way, as you selected them.</p>
+
+</page>
diff --git a/help/C/plugins.page b/help/C/plugins.page
new file mode 100644
index 0000000..574c77f
--- /dev/null
+++ b/help/C/plugins.page
@@ -0,0 +1,32 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="plugins">
+
+  <info>
+    <link type="guide" xref="index#extra-features"/>
+    <desc>Use extra features of <app>Totem</app> and extend the application.
+    </desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Plugins</title>
+
+  <p>
+    <app>Totem</app> offers you some plugins. View the list of them by clicking
+    <guiseq><gui style="menu">Edit</gui>
+    <gui style="menuitem">Pluginsâ</gui></guiseq>. Tick the wanted one. Click
+    <gui>Close</gui> when ready.
+  </p>
+    <note>
+      <p>Notice that some options are avaiable only if you fulfill some
+      requirements. For example, to use plugin <gui>BBC iPlayer</gui> you are
+      supposed to be a citizen of Great Britain.</p>
+    </note>
+
+</page>
diff --git a/help/C/sidebar.page b/help/C/sidebar.page
index 3d5f16b..de21366 100644
--- a/help/C/sidebar.page
+++ b/help/C/sidebar.page
@@ -46,92 +46,92 @@
   <terms>
     <item>
       <title><code>Playlist</code></title>
-        <p>Create and manage your own playlist. Do it by following the
-        instructions on <link xref="playlist"/> page.</p>
+      <p>Create and manage your own playlist. Do it by following the
+      instructions on <link xref="playlist"/> page.</p>
     </item>
     <item>
       <title><code>Browse</code></title>
-        <p>Find audio or video files you want to play by browsing. Do it in the
-        following way:</p>
-          <steps>
-            <item>
-              <p>View <gui>Browse</gui> option by clicking
-              <guiseq><gui style="menu">View</gui>
-              <gui style="menuitem">Browse</gui></guiseq>.</p>
-            </item>
-            <item>
-              <p>In the <gui>Sidebar</gui> there will appear a list of sources
-              you may browse, such as <gui>You Tube</gui>, <gui>Jamendo</gui> or
-              <gui>Tracker</gui>.</p>
-                <note>
-                  <p>To browse some of these sources you will need Internet
-                  connection.</p>
-                </note>
-            </item>
-          </steps>
+      <p>Find audio or video files you want to play by browsing. Do it in the
+      following way:</p>
+      <steps>
+        <item>
+          <p>View <gui>Browse</gui> option by clicking
+          <guiseq><gui style="menu">View</gui>
+          <gui style="menuitem">Browse</gui></guiseq>.</p>
+        </item>
+        <item>
+          <p>In the <gui>Sidebar</gui> there will appear a list of sources you
+          may browse, such as <gui>You Tube</gui>, <gui>Jamendo</gui> or
+          <gui>Tracker</gui>.</p>
+        </item>
+      </steps>
+      <note>
+        <p>To browse some of these sources you will need Internet connection.
+        </p>
+      </note>
     </item>
     <item>
       <title><code>Search</code></title>
-        <p>Find audio or video files you want to play by searching. Do it in the
-        following way:</p>
-          <steps>
-            <item>
-              <p>Click <guiseq><gui style="menu">View</gui>
-              <gui style="menuitem">Search</gui></guiseq>.</p>
-            </item>
-            <item>
-              <p>In the <gui>Sidebar</gui> there will appear search window.</p>
-            </item>
-            <item>
-              <p>Choose the source from the drop-down list or type the neame of
-              server you want to search.</p>
-            </item>
-          </steps>
+      <p>Find audio or video files you want to play by searching. Do it in the
+      following way:</p>
+      <steps>
+        <item>
+          <p>Click <guiseq><gui style="menu">View</gui>
+          <gui style="menuitem">Search</gui></guiseq>.</p>
+        </item>
+        <item>
+          <p>In the <gui>Sidebar</gui> there will appear search window.</p>
+        </item>
+        <item>
+          <p>Choose the source from the drop-down list or type the neame of
+          server you want to search.</p>
+        </item>
+      </steps>
     </item>
     <item>
       <title><code>Chapters</code></title>
-        <p>Divide movie or song into chapters. In this way you may mark your
-        favourite parts and start playing from specified moment. Do it in the
-        following way:</p>
-          <steps>
-            <item>
-              <p>Click <guiseq><gui style="menu">View</gui>
-              <gui style="menuitem">Chapters</gui></guiseq>.</p>
-            </item>
-            <item>
-              <p>Click <gui>Add New Chapters</gui> and then
-              <gui>Add Chapterâ</gui> button.</p>
-            </item>
-            <item>
-              <p>New dialog will pop up. Name new chapter and click
-              <gui>OK</gui>  when ready.</p>
-                <note style="tip">
-                  <p>In this way you may add more chapters. The list of them
-                  will appear in the <gui>Sidebar</gui>. Apart from the name you
-                  chose for chapter, <app>Totem</app> will also show the time,
-                  when the chapter begins.</p>
-                </note>
-            </item>
-            <item>
-              <p>You may also remove chapters by clicking
-              <gui>Remove Chapter</gui> button.</p>
-            </item>
-            <item>
-              <p>Navigate between chapters. Highlight one of them and click
-              <gui>Go to Chapter</gui> button. <app>Totem</app> will start
-              playing from the time specified by chosen chapter.</p>
-            </item>
-            <item>
-              <p>Save the list of chapters by clicking <gui>Save Changes</gui>.
-              </p>
-              <note>
-                <p>You may also load existing chapters. Do it by clicking
-                <gui>Load Chaptersâ</gui>. The chooser dialog will open. Select
-                file and click <gui>Open</gui> button.</p>
-              </note>
-            </item>
-          </steps>
+      <p>Divide movie or song into chapters. In this way you may mark your
+      favourite parts and start playing from specified moment. Do it in the
+      following way:</p>
+      <steps>
+        <item>
+          <p>Click <guiseq><gui style="menu">View</gui>
+          <gui style="menuitem">Chapters</gui></guiseq>.</p>
+        </item>
+        <item>
+          <p>Click <gui>Add New Chapters</gui> and then
+          <gui>Add Chapterâ</gui> button.</p>
+        </item>
+        <item>
+          <p>New dialog will pop up. Name new chapter and click
+          <gui>OK</gui>  when ready.</p>
+          <note style="tip">
+            <p>In this way you may add more chapters. The list of them
+            will appear in the <gui>Sidebar</gui>. Apart from the name you
+            chose for chapter, <app>Totem</app> will also show the time,
+            when the chapter begins.</p>
+          </note>
+        </item>
+        <item>
+          <p>You may also remove chapters by clicking
+          <gui>Remove Chapter</gui> button.</p>
+        </item>
+        <item>
+          <p>Navigate between chapters. Highlight one of them and click
+          <gui>Go to Chapter</gui> button. <app>Totem</app> will start
+          playing from the time specified by chosen chapter.</p>
+        </item>
+        <item>
+          <p>Save the list of chapters by clicking <gui>Save Changes</gui>.
+          </p>
+        </item>
+      </steps>
     </item>
   </terms>
+  <note>
+    <p>You may also load existing chapters. Do it by selecting
+    <gui>Load Chaptersâ</gui>. The chooser dialog will open. Select
+    file and click <gui>Open</gui> button.</p>
+  </note>
 
 </page>
diff --git a/help/C/supported-formats.page b/help/C/supported-formats.page
new file mode 100644
index 0000000..f1eb7c7
--- /dev/null
+++ b/help/C/supported-formats.page
@@ -0,0 +1,41 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="supported-formats">
+
+  <info>
+    <link type="guide" xref="index"/>
+    <link type="seealso" xref="introduction"/>
+    <desc>See what file formats are supported by <gui>Totem</gui>.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Supported file formats</title>
+
+  <p>File formats displayed by <app>Totem</app> depend on <gui>GStreamer</gui>
+  plugins. Install plugin packages you need:</p>
+
+  <list>
+    <item>
+      <p>The basic and essential plugin for GStreamer is
+      <code>gst-plugins-base</code>.</p>
+    </item>
+    <item>
+      <p>The plugin for most open formts is <code>gst-plugins-good</code>.</p>
+    </item>
+    <item>
+      <p>The plugins needed to play DVDs are <code>gst-plugins-ugly</code> and
+      <code>gst-plugins-bad</code>.</p>
+    </item>
+    <item>
+      <p>The plugin, which contains all the basic decoders for popular codecs is
+      <code>gst-ffmpeg</code>.</p>
+    </item>
+  </list>
+
+</page>
diff --git a/help/C/troubleshooting-Audio-CD.page b/help/C/troubleshooting-Audio-CD.page
new file mode 100644
index 0000000..d220cf9
--- /dev/null
+++ b/help/C/troubleshooting-Audio-CD.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="troubleshooting-audio-CD">
+
+  <info>
+    <link type="guide" xref="index#troubleshooting"/>
+    <desc>I cannot play my Audio CD in <app>Totem</app>.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Problem with Audio CD</title>
+
+  <p>
+    Please notice, that <app>Totem</app> does not support playback of Audio CDs.
+    You may use other music player, or rip your Audio CD and then play it in
+    <app>Totem</app>. <app>Sound Juicer</app> may be used to rip your Audio CD.
+  </p>
+  <terms>
+    <item>
+      <title><code>Ripping CD</code></title>
+      <p>Converting Audio CD contents into music files (e.g. mp3 or ogg).</p>
+    </item>
+  </terms>
+
+</page>
diff --git a/help/C/troubleshooting-DVD.page b/help/C/troubleshooting-DVD.page
new file mode 100644
index 0000000..89056c0
--- /dev/null
+++ b/help/C/troubleshooting-DVD.page
@@ -0,0 +1,33 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="troubleshooting-DVD">
+
+  <info>
+    <link type="guide" xref="index#troubleshooting"/>
+    <link type="seealso" xref="supported-formats"/>
+    <desc>I cannot play my DVD.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Problem with playing movie from DVD</title>
+
+  <p>
+  It may happen, that after putting your DVD into CD/DVD drive <app>Totem</app>
+  will not be able to play it. This may be because your DVD is encrypted and a
+  DVD decryption library is not installed. See <link xref="supported-formats"/>
+  page for more information.
+  </p>
+
+  <note style="tip">
+    <p>If <app>Totem</app> still cannot play your DVD, consider installing
+    <code>libdvdcss</code>. However, notice that using this library is not legal
+    in all countries.</p>
+  </note>
+
+</page>
diff --git a/help/C/troubleshooting-subtitles.page b/help/C/troubleshooting-subtitles.page
new file mode 100644
index 0000000..948bf89
--- /dev/null
+++ b/help/C/troubleshooting-subtitles.page
@@ -0,0 +1,60 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="guide"
+      id="troubleshooting-subtitles">
+
+  <info>
+    <link type="guide" xref="index#troubleshooting"/>
+    <link type="seealso" xref="subtitles"/>
+    <link type="seealso" xref="preferences"/>
+    <desc>I cannot load subtitles.</desc>
+    <credit type="author">
+      <name>Marta Bogdanowicz</name>
+      <email>majus85 gmail com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Problem with loading subtitles</title>
+
+  <p>
+  It may happen that, even though you follow instructions concerning subtitles
+  from <link xref="subtitles"/> page or <link xref="preferences"/> page,
+  <app>Totem</app> still does not load subtitles. The reason for that may be:
+  </p>
+
+  <list>
+    <item>
+      <p>Wrong name of the subtitles file - open the file chooser and check if
+      the name of the subtitles file is the same as the name of the movie file.
+      </p>
+    </item>
+    <item>
+      <p>Lack of the subtitles file - open the file chooser and check if there
+      is also a file with the subtitles in the directory with the movie.</p>
+    </item>
+  </list>
+
+  <p>If you do not have subtitles file for your movie, you can search for it
+  via <app>Totem</app>. Do it in the following way:</p>
+  <steps>
+    <item>
+      <p>Select <guiseq><gui style="menu">Edit</gui>
+      <gui style="menuitem">Pluginsâ</gui></guiseq>.</p>
+    </item>
+    <item>
+      <p>The <gui>Configure Plugins</gui> window will pop up.</p>
+    </item>
+    <item>
+      <p>Tick <gui>Subtitle Downloader</gui> option. It will try to find
+      and download subtitles for the currently played movie.</p>
+    </item>
+  </steps>
+
+  <note>
+  <p>Please notice that to search for subtitles you need to be connected
+  to the Internet.</p>
+  </note>
+
+</page>
diff --git a/help/Makefile.am b/help/Makefile.am
index ec63718..00b903a 100644
--- a/help/Makefile.am
+++ b/help/Makefile.am
@@ -6,24 +6,32 @@ DOC_ID = totem
 
 # List of figures to be included
 DOC_FIGURES = \
-	figures/totem-main-window.png \
+  figures/totem-main-window.png \
 
 # List of pages
 DOC_PAGES = \
-	adjustment-sound.page \
-	file-open.page \
-	file-save.page \
-	index.page \
-	introduction.page \
-	keyboard-shortcuts.page \
-	navigation.page \
-	playlist.page \
-	preferences.page \
-	properties.page \
-	screenshot.page \
-	screenshot-gallery.page \
-	sidebar.page \
-	subtitles.page
+  adjustment-sound.page \
+  adjustment-view.page \
+  file-open.page \
+  file-save.page \
+  index.page \
+  introduction.page \
+  keyboard-shortcuts.page \
+  navigation.page \
+  playing-DVD.page \
+  playing-order.page \
+  playlist.page \
+  plugins.page \
+  preferences.page \
+  properties.page \
+  screenshot-gallery.page \
+  screenshot.page \
+  sidebar.page \
+  subtitles.page \
+  supported-formats.page \
+  troubleshooting-Audio-CD.page \
+  troubleshooting-DVD.page \
+  troubleshooting-subtitles.page
 
 DOC_LINGUAS = bg ca cs da de el en_GB es eu fi fr gl it ja oc pa pl pt_BR ro ru sl sv uk zh_CN zh_HK zh_TW
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]