<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="16-Puzzle">

  <info>
    <link type="guide" xref="index#play" />
    <revision pkgversion="3.31" version="0.2" date="2019-01-23" status="final"/>

    <credit type="author copyright">
      <name>Arnaud Bonatti</name>
      <email>arnaud.bonatti@gmail.com</email>
      <years>2014-2019</years>
    </credit>

    <desc></desc>
  </info>

  <title>16-Puzzle</title>

  <p>The <em>16-Puzzle</em> is the variant puzzle of <app>Taquin</app>. You can launch it at any time from the <link xref="start-screen">Start Screen</link>.</p>

  <section id="16-play">
    <title>Gameplay</title>

    <p>The goal is to move all the tiles to their proper places.</p>

    <p>You move all the tiles of a row or a column in one direction. The tile that is pushed out of the board is placed at the opposite side of the row or column.</p>

  </section>
  <section id="16-end">
    <title>End of the game</title>
    <p>At the end of the game, <app>Taquin</app> notifies you and displays the complete image.</p>
    <p>You can click the <gui>New Game</gui> button in the headerbar to go to the <link xref="start-screen">Start Screen</link>. Alternatively, you can restart the game by clicking on the button with a counter of moves done, and then on the <gui>Restart</gui> entry.</p>
  </section>

  <section id="16-mouse">
    <title>How to play with a mouse</title>

    <p>To make a move:</p>
    <steps>
      <item>
        <p>Click on one of the arrows displayed around the board. The row or column at the end of which this arrow is moves in this direction, and the tile that was next to the arrow is placed at the opposite side.</p>
      </item>
      <item>
        <p>You can always undo your move. For that, click on the button with a counter of moves done in the headerbar, and click the <gui>Undo</gui> entry in the menu that appears.</p>
      </item>
    </steps>

    <p>Whether you finished the current game or not:</p>
    <steps>
      <item>
        <p>To start a new game –possibly with other options–, click the <gui>New Game</gui> button in the headerbar to go to the <link xref="start-screen">Start Screen</link>.</p>
      </item>
      <item>
        <p>Alternatively, you may want to restart the game. For that, click in the headerbar on the button with a counter of moves done, and click the <gui>Restart</gui> entry in the menu that appears.</p>
      </item>
    </steps>

    <p>You can also use the keyboard.</p>
  </section>

  <section id="16-keyboard">
    <title>How to play with the keyboard</title>

    <p>To make a move:</p>
    <steps>
      <item>
        <p>Use the <key>Left</key> and <key>Right</key> arrows to change the selected column, and the <key>Up</key> and <key>Down</key> arrows to change the selected row. The currently selected row and column are indicated with lights around the board.</p>
        <p>Use <keyseq><key>Shift</key><key>Left</key></keyseq> and <keyseq><key>Shift</key><key>Right</key></keyseq> to swipe the selected row, or <keyseq><key>Shift</key><key>Up</key></keyseq> and <keyseq><key>Shift</key><key>Down</key></keyseq> to swipe the selected column.</p>
      </item>
      <item>
        <p>You can always undo your move. For that, use <keyseq><key>Ctrl</key><key>Z</key></keyseq>.</p>
      </item>
    </steps>

    <p>Whether you finished the current game or not:</p>
    <steps>
      <item>
        <p>To start a new game –possibly with other options–, use <keyseq><key>Ctrl</key><key>N</key></keyseq> to go to the <link xref="start-screen">Start Screen</link>.</p>
      </item>
      <item>
        <p>Alternatively, you may want to restart the game. For that, use <keyseq><key>Shift</key><key>Ctrl</key><key>N</key></keyseq>.</p>
      </item>
    </steps>

    <p>You can also use a mouse.</p>
  </section>
</page>
