Help:Hex - Revision history

Demer: fixed typo

2020-12-10T21:47:25Z

fixed typo

Selinger: Updated the documentation of the old tag; show that it is deprecated.

2020-12-10T17:08:29Z

Updated the documentation of the old <hex> tag; show that it is deprecated.

Roland Illig: /* Setting up a certain position and some moves */

2012-11-04T14:37:08Z

‎Setting up a certain position and some moves

Roland Illig: /* Setting up a certain position and some moves */ changed the syntax to "common words" instead of cryptic abbreviations

2012-11-04T14:32:40Z

‎Setting up a certain position and some moves: changed the syntax to "common words" instead of cryptic abbreviations

Roland Illig: "game mode", especially for commenting games

2012-11-04T13:04:25Z

"game mode", especially for commenting games

Roland Illig: /* Source code */ The location changed.

2012-09-27T22:37:04Z

‎Source code: The location changed.

Roland Illig: /* Syntax */ example

2012-09-22T19:25:27Z

‎Syntax: example

Roland Illig (Admin): /* Examples */ example by visualization

2012-09-09T23:14:06Z

‎Examples: example by visualization

Roland Illig (Admin): /* Examples */ example by visualization

2012-09-09T23:12:58Z

‎Examples: example by visualization

Roland Illig (Admin): /* Examples */ example by visualization

2012-09-09T23:04:04Z

‎Examples: example by visualization

← Older revision		Revision as of 21:47, 10 December 2020
Line 1:		Line 1:
−	;<font color="red">''This page is outdated. It describes the old <tt><hex></tt> syntax for writing Hex diagrams, ~~whic his~~ still used on some pages of this Wiki. New diagrams should be written using the more versatile <tt><hexboard></tt> syntax described at [[New board diagrams]].''</font>	+	;<font color="red">''This page is outdated. It describes the old <tt><hex></tt> syntax for writing Hex diagrams, which is still used on some pages of this Wiki. New diagrams should be written using the more versatile <tt><hexboard></tt> syntax described at [[New board diagrams]].''</font>

	== Syntax ==		== Syntax ==

@@ Line 1: / Line 1: @@
-This is the documentation for the MediaWiki plug-in for drawing Hex diagrams.
+;<font color="red">''This page is outdated. It describes the old <tt>&lt;hex&gt;</tt> syntax for writing Hex diagrams, whic his still used on some pages of this Wiki. New diagrams should be written using the more versatile <tt>&lt;hexboard&gt;</tt> syntax described at [[New board diagrams]].''</font>
 == Syntax ==
@@ Line 45: / Line 45: @@
 When you want to add move numbers, put a single digit (0-9) between the command and the coordinate,
 for example '''R5e4''' when Red puts his fifth move onto e4.
 === Examples ===
@@ Line 52: / Line 50: @@
 * '''Ba4''' puts a blue stone ('''B''') in the first column ('''a''') of the fourth row ('''4''').
 * '''R7b1''' puts a red stone ('''R''') in the second column ('''b''') of the first row ('''1''') and labels it with a seven ('''7''').
 <hex>
 R5 C5 Q1
