GNOME.org
 

[gnome-user-docs/wip/mdh: 3/3] gnome-help: update screenshot page (fixes #144)


commit 964afebe9f020a81e590383d56d58c8c40a03b8f
Author: Michael Hill <mdhillca gmail com>
Date:   Tue Apr 5 19:31:56 2022 -0400

    gnome-help: update screenshot page (fixes #144)

 gnome-help/C/figures/camera-photo-symbolic.svg |   7 +
 gnome-help/C/figures/camera-video-symbolic.svg |   4 +
 gnome-help/C/figures/screenshot-tool.png       | Bin 0 -> 148085 bytes
 gnome-help/C/keyboard-shortcuts-set.page       |  30 +---
 gnome-help/C/screen-shot-record.page           | 202 +++++++++++++++++--------
 gnome-help/C/shell-keyboard-shortcuts.page     |  19 +--
 gnome-help/Makefile.am                         |   3 +
 7 files changed, 164 insertions(+), 101 deletions(-)
---
diff --git a/gnome-help/C/figures/camera-photo-symbolic.svg b/gnome-help/C/figures/camera-photo-symbolic.svg
new file mode 100644
index 00000000..ad32b0df
--- /dev/null
+++ b/gnome-help/C/figures/camera-photo-symbolic.svg
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg height="16px" viewBox="0 0 16 16" width="16px" xmlns="http://www.w3.org/2000/svg";>
+    <g fill="#2e3434">
+        <path d="m 6.5 0 c -0.265625 0 -0.519531 0.105469 -0.707031 0.292969 l -1.707031 1.707031 h 
-1.085938 c -1.644531 0 -3 1.355469 -3 3 v 7 c 0 1.644531 1.355469 3 3 3 h 10 c 1.644531 0 3 -1.355469 3 -3 v 
-7 c 0 -1.644531 -1.355469 -3 -3 -3 h -1.085938 l -1.707031 -1.707031 c -0.1875 -0.1875 -0.441406 -0.292969 
-0.707031 -0.292969 z m 0.414062 2 h 2.171876 l 1.707031 1.707031 c 0.1875 0.1875 0.441406 0.292969 0.707031 
0.292969 h 1.5 c 0.570312 0 1 0.429688 1 1 v 7 c 0 0.570312 -0.429688 1 -1 1 h -10 c -0.570312 0 -1 -0.429688 
-1 -1 v -7 c 0 -0.570312 0.429688 -1 1 -1 h 1.5 c 0.265625 0 0.519531 -0.105469 0.707031 -0.292969 z m 0 0"/>
+        <path d="m 8 4 c -2.199219 0 -4 1.800781 -4 4 s 1.800781 4 4 4 s 4 -1.800781 4 -4 s -1.800781 -4 -4 
-4 z m 0 2 c 1.117188 0 2 0.882812 2 2 s -0.882812 2 -2 2 s -2 -0.882812 -2 -2 s 0.882812 -2 2 -2 z m 0 0"/>
+    </g>
+</svg>
diff --git a/gnome-help/C/figures/camera-video-symbolic.svg b/gnome-help/C/figures/camera-video-symbolic.svg
new file mode 100644
index 00000000..7b126f11
--- /dev/null
+++ b/gnome-help/C/figures/camera-video-symbolic.svg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg height="16px" viewBox="0 0 16 16" width="16px" xmlns="http://www.w3.org/2000/svg";>
+    <path d="m 7 3 c -1.644531 0 -3 1.355469 -3 3 v 1.425781 l -3.320312 -3.433593 h -0.679688 v 9 h 
0.644531 l 3.355469 -3.492188 v 1.5 c 0 1.644531 1.355469 3 3 3 h 6 c 1.644531 0 3 -1.355469 3 -3 v -5 c 0 
-1.644531 -1.355469 -3 -3 -3 z m 0 2 h 6 c 0.570312 0 1 0.429688 1 1 v 5 c 0 0.570312 -0.429688 1 -1 1 h -6 c 
-0.570312 0 -1 -0.429688 -1 -1 v -5 c 0 -0.570312 0.429688 -1 1 -1 z m 0 0" fill="#2e3434"/>
+</svg>
diff --git a/gnome-help/C/figures/screenshot-tool.png b/gnome-help/C/figures/screenshot-tool.png
new file mode 100644
index 00000000..aad3246d
Binary files /dev/null and b/gnome-help/C/figures/screenshot-tool.png differ
diff --git a/gnome-help/C/keyboard-shortcuts-set.page b/gnome-help/C/keyboard-shortcuts-set.page
index 382259d0..2fef10fd 100644
--- a/gnome-help/C/keyboard-shortcuts-set.page
+++ b/gnome-help/C/keyboard-shortcuts-set.page
@@ -8,12 +8,8 @@
     <link type="guide" xref="keyboard"/>
     <link type="seealso" xref="shell-keyboard-shortcuts"/>
 
-    <revision pkgversion="3.8.0" version="0.3" date="2013-03-23" status="review"/>
-    <revision pkgversion="3.9.92" date="2013-10-11" status="candidate"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="candidate"/>
-    <revision pkgversion="3.17.90" date="2015-08-30" status="candidate"/>
-    <revision pkgversion="3.29" date="2018-08-27" status="review"/>
     <revision version="gnome:40" date="2021-03-02" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-04-05"/>
 
     <credit type="author">
       <name>Michael Hill</name>
@@ -279,34 +275,22 @@
 <table rules="rows" frame="top bottom" ui:expanded="false">
 <title>Screenshots</title>
   <tr>
-       <td><p>Copy a screenshot of a window to clipboard</p></td>
-       <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Print</key></keyseq></p></td>
+       <td><p>Save a screenshot of a window</p></td>
+       <td><p><keyseq><key>Alt</key><key>Print</key></keyseq></p></td>
   </tr>
   <tr>
-       <td><p>Copy a screenshot of an area to clipboard</p></td>
-       <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Print</key></keyseq></p></td>
+       <td><p>Save a screenshot of the entire screen</p></td>
+       <td><p><keyseq><key>Shift</key><key>Print</key></keyseq></p></td>
   </tr>
   <tr>
-       <td><p>Copy a screenshot to clipboard</p></td>
-       <td><p><keyseq><key>Ctrl</key><key>Print</key></keyseq></p></td>
+       <td><p>Launch the screenshot tool</p></td>
+       <td><p><key>Print</key></p></td>
   </tr>
   <tr>
         <td><p>Record a short screencast</p></td>
         <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>R</key>
         </keyseq></p></td>
   </tr>
-  <tr>
-       <td><p>Save a screenshot of a window to Pictures</p></td>
-       <td><p><keyseq><key>Alt</key><key>Print</key></keyseq></p></td>
-  </tr>
-  <tr>
-       <td><p>Save a screenshot of an area to Pictures</p></td>
-       <td><p><keyseq><key>Shift</key><key>Print</key></keyseq></p></td>
-  </tr>
-  <tr>
-       <td><p>Save a screenshot to Pictures</p></td>
-       <td><p><key>Print</key></p></td>
-  </tr>
 </table>
 
 <table rules="rows" frame="top bottom" ui:expanded="false">
diff --git a/gnome-help/C/screen-shot-record.page b/gnome-help/C/screen-shot-record.page
index 28441ca9..9ff50937 100644
--- a/gnome-help/C/screen-shot-record.page
+++ b/gnome-help/C/screen-shot-record.page
@@ -1,13 +1,15 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      type="topic" style="task"
+      xmlns:if="http://projectmallard.org/if/1.0/";
+      xmlns:ui="http://projectmallard.org/ui/1.0/";
+      xmlns:its="http://www.w3.org/2005/11/its";
+      type="topic" style="task" version="1.0 if/1.0 ui/1.0"
       id="screen-shot-record">
-
+      
   <info>
     <link type="guide" xref="tips"/>
 
-    <revision pkgversion="3.6.1" date="2012-11-10" status="review"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
     <revision pkgversion="3.14.0" date="2015-01-14" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-04-05"/>
 
     <credit type="author copyright">
       <name>Tiffany Antopolski</name>
@@ -37,6 +39,14 @@
 
 <title>Screenshots and screencasts</title>
 
+  <list>
+    <item><p><gui>Capture all or part of your screen as an image</gui></p></item>
+    <item><p><gui>Send it as a file or paste it from the clipboard</gui></p></item>
+    <item><p><gui>Save a video of your screen activity</gui></p></item>
+  </list>
+
+  <media type="image" src="figures/screenshot-tool.png" width="500"/>
+
   <p>You can take a picture of your screen (a <em>screenshot</em>) or record a
   video of what is happening on the screen (a <em>screencast</em>). This is
   useful if you want to show someone how to do something on the computer, for
@@ -48,64 +58,62 @@
 
   <steps>
     <item>
-      <p>Open <app>Screenshot</app> from the
-      <gui xref="shell-introduction#activities">Activities</gui> overview.</p>
+      <p>Press the <key>Print</key> key or launch <app>Take a Screenshot</app>
+      from the <gui xref="shell-introduction#activities">Activities</gui>
+      overview.</p>
+    </item>
+    <item>
+      <p>The screenshot overlay presents you with handles to select the area to
+      capture, and
+      <media its:translate="no" type="image" src="figures/camera-photo-symbolic.svg"/>
+      indicates screenshot (still image) mode.</p>
+       <note>
+         <p>Click the pointer button to include the pointer in the screenshot.</p>
+       </note>
+    </item>
+    <item>
+      <p>Click and drag the area you want for the screenshot using the handles
+      or the crosshair pointer.</p>
     </item>
     <item>
-      <p>In the <app>Screenshot</app> window, select whether to grab the whole
-      screen, the current window, or an area of the screen. Set a delay if you
-      need to select a window or otherwise set up your desktop for the
-      screenshot.</p>
+       <p>To capture the selected area, click the big round button.</p>
     </item>
     <item>
-       <p>Click <gui>Take Screenshot</gui>.</p>
-       <p>If you selected <gui>Selection</gui>, the pointer changes
-       into a crosshair. Click and drag the area you want for the
-       screenshot.</p>
+       <p>To capture the entire screen, click <gui>Screen</gui> and then click
+       the big round button.</p>
     </item>
     <item>
-      <p>In the <gui>Save Screenshot</gui> window, enter a file name and choose
-      a folder, then click <gui>Save</gui>.</p>
-      <p>Alternatively, import the screenshot directly into an image-editing
-      application without saving it first. Click <gui>Copy to Clipboard</gui>
-      then paste the image in the other application, or drag the screenshot
-      thumbnail to the application.</p>
+       <p>To capture a window, click <gui>Window</gui>. An overview of all the
+       open windows is displayed with the active window checked. Click to choose
+       a window and then click the big round button.</p>
     </item>
   </steps>
 
-  <section id="keyboard-shortcuts">
-    <title>Keyboard shortcuts</title>
-
-    <p>Quickly take a screenshot of the desktop, a window, or an area at any
-    time using these global keyboard shortcuts:</p>
-
-    <list style="compact">
-      <item>
-        <p><key>Print Screen</key> to take a screenshot of the desktop.</p>
-      </item>
-      <item>
-        <p><keyseq><key>Alt</key><key>Print Screen</key></keyseq> to take a
-        screenshot of a window.</p>
-      </item>
-      <item>
-        <p><keyseq><key>Shift</key><key>Print Screen</key></keyseq> to take a
-        screenshot of an area you select.</p>
-      </item>
-    </list>
-
-    <p>When you use a keyboard shortcut, the image is automatically saved in
-    your <file>Pictures</file> folder in your home folder with a file name that
-    begins with <file>Screenshot</file> and includes the date and time it was
-    taken.</p>
-    <note style="note">
-      <p>If you do not have a <file>Pictures</file> folder, the images will be
-      saved in your home folder instead.</p>
-    </note>
-    <p>You can also hold down <key>Ctrl</key> with any of the above shortcuts
-    to copy the screenshot image to the clipboard instead of saving it.</p>
   </section>
+  
+  <section id="locations">
+  <title>Where do they go?</title>
 
-</section>
+  <list>
+    <item>
+      <p>A screenshot image is automatically saved in the
+      <file>Pictures/Screenshots</file> folder in your home folder with a file
+      name that begins with <file>Screenshot</file> and includes the date and
+      time it was taken.</p>
+    </item>
+    <item>
+      <p>The image is also saved in the clipboard, so you can immediately
+      paste it into an image-editing application or share it on social media.</p>
+    </item>
+    <item>
+      <p>A screencast video is automatically saved in your
+      <file>Videos/Screencasts</file> folder in your home folder, with a file
+      name that starts with <file>Screencast</file> and includes the date and
+      time it was taken.</p>
+    </item>
+  </list>
+    
+  </section>
 
 <section id="screencast">
   <title>Make a screencast</title>
@@ -114,29 +122,89 @@
 
   <steps>
     <item>
-      <p>Press
-      <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>R</key></keyseq>
-      to start recording what is on your screen.</p>
-      <p>A red circle is displayed in the top right corner of the screen
-      when the recording is in progress.</p>
+      <p>Press the <key>Print</key> key or launch <app>Take a Screenshot</app>
+      from the <gui xref="shell-introduction#activities">Activities</gui>
+      overview.</p>
+    </item>
+    <item>
+      <p>Click
+      <media its:translate="no" type="image" src="figures/camera-video-symbolic.svg"/>
+      to switch to screencast mode.</p>
+       <note>
+         <p>Click the pointer button to include the pointer in the screencast.</p>
+       </note>
+    </item>
+    <item>
+      <p>Choose <gui>Selection</gui> or <gui>Screen</gui>. For
+      <gui>Selection</gui>, click and drag the area you want for the screencast
+      using the handles or the crosshair pointer.</p>
     </item>
     <item>
-      <p>Once you have finished, press
-      <keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>R</key></keyseq>
-      again to stop the recording.</p>
+      <p>Click the big round red button to start recording what is on your
+      screen.</p>
+      <p>A red indicator is displayed in the top right corner of the screen
+      when the recording is in progress, showing the elapsed seconds.</p>
     </item>
     <item>
-      <p>The video is automatically saved in your <file>Videos</file> folder
-      in your home folder, with a file name that starts with
-      <file>Screencast</file> and includes the date and time it was taken.</p>
+      <p>Once you have finished, click the red indicator or press
+      <keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>R</key></keyseq>
+      to stop the recording.</p>
     </item>
   </steps>
 
-  <note style="note">
-    <p>If you do not have a <file>Videos</file> folder, the videos will be
-    saved in your home folder instead.</p>
-  </note>
-
 </section>
+  
+  <section id="keyboard-shortcuts">
+    <title>Keyboard shortcuts</title>
+
+    <p>Within the screenshot feature, you can use these keyboard shortcuts:</p>
+
+<table rules="rows" frame="top bottom">
+
+  <tr>
+    <td><p><key>S</key></p></td>
+    <td><p>Select area</p></td>
+  </tr>
+  <tr>
+    <td><p><key>C</key></p></td>
+    <td><p>Capture screen</p></td>
+  </tr>
+  <tr>
+    <td><p><key>W</key></p></td>
+    <td><p>Capture window</p></td>
+  </tr>
+  <tr>
+    <td><p><key>P</key></p></td>
+    <td><p>Toggle between show and hide pointer</p></td>
+  </tr>
+  <tr>
+    <td><p><key>V</key></p></td>
+    <td><p>Toggle between screenshot and screencast</p></td>
+  </tr>
+  <tr>
+    <td><p><key>Enter</key></p></td>
+    <td><p>Capture, also activated by <key>Space</key> or
+    <keyseq><key>Ctrl</key><key>C</key></keyseq></p></td>
+  </tr>
+</table>
+
+    <p>These shortcuts can be used to bypass the screenshot feature:</p>
+
+<table rules="rows" frame="top bottom">
+  <tr>
+    <td><p><keyseq><key>Alt</key><key>Print</key></keyseq></p></td>
+    <td><p>Capture the window that currently has focus</p></td>
+  </tr>
+  <tr>
+    <td><p><keyseq><key>Shift</key><key>Print</key></keyseq></p></td>
+    <td><p>Capture the entire screen</p></td>
+  </tr>
+  <tr>
+    <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>R</key></keyseq></p></td>
+    <td><p>Start and stop recording a screencast</p></td>
+  </tr>
+</table>
+
+  </section>
 
 </page>
diff --git a/gnome-help/C/shell-keyboard-shortcuts.page b/gnome-help/C/shell-keyboard-shortcuts.page
index 812a8fdd..114c658c 100644
--- a/gnome-help/C/shell-keyboard-shortcuts.page
+++ b/gnome-help/C/shell-keyboard-shortcuts.page
@@ -10,10 +10,8 @@
     <link type="guide" xref="shell-overview#apps"/>
     <link type="seealso" xref="keyboard-key-super"/>
 
-    <revision pkgversion="3.8.0" version="0.4" date="2013-04-23" status="review"/>
-    <revision pkgversion="3.13.92" date="2014-09-22" status="review"/>
-    <revision pkgversion="3.20" date="2016-08-13" status="candidate"/>
     <revision pkgversion="3.29" date="2018-08-27" status="review"/>
+    <revision version="gnome:42" status="final" date="2022-04-05"/>
 
     <credit type="author copyright">
       <name>Shaun McCance</name>
@@ -166,22 +164,21 @@ information on navigating user interfaces with only the keyboard.</p>
 <table rules="rows" frame="top bottom" ui:expanded="false">
 <title>Capturing from the screen</title>
   <tr>
-    <td><p><key>Print Screen</key></p></td>
-    <td><p><link xref="screen-shot-record#screenshot">Take a screenshot.</link></p></td>
+    <td><p><key>Print</key></p></td>
+    <td><p><link xref="screen-shot-record#screenshot">Launch the screenshot tool.</link></p></td>
   </tr>
   <tr>
-    <td><p><keyseq><key>Alt</key><key>Print Screen</key></keyseq></p></td>
+    <td><p><keyseq><key>Alt</key><key>Print</key></keyseq></p></td>
     <td><p><link xref="screen-shot-record#screenshot">Take a screenshot of a
      window.</link></p></td>
   </tr>
   <tr>
-    <td><p><keyseq><key>Shift</key><key>Print Screen</key></keyseq></p></td>
-    <td><p><link xref="screen-shot-record#screenshot">Take a screenshot of an
-    area of the screen.</link> The pointer changes to a crosshair. Click and
-    drag to select an area.</p></td>
+    <td><p><keyseq><key>Shift</key><key>Print</key></keyseq></p></td>
+    <td><p><link xref="screen-shot-record#screenshot">Take a screenshot of the
+    entire screen.</link>.</p></td>
   </tr>
   <tr>
-    <td><p><keyseq><key>Ctrl</key><key>Alt</key><key>Shift</key><key>R</key></keyseq></p></td>
+    <td><p><keyseq><key>Shift</key><key>Ctrl</key><key>Alt</key><key>R</key></keyseq></p></td>
     <td><p><link xref="screen-shot-record#screencast">Start and stop screencast
      recording.</link></p></td>
   </tr>
diff --git a/gnome-help/Makefile.am b/gnome-help/Makefile.am
index 6645a6e7..d3ba2995 100644
--- a/gnome-help/Makefile.am
+++ b/gnome-help/Makefile.am
@@ -9,6 +9,8 @@ HELP_LINGUAS = as ca cs da de el fa fi fr es gl gu he hi hr hu id it ja kn ko lv
 HELP_MEDIA = \
        figures/bluetooth-active-symbolic.svg \
        figures/bluetooth-symbolic.svg \
+       figures/camera-photo-symbolic.svg \
+       figures/camera-video-symbolic.svg \
        figures/classic-topbar-accessibility.svg \
        figures/classic-topbar-airplane-mode.svg \
        figures/classic-topbar-audio-volume-muted.svg \
@@ -82,6 +84,7 @@ HELP_MEDIA = \
        figures/printing-select.png \
        figures/rotation-allowed-symbolic.svg \
        figures/rotation-locked-symbolic.svg \
+       figures/screenshot-tool.png \
        figures/shell-activities-dash.png \
        figures/shell-appmenu-classic.png \
        figures/shell-appmenu-shell.png \
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]