Update of the user guide and its translations.

git-svn-id: file:///srv/svn/repos/haiku/haiku/trunk@37659 a95241bf-73f2-0310-859d-f6bbb57e9c96
2010-07-21 15:52:50 +00:00
parent fb2d716a99
commit facb1eb9ad
70 changed files with 601 additions and 420 deletions
@@ -4,7 +4,7 @@
 <head>
 <!-- 
 *
- * Copyright 2009, Haiku. All rights reserved.
+ * Copyright 2009-2010, Haiku. All rights reserved.
 * Distributed under the terms of the MIT License.
 *
 * Authors:
@@ -40,7 +40,7 @@
 </ul>
 <span>
 «  <a href="poorman.html">PoorMan</a> 
-::  <a href="../applications.html#list-of-apps" class="uplink">Додатки (Applications)</a> 
+::  <a href="../applications.html#list-of-apps" class="uplink">Applications</a> 
 ::  <a href="showimage.html">Showimage</a>  »
 </span></div>
 </div>
@@ -52,35 +52,47 @@
 <h2><img src="../../images/apps-images/screenshot-icon_64.png" alt="screenshot-icon_64.png" width="64" height="64" />Screenshot</h2>
 <table summary="layout" border="0" cellspacing="0" cellpadding="2">
 <tr><td>Розташування в Deskbar:</td><td style="width:15px;"></td><td><span class="menu">Додатки(Applications)</span></td></tr>
-<tr><td>Розташування в Tracker:</td><td></td><td><span class="path">/boot/system/apps/Screenshot</span></td></tr>
+<tr><td>Розташування в Tracker:</td><td></td><td><span class="path">/boot/system/apps/Screenshot</span><br />
+<span class="path">/bin/screenshot</span></td></tr>
 <tr><td>Настройки розташовані за адресою:</td><td></td><td><span class="path">~/config/settings/screenshot</span></td></tr>
 </table>
 <p><br /></p>
-<p>Besides normal screenshots taken via <span class="key">PRINT</span>, which puts a PNG of the current screen into <span class="path">/boot/home/</span>, this application provides some useful options.</p>
+<p>Screenshots are taken by either starting the Screenshot application or by pressing the <span class="key">PRINT</span> key,</p>
 <p><img id="sreenshot" src="../images/apps-images/screenshot.png" alt="screenshot.png" /></p>
-<p>Starting Screenshot will take a screenshot as usual, but offers from its main window controls to set filename, format and folder before saving the image.</p>
-<p>The <span class="button">Options</span> dialog has a few more settings:</p>
-<p><img id="sreenshot-options" src="../images/apps-images/screenshot-options.png" alt="screenshot-options.png" /></p>
-<p>Besides the obvious, toggle between taking the whole screen or just the active window, including the window border and the mouse pointer, you can enter a delay before a screenshot is taken. Of course, this delay takes only effect if you take a new shot by pressing <span class="button">Take Screenshot</span>.</p>
-
+<p>In the Screenshot panel you can toggle between taking the whole screen or just the active window and decide if the window border and mouse pointer should be included. You can also enter a delay before a screenshot is taken.</p>
+<p>Below that you set the name, format and location for the screenshot that will be used when you click <span class="button">Save</span>. Instead of saving the file to disk you can also decide to <span class="button">Copy to clipboard</span> to be able to paste the shot directly into another application, or take a <span class="button">New screenshot</span>.</p>
+<p>All settings are remembered the next time you take a screenshot, enabling these convenient keyboard shortcuts:</p>
+<table summary="shortcuts" border="0" cellspacing="0" cellpadding="4">
+<tr><td><span class="key">PRINT</span></td><td style="width:15px;"></td><td>Takes a screenshot with zero delay and launches the Screenshot panel.</td></tr>
+<tr><td class="onelinetop"><span class="key">SHIFT</span> <span class="key">PRINT</span></td><td></td><td>Takes a screenshot silently (without opening the panel), while still respecting the last used settings.</td></tr>
+<tr><td><span class="key">CTRL</span> <span class="key">PRINT</span></td><td></td><td>Also takes a screenshot silently with the saved settings, but instead of saving it as a file, it's just copied to the clipboard.</td></tr>
+</table>
 <h2>
 <a href="#"><img src="../../images/up.png" style="border:none;float:right" alt="index" /></a>
 Taking a screenshot from Terminal</h2>
