home *** CD-ROM | disk | FTP | other *** search
/ Mac Easy 2010 May / Mac Life Ubuntu.iso / casper / filesystem.squashfs / usr / share / gnome / help / totem / oc / totem.xml
Encoding:
Extensible Markup Language  |  2009-04-14  |  57.8 KB  |  1,172 lines

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  3. <!ENTITY legal SYSTEM "legal.xml">
  4. <!ENTITY appversion "2.26">
  5. <!ENTITY manrevision "3.0">
  6. <!ENTITY date "February 2009">
  7. <!ENTITY app "Totem Movie Player">
  8. <!-- Information about the entities
  9.        The legal.xml file contains legal information, there is no need to edit the file. 
  10.        Use the appversion entity to specify the version of the application.
  11.        Use the manrevision entity to specify the revision number of this manual.
  12.        Use the date entity to specify the release date of this manual.
  13.        Use the app entity to specify the name of the application. -->]>
  14. <!-- 
  15.       (Do not remove this comment block.)
  16.   Maintained by the GNOME Documentation Project
  17.   http://developer.gnome.org/projects/gdp
  18.   Template version: 2.0 beta
  19.   Template last modified Apr 11, 2002
  20. -->
  21. <!-- =============Document Header ============================= -->
  22. <article id="index" lang="oc">
  23. <!-- please do not change the id; for translations, change lang to -->
  24. <!-- appropriate code -->
  25.   <articleinfo> 
  26.     <title>Manual de <application>Totem Movie Player</application></title>       
  27.     <copyright> 
  28.       <year>2003</year> 
  29.       <holder>Chee Bin HOH</holder>
  30.     </copyright>
  31.     <copyright>
  32.       <year>2009</year>
  33.       <holder>Philip Withnall</holder>
  34.     </copyright>
  35.     <releaseinfo revision="2.26" role="final">
  36.         <ulink type="peerreview" url="http://bugzilla.gnome.org/show_bug.cgi?id=574524"/>
  37.     </releaseinfo>
  38.  
  39.     <abstract role="description">
  40.       <para><application>Totem Movie Player</application> is a media player for GNOME that runs on GStreamer by default, but can
  41. also be run on xine. It has support for most audio and video codecs including
  42. DVDs among many others. Features include TV-out, fullscreen,
  43. subtitles, and more.</para>
  44.     </abstract>
  45.  
  46.     <publisher> 
  47.       <publishername>Proj√®cte de documentacion de GNOME</publishername> 
  48.     </publisher> 
  49.  
  50.       <legalnotice id="legalnotice">
  51.     <para>
  52.       Permission is granted to copy, distribute and/or modify this
  53.       document under the terms of the GNU Free Documentation
  54.       License (GFDL), Version 1.1 or any later version published
  55.       by the Free Software Foundation with no Invariant Sections,
  56.       no Front-Cover Texts, and no Back-Cover Texts.  You can find
  57.       a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
  58.       distributed with this manual.
  59.          </para>
  60.          <para> This manual is part of a collection of GNOME manuals
  61.           distributed under the GFDL.  If you want to distribute this
  62.           manual separately from the collection, you can do so by
  63.           adding a copy of the license to the manual, as described in
  64.           section 6 of the license.
  65.     </para>
  66.  
  67.     <para>
  68.       Many of the names used by companies to distinguish their
  69.       products and services are claimed as trademarks. Where those
  70.       names appear in any GNOME documentation, and the members of
  71.       the GNOME Documentation Project are made aware of those
  72.       trademarks, then the names are in capital letters or initial
  73.       capital letters.
  74.     </para>
  75.  
  76.     <para>
  77.       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
  78.       UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
  79.       WITH THE FURTHER UNDERSTANDING THAT:
  80.  
  81.       <orderedlist>
  82.         <listitem>
  83.           <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
  84.                     WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
  85.                     IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
  86.                     THAT THE DOCUMENT OR MODIFIED VERSION OF THE
  87.                     DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
  88.                     A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
  89.                     RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
  90.                     OF THE DOCUMENT OR MODIFIED VERSION OF THE
  91.                     DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
  92.                     MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
  93.                     YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
  94.                     CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
  95.                     SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
  96.                     OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
  97.                     LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
  98.                     VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
  99.                     EXCEPT UNDER THIS DISCLAIMER; AND
  100.           </para>
  101.         </listitem>
  102.         <listitem>
  103.           <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
  104.                        THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
  105.                        CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
  106.                        INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
  107.                        DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
  108.                        OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
  109.                        PARTIES, BE LIABLE TO ANY PERSON FOR ANY
  110.                        DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
  111.                        CONSEQUENTIAL DAMAGES OF ANY CHARACTER
  112.                        INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
  113.                        OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
  114.                        MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
  115.                        LOSSES ARISING OUT OF OR RELATING TO USE OF THE
  116.                        DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
  117.                        EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
  118.                        THE POSSIBILITY OF SUCH DAMAGES.
  119.           </para>
  120.         </listitem>
  121.       </orderedlist>
  122.     </para>
  123.   </legalnotice>
  124.  
  125.  
  126.     <!-- This file  contains link to license for the documentation (GNU FDL), and 
  127.          other legal stuff such as "NO WARRANTY" statement. Please do not change 
  128.      any of this. -->
  129.  
  130.     <authorgroup> 
  131.       <author role="maintainer"> 
  132.     <firstname>Chee Bin</firstname> 
  133.     <surname>HOH</surname> 
  134.     <affiliation> 
  135.         <orgname>Proj√®cte de documentacion de GNOME</orgname> 
  136.       <address> <email>cbhoh@gnome.org</email> </address> 
  137.     </affiliation> 
  138.       </author>
  139.       <author>
  140.     <firstname>Baptiste</firstname> 
  141.     <surname>Mille-Mathias</surname> 
  142.     <affiliation> 
  143.       <orgname>Proj√®cte de documentacion de GNOME</orgname> 
  144.       <address> <email>baptiste.millemathias@gmail.org</email> </address> 
  145.   </affiliation>
  146.         <contrib>Metre a jorn la documentacion</contrib>      
  147.       </author>
  148.        <author>
  149.     <firstname>Philip</firstname> 
  150.     <surname>Withnall</surname> 
  151.     <affiliation> 
  152.       <address> <email>philip@tecnocode.co.uk</email> </address> 
  153.   </affiliation>
  154.         <contrib>Metre a jorn la documentacion</contrib>      
  155.       </author>   
  156.  
  157. <!-- This is appropriate place for other contributors: translators,
  158.      maintainers,  etc. Commented out by default.
  159.       <othercredit role="translator">
  160.     <firstname>Latin</firstname> 
  161.     <surname>Translator 1</surname> 
  162.     <affiliation> 
  163.           <orgname>Latin Translation Team</orgname> 
  164.         <address> <email>translator@gnome.org</email> </address> 
  165.         </affiliation>
  166.         <contrib>Latin translation</contrib>
  167.       </othercredit>
  168. -->
  169.     </authorgroup>
  170. <!-- According to GNU FDL, revision history is mandatory if you are -->
  171. <!-- modifying/reusing someone else's document.  If not, you can omit it. -->
  172. <!-- Remember to remove the &manrevision; entity from the revision entries other -->
  173. <!-- than the current revision. -->
  174. <!-- The revision numbering system for GNOME manuals is as follows: -->
  175. <!-- * the revision number consists of two components -->
  176. <!-- * the first component of the revision number reflects the release version of the GNOME desktop. -->
  177. <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
  178. <!-- For example, if the GNOME desktop release is V2.x, the first version of the manual that -->
  179. <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
  180. <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
  181. <!-- to V3.0, and so on. -->  
  182.     <revhistory>
  183.       <revision> 
  184.         <revnumber><application>Totem Movie Player</application> Manual V2.0</revnumber> 
  185.     <date>Agost de 2006</date> 
  186.     <revdescription> 
  187.       <para role="author">Chee Bin HOH <email>cbhoh@gnome.org</email></para>
  188.       <para role="publisher">Proj√®cte de documentacion de GNOME</para>
  189.         </revdescription> 
  190.       </revision>
  191.       <revision> 
  192.         <revnumber><application>Totem Movie Player</application> Manual V3.0</revnumber> 
  193.     <date>February 2009</date> 
  194.     <revdescription> 
  195.       <para role="author">Philip Withnall
  196.         <email>philip@tecnocode.co.uk</email>
  197.       </para>
  198.       <para role="publisher">Proj√®cte de documentacion de GNOME</para>
  199.         </revdescription> 
  200.       </revision>
  201.     </revhistory> 
  202.  
  203.     <releaseinfo>This manual describes version 2.26 of <application>Totem Movie Player</application>.
  204.     </releaseinfo> 
  205.     <legalnotice> 
  206.       <title>Feedback</title> 
  207.       <para>To report a bug or make a suggestion regarding the <application>Totem Movie Player</application> application or
  208.         this manual, follow the directions in the 
  209.         <ulink url="ghelp:user-guide#feedback" type="help">GNOME Feedback Page</ulink>. 
  210.       </para>
  211.     </legalnotice> 
  212.   </articleinfo> 
  213.  
  214.   <indexterm zone="index"> 
  215.     <primary>Totem Movie Player</primary> 
  216.   </indexterm> 
  217.   <indexterm zone="index"> 
  218.     <primary>totem</primary> 
  219.   </indexterm>
  220.  
  221.  
  222. <!-- ============= Document Body ============================= -->
  223. <!-- ============= Introduction ============================== -->
  224. <!-- Use the Introduction section to give a brief overview of what
  225.      the application is and what it does. -->
  226.   <sect1 id="totem-introduction"> 
  227.     <title>Introduccion</title> 
  228.     <para>The <application>Totem Movie Player</application> application is a movie player for the GNOME desktop based on
  229.       the GStreamer framework and xine library, and enables you to play movies or songs.
  230.     </para>
  231.     <para><application>Totem Movie Player</application> provides the following features:</para>
  232.     <itemizedlist> 
  233.       <listitem> 
  234.     <para>Support for a variety of video and audio files.</para>
  235.       </listitem>
  236.       <listitem>
  237.     <para>A variety of zoom levels and aspect ratios, and a fullscreen view.</para> 
  238.       </listitem>
  239.       <listitem>
  240.         <para>Seek and volume controls.</para>
  241.       </listitem>
  242.       <listitem>
  243.         <para>Una ti√®ra de lectura.</para>
  244.       </listitem>
  245.       <listitem>
  246.         <para>Subtitle support.</para>
  247.       </listitem>
  248.       <listitem>
  249.     <para>Complete keyboard navigation.</para>
  250.       </listitem>
  251.       <listitem>
  252.     <para>Comprehensive set of plugins, including a subtitle downloader, YouTube browser, and disc burner.</para>
  253.       </listitem>
  254.     </itemizedlist> 
  255.     <note>
  256.       <para><application>Totem Movie Player</application> also comes with additional functionality such as:
  257.       </para>
  258.       <itemizedlist>
  259.     <listitem>
  260.       <para>Video thumbnailer for GNOME.</para>
  261.         </listitem>
  262.         <listitem>
  263.       <para>Audio preview application for GNOME.</para>
  264.         </listitem>
  265.     <listitem>
  266.       <para>Nautilus properties tab.</para>
  267.         </listitem>
  268.       </itemizedlist>
  269.     </note>
  270.   </sect1>
  271. <!-- =========== End of Introduction ========================= -->
  272.  
  273. <!-- =========== Getting Started ============================= -->
  274. <!-- Use the Getting Started section to describe the steps required
  275.      to start the application and to describe the user interface components
  276.      of the application. If there is other information that it is important
  277.      for readers to know before they start using the application, you should
  278.      also include this information here. 
  279.      If the information about how to get started is very short, you can 
  280.      include it in the Introduction and omit this section. -->
  281.  
  282.   <sect1 id="totem-getting-started"> 
  283.     <title>Per comen√ßar</title> 
  284.  
  285.     <sect2 id="totem-start">
  286.       <title>To Start <application>Totem Movie Player</application></title>
  287.       <para>You can start <application>Totem Movie Player</application> in the following ways:
  288.       </para> 
  289.       <variablelist>
  290.     <varlistentry>
  291.       <term>Menut <guimenu>Applications</guimenu></term>
  292.       <listitem>
  293.         <para>Choose  
  294.               <menuchoice>
  295.         <guisubmenu>Sound & Video</guisubmenu>
  296.         <guimenuitem>Movie Player</guimenuitem>
  297.           </menuchoice>. 
  298.             </para>
  299.       </listitem>
  300.     </varlistentry>
  301.     <varlistentry>
  302.       <term>Linha de comanda</term>
  303.       <listitem>
  304.         <para>To start <application>Totem Movie Player</application> from a command line, type the following command, 
  305.               then press <keycap>Return</keycap>:</para>
  306.         <para> 
  307.             <command>totem</command> 
  308.             </para> 
  309.         <tip>
  310.           <para>To view other command line options that are available,
  311.                 type <command>totem --help</command>, then press <keycap>Return</keycap>.
  312.               </para>
  313.         </tip>
  314.       </listitem>
  315.     </varlistentry>
  316.       </variablelist>
  317.     </sect2>
  318.  
  319.     <sect2 id="totem-when-start">
  320.       <title>When You Start <application>Totem Movie Player</application></title>
  321.       <para>When you start <application>Totem Movie Player</application>, the following window is displayed.</para>
  322.  
  323.       <!-- ==== Figure ==== -->
  324.       <figure id="totem-start-fig"> 
  325.     <title><application>Totem Movie Player</application> Start Up Window</title> 
  326.     <screenshot> 
  327.       <mediaobject> 
  328.         <imageobject>
  329.           <imagedata fileref="figures/totem_start_window.png" format="PNG"/> 
  330.         </imageobject>
  331.         <textobject> 
  332.           <phrase>Shows <application>Totem Movie Player</application> main window with
  333.           sidebar opened on playlist. Contains
  334.           menubar, display area, sidebar, elapsed time slider, seek control
  335.           buttons, volume slider and statusbar.
  336.           </phrase>
  337.         </textobject> 
  338.       </mediaobject> 
  339.     </screenshot> 
  340.       </figure>
  341.       <!-- ==== End of Figure ==== -->
  342.  
  343.       <!-- Include any descriptions of the GUI immediately after the screenshot of the main UI, -->
  344.       <!-- for example, the items on the menubar and on the toolbar. This section is optional. -->
  345.       <para>The <application>Totem Movie Player</application> window contains the following elements:
  346.       </para>
  347.       <variablelist>
  348.     <varlistentry>
  349.       <term>Barra de menuts.</term>
  350.         <listitem>
  351.           <para>The menus on the menubar contain all of the commands you need to use in 
  352.             <application>Totem Movie Player</application>.</para>
  353.        </listitem>
  354.        </varlistentry>
  355.     <varlistentry>
  356.       <term>Display area.</term>
  357.       <listitem>
  358.         <para>The display area displays the movie or a visualization of the current song.
  359.             </para>
  360.       </listitem>
  361.     </varlistentry>
  362.     <varlistentry>
  363.       <term>Barra laterala.</term>
  364.       <listitem>
  365.         <para>The sidebar displays properties of the file played and acts as
  366.         playlist. It can also be used by various plugins, such as the MythTV, YouTube and Video
  367.         Search plugins. They can be selected by clicking on the drop-down list at the top of the sidebar.
  368.             </para>
  369.       </listitem>
  370.     </varlistentry>
  371.     <varlistentry>
  372.       <term>Elapsed time slider.</term>
  373.       <listitem>
  374.         <para>The elapsed time slider displays the elapsed time of the movie or song that is playing.
  375.               It also enables you to skip forward or backward in a movie or song by dragging the slider's handle along the bar,
  376.               or by clicking on a point on the bar.
  377.             </para>
  378.       </listitem>
  379.         </varlistentry>
  380.         <varlistentry>
  381.           <term>Seek control buttons.</term>
  382.           <listitem>
  383.             <para>The seek control buttons enable you to move to the next or previous track, and to pause or play
  384.               a movie or song.
  385.             </para>
  386.       </listitem>
  387.         </varlistentry>
  388.     <varlistentry>
  389.       <term>Volume button.</term>
  390.           <listitem>
  391.         <para>The volume button enables you to adjust the volume.</para>
  392.           </listitem>
  393.         </varlistentry>
  394.     <varlistentry>
  395.       <term>Statusbar.</term>
  396.       <listitem>
  397.         <para>The statusbar displays status information about the movie or song that is playing.</para>
  398.       </listitem>
  399.     </varlistentry>
  400.       </variablelist>
  401.     </sect2>
  402.   </sect1>
  403. <!-- =========== End of Getting Started ====================== -->
  404.  
  405. <!-- =========== Usage ======================================= -->
  406. <!-- Use this section to describe how to use the application to perform the tasks for 
  407.   which the application is designed. -->
  408.   <sect1 id="totem-usage"> 
  409.     <title>Utilizacion</title> 
  410.  
  411.     <!-- ================ Usage Subsection ================================ -->
  412.     <sect2 id="totem-open-file"> 
  413.       <title>Dobrir un fichi√®r</title> 
  414.       <para>To open a video or an audio file, choose
  415.         <menuchoice>
  416.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut>
  417.           <guimenu>Movie</guimenu>
  418.       <guisubmenu>Open</guisubmenu>
  419.         </menuchoice>.
  420.         The <application>Select Movies or Playlists</application> dialog is displayed.
  421.         Select the file or files you want to open, then click 
  422.     <guibutton>OK</guibutton>. 
  423.       </para>
  424.       <para>You can drag a file from another application such as a file manager to the
  425.         <application>Totem Movie Player</application> window. If you drag the file to the display area, the file will replace the current
  426.         playlist and will start playing immediately. If you drag the file to the playlist in the sidebar, the file will be
  427.         appended to the current playlist. The <application>Totem Movie Player</application> application
  428.         will open the file and play the movie or song. <application>Totem Movie Player</application> 
  429.         displays the title of the movie or song in the titlebar of
  430.         the window and in the playlist in the sidebar.
  431.       </para>
  432.       <para>If you try to open a file format that <application>Totem Movie Player</application> does
  433.     not recognize, the application displays an error message. This error is most often encountered
  434.     if you do not have the correct codecs installed. Information on getting codecs working can be found on
  435.     the <ulink url="http://projects.gnome.org/totem/#codecs" type="http"><application>Totem Movie Player</application> website</ulink>.
  436.       </para>
  437.       <tip>
  438.     <para>You can double-click on a video or an audio file in the <application>Nautilus</application>
  439.           file manager to open it in the <application>Totem Movie Player</application> window.
  440.         </para>
  441.       </tip>
  442.     </sect2> 
  443.  
  444.     <sect2 id="totem-usage-open-location">
  445.       <title>Dobrir un empla√ßament</title>
  446.       <para>To open a file by URI (location), choose
  447.         <menuchoice>
  448.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>L</keycap></keycombo></shortcut>
  449.       <guimenu>Movie</guimenu>
  450.       <guimenuitem>Open Location</guimenuitem>
  451.         </menuchoice>. The <application>Open Location</application> dialog is displayed. Use the drop-down
  452.         combination box to specify the URI you would like to open (it lists URIs which have
  453.         previously been opened) ‚Äì or type one in directly ‚Äì then click on the <guibutton>Open</guibutton> button.
  454.       </para>
  455.       <para>If you have a URI in the clipboard already, it will automatically be pasted into the combination box.</para>
  456.     </sect2>
  457.  
  458.     <sect2 id="totem-usage-play">
  459.       <title>To Play a Movie (DVD or VCD)</title>
  460.           <para>Insert the disc in the optical device of your computer, then choose
  461.               <menuchoice><guimenu>Movie</guimenu><guimenuitem>Play Disc</guimenuitem>
  462.               </menuchoice>.</para>
  463.              <para>To eject a DVD or VCD, choose 
  464.         <menuchoice>
  465.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo></shortcut>
  466.       <guimenu>Movie</guimenu>
  467.       <guimenuitem>Eject</guimenuitem>
  468.         </menuchoice>.
  469.       </para>
  470.        </sect2>
  471.  
  472.     <sect2 id="totem-usage-pause">
  473.       <title>To Pause a Movie or Song</title>
  474.       <para>To pause a movie or song that is playing, click on the 
  475.         <inlinemediaobject>
  476.       <imageobject><imagedata fileref="figures/totem_pause_button.png" format="PNG"/></imageobject>
  477.           <textobject><phrase>Shows pause button.</phrase></textobject>
  478.         </inlinemediaobject> button, or choose 
  479.         <menuchoice>
  480.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo></shortcut>
  481.       <guimenu>Movie</guimenu>
  482.           <guimenuitem>Play / Pause</guimenuitem>
  483.         </menuchoice>. You may also use the <keycap>P</keycap> key to pause or play a movie.
  484.       </para>
  485.       <para>To resume playing a movie or song, click on the 
  486.         <inlinemediaobject>
  487.       <imageobject><imagedata fileref="figures/totem_play_button.png" format="PNG"/></imageobject>
  488.           <textobject><phrase>Shows play button.</phrase></textobject>
  489.         </inlinemediaobject> button again, or choose 
  490.         <menuchoice>
  491.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>Space</keycap></keycombo></shortcut>
  492.       <guimenu>Movie</guimenu>
  493.           <guimenuitem>Play / Pause</guimenuitem>
  494.         </menuchoice>.
  495.       </para>
  496.     </sect2>
  497.  
  498.     <sect2 id="totem-usage-view-properties">
  499.       <title>To View Properties of a Movie or Song</title>
  500.       <para>To view the properties of a movie or song, choose 
  501.         <menuchoice>
  502.       <guimenu>View</guimenu>
  503.       <guimenuitem>Sidebar</guimenuitem></menuchoice> to make the sidebar
  504.       appear, and choose <guimenu>Properties</guimenu> in the drop-down list at the top of the sidebar.</para>
  505.     </sect2>
  506.  
  507.     <sect2 id="totem-usage-seek">
  508.       <title>To Seek Through Movies or Songs</title>
  509.       <para>To seek through movies or songs, you can use the following methods:
  510.       </para>
  511.       <variablelist>
  512.     <varlistentry>
  513.       <term>To skip forward</term>
  514.       <listitem>
  515.         <para>To skip forward through a movie or song, choose
  516.               <menuchoice>
  517.         <shortcut><keycap>Right</keycap></shortcut>
  518.                 <guimenu>Go</guimenu>
  519.         <guimenuitem>Skip Forward</guimenuitem>
  520.               </menuchoice>.
  521.             </para>
  522.           </listitem>
  523.         </varlistentry>
  524.     <varlistentry>
  525.       <term>To skip backward</term>
  526.       <listitem>
  527.         <para>To skip backwards through a movie or song, choose
  528.               <menuchoice>
  529.         <shortcut><keycap>Left</keycap></shortcut>
  530.                 <guimenu>Go</guimenu>
  531.         <guimenuitem>Skip Backwards</guimenuitem>
  532.               </menuchoice>.
  533.              </para>
  534.           </listitem>
  535.         </varlistentry>
  536.     <varlistentry>
  537.       <term>To skip to a time</term>
  538.       <listitem>
  539.         <para>To skip to a specific elapsed time in the movie or song, choose 
  540.               <menuchoice>
  541.         <shortcut><keycombo><keycap>Ctrl</keycap><keycap>K</keycap></keycombo></shortcut>
  542.                 <guimenu>Go</guimenu>
  543.         <guimenuitem>Skip to</guimenuitem>
  544.               </menuchoice>. The <application>Skip to</application> dialog is displayed. Use the 
  545.               spin box to specify the elapsed time (in seconds) to skip to, then
  546.               click <guibutton>OK</guibutton>.
  547.             </para>
  548.             <para>The spin box also allows more natural language to be used. You can enter a time in the
  549.             formats "hh:mm:ss", "mm:ss" or "ss"; where "hh" is the hour, "mm" is the minute and "ss" is the
  550.             second to skip to.
  551.             </para>
  552.           </listitem>
  553.         </varlistentry>
  554.     <varlistentry>
  555.       <term>To move to the next movie or song</term>
  556.       <listitem>
  557.         <para>To move to the next movie or song, choose 
  558.               <menuchoice>
  559.                 <shortcut><keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></shortcut>
  560.                 <guimenu>Go</guimenu>
  561.                 <guimenuitem>Next Chapter/Movie</guimenuitem>
  562.               </menuchoice> or click on the 
  563.               <inlinemediaobject> 
  564.             <imageobject><imagedata fileref="figures/totem_next_button.png" format="PNG"/></imageobject>
  565.             <textobject><phrase>Shows a seek next button</phrase></textobject>
  566.               </inlinemediaobject> button.
  567.             </para>
  568.           </listitem>
  569.         </varlistentry>
  570.     <varlistentry>
  571.       <term>To move to the previous movie or song</term>
  572.       <listitem>
  573.         <para>To move to the previous movie or song, choose 
  574.               <menuchoice>
  575.                 <shortcut><keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></shortcut>
  576.                 <guimenu>Go</guimenu>
  577.                 <guimenuitem>Previous Chapter/Movie</guimenuitem>
  578.               </menuchoice> or click on the
  579.               <inlinemediaobject> 
  580.             <imageobject><imagedata fileref="figures/totem_previous_button.png" format="PNG"/></imageobject>
  581.             <textobject><phrase>Shows a seek previous button</phrase></textobject>
  582.               </inlinemediaobject> button.
  583.             </para>
  584.           </listitem>
  585.         </varlistentry>
  586.       </variablelist>
  587.     </sect2>
  588.  
  589.     <sect2 id="totem-usage-change-zoom">
  590.       <title>To Change the Zoom Factor</title>
  591.       <sect3 id="totem-usage-change-size">
  592.         <title>To Change the Video Size</title>
  593.       <para>To change the zoom factor of the display area, you can use the 
  594.         following methods:
  595.       </para>
  596.       <itemizedlist>
  597.     <listitem>
  598.       <para>To zoom to fullscreen mode, choose
  599.       <menuchoice><shortcut><keycap>F11</keycap></shortcut>
  600.       <guimenu>View</guimenu><guimenuitem>Fullscreen</guimenuitem></menuchoice>. You can also
  601.       use the <keycap>F</keycap> key to toggle fullscreen mode.
  602.       To exit fullscreen mode, click on the
  603.             <guibutton>Leave Fullscreen</guibutton> button or press
  604.             <keycap>Esc</keycap>, <keycap>F11</keycap> or <keycap>F</keycap>.
  605.           </para>
  606.     </listitem>
  607.     <listitem>
  608.       <para>To change the size of the original movie or visualization,
  609.             choose 
  610.             <menuchoice>
  611.           <shortcut><keycombo><keycap>Ctrl</keycap><keycap>0</keycap></keycombo></shortcut>
  612.           <guimenu>View</guimenu><guimenuitem>Fit Window to Movie</guimenuitem>
  613.             </menuchoice> and choose a scale ratio.
  614.       </para>
  615.     </listitem>
  616.     </itemizedlist>
  617.     </sect3>
  618.      <sect3 id="totem-usage-change-ratio">
  619.         <title>To Change the Video Aspect Ratio</title>
  620.           <para>To switch between different aspect ratios, choose
  621.             <menuchoice>
  622.           <shortcut><keycap>A</keycap></shortcut>
  623.           <guimenu>View</guimenu>
  624.           <guisubmenu>Aspect Ratio</guisubmenu>
  625.             </menuchoice>.</para>
  626.       </sect3>
  627.     </sect2>
  628.  
  629.     <sect2 id="totem-usage-adjust-volume">
  630.       <title>To Adjust the Volume</title>
  631.       <para>To increase the volume, choose 
  632.         <menuchoice>
  633.       <shortcut><keycap>Up</keycap></shortcut>
  634.           <guimenu>Sound</guimenu>
  635.           <guimenuitem>Volume Up</guimenuitem>
  636.         </menuchoice>. 
  637.         To decrease the volume, choose
  638.         <menuchoice>
  639.       <shortcut><keycap>Down</keycap></shortcut>
  640.           <guimenu>Sound</guimenu>
  641.           <guimenuitem>Volume Down</guimenuitem>
  642.         </menuchoice>.         
  643.       </para>
  644.       <para>You can also use the volume button: click on the volume button and choose the volume level with the slider.</para>
  645.     </sect2>
  646.  
  647.     <sect2 id="totem-usage-on-top">
  648.       <title>To Make the Window Always on Top</title>
  649.       <para>To make the <application>Totem Movie Player</application> window always on top of other application windows,
  650.         choose
  651.         <menuchoice>
  652.           <guimenu>Edit</guimenu>
  653.           <guimenuitem>Plugins</guimenuitem>
  654.         </menuchoice>. Select the <guilabel>Always on Top</guilabel> plugin to enable it. The <application>Totem Movie Player</application> window will now stay on
  655.         top of all other windows while a movie is playing, but not while audio or visualizations are playing.
  656.        </para>
  657.        <para>To stop the window from always being on top, disable the <guilabel>Always on Top</guilabel> plugin again.
  658.        See <xref linkend="totem-plugins-always-on-top"/> for more information.</para>
  659.     </sect2>
  660.  
  661.     <sect2 id="totem-usage-show-control">
  662.       <title>To Show or Hide Controls</title>
  663.       <para>To show or hide the <application>Totem Movie Player</application> window controls, choose 
  664.         <menuchoice>
  665.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut>
  666.           <guimenu>View</guimenu>
  667.           <guimenuitem>Show Controls</guimenuitem>
  668.         </menuchoice>, or press the <keycap>H</keycap> key. 
  669.         You can also right-click on the <application>Totem Movie Player</application> window, then choose
  670.         <menuchoice>
  671.       <shortcut><keycombo><keycap>Ctrl</keycap><keycap>H</keycap></keycombo></shortcut>
  672.       <guimenuitem>Show Controls</guimenuitem>
  673.         </menuchoice> from the popup menu.
  674.       </para>
  675.       <para>If the <guilabel>Show Controls</guilabel> option is selected,
  676.         <application>Totem Movie Player</application> will show the menubar, elapsed time slider,
  677.         seek control buttons, volume slider and statusbar on the window. If
  678.         the <guilabel>Show Controls</guilabel> option is unselected, the application
  679.         will hide these controls and show only the display area.
  680.       </para>
  681.     </sect2>
  682.  
  683.     <sect2 id="totem-usage-playlist">
  684.       <title>Gerir una ti√®ra de lectura</title>
  685.  
  686.       <sect3 id="totem-usage-playlist-show-hide">
  687.     <title>To Show or Hide the Playlist</title>
  688.     <para>To show or hide the playlist, choose 
  689.           <menuchoice>
  690.         <guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem>
  691.           </menuchoice> or click on the <guibutton>Sidebar</guibutton> button, and
  692.           choose <guimenu>Playlist</guimenu> on the top of 
  693.           the sidebar.</para>
  694.       </sect3>
  695.  
  696.       <sect3 id="totem-usage-playlist-manage">
  697.     <title>Manage a Playlist</title>
  698.     <para>You can use the <application>Playlist</application> dialog to do the following:
  699.           <variablelist>
  700.         <varlistentry>
  701.           <term>Apondre una pista o un film</term>
  702.           <listitem>
  703.         <para>To add a track or movie to the playlist, click on the <guibutton>Add</guibutton>
  704.                   button. The <application>Select Movies or Playlists</application> dialog is displayed. Select the file that you 
  705.                   want to add to the playlist, then click <guibutton>Add</guibutton>.
  706.                 </para>
  707.               </listitem>
  708.             </varlistentry>
  709.         <varlistentry>
  710.           <term>Suprimir una pista o un film</term>
  711.           <listitem>
  712.         <para>To remove a track or movie from the playlist, select the item or items to remove from the
  713.                   playlist, then click on the <guibutton>Remove</guibutton> button.
  714.                 </para>
  715.               </listitem>
  716.         </varlistentry>
  717.         <varlistentry>
  718.           <term>To save the playlist to a file</term>
  719.           <listitem>
  720.         <para>To save the playlist to a file, click on the <guibutton>Save Playlist</guibutton>
  721.                   button. The <application>Save Playlist</application> dialog is displayed; specify
  722.                   the filename as which you want to save the playlist, and click <guibutton>Save</guibutton>.
  723.                 </para>
  724.               </listitem>
  725.         </varlistentry>
  726.         <varlistentry>
  727.           <term>To move a track or movie up the playlist</term>
  728.           <listitem>
  729.         <para>To move a track or movie up the playlist, select the item from the 
  730.                   playlist, then click on the <guibutton>Move Up</guibutton> button.
  731.                 </para>
  732.               </listitem>
  733.         </varlistentry>
  734.         <varlistentry>
  735.           <term>To move a track or movie down the playlist</term>
  736.           <listitem>
  737.         <para>To move a track or movie down the playlist, select the item from the 
  738.                   playlist, then click on the <guibutton>Move Down</guibutton> button.
  739.                 </para>
  740.               </listitem>
  741.         </varlistentry>
  742.           </variablelist>
  743.         </para>
  744.       </sect3>
  745.       <sect3 id="totem-usage-playlist-repeat">
  746.     <title>To Select or Unselect Repeat Mode</title>
  747.     <para>To enable or disable repeat mode, choose
  748.           <menuchoice><guimenu>Edit</guimenu><guimenuitem>Repeat Mode</guimenuitem></menuchoice>.
  749.         </para>
  750.       </sect3>
  751.       <sect3 id="totem-usage-playlist-shuffle">
  752.     <title>To Select or Unselect Shuffle Mode</title>
  753.     <para>To enable or disable shuffle mode, choose
  754.           <menuchoice><guimenu>Edit</guimenu><guimenuitem>Shuffle
  755.           Mode</guimenuitem></menuchoice>.
  756.         </para>
  757.       </sect3>
  758.     </sect2>
  759.  
  760.     <sect2 id="totem-usage-subtitle">
  761.       <title>To Choose Subtitles</title>
  762.       <para>To choose
  763.       the language of the subtitles, select
  764.       <menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu></menuchoice>
  765.       and choose the subtitle language you want to display.</para>
  766.       <para>To disable the display of subtitles, select
  767.       <menuchoice><guimenu>View</guimenu><guisubmenu>Subtitles</guisubmenu><guimenuitem>None</guimenuitem></menuchoice>.</para>
  768.       <note><para>By default, <application>Totem Movie Player</application> will choose the same language for the
  769.       subtitles as the one you normally use on your computer.</para></note>
  770.       <para><application>Totem Movie Player</application> will automatically load and display subtitles for a video if it finds a subtitle file with the
  771.       same name as the video being played, and the extension <filename>asc</filename>, <filename>txt</filename>,
  772.       <filename>sub</filename>, <filename>srt</filename>, <filename>smi</filename>, <filename>ssa</filename> or <filename>ass</filename>.
  773.       </para>
  774.       <para>If the file containing the subtitles has a different name from the video being played, you can
  775.       right-click on the video in the playlist and choose <menuchoice><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>
  776.       from the popup menu to load the correct subtitle file. You may also choose subtitles by choosing
  777.       <menuchoice><guimenu>View</guimenu><guimenuitem>Select Text Subtitles</guimenuitem></menuchoice>.</para>
  778.       <para>Using the <guilabel>Subtitles downloader</guilabel> plugin, you can also download subtitles from the OpenSubtitles service. See
  779.       <xref linkend="totem-plugins-opensubtitles"/> for more information.</para>
  780.     </sect2>
  781.  
  782.     <sect2 id="totem-usage-take-screenshot">
  783.       <title>To Take a Screenshot</title>
  784.       <para>To take a screenshot of the movie or visualization that is playing, choose 
  785.         <menuchoice>
  786.           <guimenu>Edit</guimenu>
  787.           <guimenuitem>Take Screenshot</guimenuitem>
  788.         </menuchoice>. The <application>Save Screenshot</application> dialog is displayed. Choose a location and
  789.     insert the filename as which you want to save the screenshot, then click on the <guibutton>Save</guibutton> button
  790.     to save the screenshot.
  791.       </para>
  792.       <tip><para><application>Totem Movie Player</application> will display a preview of the screenshot which is to be saved on the left-hand side of the <application>Save Screenshot</application> dialog.</para></tip>
  793.     </sect2>
  794.  
  795.     <sect2 id="totem-usage-create-screenshot-gallery">
  796.       <title>To Create a Screenshot Gallery</title>
  797.       <para>To create a gallery of screenshots of the movie or visualization that is playing, choose
  798.         <menuchoice>
  799.           <guimenu>Edit</guimenu>
  800.           <guimenuitem>Create Screenshot Gallery</guimenuitem>
  801.         </menuchoice>. The <application>Save Gallery</application> dialog is displayed. Choose a location and
  802.     insert the filename as which you want to save the gallery image, then click on the <guibutton>Save</guibutton> button
  803.     to save the screenshot.
  804.       </para>
  805.       <tip><para>You may specify the width of the individual screenshots in the gallery using the <guilabel>Screenshot width</guilabel> entry.
  806.       The default width is 128 pixels.</para>
  807.       <para>You may also specify the number of screenshots to be put in the gallery. By default, this is calculated based on the length of the movie;
  808.       however, this may be overridden by deselecting the <guilabel>Calculate the number of screenshots</guilabel> checkbox and entering the new
  809.       number in the <guilabel>Number of screenshots</guilabel> spin box.</para></tip>
  810.     </sect2>
  811.   </sect1>
  812.  
  813. <!-- =========== Plugins ======================================= -->
  814.   <sect1 id="totem-plugins">
  815.     <title>Plugins</title>
  816.     <para><application>Totem Movie Player</application> has many features which are present in the form of plugins ‚Äî pieces of the software which are only loaded
  817.       if necessary.</para>
  818.     <sect2 id="totem-plugins-load">
  819.       <title>To Enable a Plugin</title>
  820.       <para>To view the list of installed plugins, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Plugins</guimenuitem></menuchoice>. The
  821.         <application>Configure Plugins</application> dialog is displayed. On the left is a list of all the plugins you have installed, while on the right is
  822.         a description of the currently selected plugin. Plugins which have options which can be changed will have a sensitive <guibutton>Configure</guibutton>
  823.         button on the right.</para>
  824.       <para>To enable a plugin, simply select the checkbox to the left of its name in the plugin list, and the plugin will be loaded immediately. If
  825.         there is any error loading the plugin, an error dialog will also be displayed immediately.</para>
  826.       <para>To disable a plugin again, deselect its checkbox. Plugins will remain enabled or disabled as set even when <application>Totem Movie Player</application> is
  827.         closed.</para>
  828.     </sect2>
  829.     <sect2 id="totem-plugins-always-on-top">
  830.       <title>Always on Top</title>
  831.       <para>When enabled, the <guilabel>Always on Top</guilabel> plugin will force the main <application>Totem Movie Player</application> window to be on top of
  832.         all other windows while a movie is playing, but not while audio or visualizations are playing. To stop the window being on top, disable
  833.         the plugin again.</para>
  834.     </sect2>
  835.     <sect2 id="totem-plugins-coherence">
  836.       <title>Coherence DLNA/UPnP Client</title>
  837.       <para>The <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin allows <application>Totem Movie Player</application> to play multimedia content from
  838.         UPnP media servers (such as Coherence servers) on the local network.</para>
  839.       <para>With the <guilabel>Coherence DLNA/UPnP Client</guilabel> plugin enabled, choose
  840.         <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
  841.         <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Coherence DLNA/UPnP Client</guilabel> from the drop-down list at the
  842.         top of the sidebar to display the <guilabel>Coherence DLNA/UPnP Client</guilabel> sidebar.</para>
  843.       <para>The tree view in the sidebar will list the available media servers. Clicking on one will expand it to show the types of media it can serve,
  844.         and clicking on a media folder will expand it to list the media files available. Double-clicking on a media file will add it to
  845.         <application>Totem Movie Player</application>'s playlist and play it. You may alternatively right-click on a file and choose
  846.         <menuchoice><guimenuitem>Play</guimenuitem></menuchoice> or <menuchoice><guimenuitem>Enqueue</guimenuitem></menuchoice> to play the file
  847.         immediately or add it to the playlist, respectively.</para>
  848.       <para>If the media server allows it, choosing <menuchoice><guimenuitem>Delete</guimenuitem></menuchoice> from a file's context menu allows you to
  849.         delete that file from the media server.</para>
  850.     </sect2>
  851.     <sect2 id="totem-plugins-gromit">
  852.       <title>Gromit Annotations</title>
  853.       <para>The <guilabel>Gromit Annotations</guilabel> plugin allows you to draw on top of movies as they are played using
  854.         <ulink type="http" url="http://www.home.unix-ag.org/simon/gromit/"><application>Gromit</application></ulink>. You must have
  855.         <application>Gromit</application> installed before you can enable the plugin ‚Äî consult your operating system documentation for
  856.         information on how to do this.</para>
  857.       <para>With the plugin enabled, press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo> to toggle <application>Gromit</application>
  858.         on or off. When <application>Gromit</application> is enabled, your pointer will change to a crosshair. To draw on the screen, hold down your
  859.         mouse button and drag your pointer around, before releasing your mouse button. Press <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo>
  860.         again to toggle <application>Gromit</application> off.</para>
  861.       <para>To clear the screen of annotations, press <keycombo><keycap>Ctrl</keycap><keycap>E</keycap></keycombo>, or close
  862.         <application>Totem Movie Player</application>.</para>
  863.     </sect2>
  864.     <sect2 id="totem-plugins-jamendo">
  865.       <title>Jamendo</title>
  866.       <para>The <guilabel>Jamendo</guilabel> plugin allows you to listen to the collection of Creative Commons-licensed music on the
  867.         <ulink type="http" url="http://www.jamendo.com/en/">Jamendo</ulink> service.</para>
  868.       <sect3 id="totem-plugins-jamendo-configuration">
  869.         <title>To Configure the Plugin</title>
  870.         <para>The <guilabel>Jamendo</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the plugin,
  871.           and the <application>Jamendo Plugin Configuration</application> dialog will be displayed. Here, you can choose whether to download songs in Ogg or
  872.           MP3 format (Ogg is preferred due to its open-source nature); and the number of albums to retrieve when doing a search (choose more albums if
  873.           you have a faster Internet connection).</para>
  874.         <para>Once you're done, click <guibutton>OK</guibutton>.</para>
  875.       </sect3>
  876.       <sect3 id="totem-plugins-jamendo-setup">
  877.         <title>To Display the Jamendo Sidebar</title>
  878.         <para>With the <guilabel>Jamendo</guilabel> plugin enabled, choose
  879.           <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
  880.           <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Jamendo</guilabel> from the drop-down list at the top of the sidebar
  881.           to display the <guilabel>Jamendo</guilabel> sidebar.</para>
  882.       </sect3>
  883.       <sect3 id="totem-plugins-jamendo-search">
  884.         <title>To Search for Music</title>
  885.         <para>Enter your search terms in the search entry at the top of the <guilabel>Jamendo</guilabel> sidebar. You can search by either artist or
  886.           by tags. Click on the search button to start your search.</para>
  887.         <para>Search results will be displayed in the tree view in the <guilabel>Search Results</guilabel> page of the sidebar, and can be browsed
  888.           through using the arrow buttons at the bottom of the sidebar. Albums are listed, and if you click on an album, its tracks will be listed
  889.           below it. Click again to hide the album's tracks.</para>
  890.         <para>With an artist selected, you can click on the <guibutton>Jamendo Album Page</guibutton> button to open that album's page on the
  891.           Jamendo website. Double-clicking an album, or choosing <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from the album's
  892.           context menu, will replace your playlist with all the tracks on that album and begin streaming the first track from Jamendo's website.
  893.           Double-clicking an individual track will replace your playlist with just that track.</para>
  894.       </sect3>
  895.       <sect3 id="totem-plugins-jamendo-popular">
  896.         <title>Popular Albums and Latest Releases</title>
  897.         <para>Viewing the <guilabel>Popular</guilabel> page in the <guilabel>Jamendo</guilabel> sidebar will load a list of the most popular albums
  898.           on Jamendo at the moment, which can be played as with search results. Viewing the <guilabel>Latest Releases</guilabel> page will likewise
  899.           load a list of the latest albums released on Jamendo.</para>
  900.       </sect3>
  901.     </sect2>
  902.     <sect2 id="totem-plugins-tracker">
  903.       <title>Local Search</title>
  904.       <para>The <guilabel>Local Search</guilabel> plugin allows you to search for playable movies and audio files on your computer from within
  905.         <application>Totem Movie Player</application>. With the plugin enabled, choose
  906.         <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
  907.         <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>Local Search</guilabel> from the drop-down list at the top of the
  908.         sidebar to display the <guilabel>Local Search</guilabel> sidebar.</para>
  909.       <para>To perform a search, enter your search terms in the search entry at the top of the sidebar and click <guibutton>Find</guibutton>. Your
  910.         search terms may include wildcards such as <literal>*</literal>, which will match any character. For example, the search
  911.         <userinput>*.mpg</userinput> will find all movies with the <filename class="extension">.mpg</filename> file extension.</para>
  912.       <para>Search results may be browsed using the <guibutton>Back</guibutton> and <guibutton>Forward</guibutton> buttons at the bottom of the
  913.         sidebar, and you may jump to a specific results page by entering its number in the spin box.</para>
  914.     </sect2>
  915.     <sect2 id="totem-plugins-publish">
  916.       <title>Publish Playlist</title>
  917.       <para>The <guilabel>Publish Playlist</guilabel> plugin allows you to publish playlists on your local network to allow other computers to access
  918.         and play them.</para>
  919.       <sect3 id="totem-plugins-publish-configuration">
  920.         <title>To Configure the Plugin</title>
  921.         <para>The <guilabel>Publish Playlist</guilabel> plugin can be configured. Click on the <guibutton>Configure</guibutton> button when enabling the
  922.           plugin, and the configuration dialog will be displayed. Here, you can change the name which will appear for your playlist share. The following
  923.           strings will be replaced when playlists are published:
  924.           <variablelist>
  925.         <varlistentry>
  926.           <term><literal>%a</literal></term>
  927.           <listitem><para>Replaced with the program's name: <application>Totem Movie Player</application>.</para></listitem>
  928.         </varlistentry>
  929.         <varlistentry>
  930.           <term><literal>%h</literal></term>
  931.           <listitem><para>Replaced with your computer's host name.</para></listitem>
  932.         </varlistentry>
  933.         <varlistentry>
  934.           <term><literal>%u</literal></term>
  935.           <listitem><para>Replaced with your username.</para></listitem>
  936.         </varlistentry>
  937.         <varlistentry>
  938.           <term><literal>%U</literal></term>
  939.           <listitem><para>Replaced with your real name.</para></listitem>
  940.         </varlistentry>
  941.         <varlistentry>
  942.           <term><literal>%%</literal></term>
  943.           <listitem><para>Replaced with a literal percent sign.</para></listitem>
  944.         </varlistentry>
  945.       </variablelist>
  946.     </para>
  947.     <para>You can also select the <guilabel>Use encrypted transport protocol</guilabel> checkbox if you wish to encrypt the shared playlists when
  948.       they're transmitted over the network.</para>
  949.         <para>Once you're done, click <guibutton>Close</guibutton>.</para>
  950.       </sect3>
  951.       <sect3 id="totem-plugins-publish-publishing">
  952.         <title>To Publish Playlists</title>
  953.         <para>With the plugin enabled, you do not need to explicitly publish playlists; they are automatically made available on the network as
  954.           a Zeroconf website.</para>
  955.       </sect3>
  956.       <sect3 id="totem-plugins-publish-neighborhood">
  957.         <title>To Browse your Neighborhood</title>
  958.         <para>To view the shared playlists of others on your network, select <guilabel>Neighborhood</guilabel> from the drop-down list at the top of the
  959.           sidebar. If any playlists have been published on the network, they will be listed here. Double-click on a playlist to load and play it on
  960.           your computer.</para>
  961.       </sect3>
  962.     </sect2>
  963.     <sect2 id="totem-plugins-opensubtitles">
  964.       <title>Subtitles downloader</title>
  965.       <para>The <guilabel>Subtitles downloader</guilabel> plugin allows you to find and download subtitle files from the
  966.         <ulink type="http" url="http://www.opensubtitles.org/en">OpenSubtitles</ulink> service.</para>
  967.       <para>Subtitles can only be downloaded for local movies; not audio files, DVDs, DVB streams, VCDs or HTTP streams. To search for subtitles for
  968.         the currently playing movie, choose <menuchoice><guimenu>View</guimenu><guimenuitem>Download Movie Subtitles</guimenuitem></menuchoice>, which
  969.         will display the <application>Download Movie Subtitles</application> dialog.</para>
  970.       <para>Select the language in which you wish to have your subtitles from the drop-down list at the top of the dialog, then click on the
  971.         <guibutton>Find</guibutton> button to search for subtitles for the current movie. Subtitles are found on the basis of the movie's content,
  972.         rather than its filename or tags.</para>
  973.       <para>Search results are listed in the tree view in the middle of the dialog. Currently, subtitles can only be used with a movie by
  974.         <emphasis>reloading</emphasis> the movie with the subtitles, so after selecting the subtitle file you wish to download, click on the
  975.         <guibutton>Play with Subtitle</guibutton> button to download the subtitles and reload the movie.</para>
  976.       <note><para>Downloaded subtitle files are cached so that they do not need to be downloaded again when playing the movie again. When downloading
  977.         new subtitles for a movie, any previously downloaded subtitles for that movie are deleted.</para></note>
  978.     </sect2>
  979.     <sect2 id="totem-plugins-thumbnail">
  980.       <title>Thumbnail</title>
  981.       <para>The <guilabel>Thumbnail</guilabel> plugin sets <application>Totem Movie Player</application>'s main window icon to a thumbnail of the current movie,
  982.         and updates the icon when new movies are loaded.</para>
  983.       <note><para>If a thumbnail doesn't exist for the current movie (or if you're playing an audio file), the main window icon will be reset to the
  984.         <application>Totem Movie Player</application> logo.</para></note>
  985.     </sect2>
  986.     <sect2 id="totem-plugins-brasero">
  987.       <title>Video Disc Recorder</title>
  988.       <para>The <guilabel>Video Disc Recorder</guilabel> plugin allows you to burn the current playlist to a DVD or VCD using <application>Brasero</application>.</para>
  989.       <para>To burn the current playlist, choose <menuchoice><guimenu>Movie</guimenu><guimenuitem>Create Video Disc</guimenuitem></menuchoice>.
  990.         A <application>Brasero</application> dialog will be displayed, giving options for converting the movies to the appropriate format and burning them to disc. For more
  991.         information, see the <ulink type="help" url="ghelp:brasero?brasero-new-project-video">Brasero documentation</ulink>.</para>
  992.     </sect2>
  993.     <sect2 id="totem-plugins-youtube">
  994.       <title>YouTube browser</title>
  995.       <para>The <guilabel>YouTube browser</guilabel> plugin allows you to search and browse
  996.         <ulink type="http" url="http://www.youtube.com/">YouTube</ulink>, and play YouTube videos directly in
  997.         <application>Totem Movie Player</application>. With the plugin enabled, choose
  998.         <menuchoice><shortcut><keycap>F9</keycap></shortcut><guimenu>View</guimenu><guimenuitem>Sidebar</guimenuitem></menuchoice> or click on the
  999.         <guibutton>Sidebar</guibutton> button to show the sidebar. Select <guilabel>YouTube</guilabel> from the drop-down list at the top of the
  1000.         sidebar to display the <guilabel>YouTube</guilabel> sidebar.</para>
  1001.       <para>To search for a YouTube video, enter your search terms in the entry at the top of the sidebar, then click <guibutton>Find</guibutton>.
  1002.         The search results will be listed in the tree view below. More results will be loaded automatically as you scroll down the list.</para>
  1003.       <para>To play a video, double-click it in the results list, or choose <menuchoice><guimenuitem>Add to Playlist</guimenuitem></menuchoice> from
  1004.         its context menu. When a video is played, a list of related videos will automatically be loaded in the <guilabel>Related Videos</guilabel>
  1005.         page of the <guilabel>YouTube</guilabel> sidebar.</para>
  1006.       <para>YouTube videos can be opened in a web browser by choosing <menuchoice><guimenuitem>Open in Web Browser</guimenuitem></menuchoice> from
  1007.         their context menu. This will open the video in its original location on the YouTube website.</para>
  1008.     </sect2>
  1009.   </sect1>
  1010.  
  1011. <!-- =========== Usage ======================================= -->
  1012. <!-- Use this section to describe how to customize the 
  1013.      application. -->
  1014.   <sect1 id="totem-prefs">
  1015.     <title>Prefer√©ncias</title>
  1016.     <para>To modify the preferences of <application>Totem Movie Player</application>, choose
  1017.       <menuchoice>
  1018.         <guimenu>Edit</guimenu>
  1019.     <guimenuitem>Preferences</guimenuitem>
  1020.       </menuchoice>.</para>
  1021.  
  1022.     <sect2 id="totem-prefs-general">
  1023.       <title>General</title>
  1024.       <variablelist>
  1025.     <varlistentry>
  1026.       <term>Ret</term>
  1027.       <listitem>
  1028.         <para>Select network connection speed from the <guilabel>Connection speed</guilabel> 
  1029.               drop-down list.
  1030.             </para>
  1031.           </listitem>
  1032.         </varlistentry>    
  1033.     <varlistentry>
  1034.       <term>Text Subtitles</term>
  1035.       <listitem>
  1036.         <itemizedlist>
  1037.           <listitem>
  1038.               <para><guilabel>Automatically load subtitle files</guilabel>: select this option to automatically load any subtitle
  1039.               files with the same filename as a movie when the movie is loaded.</para>
  1040.           </listitem>
  1041.           <listitem>
  1042.                 <para><guilabel>Font</guilabel>: select this option to change
  1043.                 the font used to display subtitles.</para>
  1044.               </listitem>
  1045.               <listitem>
  1046.                 <para><guilabel>Encoding</guilabel>: select this option to change the
  1047.                 encoding used to display subtitles.</para>
  1048.               </listitem>
  1049.             </itemizedlist>
  1050.           </listitem>
  1051.         </varlistentry>    
  1052.       </variablelist>
  1053.     </sect2>
  1054.     <sect2 id="totem-prefs-display">
  1055.       <title>Visualizar</title>
  1056.       <variablelist>
  1057.     <varlistentry>
  1058.       <term>Visualizar</term>
  1059.       <listitem>
  1060.         <para>Select the resize option if you want <application>Totem Movie Player</application>
  1061.               to automatically resize the window to the size of the video when a new video is loaded.
  1062.             </para>
  1063.           </listitem>
  1064.           <listitem>
  1065.             <para>Select the screensaver option if you want to allow the screensaver to activate when
  1066.             playing audio files. Some monitors with integrated speakers may stop playing music when the screensaver is activated.</para>
  1067.           </listitem>
  1068.         </varlistentry>
  1069.     <varlistentry>
  1070.       <term>Visual Effects</term>
  1071.       <listitem>
  1072.         <itemizedlist>
  1073.           <listitem>
  1074.                 <para><guilabel>Visual</guilabel>: select this option to show visual effects
  1075.                   while an audio file is playing.
  1076.                 </para>
  1077.               </listitem>
  1078.           <listitem>
  1079.         <para><guilabel>Type of visualization</guilabel>: select type of visualization from the
  1080.                   drop-down list.
  1081.                 </para>
  1082.               </listitem>
  1083.           <listitem>
  1084.         <para><guilabel>Visualization size</guilabel>: select visualization size from the
  1085.                   drop-down list.
  1086.                 </para>
  1087.               </listitem>
  1088.             </itemizedlist>
  1089.           </listitem>
  1090.         </varlistentry>
  1091.     <varlistentry>
  1092.       <term>Color balance</term>
  1093.       <listitem>
  1094.         <itemizedlist>
  1095.           <listitem>
  1096.             <para><guilabel>Brightness</guilabel>: use the slider to specify the level of brightness.</para>
  1097.           </listitem>
  1098.           <listitem>
  1099.              <para><guilabel>Contrast</guilabel>: use the slider to specify the level of contrast.</para>
  1100.           </listitem>
  1101.           <listitem>
  1102.             <para><guilabel>Saturation</guilabel>: use the slider to specify the
  1103.             level of saturation.</para>
  1104.           </listitem>
  1105.           <listitem>
  1106.              <para><guilabel>Hue</guilabel>: use the slider to specify the level
  1107.              of hue.</para>
  1108.           </listitem>
  1109.         </itemizedlist>
  1110.         <tip><para>You may use the <guilabel>Reset To Defaults</guilabel> button to reset the color balance controls to their
  1111.         default positions.</para></tip>
  1112.       </listitem>
  1113.     </varlistentry>
  1114.       </variablelist>
  1115.     </sect2>
  1116.     <sect2 id="totem-prefs-audio">
  1117.       <title>Audio</title>
  1118.       <variablelist>
  1119.     <varlistentry>
  1120.       <term>Audio Output</term>
  1121.       <listitem>
  1122.         <para>Select audio output type from the <guilabel>Audio output type</guilabel>
  1123.               drop-down list.
  1124.             </para>
  1125.           </listitem>
  1126.         </varlistentry>
  1127.       </variablelist>
  1128.     </sect2>
  1129.   </sect1>
  1130.  
  1131. <!-- ============= Bugs ================================== -->
  1132. <!-- This section is optional and is commented out by default. 
  1133.      You can use it to describe known bugs and limitations of the 
  1134.       program if there are any - please be frank and list all
  1135.      problems you know of. 
  1136.   
  1137.   <sect1 id="mayapp-bugs">
  1138.   <title>Known Bugs and Limitations</title>
  1139.   <para> </para>
  1140.  </sect1>
  1141. -->
  1142.  
  1143. <!-- ============= About ================================== -->
  1144. <!-- This section contains info about the program (not docs), such as
  1145.       author's name(s), web page, license, feedback address. This
  1146.       section is optional: primary place for this info is "About.." box of
  1147.       the program. However, if you do wish to include this info in the
  1148.       manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
  1149.   <sect1 id="totem-about"> 
  1150.     <title>A prepaus de <application>Totem Movie Player</application></title> 
  1151.     <para><application>Totem Movie Player</application> is written by
  1152.       Bastien Nocera (<email>hadess@hadess.net</email>),
  1153.       Julien Moutte (<email>julien@moutte.net</email>) for the GStreamer backend,
  1154.       and Guenter Bartsch (<email>guenter@users.sourceforge.net</email>).
  1155.       To find more information about <application>Totem Movie Player</application>, please visit the 
  1156.       <ulink url="http://projects.gnome.org/totem/" type="http"><application>Totem Movie Player</application> 
  1157.       website</ulink>. 
  1158.     </para>
  1159.     <para>
  1160.       To report a bug or make a suggestion regarding the <application>Totem Movie Player</application> application or
  1161.       this manual, follow the directions in the 
  1162.       <ulink url="ghelp:user-guide#feedback" type="help">GNOME Feedback Page</ulink>. 
  1163.     </para>
  1164.     <para> This program is distributed under the terms of the GNU
  1165.       General Public license as published by the Free Software
  1166.       Foundation; either version 2 of the License, or (at your option)
  1167.       any later version. A copy of this license can be found at this
  1168.       <ulink url="ghelp:gpl" type="help">link</ulink>, or in the file
  1169.       COPYING included with the source code of this program. </para>
  1170.   </sect1> 
  1171. </article>
  1172.