[gnome-games] [help] Imported the new Mallard-based help * Removed old pictures and uplodaed new one * Added a sma



commit 32a137b956070b8120687ef89b3c6e91014ab2e2
Author: Milo Casagrande <milo ubuntu com>
Date:   Sat Feb 13 18:56:13 2010 +0100

    [help] Imported the new Mallard-based help
    * Removed old pictures and uplodaed new one
    * Added a small video demonstration of gnotravex
    * Removed old xml files
    * Updated the Makefile

 gnotravex/help/C/figures/gnotravex-logo.png        |  Bin 0 -> 2993 bytes
 gnotravex/help/C/figures/gnotravex-main-window.png |  Bin 0 -> 29540 bytes
 gnotravex/help/C/figures/gnotravex-video.ogv       |  Bin 0 -> 765557 bytes
 gnotravex/help/C/figures/gnotravex_game.png        |  Bin 4803 -> 0 bytes
 gnotravex/help/C/figures/gnotravex_mainwindow.png  |  Bin 4538 -> 0 bytes
 gnotravex/help/C/gameplay.page                     |   37 +++
 gnotravex/help/C/gnotravex.xml                     |  310 --------------------
 gnotravex/help/C/hint.page                         |   58 ++++
 gnotravex/help/C/index.page                        |   42 +++
 gnotravex/help/C/legal.xml                         |   76 -----
 gnotravex/help/C/license.page                      |   59 ++++
 gnotravex/help/C/move.page                         |   50 ++++
 gnotravex/help/C/multiplayer.page                  |   24 ++
 gnotravex/help/C/shortcut.page                     |   82 +++++
 gnotravex/help/C/size.page                         |   32 ++
 gnotravex/help/C/usage.page                        |   66 ++++
 gnotravex/help/C/winning.page                      |   53 ++++
 gnotravex/help/Makefile.am                         |   23 +-
 18 files changed, 519 insertions(+), 393 deletions(-)
