Update Memorize page to v 45

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

19 files changed, 195 insertions, 102 deletions

diff --git a/images/100px-MemorizeSharing.jpg b/images/100px-MemorizeSharing.jpg
deleted file mode 100644
index 26736ae..0000000
--- a/images/100px-MemorizeSharing.jpg
+++ /dev/null
diff --git a/images/Memorize1-tb_Edit.png b/images/Memorize1-tb_Edit.png
new file mode 100644
index 0000000..4f77655
--- /dev/null
+++ b/images/Memorize1-tb_Edit.png
diff --git a/images/Memorize1-tb_Play.png b/images/Memorize1-tb_Play.png
new file mode 100644
index 0000000..cafd898
--- /dev/null
+++ b/images/Memorize1-tb_Play.png
diff --git a/images/Memorize1.png b/images/Memorize1.png
new file mode 100644
index 0000000..5249f72
--- /dev/null
+++ b/images/Memorize1.png
diff --git a/images/Memorize1comp.png b/images/Memorize1comp.png
new file mode 100644
index 0000000..173e32a
--- /dev/null
+++ b/images/Memorize1comp.png
diff --git a/images/Memorize2-add_contents.png b/images/Memorize2-add_contents.png
new file mode 100644
index 0000000..9e88929
--- /dev/null
+++ b/images/Memorize2-add_contents.png
diff --git a/images/Memorize2-ic_1_2.png b/images/Memorize2-ic_1_2.png
new file mode 100644
index 0000000..d83c54d
--- /dev/null
+++ b/images/Memorize2-ic_1_2.png
diff --git a/images/Memorize2.png b/images/Memorize2.png
new file mode 100644
index 0000000..dc6d73a
--- /dev/null
+++ b/images/Memorize2.png
diff --git a/images/Memorize2_ic_clear.png b/images/Memorize2_ic_clear.png
new file mode 100644
index 0000000..6ed9f12
--- /dev/null
+++ b/images/Memorize2_ic_clear.png
diff --git a/images/Memorize2_ic_diff.png b/images/Memorize2_ic_diff.png
new file mode 100644
index 0000000..5695ff5
--- /dev/null
+++ b/images/Memorize2_ic_diff.png
diff --git a/images/Memorize2_ic_eq.png b/images/Memorize2_ic_eq.png
new file mode 100644
index 0000000..e00fbdb
--- /dev/null
+++ b/images/Memorize2_ic_eq.png
diff --git a/images/Memorize2_ic_gray.png b/images/Memorize2_ic_gray.png
new file mode 100644
index 0000000..3ebf3a1
--- /dev/null
+++ b/images/Memorize2_ic_gray.png
diff --git a/images/MemorizeCreateColorGame.jpg b/images/MemorizeCreateColorGame.jpg
deleted file mode 100644
index 4f66945..0000000
--- a/images/MemorizeCreateColorGame.jpg
+++ /dev/null
diff --git a/images/MemorizeCreateColorTile.jpg b/images/MemorizeCreateColorTile.jpg
deleted file mode 100644
index 073420c..0000000
--- a/images/MemorizeCreateColorTile.jpg
+++ /dev/null
diff --git a/images/MemorizeCreateSoundGame.jpg b/images/MemorizeCreateSoundGame.jpg
deleted file mode 100644
index 3c3213a..0000000
--- a/images/MemorizeCreateSoundGame.jpg
+++ /dev/null
diff --git a/images/MemorizeGameAdd.jpg b/images/MemorizeGameAdd.jpg
deleted file mode 100644
index c2fe66c..0000000
--- a/images/MemorizeGameAdd.jpg
+++ /dev/null
diff --git a/images/MemorizeGameCreate.jpg b/images/MemorizeGameCreate.jpg
deleted file mode 100644
index 7183166..0000000
--- a/images/MemorizeGameCreate.jpg
+++ /dev/null
diff --git a/images/more.png b/images/more.png
new file mode 100644
index 0000000..3eb7b05
--- /dev/null
+++ b/images/more.png
diff --git a/source/memorize.rst b/source/memorize.rst
index 0a32325..1bb158c 100644
--- a/source/memorize.rst
+++ b/source/memorize.rst
@@ -7,125 +7,218 @@ About
 
 This Activity allows learners to take the learning process in their own hands, as they play but also create their own games. The game has matching pairs of what are clickable tiles, or blocks. The card pairs are composed of text, sound or images. The children turn over the cards to match words, words and sounds, words and pictures, or pictures and sounds. There are a few default games loaded. These images, sounds and text can be extended to animations or movie snippets. Players of Memorize can play together across multiple machines. 
 
