New page Sugar features and shift links

Signed-off-by: Iain Brown Douglas <iain@browndouglas.plus.com>

6 files changed, 87 insertions, 11 deletions

diff --git a/source/gnome.rst b/source/gnome.rst
index 0f7c283..c6134a6 100644
--- a/source/gnome.rst
+++ b/source/gnome.rst
@@ -1,5 +1,5 @@
 =====
-Gnome
+GNOME
 =====
 
 In late 2009 OLPC added a more conventional desktop environment called GNOME to its operating system. This is intended for older children and advanced users.
diff --git a/source/journal.rst b/source/journal.rst
index 0261cf9..f7a057f 100644
--- a/source/journal.rst
+++ b/source/journal.rst
@@ -17,6 +17,11 @@ To show the Journal, click the Journal icon on the Frame.
 
 On an XO laptop, you can press the magnifying glass key in the top row of the keyboard to immediately open the Journal and search.
 
+|journal| **Seen in an Activity**, this icon on the Activity toolbar (or Activity tab) allows quick access to the Journal, to add a description, or further notes to yourself about what you are going to do, or have done in that session of the Activity.
+
+.. |journal| image:: ../images/journal_qa.png
+
+
 Journal features
 ----------------
 
@@ -54,7 +59,7 @@ The Detail view appears when you click the Detail view button for an entry. This
 *  8 - Favorites Icon: This icon indicates whether an entry has been starred as a favorite which can be done by clicking it.
 *  9 - Thumbnail image: Each entry has a thumbnail image that is created automatically. The image show the Activity screen when the last change to the Journal entry was saved.
 *  10 - Participants: Displays the XO icons of each person who participated in a shared Activity. 
-*  11 - Comments:  Comments by the joiners will be displayed here. The comments will be from Portfolio activity and from journal share.
+*  11 - Comments: Comments by the joiners will be displayed here. The comments will be from Portfolio activity and from journal share.
 *  12 - Tags field: You can enter search tags. Tags are keywords used to describe a journal entry so that you can find it later using the Search box. For example, if your project is for school, maybe science class, and it is a report about local flowers, you could put "science" and "flowers" as the tags. You can write as many tags as you wish. You can also use keywords to help you "group" this entry, for instance by origin or context.
 *  13 - Description field: You can type a description of the entry, which you can find later using the Search box. Use a description to remind you of what you did. For example: "Flowers I saw on the hike to the waterfall". Or you can reflect on your work and process: what I have done; how I have done it; and how successful these efforts have been. "This was not easy, but I learned a lot about different types of flowers in my community by speaking with my family". This is important because these description can be shown in the reflection Activity called "Portfolio".
 
diff --git a/source/paint.rst b/source/paint.rst
index 5a79640..63f34d5 100644
--- a/source/paint.rst
+++ b/source/paint.rst
@@ -36,7 +36,7 @@ The Activity tab
 
 .. image :: ../images/Paint1ActTab.png
 
-Activity tab. Here you may name the project, and access the :doc:`/journal`, to provide a description. Try to get in the habit of re-naming the project before you start work.  Move the cursor over the existing title, click the left mouse button, and start typing a name for the project. Your new name will overwrite the original.
+Activity tab, here you can enter a name for the page or project, the "pencil and book" icon allows :ref:`journal_qa` to provide a description. Try to get in the habit of re-naming the project before you start work.  Move the cursor over the existing title, click the left mouse button, and start typing a name for the project. Your new name will overwrite the original.
 
 The collaboration button is grayed out, see :ref:`Share`.
 
diff --git a/source/record.rst b/source/record.rst
index 394c043..316c69d 100644
--- a/source/record.rst
+++ b/source/record.rst
@@ -40,11 +40,11 @@ Record features in detail
 
 **Toolbar and capture buttons explained**
 
-1. Activity tab. Here you can enter a name for the project, access the Journal, to provide a description, and select Private, or My Neighbourhood, see :ref:`Sharing Media`.
+1. Activity tab, here you can enter a name for the page or project, the "pencil and book" icon allows :ref:`journal_qa` to provide a description, and select Private, or My Neighbourhood, see :ref:`Sharing Media`.
 
 2. Picture camera mode is selected.
 
-3. Video camera mode button.  Press to switch to Video camera mode.
+3. Video camera mode button. Press to switch to Video camera mode.
 
 4. Audio recording mode button. Press to switch to Audio recording mode.
 
@@ -136,7 +136,7 @@ A field, in which to enter a title for the photo appears **2**. The title “Cor
 
 At the bottom right of the main image is a little tab, **3**, which allows you to find out more about the photo that was taken. Now pressing that tab **4** reveals the image information, author, date, and a space to add tags. A tag is a single word that helps categorize an item.
 
-The tray displays a history of your previously taken photos. When you have more photos  in the tray the *scroll button* **5** scrolls through the images.
+The tray displays a history of your previously taken photos. When you have more photos in the tray the *scroll button* **5** scrolls through the images.
 
 To replay a video or audio recording, click the thumbnail of the recording in the tray. When viewing or listening to a clip, if you move your cursor in the main image area, you see small window **6**, representing the output of your camera or microphone. Click on that window to return from *viewer* mode to *capture* mode.
 
@@ -166,7 +166,7 @@ Once you have made your Activity available to share, others, looking at their Ne
 
 They must then select "Join" and their Record Activity opens with your images in their tray.
 
