[Xfce4-commits] <xfce4-docs:ristretto-master> Describe preferences-dialog
Stephan Arts
noreply at xfce.org
Thu Nov 3 12:04:01 CET 2011
Updating branch refs/heads/ristretto-master
to 960f5a1713646455b45ebeada4fd6fd33cdc8a73 (commit)
from 30d5cd7f95207cbcb2e3e1ab4a5bd604174bced8 (commit)
commit 960f5a1713646455b45ebeada4fd6fd33cdc8a73
Author: Stephan Arts <stephan at xfce.org>
Date: Thu Nov 3 12:02:10 2011 +0100
Describe preferences-dialog
manual/getting-started.page | 2 +-
manual/preferences.page | 144 +++++++++++++++++++++++++++++++++++--------
2 files changed, 119 insertions(+), 27 deletions(-)
diff --git a/manual/getting-started.page b/manual/getting-started.page
index 455df6e..35ca184 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>
diff --git a/manual/preferences.page b/manual/preferences.page
index 2d68a9f..ed9afdd 100644
--- a/manual/preferences.page
+++ b/manual/preferences.page
@@ -16,55 +16,147 @@
</info>
<title>Preferences</title>
+ <p>
+ The behaviour and looks of <app>Ristretto</app> can be modified,
+ mostly through options displayed in the <gui>Preferences Dialog</gui>.
+ </p>
<section id="preferences-dialog">
<title>Preferences Dialog</title>
<p>
+ The Preferences dialog allows a user to configure different
+ aspects of <app>Ristretto</app>. These options are grouped
+ under the following tabs.
</p>
<section id="display-preferences">
- <title>Display preferences</title>
- <p>
- </p>
- <figure>
<title>Display preferences</title>
- <media type="image" src="media/preferences-display.png" mime="image/png" style="right"/>
- </figure>
+ <p>
+ </p>
+ <figure>
+ <title>Display preferences</title>
+ <media type="image" src="media/preferences-display.png" mime="image/png" style="right"/>
+ </figure>
+ <section>
+ <title>Override background color</title>
+ <p>
+ Did you notice how the background-color around the image was
+ the same as the rest of the window? It was themed by Gtk+,
+ when you enable this option, the theme-color is overridden by
+ whatever you set here.
+ Most people like it black, but there is no limitation to the
+ colors you can pick.
+ </p>
+ </section>
+ <section>
+ <title>Merge toolbars</title>
+ <p>
+ By default, <app>Ristretto</app> comes with two toolbars,
+ one containing the file-operations, and one for navigating
+ the opened images. If you want to reduce the amount of
+ space used for the different buttons, you can enable this
+ option and the two toolbars merge into one.
+ </p>
+ </section>
+ <section>
+ <title>Hide Thumbnailbar when fullscreen</title>
+ <p>
+ If the <app>Ristretto</app> window is fullscreen, you can
+ choose to automatically hide the thumbnailbar. Even though
+ the thumbnailbar is normally visible. This option overrides
+ the <keyseq><key>Control</key><key>t</key></keyseq>
+ shortcut for toggleing the visibility of the thumbnailbar.
+ </p>
+ </section>
</section>
<section id="slideshow-preferences">
- <title>Slideshow preferences</title>
- <p>
- </p>
- <figure>
<title>Slideshow preferences</title>
- <media type="image" src="media/preferences-slideshow.png" mime="image/png" style="right"/>
- </figure>
+ <p>
+ </p>
+ <figure>
+ <title>Slideshow preferences</title>
+ <media type="image" src="media/preferences-slideshow.png" mime="image/png" style="right"/>
+ </figure>
+ <section>
+ <title>Timeout</title>
+ <p>
+ When showing a slideshow of images, the value of this
+ slider determines how long <app>Ristretto</app> will show each image.
+ </p>
+ </section>
</section>
<section id="control-preferences">
- <title>Control preferences</title>
- <p>
- </p>
- <figure>
<title>Control preferences</title>
- <media type="image" src="media/preferences-control.png" mime="image/png" style="right"/>
- </figure>
+ <p>
+ </p>
+ <figure>
+ <title>Control preferences</title>
+ <media type="image" src="media/preferences-control.png" mime="image/png" style="right"/>
+ </figure>
+ <section>
+ <title>Revert zoom direction</title>
+ <p>
+ By default, <app>Ristretto</app> zooms <em>in</em> when
+ you turn the scroll-wheel forward, and zooms <em>out</em> when you turn
+ the scroll-wheel backward. For touch-pads, this can be awkward, because
+ a two-finger scroll is more of a pushing and pulling action.
+ With this option set, turning the scroll-wheel forward
+ will zoom <em>out</em> (pushing the image away) and turning the
+ scroll-wheel backward will zoom <em>in</em> (pulling the image closer).
+ </p>
+ </section>
</section>
<section id="behaviour-preferences">
- <title>Behaviour preferences</title>
- <p>
- </p>
- <figure>
<title>Behaviour preferences</title>
- <media type="image" src="media/preferences-behaviour.png" mime="image/png" style="right"/>
- </figure>
+ <p>
+ </p>
+ <figure>
+ <title>Behaviour preferences</title>
+ <media type="image" src="media/preferences-behaviour.png" mime="image/png" style="right"/>
+ </figure>
+ <section>
+ <title>Maximize window on startup when opening an image</title>
+ <p>
+ This option will automatically maximize the main window whenever
+ <app>Ristretto</app> is launched with a file argument.
+ </p>
+ </section>
+ <section>
+ <title>Wrap around images</title>
+ <p>
+ With this option set, <app>Ristretto</app> will wrap
+ around images. When pressing <gui>Next</gui> on the last image, or
+ <gui>Previous</gui> on the first image, it will jump to
+ the <em>Last</em> or <em>First</em> image respectively.
+ </p>
+ </section>
</section>
</section>
- <section id="advanced-preferences">
- <title>Advanced options</title>
+ <section id="advanced-preferences"> <title>Advanced options</title>
<p>
</p>
<section id="thunar-properties-dialog">
<title>Don't use Thunar to show the file-properties dialog</title>
<p>
+ By default, <app>Ristretto</app> will ask thunar to pop-up
+ the file-properties dialog. This way, you'll have the
+ advantage of all of thunar's plugins that extend it's file-properties
+ dialog beyond it's native functionality. Aswell as a consistent
+ look-and-feel throughout the xfce desktop.
+ </p>
+ <p>
+ However, there are some cases where you want <app>Ristretto</app> not
+ to use Thunar, but go for the build-in dialog all the times.
+ This can be the case when you have Thunar installed, but don't use it.
+ Launching the file-properties dialog from <app>Ristretto</app> will then
+ cause Thunar to be launched, making it a pretty expensive
+ dialog.
+ </p>
+ <p>
+ Being a somewhat advanced feature, this option is not
+ exposed through the preferences-dialog, and can only be enabled through
+ the <app>xfconf command-line utility</app> <cmd>xfconf-query</cmd>.
+ This can be done as followed:
</p>
+ <screen><output style="prompt">$ </output><input>xfconf-query -c ristretto -p /window/use-thunar-properties -n -t bool -s false</input></screen>
</section>
</section>
</page>
More information about the Xfce4-commits
mailing list