TenkCert

  TenkCert is a certificate creation and printing program for the Ismaili 10K
  Run for Charity (see http://www.runforcharity.org).  It takes in input for
  two classes of runners: 4K fun run and the 10K main run.

Setting up the Program:

  This program's only absolute requirement is a Java Runtime Environment
  version 1.4 or later.  This is available from [http://java.sun.com].  The
  runtime environment does not need to be specially configured.

  To make full use of the program you will probably want to setup a database,
  you may use any database you like provided you can access it with a Type 4
  JDBC driver.  The program has been tested with IBM DB2 8.2 and MySQL 4.0.17,
  MySQL is freely availabe from [http://mysql.org], you will need to download
  the database as well as the mysql connector for java (this is the JDBC
  driver).

  Once you install the database you will need to create the proper tables.
  Executing the 'db.sql' on the database should setup two tables: mainrun and
  funrun.  Once the database is initialized you need to configure the
  connection from the program to the database.  This involves putting a copy of
  the database driver in the same location as tenk.jar and naming the driver
  mcon.jar and creating a file called db.cfg to configure the driver and its
  connection to the database.  See db.cfg.sample for detailed instructions and
  an example.

Starting the Program:

  The program should needs a fair about of setup, the database needs to be
  prepared, you will need to configure the connection, install a java virtual
  machine, etc.  These instructions only concern starting the program once it
  has been configured.

  Run the program by entering 'java -jar tenk.jar' from shell/DOS prompt in
  that directory, or on Windows just by double clicking the tenk.jar file.

Building the Program and Configuring the Certificate:

  If you want to install from source you will need ANT (http://ant.apache.org),
  other than that you shouldn't need to do much.  Just go to the folder where
  you uncompressed the source and enter 'ant'.

  Configuring the certificate is currently done within the program itself.  The
  following instructions assume you have some Java experience.

  You will need to edit FunRun.java and MainRun.java in the tenk/ directory.
  Find the makeCert() function and add or modify the appropriate lines.  The
  Cert.addLine() function takes three arguments: text, position, font.  Text
  should be a String.  Position should be a double indicating the vertical
  placment on the page (it should be between 0 and 1, where 0 is the top and 1
  is the bottom).  Font should be the a Font object containing the style
  information for the text.

Using the Program:

  Initially you will see a window split into two halves, the left side contains
  a listing of the runners for the 10K run and the right side lists the runners
  of the 4K run.  Addtionally, each list box contains details on the number of
  times each record has been printed (shown in square brackets).  For the main
  run, the bib number is shown in normal brackets.

  To add runners you can use the Add or Load buttons.  Selecting Add will bring
  up a window so you can manually input data for a single runner.  Selecting
  Load will bring up a dialog asking for the location of a file, this is
  convenient for loading a large number of runners.  Files should be in one of
  two csv (comma separated values) file formats:

  4K run:   <id>,<first name>,<last name> 
  10K run:  <bib>,<first name>,<last name>,<age>,<gender M/F/U>
            ,<time as hh:mm:ss>

  To delete a runner select the runner you would like to delete and press the
  Delete button, it will confirm before removing the runner.  You may only
  select one runner at a time, if more than one is selected it will only delete
  the first one.

  If you want a rough preview of the certificate use the Preview button,
  however the page aspect ratio is not preserved, and the font size will differ
  from the printed version.

  To print a certificate, select the group of runners you want to print
  certificates for and press the Print button.  It will bring up the usual
  print dialog asking which printer to use and so on.

  For the 10K run, it is possible to produce an HTML summary of: a listing of
  all runners with their rankings, and the top 3 runners in each category.

Licensing:

  TenkCert is free software licensed under the zlib/libpng license.  See the
  'LICENSE' file for details.