---
diff --git a/gnotravex/help/C/figures/gnotravex-logo.png b/gnotravex/help/C/figures/gnotravex-logo.png
new file mode 100644
index 0000000..bab1866
Binary files /dev/null and b/gnotravex/help/C/figures/gnotravex-logo.png differ
diff --git a/gnotravex/help/C/figures/gnotravex-main-window.png b/gnotravex/help/C/figures/gnotravex-main-window.png
new file mode 100644
index 0000000..9f33f12
Binary files /dev/null and b/gnotravex/help/C/figures/gnotravex-main-window.png differ
diff --git a/gnotravex/help/C/figures/gnotravex-video.ogv b/gnotravex/help/C/figures/gnotravex-video.ogv
new file mode 100644
index 0000000..e09b30b
Binary files /dev/null and b/gnotravex/help/C/figures/gnotravex-video.ogv differ
diff --git a/gnotravex/help/C/gameplay.page b/gnotravex/help/C/gameplay.page
new file mode 100644
index 0000000..ef3f3c3
--- /dev/null
+++ b/gnotravex/help/C/gameplay.page
@@ -0,0 +1,37 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="topic"
+  id="gameplay">
+      
+  <info>
+    <link type="guide" xref="index"/>
+    <desc>Introduction to <app>GNOME Tetravex</app>.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-17" status="draft"/>
+   <credit type="author">
+    <name>Milo Casagrande</name>
+    <email>milo ubuntu com</email>
+   </credit>
+   <license>
+     <p>Creative Commons Share Alike 3.0</p>
+   </license>
+  </info>
+
+  <title>Gameplay</title>
+
+  <p>
+    <app>GNOME Tetravex</app> is a simple puzzle game which scope is to move
+    the various pieces from one side of the board to the other side, so that the 
+    same numbers depicted on the pieces are touching each other.
+  </p>
+  <p>
+    The game is timed, and these times are used as the score for the game. You have
+    to move all the pieces in the least time possible.
+  </p>
+  <figure>
+    <title>Main game window</title>
+    <desc><app>Tetravex</app> main window</desc>
+    <media type="image" src="figures/gnotravex-main-window.png" mime="image/png" style="center">
+      <p><app>Tetravex</app> main window.</p>
+    </media>
+  </figure>
+
+</page>
diff --git a/gnotravex/help/C/hint.page b/gnotravex/help/C/hint.page
new file mode 100644
index 0000000..daefdba
--- /dev/null
+++ b/gnotravex/help/C/hint.page
@@ -0,0 +1,58 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="hint">
+  <info>
+    <link type="guide" xref="index#tips"/>
+    <link type="seealso" xref="usage"/>
+    <desc>Use hints or solve the game automatically.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-23" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+  </info>
+  <title>Hints</title>
+
+  <note style="warning">
+    <p>
+      If you use one of the following methods to complete the game, your scores
+      will not be included among the high scores.
+    </p>
+  </note>
+
+  <section id="hint-hints">
+  
+    <title>Use the hints system</title>
+    
+    <p>
+      At any time in the game, if you do not know how to start it, or where to move
+      a piece, it is possible to use the built-in hints system.
+    </p>
+    <p>
+      The system will move one piece from the right box to its correct position
+      into the left box.
+    </p>
+    <p>
+      To use the hints system, perform one of the following:
+    </p>
+    <list>
+      <item>
+        <p>
+          Press <keyseq><key>Ctrl</key><key>H</key></keyseq>.
+        </p>
+      </item>
+      <item>
+        <p>
+          Choose <guiseq><gui style="menu">Game</gui><gui style="menuitem">Hint</gui></guiseq>.
+        </p>
+      </item>
+    </list>
+  </section>
+  <section id="hint-solve">
+    <title>Solve the game</title>
+    <p>
+      If you get stuck in the game, or you want to solve it automatically, 
+      choose <guiseq><gui style="menu">Game</gui><gui style="menuitem">Solve</gui></guiseq>.
+    </p>
+  </section>
+</page>
diff --git a/gnotravex/help/C/index.page b/gnotravex/help/C/index.page
new file mode 100644
index 0000000..5c61e72
--- /dev/null
+++ b/gnotravex/help/C/index.page
@@ -0,0 +1,42 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  id="index"
+  type="guide"
+  groups="one two three"
+  style="2column">
+
+  <info>
+    <title type="link">GNOME Tetravex</title>
+    <title type="text">GNOME Tetravex</title>
+    <desc>GNOME Tetravex help.</desc>
+    <revision version="2.30" date="2009-12-17" status="final"/>
+    <credit type="author">
+      <name>Rob Bradford</name>
+      <email>robster debian org</email>
+    </credit>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>
+    <media type="image" mime="image/png" src="figures/gnotravex-logo.png">GNOME Tetravex logo</media>
+    GNOME Tetravex
+  </title>
+
+  <section id="play" style="2column">
+    <title>Basic Gameplay &amp; Usage</title>
+  </section>
+
+  <section id="multi" style="2column">
+    <title>Multiplayer Game</title>
+  </section>
+  
+  <section id="tips" style="2column">
+    <title>Tips &amp; Tricks</title>
+  </section>
+
+</page>
diff --git a/gnotravex/help/C/license.page b/gnotravex/help/C/license.page
new file mode 100644
index 0000000..05de0b2
--- /dev/null
+++ b/gnotravex/help/C/license.page
@@ -0,0 +1,59 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="license">
+  
+  <info>
+    <link type="seealso" xref="index"/>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-28" status="draft"/>
+    <desc>Legal information.</desc>
+  </info>
+
+  <title>License</title>
+  <p>
+    <!-- 
+    Translators: try to use the same translation as the one provided by the CreativeCommons website. 
+    If there is no translation for your language, consider providing one to CreativeCommons.
+    -->
+    This work is distributed under a CreativeCommons Attribution-Share Alike
+    3.0 Unported license.
+  </p>
+  <p>
+    You are free:
+  </p>
+  <terms>
+    <item>
+      <title><em>To share</em></title>
+      <p>To copy, distribute and transmit the work.</p>
+    </item>
+    <item>
+      <title><em>To remix</em></title>
+      <p>To adapt the work.</p> 
+    </item>
+  </terms>
+  <p>
+    Under the following conditions:
+  </p>
+  <terms>
+    <item>
+      <title><em>Attribution</em></title>
+      <p>
+        You must attribute the work in the manner specified by the author or 
+        licensor (but not in any way that suggests that they endorse you or 
+        your use of the work).  
+      </p>
+    </item>
+    <item>
+      <title><em>Share Alike</em></title>
+      <p>
+        If you alter, transform, or build upon this work, you may distribute the 
+        resulting work only under the same, similar or a compatible license.  
+      </p>
+    </item>
+  </terms>
+  <p>
+    <!-- Translators: there are no official localized versions of the legal code, only the deed is localized. -->
+    For the full text of the license, see the 
+    <link href="http://creativecommons.org/licenses/by-sa/3.0/legalcode";>CreativeCommons website</link>, 
+    or read the full <link href="http://creativecommons.org/licenses/by-sa/3.0/";>Commons Deed</link>. 
+  </p>
+</page>
diff --git a/gnotravex/help/C/move.page b/gnotravex/help/C/move.page
new file mode 100644
index 0000000..03a3502
--- /dev/null
+++ b/gnotravex/help/C/move.page
@@ -0,0 +1,50 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="move">
+
+  <info>
+    <link type="guide" xref="index#play" group="two"/>
+    <link type="seealso" xref="usage"/>
+    <desc>How to move the pieces on the game board.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-17" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+  
+  <title>Move the pieces</title>
+  
+  <section id="move-piece">
+    <title>Move a piece</title>
+    <p>
+      To move a piece, you need to click-and-hold on it, drag it from its current
+      position to its new position, either on the right box or on the
+      left box, and release the mouse button.
+    </p>
+    <p>
+      These moves are not permanent and can be reversed.
+    </p>
+    <note>
+      <p>
+        The pieces in the left box can be moved all at once in one direction. See 
+        <link xref="shortcut"/> for more information.
+      </p>
+    </note>
+  </section>
+  <section id="move-avoid">
+    <title>Avoid the click-and-hold</title>
+    <p>
+      If you do not feel comfortable with the click-and-hold action to move the
+      pieces, it is possible to change that behavior so that you only have to
+      click on a piece to move it, and click again to release it in its new position.
+    </p>
+    <p>
+      To do that, from the main menu bar, choose <gui style="menu">Move</gui>, 
+      and select <gui style="checkbox">Click to Move</gui>.
+    </p>
+  </section>
+</page>
diff --git a/gnotravex/help/C/multiplayer.page b/gnotravex/help/C/multiplayer.page
new file mode 100644
index 0000000..76c3f53
--- /dev/null
+++ b/gnotravex/help/C/multiplayer.page
@@ -0,0 +1,24 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="topic"
+  id="multiplayer">
+
+  <info>
+    <link type="guide" xref="index#multi"/>
+  	<desc>How to play with other people.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-18" status="draft"/> 
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Play with other people</title>
+
+  <p>
+    With <app>GNOME Tetravex</app> it is not possible to play with or against 
+    other people over the Internet or a local network.
+  </p>
+</page>
diff --git a/gnotravex/help/C/shortcut.page b/gnotravex/help/C/shortcut.page
new file mode 100644
index 0000000..1be6dd1
--- /dev/null
+++ b/gnotravex/help/C/shortcut.page
@@ -0,0 +1,82 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="shortcut">
+
+  <info>
+    <link type="guide" xref="index#tips"/>
+    <link type="seealso" xref="usage"/>
+    <desc>Use the keyboard to play the game.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-21" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Keyboard shortcuts</title>
+
+  <section id="shortcuts-game">
+    <title>Game shortcuts</title>
+    <p>
+      The following table groups the most useful shortcuts for playing <app>GNOME Tetravex</app>.
+    </p>
+    <table frame="all" rules="rows cols">
+      <tr>
+        <td><p>Shortcut</p></td><td><p>Description</p></td>
+      </tr>
+      <tr>
+        <td>
+          <p><keyseq><key>Ctrl</key><key>N</key></keyseq></p>
+        </td>
+        <td>
+          <p>Start a new game.</p>
+        </td>
+      </tr>
+      <tr>
+        <td>
+          <p><key>Pause</key></p>
+        </td>
+        <td>
+          <p>Pause or resume the game.</p>
+        </td>
+      </tr>
+      <tr>
+        <td>
+          <p>
+            <keyseq><key>Ctrl</key><key>Up</key></keyseq>
+          </p>
+        </td>
+        <td>
+          <p>Move all the pieces in the left box up by one.</p>
+        </td>
+      </tr>
+      <tr>
+        <td>
+          <p><keyseq><key>Ctrl</key><key>Down</key></keyseq></p>
+        </td>
+        <td>
+          <p>Move all the pieces in the left box down by one.</p>
+        </td>
+      </tr>
+      <tr>
+        <td>
+          <p><keyseq><key>Ctrl</key><key>Left</key></keyseq></p>
+        </td>
+        <td>
+          <p>Move all the pieces in the left box left by one.</p>
+        </td>
+      </tr>
+      <tr>
+        <td>
+          <p><keyseq><key>Ctrl</key><key>Right</key></keyseq></p>
+        </td>
+        <td>
+          <p>Move all the pieces in the left box right by one.</p>
+        </td>
+      </tr>
+    </table>
+  </section>
+</page>
diff --git a/gnotravex/help/C/size.page b/gnotravex/help/C/size.page
new file mode 100644
index 0000000..8a58483
--- /dev/null
+++ b/gnotravex/help/C/size.page
@@ -0,0 +1,32 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="size">
+
+  <info>
+    <link type="guide" xref="index#play" group="three"/>
+    <desc>Change the size of the game board.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-18" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+  <title>Game board size</title>
+
+  <p>
+    To change the size of the game board, in order to increase or decrease the
+    complexity of the game, choose <gui>Size</gui> from the main menu bar, and then
+    select the dimension of the board.
+  </p>
+  <p>
+    You can select from five different dimension, from 2Ã?2 to 6Ã?6. The default one is 3Ã?3.
+  </p>
+  <note style="tip">
+    <p>
+      If the pieces are too small, resizing the window will change their size.
+    </p>
+  </note>
+</page>
diff --git a/gnotravex/help/C/usage.page b/gnotravex/help/C/usage.page
new file mode 100644
index 0000000..a691a8d
--- /dev/null
+++ b/gnotravex/help/C/usage.page
@@ -0,0 +1,66 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="usage">
+
+  <info>
+    <link type="guide" xref="index#play" group="one"/>
+    <link type="seealso" xref="gameplay"/>
+    <desc>How to play <app>GNOME Tetravex</app>.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-17" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <credit type="author">
+      <name>Rob Bradford</name>
+      <email>robster debian org</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>    
+  </info>
+
+  <title>Play <app>GNOME Tetravex</app></title>
+
+  <section id="usage-basic">
+    <title>Basic usage</title>
+    <p>
+      The game window is divided into two boxes: the one on the right side of 
+      the window contains the pieces that needs to be arranged; the one on the 
+      left side of the window is where the pieces from the right box will be 
+      arranged and moved. Each piece is divided into four little triangles 
+      containing a number.
+    </p>
+    <p>
+      The scope of the game is to position the pieces so that only two identical 
+      numbers are next to each other.
+    </p>
+    <p>
+      It is not possible to position the pieces so that different number are next
+      to each other.
+    </p>
+    <p>
+      The game is completed when you have positioned all the pieces in their right
+      positions.
+    </p>
+    <note>
+      <p>
+        When you start <app>GNOME Tetravex</app>, the game will start immediately,
+        and the time will start counting.
+      </p>
+    </note>
+
+  </section>
+  
+  <section id="usage-video">
+    <title>Video demonstration</title>
+    <p>
+      This small video shows how the game works, and what are the possible movements.
+    </p>
+    <p>
+      <media type="video" mime="application/ogg" src="figures/tetravex.ogv">
+      Simple demonstration of a game
+      </media>
+    </p>
+  </section>
+</page>
diff --git a/gnotravex/help/C/winning.page b/gnotravex/help/C/winning.page
new file mode 100644
index 0000000..6ed1d2a
--- /dev/null
+++ b/gnotravex/help/C/winning.page
@@ -0,0 +1,53 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="guide"
+  id="winning">
+
+  <info>
+    <link type="guide" xref="index#tips"/>
+    <link type="seealso" xref="hint"/>
+    <link type="seealso" xref="usage"/>
+    <desc>Simple tips on how to possibly win a game.</desc>
+    <revision pkgversion="2.30" version="0.1" date="2009-12-26" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+  
+  <title>Win <app>GNOME Tetravex</app></title>
+  
+  <note>
+    <p>
+      The following tips will not assure you to win a game, they are intended as
+      a simple aid. 
+    </p>
+  </note>
+  
+  <section id="winning-single">
+    <title>Look for a single number</title>
+    <p>
+      When you start a new game, look for a single number, or a number that has no
+      similar numbers that can be placed next to it.
+    </p>
+    <p>
+      If you have one such number, that piece is a valid starting piece, since you
+      know where it has to be placed.
+    </p>
+    <p>
+      Note that the bigger the size of the board, the harder is to find such a 
+      number.
+    </p>
+  </section>
+  <!-- This is just an idea... need to think about it... -->
+  <section id="winning-share">
+    <title>Have a tip to share?</title>
+    <p>
+      If you have a tip to share about <app>GNOME Tetravex</app>, or any other
+      GNOME games, write us at <email>gnome-doc-list gnome org</email>. We will add
+      them here!
+    </p>
+  </section>
+</page>
diff --git a/gnotravex/help/Makefile.am b/gnotravex/help/Makefile.am
index db7f096..af2c81e 100644
--- a/gnotravex/help/Makefile.am
+++ b/gnotravex/help/Makefile.am
@@ -1,15 +1,24 @@
 include $(top_srcdir)/gnome-doc-utils.make
 
-DOC_LINGUAS = ca cs da de el en_GB es eu fr it oc ru sl sr sv
+DOC_ID = gnotravex
 
-DOC_MODULE = gnotravex
+DOC_FIGURES = \
+	figures/gnotravex-main-window.png \
+	figures/gnotravex-video.ogv
 
-DOC_ENTITIES = \
-	legal.xml
+DOC_PAGES = \
+  gameplay.page \
+  hint.page \
+  index.page \
+  license.page \
+  move.page \
+  multiplayer.page \
+  shortcut.page \
+  size.page \
+  usage.page \
+  winning.page
 
-DOC_FIGURES = \
-	figures/gnotravex_game.png \
-	figures/gnotravex_mainwindow.png
+DOC_LINGUAS = ca cs da de el en_GB es eu fr it oc ru sl sr sv
 
 dist-hook: doc-dist-hook
 



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]