-Now in Record, thumbnails of both parties are shared.  The frame of the thumbnail is in the same colors as the XO icon of the person who took the photo.
+Now in Record, thumbnails of both parties are shared. The frame of the thumbnail is in the same colors as the XO icon of the person who took the photo.
 
 Images shared
 :::::::::::::
diff --git a/source/sugar_features.rst b/source/sugar_features.rst
new file mode 100644
index 0000000..1e15ed0
--- /dev/null
+++ b/source/sugar_features.rst
@@ -0,0 +1,71 @@
+==============
+Sugar Features
+==============
+
+This page presents a number of Sugar features common to many Activities. The page is designed as a series of "reference topics".
+
+This experimental page includes graphical spacers to separate non-related topics.
+
+.. _View source:
+
+View source
+-----------
+
+You can view the source code of Sugar Activities and other pages.
+
+One method to view source is to right click on the Activity's icon in the :doc:`/frame`. Here is an example of viewing the source of a page in :doc:`/help` Activity.
+
+Open Help Activity, bring in the :doc:`/frame` with the "Frame key" or F6. Right click on the Help icon, and select *View source*.
+
+.. image :: ../images/HelpFrame.png
+
+Using
+-----
+
+The Sugarlabs.org wiki has a informative article: http://wiki.sugarlabs.org/go/View_Source
+
+An example of the View source feature in use, is inspecting the source code of the Help Activity. When you read the *source*, you see the simple text, which Help converts into HTML pages for display. This is useful in the process of editing Help pages as described here :doc:`/how_to_help`
+
+*End of topic - spacer below.*
+
+.. image :: ../images/spacer600.png
+
+.. _say_selected_text:
+
+Say selected text
+-----------------
+
+.. image :: ../images/HelpSpeech1.png
+
+You can have Speak, or robot Alice, read aloud, selected text. Here we demonstrate Alice reading text framed by :doc:`/help`. In Help, for instance, you can select a whole page of text, and have it read aloud to you while you explore that Activity.
+
+Try it now, Select the text in this frame.
+
+To select text, move the mouse to the top left of the text, there is a green arrow near the correct point. Click the left, or main, mouse button. Move the cursor to the bottom right of the text to select, there is a red arrow near the correct point.
+
+Bring in the :doc:`/frame` with the "Frame key" or F6. Press on the "Speech lips" icon in the bottom of the frame, then press on *Say selected text*. Notice also that there is a pause feature, once *speech* has started.
+
+.. image :: ../images/HelpSpeech2.png
+
+The *Say selected text* feature is available in many text based Activities including :doc:`/browse`, :doc:`/fototoon`, :doc:`/write`. Look out for the "Speech lips" icon in the bottom of the Frame, or as a button in the toolbar of an Activity, as in :doc:`/write`.
+
+*End of topic - spacer below.*
+
+.. image :: ../images/spacer600.png
+
+.. _journal_qa:
+
+quick access to the journal
+---------------------------
+
+|journal| This icon on the Activity toolbar (or Activity tab) allows quick access to the :doc:`/journal` to add a description, or further notes to yourself about what you are going to do, or have done in that session of the Activity.
+
+.. |journal| image:: ../images/journal_qa.png
+
+*End of topic - spacer below.*
+
+.. image :: ../images/spacer600.png
+
+.. Note::
+
+   This is a new unfinished page, you can modify it yourself following guidance here :doc:`/how_to_help`
diff --git a/source/write.rst b/source/write.rst
index 1f9c62c..8183498 100644
--- a/source/write.rst
+++ b/source/write.rst
@@ -23,13 +23,13 @@ Here Write has been used to produce some colorful text.
 The Toolbars
 ------------
 
- **Tip** Use the :ref:`Speak Help` feature to have robot Alice read aloud this page in the background, while you explore the Write Activity.
+ **Tip** Use the :ref:`say_selected_text` feature to have robot Alice read aloud this page in the background, while you explore the Write Activity.
 
 .. image :: ../images/Write0act.png
 
 We look first at the nine buttons in the top row of the toolbar. The buttons open the corresponding tab or toolbar.
 
-1. The Activity button: Allows you to name your file, access the Journal to add a description, and share, or collaborate.
+1. Activity tab, or button, here you can enter a name for the page or project, access the Journal, and chose private or sharing in My Neighborhood.
 2. The Edit button: Allows to Copy, Paste, Undo, Redo, and search inside your document.
 3. The View button: Allows you to zoom in and out of the document and to navigate through the pages quickly.
 4. The Speak button. You can have Speak, robot Alice, read your work aloud.
@@ -48,7 +48,7 @@ Activity button (1)
 .. image :: ../images/Write1act.png
 
 1. Allows you to name your file. Click the cursor in the field, the existing text is selected, and a new file name can be entered.
-2. Access the Journal entry and add a description.
+2. The "pencil and book" icon allows :ref:`journal_qa` to provide a description.
 3. This button is the collaboration, or sharing "switch". The options are
 
   |Home_key_f3_small.png| Private, this is the non-sharing option, with no networking.
@@ -96,7 +96,7 @@ Speak button (4)
 
 .. image :: ../images/Write4spk.png
 
-1. Play / Pause the Speak function, robot Alice will read aloud any text which you select..
+1. Play / Pause the Speak function, robot Alice will read aloud any text which you select. See :ref:`say_selected_text`.
 2. Stop robot Alice.
 3. Select robot Alice's language.