[Xfce4-commits] <xfce4-docs:ristretto-master> Update getting-started page with viewing information

[Stephan Arts]

Updating branch refs/heads/ristretto-master
         to a1aa3372d6ca30a515ebbd9e2a06d5120c80a85e (commit)
       from 0e591ff7fb0cad2499a9514296a003cf4a6f0ef2 (commit)

commit a1aa3372d6ca30a515ebbd9e2a06d5120c80a85e
Author: Stephan Arts <stephan at xfce.org>
Date:   Sun Oct 30 01:00:02 2011 +0200

    Update getting-started page with viewing information

 manual/getting-started.page |   80 ++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 76 insertions(+), 4 deletions(-)

diff --git a/manual/getting-started.page b/manual/getting-started.page
index 2d20680..4c7b8b1 100644
--- a/manual/getting-started.page
+++ b/manual/getting-started.page
@@ -5,7 +5,7 @@
 
     <info>
         <link type="guide" xref="index#introduction"/>
-        <link type="seealso" xref="preferences"/>
+        <link type="seealso" xref="Preferences"/>
         <desc>Getting started with <app>Ristretto Image Viewer</app></desc>
         <credit type="author">
         <name>Stephan Arts</name>
@@ -19,16 +19,88 @@
     <title>Getting Started...</title>
     <p>
     When <app>Ristretto Image Viewer</app> is first started, it shows an
-    empty window with two toolbars. 
+    empty window with two toolbars.
     </p>
     <figure>
         <title>First Started</title>
         <media type="image" src="media/ristretto.png" mime="image/png" style="right"/>
     </figure>
+    <p>
+    Image-files can be opened using the <gui>Open</gui> button on the top
+    toolbar, or the <gui>File</gui> menu.
+    </p>
+    <section id="view">
+        <title>Viewing an image</title>
+        <p>
+        When an image is opened in ristretto, it might look like the
+        image below. Notice how a thumbnail-bar appears showing the
+        other images in the same folder as the one just opened.
+        </p>
+        <figure>
+            <title>Viewing an image</title>
+            <media type="image" src="media/view-images-1.png" mime="image/png" style="right"/>
+        </figure>
+        <section id="zooming">
+        <title>Zooming</title>
+        <p>
+        Showing an image like this is nice, but sometimes you want to
+        zoom in on a detail, get a closer look. To do this
+        <app>Ristretto</app> provides the ability to zoom in on a
+        section of the image. There are several ways to do zoom in on an image, 
+        </p>
+
+        <list type="upper-roman">
+        <item>
+        <p>
+        The first way to zoom is via the zoom buttons on the side toolbar.
+        It is possible to zoom in, out, to 100% or to make the image fit 
+        the screen. These buttons can also be reached from the 
+        <guiseq><gui>View</gui><gui>Zooming</gui></guiseq> menu.</p>
+        </item>
 
-    <section id="slideshow-settings">
-        <title>Configuring</title>
+        <item>
+        <p>
+        A second way is using the scroll-wheel on the mouse, Moving the
+        mouse-wheel forward zooms in on the image, moving the 
+        mouse-wheel backward will zoom out.</p>
+        <note style="advanced">
+        <p>
+        The zoom-direction of the mouse-wheel can be adjusted, see 
+        <link xref="preferences"/> for more details.
+        </p>
+        </note>
+        </item>
+        <item>
         <p>
+        The third, and last way to zoom on an image is using so-called
+        BOX-ZOOM, or selection-zoom. Press 
+        <keyseq><key>Control</key>Click</keyseq>, and drag the
+        mouse-cursor. This way a box appears, when the mouse-button is
+        released, <app>Ristretto</app> will zoom in on the selected
+        portion of the image.</p>
+        </item>
+        </list>
+        </section>
+        <section id="rotation">
+        <title>Rotating</title>
+        <p>
+        Sometimes, it is necessary to rotate an image because it is not
+        positioned in the right orientation. To solve this, you can use
+        the <gui>Rotate</gui> buttons on the toolbar.
+        </p>
+        <note style="tip">
+        <p>Some digital cameras store the image-orientation inside the
+        EXIF data. If this information is present, <app>Ristretto</app>
+        reads this information and automatically rotates the image.
+        </p>
+        </note>
+        <note style="important">
+        <p><app>Ristretto</app> does not provide a way to save the
+        altered orientation back into the file. If you want to modify
+        the image-data, this needs to be done with an image-editor, like
+        <app>The GIMP</app>.
         </p>
+        </note>
+        </section>
     </section>
 </page>