7. Export to HTML

Before you export your ChessTask file into HTML format, make sure that the correct options are set.

If you select "Export"/"Options" you get a small window with the available HTML options:

• Export to single file: If this box is "checked" all tasks of your list are written into a single HTML file `index.html' and the solutions likewise to `sol.html'. If "unchecked" (the default), ChessTask generates an own HTML page for each task and each solution. These pages get linked, such that you can step from one task to another.
• Use TrueType font: This box is "checked" by default and you can leave it like that for now. The option behind it is important in connection to the Advanced text options and gets explained in The DBChess fonts.
• Informator symbols in plain text: Is "unchecked" by default and "disabled" as long as the option "Use TrueType font" is selected. Both are closely related, so refer to Advanced text options, The DBChess fonts and Informator symbols for further explanations if you plan to use the "extended" text options of ChessTask. Otherwise, do not care about this checkbox.
• Levels to graphics directory: This is the most important HTML option, so read carefully! ChessTask uses `PNG' images for the display of the board diagrams, the links (from one task to another and to the index) and sometimes also for some special symbols like "capture"---depending on the options you selected. These graphic files are all kept in the directory named `graphics', which you can find in the ChessTask directory. Now, let us say you created a directory named `html' on your disk, where you want to put all the HTML files with your tasks. Further, we assume that this directory is situated at `C:/data/chesstask' so its complete path is `C:/data/chesstask/html'. The first requirement is: The `graphics' directory (or a copy of it) and the "top directory" of your tasks, which is the directory `html' in this case, have to be in the same directory. So, for the given situation you would have to create a copy of the complete `graphics' directory at `C:/data/chesstask/graphics' if it does not already exist. Of course, you want to create further subdirectories for dividing up your tasks into categories like `endings' or `openings'. Within the `endings' directory you want to separate `pawn' endings from `rook' endings a.s.o. Within your directory `html' you can set up the directory structure according to your personal needs. Now, we get to the option itself. If you want to export your tasks to a subdirectory of `C:/data/chesstask/html' you have to set Levels to graphics directory to the number of directory levels upwards to the directory `graphics'. So, for a directory `C:/data/chesstask/html/endings/bishops' the correct value would be "3". For the directory `C:/data/chesstask/html/checkmates/intwo/novar/simple' the value should be "5". Finally, I would like to recommend that you simply use the already existing directory `html', in the ChessTask directory to store your tasks in HTML format.
• Export with solutions: This "general" option affects both, LaTeX and HTML export. If it is "checked" (default) the solutions and the corresponding links are output. If "unchecked" no links appear on the "task pages" and no HTML files with solutions are generated.

Now, you can select "Export"/"HTML files", choose a directory with the help of the file dialog and create the HTML files. If you did everything right, you can inspect the result with your browser immediately.

If ChessTask did not create any files, this can have mainly two reasons:

1. You aborted the export by cancelling the file dialog.
2. The files could not be opened for writing, either because the disk is full or because you do not have permission to write to the specified directory.