-Using
------
+Using Memorize
+--------------
+
+Memorize comes with two modes, *Play*, and *Edit game*. In *Edit game* you can make a brand new Memorize game, or edit one of the demo games supplied.
+
+In *Play* mode the Activity has three sets of tiles for demo games, *Numbers, Letters* and *Sounds*. Memorize supports :ref:`Sharing` so you can play the game with others.
+
+The image below shows the Letters demo being selected, and play in progress. Notice that the unturned tiles, are in two sets, tiles are numbered with a 1 in the  top part of the gameboard, and with a 2 in the lower half. This is called a *Grouped tile game*.
 
-**Single Player Mode** The following screenshot shows the single player mode. The player has matched two pair. They are highlighted and shown on the left side. If the pair of tiles do not match, the are flipped back over. This player has found two matching pairs. The updated points are reflected next to the player icon. The labels reflect these functions:
+ (In the Sounds demo, there is an example of an *Ungrouped game*, that is, the tiles are randomly spread over the gameboard.)
 
-1. Restart the Game
-2. Load demo game - Select preloaded demo games from list. The current game is called "addition".
-3. Select the Grid Size
-4. Load the demo game. This game is "addition".
-5. Matched pairs show in the user color
-6. Game board - Click tiles to flip over. If the pair of tiles match, they are highlighted and shown on the left side. If the pair of tiles do not match, the are flipped back over. 
+The player has already matched two pairs, by clicking on the tiles. Matched tiles are highlighted and a score is shown on the left side. If the pair of tiles do not match, they are flipped back over after a short time, in which you try to memorize them.
 
-.. image :: ../images/MemorizeGameAdd.jpg
+When you play a *Grouped tile game*, the prompt will be in the top half of the gameboard, and the answer will be hidden under one of the squares in the bottom half. You have to guess where the matching tile might be. Move the cursor down and notice that the bottom rows are now 'live' --each square is highlighted as you cross it. Select your guess. After you have made a few guesses, you will start to remember where the matching tiles might be.
 
-How to play
-:::::::::::
+.. image :: ../images/Memorize1.png
 
-When you click "Load demo games" and select 'addition' from the pull-down menu, you will get a grid of 16 squares. Each square in the top two rows will be marked with the number 1; the squares in the bottom two rows will each have the number 2. 
+**Toolbar tabs and buttons in Play do the following:**
 
-Each square in the top row hides a simple addition problem which you can view by clicking on it. The answer to the addition problem is hidden under one of the squares in the bottom two rows. There is no way to know under which square, you must simply guess. Move the cursor down to your selected guess, and notice that the bottom two rows are now 'live'--each square is highlighted as you cross it. 
+.. image :: ../images/Memorize1-tb_Play.png
+
+1. Activity tab, name the game, access the Journal, to provide a description, and select Private, or My Neighbourhood, see :ref:`Sharing`.
+2. Load demo game - Select preloaded demo games from list.
+3. Select the Grid Size, 4x4, 5x5, or 6x6.
+4. Restart Game.
+5. This is the switch to *Edit game*. Create a new game or edit the current game.
+6. The *Edit game* mode icons are grayed out.
+7. grayed out.
+8. grayed out.
+9. Stop, or close the Activity.
 
 Creating a Game