-<p>The Screenshot application is also usable from Terminal or a script.<br />
-<span class="cli">Screenshot --help</span> shows the familiar options as parameters:</p>
+<p>There's a special <span class="cli">screenshot</span> application to be used from Terminal or a script.<br />
+<span class="cli">screenshot --help</span> shows the familiar options as parameters:</p>

-<pre class="terminal">~&gt; Screenshot --help
+<pre class="terminal">~&gt; screenshot --help

-Screenshot [OPTION]... Creates a bitmap of the current screen
+screenshot [OPTIONS] [FILE]  Creates a bitmap of the current screen

-OPTION
-  -o, --options         Show options window first
+FILE is the optional output path / filename used in silent mode. An exisiting
+file with the same name will be overwritten without warning. If FILE is not
+given the screenshot will be saved to a file with the default filename in the
+user's home directory.
+
+OPTIONS
  -m, --mouse-pointer   Include the mouse pointer
  -b, --border          Include the window border
  -w, --window          Capture the active window instead of the entire screen
-  -d, --delay=seconds   Take screenshot after specified delay [in seconds]
-  -s, --silent          Saves the screenshot without showing the app window
-                        overrides --options, saves to home folder as png
+  -d, --delay=seconds   Take screenshot after the specified delay [in seconds]
+  -s, --silent          Saves the screenshot without showing the application
+                        window
+  -f, --format=image    Give the image format you like to save as
+                        [bmp], [gif], [jpg], [png], [ppm], [tga], [tif]
+  -c, --clipboard       Copies the screenshot to the system clipboard without
+                        showing the application window

 Note: OPTION -b, --border takes only effect when used with -w, --window
 </pre>
@@ -91,7 +103,7 @@ Note: OPTION -b, --border takes only effect when used with -w, --window
 <div class="nav">
 <div class="inner"><span>
 «  <a href="poorman.html">PoorMan</a> 
-::  <a href="../applications.html#list-of-apps" class="uplink">Додатки (Applications)</a> 
+::  <a href="../applications.html#list-of-apps" class="uplink">Applications</a> 
 ::  <a href="showimage.html">Showimage</a>  »
 </span></div>
 </div>
@@ -74,6 +74,9 @@
 <tr><td><span class="key">CTRL</span> <span class="key">ALT</span> <span class="key">F</span></td><td></td><td>Pulls the active window to the front (only applicable with the mouse setting <a href="preferences/mouse.html">Focus Follows Mouse</a>).</td></tr>
 <tr><td><span class="key">CTRL</span> <span class="key">ALT</span> <span class="key">B</span></td><td></td><td>Sends the active window to the back. </td></tr>
 <tr><td><span class="key">ALT</span> <span class="key">Q</span></td><td></td><td>Quits an application.</td></tr>
+<tr><td><span class="key">PRINT</span></td><td style="width:15px;"></td><td>Takes a screenshot with zero delay and launches the <a href="applications/screenshot.html">Screenshot</a> panel.</td></tr>
+<tr><td class="onelinetop"><span class="key">SHIFT</span> <span class="key">PRINT</span></td><td></td><td>Takes a screenshot silently (without opening the panel), while still respecting the last used settings.</td></tr>
+<tr><td><span class="key">CTRL</span> <span class="key">PRINT</span></td><td></td><td>Also takes a screenshot silently with the saved settings, but instead of saving it as a file, it's just copied to the clipboard.</td></tr>
 </table>

 <h2>