EntryDambo version 2.03 (December 2005) French translation

Introduction

EntryDambo is an application to generate webpages with the ReplayDambo applet. It can be used to convert files from PDN and TurboDambase .doc format to ReplayDambo format. You can also use it to manually enter games. EntryDambo was made by Wieger Wesselink and Huub van de Wetering. The previous version of EntryDambo is still available here.

Webstart

EntryDambo is now a Java Webstart application. You need to have a recent version of the java runtime environment (JRE) installed on your computer to run it (5.0 or higher). The necessary software can be downloaded from www.java.com. Before you start using the application, please read the disclaimer agreement.

Disclaimer agreement

Users of the EntryDambo/ReplayDambo applications must accept this disclaimer of warranty:

  "EntryDambo/ReplayDambo is supplied as is. The authors disclaim all
  warranties, expressed or implied, including, without limitation, the
  warranties of merchantability and of fitness for any purpose. The
  authors assume no liability for damages, direct or consequential, which
  may result from the use of EntryDambo/ReplayDambo.
  EntryDambo/ReplayDambo is a freeware program and is provided at no charge
  to the user. Feel free to share it with your friends, but please do not
  give it away changed or as part of another system. Commercial usage of
  EntryDambo/ReplayDambo is not allowed under any circumstances."
  

Changes

  • PDN (portable draughts notation) is now supported. It is possible to save the games to a PDN file and later import that file again, so you can edit a file later on.

  • The user interface has been improved a lot. Most of your settings are saved in a properties file, so you only need to set them once.

  • Publishing a web page with a Dambo applet has become much easier. When exporting games to HTML, three files will be generated: filename.html, filename.gz (containing the games) and ReplayDambo.jar. The images are now part of ReplayDambo.jar.

  • The generated webpage can be uploaded to an FTP server. This makes it even easier to publish a web page. It is especially useful if you want to use EntryDambo for recording live games.

  • What did not change yet is the ReplayDambo applet itself. That is still on our todo-list.

Starting the application.

You can start the application by clicking on the EntryDambo link. If java webstart was installed properly, a security warning will appear. Only if you accept the certificate the application will start.

java certificate

Using the application.

Below an explanation is given about the most important user interface elements of the program.

Configuring the user interface.

The user interface can be configured by resizing the window in the usual way, and by means of two splitters, indicated with red arrows in the figure below. Manipulating the splitters will not shrink the size of the board. As a result, sometimes it is not possible to increase the width of the left or right columns of the window. If the left or right column is too small, the recommended way to solve this is as follows:

  1. Decrease the window height, by dragging the bottom of the window upwards (blue arrow). This will make the board smaller.

  2. Choose an appropriate width for the left and right columns using the splittes (red arrows).

  3. Increase the window height again by dragging the bottom downwards (blue arrow).

The settings of the user interface are saved, so you have to do this only once. Properties are stored in a file called .entrydambo, and is located in your home directory.

resizing the user interface

File menu

  • Import It is possible to read text files in PDN format (.pdn) and Turbo Dambase format (.doc).

  • Export Html A webpage will be generated with an applet containing all of the games. There will be three files generated: file.html (the Html file), file.gz (the file containing the games) and ReplayDambo.jar.

  • Export PDN For saving the games in PDN format. This enables you to read them later using the Import option. The file chooser dialog contains a check box "Clean PDN". If this box is checked, only standard PDN fields will be written. Some additional information will not be saved, like the top and bottomline of the applet.

  • Exit Exit the application.

Game menu

  • Add game Adds a new game to the end of the list.

  • Remove game(s) Removes all selected games from the list. Multiple games can be selected in the usual way, for example by typing Ctrl-A (twice!) to select all games, or by pressing the Ctrl-key and clicking individual games with the mouse.

Board menu

  • Auto capture If selected, all forced captures are played automatically. While this can increase the speed of entering games, inexperienced users may get confused by multiple captures executed at once.

  • Move entry This determines which fields have to be clicked with the mouse to play a move on the board. There are three choices:

    • Default: in this case all fields of the move have to be clicked in order. As soon as there is only one possible move left, it will be played.

  • All fields: all fields of the move have to be clicked in order (recommended for beginners).

  • Flits mode: all fields of the move, and all captured pieces can be clicked in arbitrary order, until the move is unique.

    To deselect all selected fields, simply click on a piece of the player whose turn it is.

  • Board size Choose the board size. This feature is still a bit experimental.

View menu

This menu contains some options to hide certain parts of the user interface.

Options menu

  • Set player file Use this to load a text file containing player names. These names will appear in the drop down boxes of the "white" and "black" fields in the data tab.

  • Set event file Use this to load a text file containing event names. These names will appear in the drop down boxes of the "event" fields in the data tab.

  • Set Html file For advanced users. Use this to select your own template file with Html code to which the applet will be written. Look here for an example.

Data tab

The data tab contains the following parts:

  • data In this part all fields of the current game can be entered. Some of the fields have a drop down list. Note that for the label of the game there are some special values defined, like %white, %black and %date. These values will be replaced by the names of the white and black players and the date, as soon as the game is abandoned.

  • new game In this part some fields of new games can be entered. When a new game is created (using add game), these values will be filled in automatically. The "all" buttons enable you to apply the value to all selected games.

  • global The topline of the applet is shared by all games. You can enter this value here.

Ftp tab

The ftp tab enables you to directly upload the current games to an ftp server. This can be useful if you want to want to want to cover games live. For the host, enter something like ftp.tue.nl. For the remote filename you have to specify the complete path on the server, for example www/games/round1. Uploading of the file ReplayDambo.jar only needs to be done once, so this can be regulated by the "upload all" check box.

Text tab

This tab is still experimental, and not very usable at the moment! It's purpose is to provide a simple way to make some annotations to a game. If there is enough interest for it, I might try to improve it.

Recent Changes

See changelog.html.

Send your comments to Wieger Wesselink.