-:::::::::::::::
-
-To create a game, here are the features you need to know:
-
-1. New Game: Start a new game
-2. Load Game: Load a game you have started
-3. Save Game: Save your work
-4. Game Name: Type the name of your game
-5. Equal Pairs: The content details of the tiles are the same
-6. Grouped Game: The content details of the tiles are different but match in kind. You can label the first tile as 1 and second matching tile as 2. Or you can allow the tiles to be displayed randomly.
-7. Insert Picture: opens the journal to select an image file
-8. Insert Sound: opens the journal to select a sound file
-9. Click to Pronounce Text
-10. Type in Text
-11. Preview
-12. Add
-13. Update
-14. Preview Matching Pairs
-15. Delete 
-
-.. image :: ../images/MemorizeGameCreate.jpg
-
-Applying
---------
-
-**Create a Color Game**
-
-In this tutorial, you will learn how to create and play a Memorize activity matching colors. The tiles are equal meaning each set is the same, and you will learn how to upload an image and add text. 
-
-**Preparation** Before beginning, save eight color fills using the Paint activity. Use the Bucket tool to fill the color image and save. The color image saved from the Paint activity is in rectangular in size. The Memorize activity uses a square picture image aligned from the upper left.
-
-1. Click the Create tab
-2. Type in a Game name
-3. Tick Equal pairs check box
-4. Insert Pictures and Text 
-
-.. image :: ../images/MemorizeCreateColorGame.jpg
-
-**Create Color Tiles**
-
-1.  Click Insert picture.
-2.  Select and click the image file with your color from the journal
-3.  Type <color name> in the Text box.
-4.  Click Add. The new pair of tiles are displayed on the left side.
-5.  Repeat steps until all pairs are added.
-6.  Click Save
-7.  To play the game go to the Play tab
-8.  Click the Load Game icon (a folder with an up arrow)
-9.  Select your game! 
-
-.. image :: ../images/MemorizeCreateColorTile.jpg
-
-**Create a Sound Game**
-
-In this tutorial, you will learn how to create and play a Memorize activity matching pictures and sounds. The tiles are grouped meaning all the pictures are numbered '1' tiles while the sounds are numbered '2' tiles. You will learn how to upload an image and upload a sound. Before beginning, save eight pictures using the Browse activity. Copy eight matching sounds files from an USB memory stick and save to the Journal. 
-
-1.  Type in a Game name
-2.  Click grouped game
-3.  Insert Picture and Text 
-
-.. image :: ../images/MemorizeCreateSoundGame.jpg
-
-1.  Click Insert sound. The Journal opens.
-2.  Select and click the file name.
-3.  Click Add. The new pair of tiles are displayed on the left side.
-4.  Repeat steps until all pairs are added.
-5.  Click Save 
-
-**Create a Spelling Game**
-
-1.  First create a spelling words with record
-2.  Choose the Audio tab of Record
-3.  Set the duration (upper right corner of the Record interface) is set to 15 seconds
-4.  Click the Record button
-5.  Say the first word of your spelling list
-6.  Click the Record button again
-7.  Wait while the Record activity saves your clip
-8.  Click the Record button
-9.  Say the next word on your list
-10. Click the Record button to save your clip
-11. Record and save the rest of the spelling words on your list
-12. Go to Memorize and create a New Game by matching the text word tile and the tile with the recorded sound files in your journal
-13. Proceed with creating the game and matching sounds as you did in the earlier Sound game. 
+---------------
+Pressing the *Edit game* button, results in editing the existing game. If you open Memorize from *Resume*, that is, an existing named file, and press the *Edit game* button, you will change that file, and the older file will be overwritten in the
+:doc:`/journal`.
+In this case the older game is lost.
+
+To create a fresh game, open Memorize, from the Home View, *Start new*. Press the Activity tab. Type in a name for the game.
+
+Memorize will remind you of this difference in behavior. If you rename an existing game, and then press the *Clear all tiles* button, you will be prompted *Do you want to ...* . If you press *Clear*, this will overwrite the previous game in your Journal. (You cannot overwrite a demo game itself. The demo games will always be there if you choose to edit a demo game, and clear its tiles.)
+
+It is good if you have some image files in your Journal, or on a USB stick. If none are available you could make some with Paint, see the tutorial below.
+
+This image shows a game being created. The right side, represents the new contents for the gameboard. So far we have Tux and his image. The left side represents the work space. A picture of a sunset has been selected from the Journal, and the text "Sunset" has been entered into the box marked *Text:*. The cursor has selected *Add new pair*, and when pressed, the new pair will transfer to the gameboard section on the right.
+
+.. image :: ../images/Memorize2.png
+
+**Toolbar tabs and buttons in Edit game do the following:**
+
+.. image :: ../images/Memorize1-tb_Edit.png
+
+1. Activity tab, name the game, access the Journal, to provide a description, and select Private, or My Neighbourhood, see :ref:`Sharing`.
+2. *Play* buttons are grayed out while in *Edit game* mode.
+3. grayed out.
+4. grayed out.
+5. This button is now marked to switch back to *Play* mode.
+6. Switch between Match different tiles, and Match identical tiles.
+7. Switch between Grouped tiles game, and Ungrouped game.
+8. Clear all tiles.
+9. Stop, or close the Activity.
+
+========= ========================      =========== =======================
+|icon<>|  Match different tiles         |icon=|     Match identical tiles
+|icon1+2| Grouped tiles game            |icon-gray| Ungrouped game
+|iconCl|   Clear all tiles
+========= ========================      =========== =======================
+
+.. |icon<>| image:: ../images/Memorize2_ic_diff.png
+
+.. |icon=| image:: ../images/Memorize2_ic_eq.png
+
+.. |icon1+2| image:: ../images/Memorize2-ic_1_2.png
+
+.. |icon-gray| image:: ../images/Memorize2_ic_gray.png
+
+.. |iconCl| image:: ../images/Memorize2_ic_clear.png
+
+If you look to the top of the toolbar in our example above, you will see this game is a *Match different tiles* and an *Ungrouped game*.
+
+Looking at the image below starting from top left, clockwise, shows some of the steps in selecting contents for the game. In the first image **1** within the work space are the *Add item* buttons. The *Insert picture* button has been used to open the Journal, and select a Tux image.
+
+Next **2** the text "Tux" was entered in the text box, and also the *Speak text* icon was selected.
+Now, the two tiles are ready to *Add as new pair* to the gameboard section on the right.
+
+With all the images loaded **3** press *Play*, the hovering cursor reveals *Play game*.
+The final image **4** shows the game in play. Notice that when the *Pronounce text* button has been selected Speak's eyes watch play.
+
+.. image :: ../images/Memorize1comp.png
+
+**The add item buttons, within the work space:**
+
+This image shows just the left side of the screen, the work space.
+
+.. image :: ../images/Memorize2-add_contents.png
+
+The Preview will show the new tile, like this, with no content, or with whatever has been selected.
+
+Text can be entered directly into the box under *Text:*.
+
+1. Insert picture, opens Journal or attached media in Image search.
+2. Insert sound file, opens Journal or attached media in Audio search.
+3. Pronounce text during tile flip
+4. Select font.
+5. *Add:* This will add the current "pair" in the work space, to the gameboard section on the right.
+6. *Update:* This will bring a selected pair, from gameboard section on the right, back into the work space, where changes can be made.
+
+Tutorials
+---------
+
+Create a Color Game
+-------------------
+
+In this tutorial, you will learn how to create and play a Memorize Activity matching colors. This is a *Match identical tiles* game. You will learn how to upload an image and add text.
+
+Before beginning, save eight color fills using the Paint activity. In Paint, use the Bucket tool to fill the whole space with a color, and name and save the image. The color image saved from the Paint activity is in rectangular in shape. The Memorize activity uses a square picture image aligned from the upper left.
+
+1. Open Memorize, from the Home View, *Start new*. (If you open Memorize from *Resume* in your Journal, that is, an existing named file, you will change that file, and the older file will be overwritten in the Journal.)
+2. Press the Activity tab.
+3. Type in a name for this game.
+4. Click the *Edit game* button.
+5. Press  *Match identical tiles*.
+6. Press to choose either a *Grouped tiles game,* or an *Ungrouped game.*
+7. Insert Pictures and Text like this:
+
+Working in the work space, which will now only have one tile pane,
+
+ * Click *Insert picture*.
+ * Select and click the image file with your color from the Journal.
+ * Type in the name of the color you just chose in the *Text:* box.
+ * Click *Add as new pair*. A new pair of tiles are displayed on the right side, the gameboard section.
+ * Repeat steps until all pairs are added.
+
+Now to play the game, click the *Play* button.
+
+Create a Sound Game
+-------------------
+
+In this tutorial, you will learn how to create and play a Memorize Activity matching pictures and sounds. The tiles are grouped meaning all the pictures are numbered '1' tiles while the sounds are numbered '2' tiles. You will learn how to upload an image and upload a sound. Before beginning, save eight pictures using the Browse activity, and eight matching sound files. The files can be on a USB stick or in your Journal. 
+
+1. Open Memorize, from the Home View, *Start new*.
+2. Press the Activity tab.
+3. Type in a name for this game.
+4. Click on *Grouped tiles game.*
+5. Click on *Match different tiles*.
+
+Working in the work space, now with two tile panes.
+
+In the first tile pane:
+ * Insert a picture file as above. If you add text too, it will be printed over your picture.
+
+In the second tile pane:
+ * Click *Insert sound*. Select either the Journal or the media where you stored your sound files.
+ * Select and click the file name.
+ * Click *Add as new pair*. The new pair of tiles are displayed on the right side.
+
+Repeat steps until all pairs are added.
+
+Now to play the game, click the *Play* button.
+
+Create a Spelling Game
+----------------------
+First create a spelling list.
+
+1. Open Activity Record.
+2. Choose the Audio tab of Record.
+3. Set the duration (upper right corner of the Record interface) to, say, 15 seconds.
+4. Click the Record button.
+5. Say the first word of your spelling list.
+6. Click the Record button again.
+7. Wait, while the Record Activity saves your sound clip.
+8. Click the Record button.
+9. Say the next word on your list.
+10. Click the Record button to save your clip.
+11. Record and save the rest of the spelling words on your list.
+
+Now in Memorize.
+
+1. Open Memorize, from the Home View, *Start new*.
+2. Press the Activity tab.
+3. Type in a name for this game.
+4. Select *Edit game*.
+5. Click on *Ungrouped game.*
+6. Click on *Match different tiles*.
+7. Use *Insert sound* to add your first recording to the first tile. In the second tile enter the word to match your sound file.
+8. Proceed adding sounds on the first tile, with matching  words on the second tile.
+
+Repeat steps until all pairs are added.
+
+Now to play the game, click the *Play* button.
+
+.. _Sharing:
 
 Sharing
 -------
 
