Packages. Guide to create new packages. |
|
What do you need?
You can create a package of content with just a simple text editor like Notepad for Windows. The files that make up a package are of two types: web pages (HTML) and chess games in PGN format. Since both of them are pure text files, using Notepad is a possibility. However, the job is easier done if you use any of the existing tools for making web pages or PGN files, many of which are free.
The structure of a package.
All packages include a webpage, which we call the Index, and usually, other Web pages and PGN files with content. Among the different types of webpages, we distinguish a special category we refer to as "web games". Along the same lines, within the games in PGN format, we refer to a special case which is that of the exercises. In brief, a package can contain the following elements:
Required:
Optionally:
- Normal web pages.
- Web games
- Web games with embedded video
- PGN games.
- PGN exercises.
We now describe each of these types.
Index.
It’s a web page, very simple, whose mission is to serve as the index to the package. The only relevant content in it is a series of links. Each link contains two relevant facts:
The text that supports the link. This text will be displayed in the list which the viewer shows below the board and serves as an index for the various elements that make up the package.
The link address. As for the address, we enter the name of the file that the Viewer will open when the user clicks with the mouse on that particular line in the list of contents of the viewer.
For example, the Index for Lesson
316 is as follows:
<body>
<p><font face="Verdana" size="2">Clase : </font></p> <ul>
<!--INDICE-ENLACES--> <li><font face="Verdana" size="2"><a
href="clase316-presen.htm">Presentaci�n.</a></font></li> <li><font
face="Verdana" size="2"><a href="clase316-portada.htm">Portada.</a></font></li>
<li><font face="Verdana" size="2"><a href="clase316-p1.htm">Partida Modelo:
Topalov,V - Kamsky,G.</a></font></li> <li><font face="Verdana" size="2"><a
href="clase316-p2.htm">Bronstein,D - Golombek,H</a></font></li> <li><font
face="Verdana" size="2"><a href="clase316-p3.htm">Kramnik,V -
Ulibin,M</a></font></li> <li><font face="Verdana" size="2"><a
href="clase316-p4.htm">Rosenthal,S - Steinitz,W</a></font></li> <li><font
face="Verdana" size="2"><a href="clase316-p5.htm">Englisch,B -
Steinitz,W</a></font></li> <li><font face="Verdana" size="2"><a
href="clase316-p6.htm">Gligoric,S - Larsen,B</a></font></li> <li><font
face="Verdana" size="2"><a href="clase316-e1.pgn">Tactica. Ejercicio 1.
F�cil</a></font></li> <li><font face="Verdana" size="2"><a
href="clase316-e2.pgn;clase316-s2.pgn">Tactica. Ejercicio 2.
Media</a></font></li> <li><font face="Verdana" size="2"><a
href="clase316-e3.pgn;clase316-s3.pgn">Tactica. Ejercicio 3.
Alta</a></font></li> <li><font face="Verdana" size="2"><a
href="clase316-pr1.pgn;clase316-sl1.pgn">El final de la semana</a></font></li>
</ul> <body>
The provision of links on the page is irrelevant, only the order. In the example above, the links are part of a "list" with entries <li> ...</ li> but this is not necessary. When the Viewer analyses this page, it will simply search for the links, ignoring everything else. Something that is essential though, is that the page should necessarily include:
<!--INDICE-ENLACES-->
Preceding all the links. Any links placed before this tag will be ignored.
In HTML format, all content placed between <!--
y
--> is considered a comment and therefore not shown when viewing the page in a browser. In the case of the Index page, it is not very important, because that page is not displayed in the viewer. However, in the other pages, we can use the comment tags to enter "commands" and other information that will be invisible.
Looking at the last three links of the previous example, we can see that the address of the link (href ="...") contains two filenames, instead of one, separated by a semicolon ";". This is because we are dealing with an exercise. The first filename is the file that contains the exercise, which as we have previously said, is a special case of PGN ( PGN exercise) and the other is the solution of the exercise, a completely normal PGN file. It is not always necessary that two filenames exists, sometimes just the PGN exercise, file is enough, as occurs in the example above, in the line:
<li><font face="Verdana" size="2"><a
href="clase316-e1.pgn">Tactica. Ejercicio 1. F�cil</a></font></li>
We will later discuss further details when we refer to the PGN exercises.
Normal web pages.
As its name suggests, a normal webpage is a page as any other that can be viewed online. In our example from the lesson 316, we have two of these pages, the presentation page and the index page.
<li><font face="Verdana" size="2"><a
href="clase316-presen.htm">Presentaci�n.</a></font></li> <li><font
face="Verdana" size="2"><a href="clase316-portada.htm">Portada.</a></font></li>
These pages may contain images and other elements, including videos; the only thing that should be borne in mind is that these elements must be included in the package for its distribution.
Games web pages.
These pages are designed to contain an annotated game. For the most part they are regular web pages, but what makes them special is that the game and its variations can be replayed on the Viewer's board. To achieve this functionality, the game in PGN format "is embedded" within the page.
For example, let’s see the page containing the first annotated game from Lesson 316:
<body>
<!--PGN='
[Event "??"] [Site "?"] [Date "????"] [Round "?"] [White "?"]
[Black "?"] [Result "0-1"] [Idioma "1"]
1. d4 Cf6 2. c4 e6 3. Cc3
Ab4 4. Cf3 b6 5. e3 Ab7 6. Ad3 Ce4 7. O-O Axc3 (7... Cxc3 8. bxc3 Axc3 9.
Tb1) 8. bxc3 O-O (8... Cxc3 9. Dc2 Axf3 10. gxf3 Dg5+ 11. Rh1 Dh5 12. Tg1
Dxf3+ 13. Tg2 f5 14. Aa3! (14. Dxc3 Dd1+=) 14... Ce4 15. Tf1 Tg8 16. Ae2 Dh3
17. f3 Cd6 18. d5+/-) 9. Ce1 f5 10. f3 Cf6 11. a4 Cc6 12. e4 fxe4 13. fxe4 e5
(13... d6!?) 14. Ag5 De7 (14... exd4? 15. cxd4 Cxd4 16. e5) 15. Cc2 Dd6?!
(15... Tae8!?) 16. Ah4! Tae8 (16... exd4 17. cxd4 Cxd4 18. Ag3 Dc5 19. Af2)
17. Ag3 De7 18. Ce3 d6 (18... exd4 19. Cd5! Cxd5 20. exd5 De3+ 21. Rh1 Ce5
22. Axe5 Txe5 23. cxd4) 19. Ah4! Cd8 (19... Dd7 20. Axf6+/-) 20. Cd5 Axd5 21.
cxd5+/- c6 22. Db3 Rh8 (22... cxd5?! 23. Ab5) 23. Tae1 h6 24. Da3! g5 25. Ag3
Cd7 (25... Ch5?! 26. Axe5+! dxe5 27. Dxe7 Txf1+ 28. Txf1 Txe7 29. Tf8+ Rg7
30. Txd8+-) 26. dxc6 Cxc6 27. Ab5 Txf1+ 28. Txf1 Ccb8 (28... Cdb8 29. d5+-)
(28... Tc8!?) 29. Ac4 Tf8 (29... exd4 30. cxd4 Dxe4 31. Dxd6+-) 30. Txf8+ Dxf8
31. dxe5 Cc5 32. exd6 Cxe4 33. d7! Cc5 (33... Cxd7 34. Dxf8+ Cxf8 35. Ae5+ Rh7
36. Ad3+-)( 33... Dxa3 34. d8=D++-) 34. Ae5+ Rh7 35. Ad3+ (35. Ad3+ Rg8 36.
Da2++-) 1-0
'-->
<font size="2"><b>
<p align="left"><font face="Verdana">Bronstein,D - Golombek,H (E43)<br>
</font> </b><font face="Verdana">Alekhine mem Mosc�, 1956<br> Defensa
Nimzoindia <b>(</b></font><b><font face="Verdana">E43)</font> </p> <p>
<font face="Verdana">
<!--INICIO-ENLAZAR-PGN-->
1.d4 Cf6 2.c4 e6 3.Cc3 Ab4 4.Cf3 b6 5.e3 Ab7 6.Ad3 Ce4 7.O-O Axc3 </font>
</b><font face="Verdana">(7...Cxc3 8.bxc3 Axc3 9.Tb1) <b>8.bxc3 O-O
</b>(8...Cxc3 9.Dc2 Axf3 10.gxf3 Dg5+ 11.Rh1 Dh5 12.Tg1 Dxf3+ 13.Tg2 f5
14.Aa3! <i>(14.Dxc3 Dd1+=) </i>14...Ce4 15.Tf1 Tg8 16.Ae2 Dh3 17.f3 Cd6
18.d5+/- Keres,P-Spassky,B/(m)/1965/]) <b>9.Ce1 f5 10.f3 Cf6 11.a4 Cc6 12.e4
fxe4 13.fxe4 e5 </b>(13...d6!?) <b>14.Ag5 De7 </b>(14...exd4? 15.cxd4 Cxd4
16.e5) <b>15.Cc2 Dd6?! </b>(15...Tae8!?) <b>16.Ah4! Tae8 </b>(16...exd4
17.cxd4 Cxd4 18.Ag3 Dc5 19.Af2) <b>17.Ag3 De7 18.Ce3 d6 </b>(18...exd4
19.Cd5! Cxd5 20.exd5 De3+ 21.Rh1 Ce5 22.Axe5 Txe5 23.cxd4) <b>19.Ah4! Cd8
</b>(19...Dd7 20.Axf6+/-) <b>20.Cd5 Axd5 21.cxd5+/- c6 22.Db3 Rh8
</b>(22...cxd5?! 23.Ab5) <b>23.Tae1 h6 24.Da3! g5 25.Ag3 Cd7 </b>(25...Ch5?!
26.Axe5+! dxe5 27.Dxe7 Txf1+ 28.Txf1 Txe7 29.Tf8+ Rg7 30.Txd8+-) <b>26.dxc6
Cxc6 27.Ab5 Txf1+ 28.Txf1 Ccb8 </b>(28...Cdb8 29.d5+-; 28...Tc8!?) <b>29.Ac4
Tf8 </b>(29...exd4 30.cxd4 Dxe4 31.Dxd6+-) <b>30.Txf8+ Dxf8 31.dxe5 Cc5
32.exd6 Cxe4 33.d7! Cc5 </b>(33...Cxd7 34.Dxf8+ Cxf8 35.Ae5+ Rh7 36.Ad3+-)(
33...Dxa3 34.d8=D++-) <b>34.Ae5+ Rh7 35.Ad3+ </b>(35.Ad3+ Rg8 36.Da2++-)
</font> <b><font face="Verdana">1-0
<!--FIN-ENLAZAR-PGN-->
</font> </p> </b> </font> <P><FONT size=2><B></P></B></FONT>
</body>
We have highlighted in green the PGN "embedded" as a comment because it is enclosed between the sequences <!--
y
-->.
For the viewer to recognize them, the opening and closing tags have to be exactly as the one marked in red:
<!--PGN='
'-->
We have highlighted in red two more comments within the page:
<!--INICIO-ENLAZAR-PGN-->
<!--FIN-ENLAZAR-PGN-->
The viewer not only extracts the game in PGN format to replay it on the board, but also "interprets" the page as a whole to synchronize the moves on the board with the moves that are shown on the visible part of page, so that clicking on any of those moves, will execute the corresponding move on the board. Conversely, when we replay the game on the board, using the buttons below it, a cursor on the text will keep indicating where we are in the moves tree. The role of the two comments above, is helping the viewer identify the area of the page containing the text to be synchronized with the moves.
There are two further comments directly related to this:
<!--EVITA ENLAZAR-->
<!--FIN EVITA ENLAZAR-->
You can put as many pairs of these tags as you want, and the area between each pair will not be explored by the application, looking for game moves.De esta forma, se pueden incluir en el texto visible jugadas sin miedo a que interfieran con el proceso de "casar" las jugadas de la parida con las del texto. In this way, the moves can be included in the visible text without fear of interfering with the process of "matching" the moves of the text with those to be replayed on the board.
The viewer can replay games directly in PGN format, so we need not use the concept of games web pages to show games online. However, they can contain additional elements such as images, videos, etc and allow editing of many resources: fonts, colors, font sizes, tables, etc, things that are not possible within the PFN format specification.
The appearance of the notation of the moves can be controlled by defining html styles. If we define the styles .j and .v , the Viewer will apply them to the moves of the main line and to the variations respectively.
For example:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<title>Partida enbebida en un HTML</title>
<style>
<!--
.j {font-family: Verdana; color: #000000;
text-decoration: none; font-weight: bold}
.v {font-family: Arial; color: #0000FF;
text-decoration: none; font-weight: bold}
-->
</style>
</head>
<body>
In the example above we setup the Viewer so that moves from the main line (.j)
are written using the Verdana font, bold and black (#000000),
while variations (.v)
are shown with Arial blue (#0000FF)
y and also in bold.
The instruction text-decoration:
none prevents the moves appearing "underlined", as with usual links on a Web page. The text becomes much more readable when you remove the "underline".
You can also define the background color of the moves (necessary if the page has defined a background color) and the color of the cursor pointing to the last executed move as the game is replayed. This is done through the "comments" below, anywhere in the page.
<!--FONDO-JUGADAS:ffffff-->
<!--CURSOR-JUGADAS:00ff00-->
The first one sets the background color for the moves while the second one sets the color for the cursor.A good place to include these comments is next to the comment:
<!--INICIO-ENLAZAR-PGN-->,
for example::
<!--FONDO-JUGADAS:ffffff-->
<!--CURSOR-JUGADAS:00ff00--> <!--INICIO-ENLAZAR-PGN--> <b>1.d4 d5 2.c4
c6 3.Cf3 Cf6 4.Cc3 a6 </b>[Un sistema que �ltimamente
Web pages with videos.
There are different ways to "embed" a video on a webpage, let us mention the one using the label <OBJECT>
<OBJECT ID="PlayerVsIntAj"
CLASSID="CLSID:6BF52A52-394A-11d3-B153-00C04F79FAA6"
width="245" height="240">
<PARAM name="autoStart"
value="True">
<PARAM name="URL"
value="videos\Video013m.wmv">
</OBJECT>
There are many different PARAM that can be used to control the look & feel of the Viewer, as well as its way of operating. The only mandatory param is the URL, that indicates the path and name of the file to replay.
<PARAM
name="uimode" value="mini">
<PARAM
name="uiMode" value="full">
<PARAM
name="uiMode" value="none">
<PARAM
name="uiMode" value="invisible">
For further information please visit this page.
If the page containing the video also shows a Web game and you would like both items to interact, the ID of the player must be PlayerVsIntAj and the following JavaScript code must be present on the page.
In the header, two functions are defined allowing the viewer to replay and stop the games:
<head>
...
<script type="text/javascript">
function PlayerVsIntAjPausa()
{
PlayerVsIntAj.controls.pause();
}
function PlayerVsIntAjPlay()
{
PlayerVsIntAj.controls.play();
}
</script>
...
</head>
<body>
Anywhere on the page, usually behind the definition of the player, place the code that lets the viewer interpreting the marks present in the video.
...
<PARAM name="URL" value="videos\Video013m.wmv">
</OBJECT>
<span id="ParamVsIntAj" style="position:absolute;left:0px;top:0px;visibility:hidden;"></span>
<script language="JScript" for="PlayerVsIntAj" event="MarkerHit(x)">
ParamVsIntAj.innerText =
PlayerVsIntAj.currentMedia.getMarkerName(x);
</script>
...
</body>
If you want to use a frames page to separate the video from the rest of the page, then the viewer must be placed in the main frame.
Games in
PGN format.
A package may contain one or more games in PGN format, you just need to add the links in the corresponding Index. While Web games are a way to show games with much more resources embedded, they are harder to build up than a simple Game in PGN format, that can also be generated automatically by applications such as Chessbase.
A simple example of a game in PGN format is as follows:
[Event "Skien"] [Site "Skien"] [Date
"1979"] [Round "?"] [White "Seirawan,Y"] [Black "Barbero,G"] [Result
"1-0"] [SetUp "1"] [FEN "2b2r1k/2pp2p1/3n1p2/2Q4p/2P5/3BPPR1/1B1PKP1q/8 w
- - 0 0"]
1. Txg7! {esto es un comentario} Rxg7 2. Dg5+ Rf7 3. Dxf6+ Re8
4. Ag6+ Cf7 {a continuaci�n una variante} (4... Tf7 5. Ae5 Dh3 6. Axd6 cxd6
7. Axf7+) 5. Ae5! (5. Ae5! Dh3 6. Axc7) 1-0
As can be seen, it consists of two distinct sections.
The first are descriptive labels, one per line and enclosed in brackets [... ]. Each label consists of a concept (eg Event, White, Result, etc.) and writing a value in quotes (eg "Skien", "Seirawan, Y", "1-0", etc). The PGN format has a predefined set of concepts, but not all need to be present in a game.
The second section, separated from the labels on a blank line, is the moves, comments and variations of the game. Anything enclosed in braces (... ) is a comment and if it is enclosed in parentheses (...) is a variation.
Besides the standard features of the PGN format, the Viewer supports certain extensions that are described below:
Extensions to the PGN format.
The Viewer provides two types of add-ons or extensions to PGN format:
New labels.
- [Idioma
"1"].
Indicates the language in which the moves are listed. 0 = English, Spanish = 1. If you do not include this tag it is assumed that the viewer is in English.
- [ImgWhite
"f-bologan.jpg"].
If you include this label, the Viewer displays on the right side of the part of the screen showing the game, the image referenced in this label. Is designed to display an image of the white player, but can be any image, including one banner.
- [UrlWhite
"http://www.paidotribo.com/ficha.asp?codart=00865"].
This tag is associated with the former and only makes sense if both are defined. Its mission is to provide a link to "jump" when you click on the image defined in the label ImgWhite.
- [ImgBlack
"f-lenier.jpg"].
Similar to ImgWhite, if you have defined the image ImgWhite,
, the image of the label is placed to the right of the other.
- [UrlBlack
"http://www.paidotribo.com/ficha.asp?codart=00865"].
Similar to UrlWhite.
- [Ejercicio
"316-E2"].
This label is necessary when the exercise is a PGN file, the value is a label identifyer the viewer does not use.
- [Video
"Video013m.wmv;336;310"]. Causes the viewer to add a new toolbar button. When you press this button, the Viewer opens a window with the dimensions specified in this label (336 x 310 in this example) and plays in it, the video for the specified file (Video013m.wmv in this example).
Comments with a special meaning.
In a PGN file, any text enclosed in braces "()" is considered a comment and this is the treatment made by the viewer in general. However, the viewer gives a special meaning to certain comments in order to expand its functionality. It does so in issues that the PGN format does not address, without losing compatibility with the standard. So items can be read with an application that follows the standard PGN, such as ChessBase.
These PGN format extensions can be grouped into three sections:
Affecting the presentation of the text.
{}This null comment (nothing between the brackets) is interpreted by the viewer as a carriage return. The Viewer makes it possible to separate paragraphs in the content of a game, adding two new lines at the beginning and at the end of the first-level variations. This is one of the settings of the viewer, improving the readability of content, without having to manually enter null comments. If you ever need one or more lines this null comment is the way to go.
|->This sequence of three characters indicates that everything appearing afterwards will be hidden. It means that when the viewer is in hiding mode, that sequence will not be displayed. This option is specifically designed to display exercises, where the user should not see immediately the comments and solutions. This is a very simple solution, and very limited too, because the content after the hiding mark can be hidden / displayed, but all at the same time. For move by move exercises you need to use PGN Exercises. When the viewer loads a content that contains that type of mark, a new button (with an eye icon) appears in the toolbar. When you press this button the hidden content is revealed.
Graphics.
{IMAGEN:nombrefichero}
example: {IMAGE:kramnik.gif}
When the Viewer finds a mark of this type, displays the image "nombrefichero” (kramnik.gif, in the example) in an auxiliary window. The exact moment for it to happen is when we are at the move immediately prior to the location of the mark.
{FONDO:color:color,casilla,casilla,...,color:color,
casilla,...}
example: {BACK:color:red,e2,color:blue,d7}
When the Viewer finds a mark of this type, applies the specified color to the squares on the board that have been indicated. Si en la casilla hay una pieza el color de la pieza no se ve afectado. The color of pieces is not affected.
{MARCO:color:color,casilla,casilla,...,color:color,
casilla,...}
example: {SQUARE:color:red,a1,h8,color:blue,b2,g7,g2,b7}
When the Viewer finds a mark of this type, the indicated squares are highlighted with boxes in the selected color.
{FLECHA:color:color,a3-h3,a2-b2,...,color:color,...}
example: {ROW:color:yellow,a3-h3,color:pink,a4-h4}
When the Viewer finds a mark of this type, it draws arrows linking the indicated squares.
These types of comments can be combined among themselves and with other comments by using the separator "/" between them, for example:
{IMAGE:leko.gif/ROW:color:yellow,a3-h3,color:pink,a4-h4/SQUARE:color:red,a1,h8,color:blue,b2,g7,g2,b7/
Una jugada t�pica del estilo impulsivo y arriesgado}
The keywords in these comments should be in the same language that have been used to annotate the moves of the game.
| CASTELLANO |
INGL�S |
| IMAGEN |
IMAGE |
| FONDO |
BACK |
| MARCO |
SQUARE |
| FLECHA |
ROW |
| COLOR |
COLOR |
| NEGRO |
BLACK |
| AZUL |
BLUE |
| CIAN |
CYAN |
| GRISOSCURO |
DARKGRAY |
| GRIS |
GRAY |
| VERDE |
GREEN |
| GRISCLARO |
LIGHTGRAY |
| MAGENTA |
MAGENTA |
| NARANJA |
ORANGE |
| ROSA |
PINK |
| ROJO |
RED |
| BLANCO |
WHITE |
| AMARILLO |
YELLOW |
| VERDECLARO |
LIGHTGREEN |
| ROJOOSCURO |
DARKRED |
Exercises
The purpose of these "extensions" is that the viewer can offer exercises to the users, that they should solve indicating the corresponding move at every moment.
Además de las extensiones que aquí se van a comentar, es imprescindible incluir la etiqueta Ejercicio . In addition to the extensions that we are going to discuss here, it is mandatory to include the label
Ejercicio.
An exercise is viewed as a normal game, but in one or several parts of the game some moves will be missing, as well as their commentaries or variations. The space that those elements should occupy is left blank. Too often everything is missing at first, and all that is displayed is an invitation to make the first move on the board.
When you are at a move immediately before a hidden move, the Viewer will show below the board, the buttons that allow “to respond” (Rpta) and "to deliver" (Ent) the exercise. To indicate your move that serves as an answer, you need to click with the mouse twice, first on the origin and then on the destination square. Once both squares are marked, click "Rpta".
The origin square is where the piece to be moved is. Clicking on it will colour that square in blue.
Next you click on the destination square, that will be marked in red. To cancel your selection and start over, simply click on the square in blue. To change only the destination square, just click on another square.
If you do not know an answer, to continue with the exercise you must click "Rpta"without marking any square. This is equivalent to an incorrect answer. As you make progress in the resolution of the exercise, the hidden moves and comments will show up, so that at the end of the exercise the game is fully displayed as a normal game.
When the exercise is over, it`s time to "deliver it" by pressing the button labeled "Ent". In doing so, the results are sent to the server. You can only click on the delivery button once, because it automatically disappears. Therefore it is very important not to do so until the exercise is completely finalized or you will lose the opportunity to improve your score by solving the remaining questions.
It is very important not to move forward using the cursor keys below the chessboard, or by clicking on the document ahead of a hidden area, because its content will be revealed and the Viewer won`t ask you again to answer those questions and you will not have a chance to win those points.
Preparing the exercise.
To prepare an exercise, you basically do two operations:
- mark the hidden areas
- assign points to the hidden moves
If you wish that on a hidden paragraph the user should only try to guess the moves made by one side, you can instruct the Viewer to execute automatically the moves made by the other side in response to those moves made by the user taking the exercise.
The following are comments with a specific meaning in relation to the creation of exercises:
{EJERCICIO:INI}
{EJERCICIO:FIN}
This pair of comments allows to hide a fragment of a game. Everything that lies between the two comments will be hidden.
For items encoded in English:
{EXERCISE:START}
{EXERCISE:END}
{DESLIZA:BLANCAS}
{ALTODESLIZAR:BLANCAS}
{DESLIZA:NEGRAS}
{ALTODESLIZAR:NEGRAS}
These pairs of comments made in fragment of a game defined between them, when a move is executed by the specified side, the next move of the opponent will be made automatically.
For items encoded in English:
{SLIP:WHITE}
{STOPSLIP:WHITE}
{SLIP:BLACK}
{STOPSLIP:BLACK}
{PUNTOS:n1:n2}
This comment indicates the points (n2) that are added to the concept (n1) for guessing the next move after the comments..
The concepts to award points are:
| n1 |
Concepto |
| 0 |
Elo |
| 1 |
Estat�gia |
| 2 |
T�ctica |
| 3 |
Aperturas |
| 4 |
Medio Juego |
| 5 |
Finales |
For items encoded in English:
{POINTS:n1:n2}
PGN Exercises.
The PGN exercises are normal PGN files, with a series of add-ons that make the viewer treat them in a special way. It is obvious that the moves that the user must guess, should be hidden and the buttons that the user needs to press to complete the exercises have to be visible.
Those add-ons or extensions, were described in the previous section "Extensions to PGN format”
Below is an example of a PGN exercise
[Event "Carlsbad"]
[Site "Carlsbad"]
[Date "1907"]
[Round "?"]
[White "Berger,J"]
[Black "Chigorin,M"]
[Result "0-1"]
[SetUp "1"]
[FEN "8/p3bn2/1pp1kp1p/6p1/1PP2PP1/P1BB1K1P/8/8 w - - 0 0"]
[Idioma "1"]
[Ejercicio "316-P1"]
{El final de la semana}{}
{}
{Juegan las blancas. El final es muy favorable gracias a la pareja de alfiles, pero hay que encontrar el mejor plan. �C�mo han de
jugar?}{}
{}
{Es el momento de indicar el primer movimiento de las blancas.}{}
{}
{EJERCICIO:INI}
{DESLIZA:BLANCAS}
1. Af5+ {PUNTOS:0:1} Rd6
2. Ag6 {PUNTOS:0:1} Cd8
3. fxg5 {PUNTOS:0:1} hxg5
4. Re4 {PUNTOS:0:1} Ce6
5. Af7 {PUNTOS:0:1} Cg7
6. Ae1 {PUNTOS:0:1} Rd7
7. Ac3 {PUNTOS:0:1} Ad8
8. b5! {PUNTOS:0:1} Re7
9. Ag8 {PUNTOS:0:1} Rf8
10. Ah7 {PUNTOS:0:1} cxb5
11. cxb5 {PUNTOS:0:1} Re7
12. Ab4+ {PUNTOS:0:1} Re6
13. Ag8+ {PUNTOS:0:1} Rd7
14. Rd5 {PUNTOS:0:1} Ae7
15. Axe7 {PUNTOS:0:1} Rxe7
16. Rc6 {PUNTOS:0:1} Ce8
17. a4 {PUNTOS:0:1} Cd6
18. Rc7 {PUNTOS:0:1} Ce4
19. Ab3 {PUNTOS:0:1} Cc5
20. Ac2 {PUNTOS:0:1} Re6
21. Rb8 {PUNTOS:0:1} Rd6
22. Rxa7 {PUNTOS:0:1} Rc7
23. a5 {PUNTOS:0:1} bxa5
24. b6+ {PUNTOS:0:1} Rc6
25. Ae4+ {PUNTOS:0:1} Cxe4
26. b7 {PUNTOS:0:1} {ganando.}
{ALTODESLIZAR:BLANCAS}
{EJERCICIO:FIN}
0-1
And this would be the appropriate solution to this PGN exercise:
[Event "Carlsbad"]
[Site "Carlsbad"]
[Date "1907"]
[Round "?"]
[White "Berger,J"]
[Black "Chigorin,M"]
[Result "0-1"]
[SetUp "1"]
[FEN "8/p3bn2/1pp1kp1p/6p1/1PP2PP1/P1BB1K1P/8/8 w - - 0 0"]
[Idioma "1"]
{El final de la semana}{}
{}
{Juegan las blancas. El final es muy favorable gracias a la pareja
de alfiles, pero hay que encontrar el mejor plan. �C�mo han de jugar?}{}
{}
1. Af5+ Rd6 2. Ag6 Cd8 3. fxg5 hxg5 4. Re4 Ce6 5. Af7 Cg7
({Si} 5... Cf4 6. Rf5 Cxh3 7. Axf6 Axf6 8. Rxf6) 6. Ae1 Rd7
7. Ac3 Ad8 8. b5! Re7 9. Ag8 Rf8 10. Ah7 cxb5 11. cxb5 Re7
12. Ab4+ Re6 13. Ag8+ Rd7 14. Rd5 {las negras est�n en zugzwang}
14... Ae7 ({si} 14... Rc7 15. Af8 Ce8 16. Ae6 Rb7 17. Ad7 Cc7+
18. Re4 a6 19. a4 axb5 20. axb5 Rb8 21. Ad6 Rb7 22. Ac6+ Rc8
23. Rf5) 15. Axe7 Rxe7 16. Rc6 Ce8 17. a4 Cd6 18. Rc7 Ce4
19. Ab3 Cc5 20. Ac2 Re6 {Hasta aqu� las blancas han jugado de modo
impecable. Pero ahora yerran el camino:} 21. Rc6? ({En lugar de
21. Rc6, lo correcto era} 21. Rb8 Rd6 (21... a6 22. Rc7 axb5
23. axb5 Re5 24. Rxb6 Rd6 25. Ra7 Rc7 26. b6+ Rc6 27. Ae4+)
22. Rxa7 Rc7 23. a5 bxa5 24. b6+ Rc6 25. Ae4+ Cxe4
26. b7 {ganando.}) 21... Re5 22. a5 Ce6 23. axb6 Cd4+
24. Rb7 axb6 25. Ad3 ({y tras} 25. Ad3 f5 26. gxf5 Cxb5
27. Axb5 Rxf5 {la partida es tablas, ya que el pe�n "h"
corona en casilla de color diferente a las del alfil.
Sin embargo, las negras tampoco jugaron as�, sino que,
en lugar de 25... f5, eligieron}) 25... Rd6? {y tras}
26. Rxb6 {terminaron perdiendo} 0-1
In all these examples, the specific exercises that are extensions to PGN format are highlighted in red. If has been assigned a point (1),
to the concept Elo (0)
in all the moves {PUNTOS:0:1},
but in real situations, the score will vary depending on the difficulty of each move and probably also the concept in which the points must be assigned.
Organization of files in one package.
The Index file can be located in any folder. That folder in turn must contain a new folder named paginas. In that paginas folder all the other files should be copied, for instance PGN and HTML files, as well as images plus other files used in any of those pages.
Although the pages are contained in a folder other than where the index
file is, links to those pages, from the index page,
should not include a reference to that paginas folder, as if they were in the same folder than the index file.
For convenience in the distribution and use, the software packages can be compressed into a zip file. The index
should appear at the root of the entries in the zip file, ie not preceded by any path, while the other files must be preceded by exactly the reference to the paginas folder

The viewer can read directly the compressed file, which can even be encrypted. In this case, the viewer will attempt to open the file using the key to the active profile connection (with which the last connection to the magazine was made, or the last selected in the folder options).
|