-Ba4 R7b1 [[#Setting_up_single_stones|Ba5]]
+Ba4 R7b1
 </hex>
@@ Line 66: / Line 63: @@
 When you want to show a complete game, it can be annoying to replace the '''H'''... and '''V'''... commands with '''M'''. For this reason, there is another feature, which automatically numbers the following stones. It is switched on with '''N:on''' and off with (you guessed it) '''N:off'''.
 === Examples ===
 * '''MR Ma1 Ma2 Ma3 Mb4''' is a sequence of four moves, starting with a red ''1''.
 * '''M5c1 Mc2 Mc3''' are three moves, starting with a red ''5''.
-* '''MB Me1 Me2 Me3''' are three moves, starting with a blue ''1''.
+* '''MB Me1 Me2 Me3''' are three moves, starting with a blue ''8''.
 * '''N:on Rg1 Bg7 N:off Rg4''' results in two numbered moves on g1 and g7, and one unnumbered move at g4.
@@ Line 80: / Line 74: @@
 MR Ma1 Ma2 Ma3 Ma4
 M5c1 Mc2 Mc3
 MB Me1 Me2 Me3
 N:on Rg1 Bg7 N:off Rg4
@@ Line 98: / Line 91: @@
 <pre>
 &lt;hex>
-R5 C9 labels border
+R5 C9 labels
 play a1 a2 a3 a4
 red numbered c1 c2 c3 c4 unnumbered
@@ Line 108: / Line 101: @@
 <hex>
-R5 C9 labels border
+R5 C9 labels
 play a1 a2 a3 a4
 red numbered c1 c2 c3 c4 unnumbered
@@ Line 157: / Line 150: @@
 === A simple board with stones in all four corners ===
 <hex>
 R5 C5 Q1
@@ Line 162: / Line 156: @@
 Be1 Ba5
 </hex>
+</pre>
-And the same with stones that are linked to other pages.
 <hex>
 R5 C5 Q1
-[[Red|Ra1]] [[Red|Re5]]
+Ra1 Re5
-[[Blue|Be1]] [[Blue|Ba5]]
+Be1 Ba5
 </hex>
 === Numbered moves ===
 <hex>
 R5 C5 Q1
 Mc3 Ma3 Me3 Mb2 Md4
 </hex>
+</pre>
-=== Border ===
-You can draw a colored border around the diagram by giving the command <tt>B:on</tt>.
 <hex>
-R5 C5 Q1 B:on
+R5 C5 Q1
-Ma1 Mb2 Mc3 Md4 Me5
+Mc3 Ma3 Me3 Mb2 Md4
 </hex>
 === All possible fields ===
 <hex>
 Q1 C11 R4
@@ Line 195: / Line 188: @@
 Ma4 Mb4 Mc4 Md4 Me4 Mf4 Mg4 Mh4 Mi4 Mj4 Mk4
 </hex>
-== Source code ==
+<hex>
+Q1 C11 R4
-The full source code of the plug-in is available [http://www.hexwiki.org/hex/ here].
+Ra1 R1b1 R2c1 R3d1 R4e1 R5f1 R6g1 R7h1 R8i1 R9j1 R0k1

@@ Line 98: / Line 98: @@
 <pre>
 &lt;hex>
-R5 C9 labels borders
+R5 C9 labels border
 play a1 a2 a3 a4
 red numbered c1 c2 c3 c4 unnumbered
@@ Line 108: / Line 108: @@
 <hex>
-R5 C9 labels borders
+R5 C9 labels border
 play a1 a2 a3 a4
 red numbered c1 c2 c3 c4 unnumbered

@@ Line 87: / Line 87: @@
 == Setting up a certain position and some moves ==
-When commenting a game you usually have some moves that lead to a certain position, and from this position you want some numbered moves. This can be done using the plain coordinates.
+When you set up a position there are two common cases: replaying a game, or setting up an isolated position. These cases can be written easily using the following ''setup modes'':
 <pre>
 &lt;hex>
-R11 C11 Q1 B:on
+R5 C9 labels borders
-a1 a2 a3 a4
+play a1 a2 a3 a4
-N:on
+red numbered c1 c2 c3 c4 unnumbered
-a5 a6 a7 a8
+blue e1 e2 e3 e4
 &lt;/hex>
 </pre>
 <hex>
-R11 C11 Q1 B:on
+R5 C9 labels borders
-a1 a2 a3 a4
+play a1 a2 a3 a4
-N:on
+red numbered c1 c2 c3 c4 unnumbered
-a5 a6 a7 a8
+blue e1 e2 e3 e4
 </hex>
-The nice point is that for the next diagram you just have to remove the '''N:on''' to have the final position without numbers, so you can easily add the next moves.
+Note:
 == Setting up a whole line at once ==

@@ Line 84: / Line 84: @@
 N:on Rg1 Bg7 N:off Rg4
 </hex>
 == Setting up a whole line at once ==

← Older revision		Revision as of 22:37, 27 September 2012
Line 160:		Line 160:
	== Source code ==		== Source code ==

−	The full source code of the plug-in is available [http://www.hexwiki.org/~~mediawiki-common/extensions/hex2~~/ here].	+	The full source code of the plug-in is available [http://www.hexwiki.org/hex/ here].

@@ Line 7: / Line 7: @@
 The first letter of each word is called the ''command'', and the remaining letters are its ''arguments''.
 There are commands for specifying the board size and for putting stones on the board.
 == Setting up the board ==

@@ Line 96: / Line 96: @@
 === Examples ===
 * '''3:__BBRRBBRR__*''' sets up the first 13 stones of the third row. The first two are empty, the next two are blue, and so on.
 == Formatting diagrams usefully ==

@@ Line 48: / Line 48: @@
 * '''Ba4''' puts a blue stone ('''B''') in the first column ('''a''') of the fourth row ('''4''').
 * '''R7b1''' puts a red stone ('''R''') in the second column ('''b''') of the first row ('''1''') and labels it with a seven ('''7''').
-* '''<nowiki>[[</nowiki>#Variant_A|Ba4]]''' is like the first example, but when you click on the stone, you reach the section called ''Variant A'' on the same page.
+* '''<nowiki>[[</nowiki>#Setting_up_single_stones|Ba5]]''' puts a blue stone on the board and links it to the section called ''Setting up single stones'' on the same page. Note that you cannot use space characters in the link.
 == Automatically numbered moves ==