-To play these games with users on more than one XO, so that the turn moves from one user to the other, when a user fails to make a matching selection:
+To play these games with users on more than one XO, so that the turn moves from one user to the other when a user fails to make a matching selection:
 
 1.  Open the Memorize activity and load the game you want to share on the main XO
-2.  Click on “Activity” then in menu bar click on the circle with a single dot
-3.  All the other XOs will see the Memorize activity icon close to your XO symbol on their neighborhood view
+2.  Click on the Activity tab, and click on the Home View button |Home_key_f3_small| so that it turns into the My Neighborhood button |Neighborhood_key|
+3.  All the other XOs will see the Memorize activity icon close to your XO symbol on their Neighborhood View.
 4.  They can then join the activity by moving their cursor over the game icon. 
 
-.. image :: ../images/100px-MemorizeSharing.jpg
+.. |Home_key_f3_small| image:: ../images/Home_key_f3_small.png
+
+.. |Neighborhood_key| image:: ../images/Neighborhood_key_sml.png
+
+|more| For further information, please see the page
+:doc:`/collaborating`
+
+.. |more| image:: ../images/more.png
 
 Extending
 ---------
 
-There are a rich set of opportunities for extending these games to be used for history, biology, music, science, early reading, mathematics and others. The media objects available in Sugar, such as sound files or images, as well as all the media objects available by transfer from a USB, mean this game can be a powerful in many educational areas. 
+There is a rich set of opportunities for extending these games. Memorize could be used in history, biology, music, science, early reading, mathematics and others. The media objects available in Sugar, such as sound files and images, as well as all the media objects available by transfer from a USB, or the internet, mean that this game can be powerful in many educational areas.