[iagno] Split help Rules page.

[Arnaud B. <arnaudb src gnome org>]

commit e2b318247297ec20710a5270f7b5d94581cf3df0
Author: Arnaud Bonatti <arnaud bonatti gmail com>
Date:   Sat Feb 1 15:53:20 2020 +0100

    Split help Rules page.

 help/C/example.page          | 106 +++++++++++++++++++++++++++++++++++++++++++
 help/C/figures/block.png     | Bin 7585 -> 0 bytes
 help/C/figures/first.png     | Bin 6168 -> 0 bytes
 help/C/figures/move-1.png    | Bin 0 -> 12046 bytes
 help/C/figures/move-2.png    | Bin 0 -> 13050 bytes
 help/C/figures/move-3.png    | Bin 0 -> 12345 bytes
 help/C/figures/move-4.png    | Bin 0 -> 13617 bytes
 help/C/figures/positions.xcf | Bin 38184 -> 46197 bytes
 help/C/rules.page            |  50 ++++++++++----------
 help/meson.build             |   7 ++-
 10 files changed, 134 insertions(+), 29 deletions(-)
---
diff --git a/help/C/example.page b/help/C/example.page
new file mode 100644
index 0000000..b58bde8
--- /dev/null
+++ b/help/C/example.page
@@ -0,0 +1,106 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="example"
+      xmlns:its="http://www.w3.org/2005/11/its";> <!-- the "its" line is allowing translations for medias -->
+
+  <info>
+    <link type="guide" xref="index#reversi" />
+    <revision version="0.1" date="2020-02-01" status="final"/>
+
+    <credit type="author copyright">
+      <name>Arnaud Bonatti</name>
+      <email>arnaud bonatti gmail com</email>
+      <years>2020</years>
+    </credit>
+
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Example game first moves</title>
+
+  <table>
+    <tr>
+      <td>
+        <media type="image" src="figures/usual-start.png" width="200" its:translate="no">
+          <p its:translate="yes">Usual start position: E4 and D5 are dark, D4 and E5 are light.</p>
+        </media>
+      </td>
+      <td>
+        <p><em>Start position</em></p>
+
+        <p>This is the usual start position of the reversi game family.</p>
+
+        <p><app>Reversi</app> also allows you to <link xref="start-position">use other start 
positions</link>.</p>
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        <media type="image" src="figures/move-1.png" width="200" its:translate="no">
+          <p its:translate="yes">Example first move: <em>Dark</em> plays D3, capturing D4 thanks to D5.</p>
+        </media>
+      </td>
+      <td>
+        <p><em>Example first move</em></p>
+
+        <p><em>Dark</em> always starts in the reversi game family.</p>
+
+        <p>Whatever start position is used, there are four possible first moves.</p>
+
+        <p>In the usual start position like here, the four possibilities are equivalent by symmetry.</p>
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        <media type="image" src="figures/move-2.png" width="200" its:translate="no">
+          <p its:translate="yes">First <em>Light</em> move: playing E3 and capturing E4 thanks to E5.</p>
+        </media>
+      </td>
+      <td>
+        <p><em>Possible second move</em></p>
+
+        <p><em>Light</em> has three possibilities of capturing one piece.</p>
+
+        <p>The game will require to search for the <link xref="strategy">best strategy</link>!</p>
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        <media type="image" src="figures/move-3.png" width="200" its:translate="no">
+          <p its:translate="yes"><em>Dark</em> turns multiple rows: playing F3, it captures both E3 due to 
D3 and E4 due to D5.</p>
+        </media>
+      </td>
+      <td>
+        <p><em>Capturing multiple rows</em></p>
+
+        <p><em>Dark</em> has five possibilities to play, all on the sixth column.</p>
+
+        <p>Two of these possibilities allow capturing in two directions at the same time, one piece in 
each.</p>
+
+        <p>Capturing the higher number of tiles is not required in reversi, and may not be the best solution 
even. Only the number of owned tiles at the end of the game will count.</p>
+      </td>
+    </tr>
+
+    <tr>
+      <td>
+        <media type="image" src="figures/move-4.png" width="200" its:translate="no">
+          <p its:translate="yes"><em>Light</em> turns a row of two pieces: playing E2, it turns E3 and E4 
thanks to E5</p>
+        </media>
+      </td>
+      <td>
+        <p><em>Turning a two-pieces row</em></p>
+
+        <p><em>Light</em> has again three play possibilities.</p>
+
+        <p>One of them is to capture two dark pieces in a row.</p>
+
+        <p>Playing that way may allow <em>Dark</em> to play next on the board edge. Is that a good strategy? 
Who knows!</p>
+      </td>
+    </tr>
+  </table>
+
+</page>
diff --git a/help/C/figures/move-1.png b/help/C/figures/move-1.png
new file mode 100644
index 0000000..72425da
Binary files /dev/null and b/help/C/figures/move-1.png differ
diff --git a/help/C/figures/move-2.png b/help/C/figures/move-2.png
new file mode 100644
index 0000000..be859e6
Binary files /dev/null and b/help/C/figures/move-2.png differ
diff --git a/help/C/figures/move-3.png b/help/C/figures/move-3.png
new file mode 100644
index 0000000..341daf0
Binary files /dev/null and b/help/C/figures/move-3.png differ
diff --git a/help/C/figures/move-4.png b/help/C/figures/move-4.png
new file mode 100644
index 0000000..dd425a6
Binary files /dev/null and b/help/C/figures/move-4.png differ
diff --git a/help/C/figures/positions.xcf b/help/C/figures/positions.xcf
index 98be8e8..a4c05f2 100644
Binary files a/help/C/figures/positions.xcf and b/help/C/figures/positions.xcf differ
diff --git a/help/C/rules.page b/help/C/rules.page
index 06b4271..b37cba7 100644
--- a/help/C/rules.page
+++ b/help/C/rules.page
@@ -1,10 +1,11 @@
 <page xmlns="http://projectmallard.org/1.0/";
