Updating branch refs/heads/ristretto-master to 960f5a1713646455b45ebeada4fd6fd33cdc8a73 (commit) from 30d5cd7f95207cbcb2e3e1ab4a5bd604174bced8 (commit)
commit 960f5a1713646455b45ebeada4fd6fd33cdc8a73 Author: Stephan Arts <step...@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> _______________________________________________ Xfce4-commits mailing list Xfce4-commits@xfce.org https://mail.xfce.org/mailman/listinfo/xfce4-commits