-      xmlns:its="http://www.w3.org/2005/11/its";
       type="topic" style="task"
-      id="rules">
+      id="rules"
+      xmlns:its="http://www.w3.org/2005/11/its";> <!-- the "its" line is allowing translations for medias -->
+
   <info>
     <link type="guide" xref="index#reversi" />
-    <revision version="0.1" date="2012-03-08" status="final"/>
+    <revision version="0.2" date="2020-02-01" status="final"/>
 
     <credit type="author copyright">
       <name>Tiffany Antopolski</name>
@@ -20,6 +21,11 @@
       <email its:translate="no">me stevepdp org</email>
       <years>2015</years>
     </credit>
+    <credit type="editor">
+      <name>Arnaud Bonatti</name>
+      <email>arnaud bonatti gmail com</email>
+      <years>2020</years>
+    </credit>
 
     <desc></desc>
   </info>
@@ -43,29 +49,19 @@
     <item><p>The winner is the the player with the most pieces of his color on the board.</p></item>
   </steps>
 
-<table>
- <tr>
-  <td>
-  <media type="image" src="figures/usual-start.png" width="200" its:translate="no">
-    <p its:translate="yes">Start position</p>
-  </media>
-   </td>
-   <td>
-  <media type="image" src="figures/first.png" width="200" its:translate="no">
-    <p its:translate="yes">Example first move</p>
-  </media>
-   </td>
-   <td>
-  <media type="image" src="figures/block.png" width="200" its:translate="no">
-    <p its:translate="yes">Blocking move</p>
-  </media>
-   </td>
-   </tr>
-   <tr>
-     <td><p><em>Start position</em></p></td>
-     <td><p><em>Example first move</em></p></td>
-     <td><p><em>A blocking move</em></p></td>
-   </tr>
-</table>
+  <table>
+    <tr>
+      <td>
+        <media type="image" src="figures/usual-start.png" width="200" its:translate="no">
+          <p its:translate="yes">Usual start position: light-dark, dark-light</p>
+        </media>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <p><em>The usual start position</em></p>
+      </td>
+    </tr>
+  </table>
 
 </page>
diff --git a/help/meson.build b/help/meson.build
index 18c258f..d0e6331 100644
--- a/help/meson.build
+++ b/help/meson.build
@@ -3,11 +3,13 @@ help_media = [
     'figures/alternative-start-1.png',
     'figures/alternative-start-2.png',
     'figures/alternative-start-3.png',
-    'figures/block.png',
-    'figures/first.png',
     'figures/iagno-video.ogv',
     'figures/logo32.png',
     'figures/logo.png',
+    'figures/move-1.png',
+    'figures/move-2.png',
+    'figures/move-3.png',
+    'figures/move-4.png',
     'figures/symmetric-start.png',
     'figures/usual-start.png'
 ]
@@ -19,6 +21,7 @@ help_files = [
     'change-color.page',
     'develop.page',
     'documentation.page',
+    'example.page',
     'highlights.page',
     'index.page',
     'legal.xml',