If you have a problem with the program and can't find any explanation of it
in the help or faq please consult the Known Problems page. If
the problem is not described there then please contact us.
1. What does Palview do?
This program allows you to take a chess game stored in PGN format
and convert it into an html/javascript page for viewing on a website.
Viewers of the page will be able to play through the game
using a control panel and even be able to jump to any point
in the game by clicking on the appropriate pgn move if that option is activated.
You may also choose to insert static diagrams at various points in the game rather
than having a single board on which to play out the game.
Generated html pages may contain only one game or several different games.
If there are several games then they may either follow one another on the page,
each with their own board,
or alternatively be selected from a list for display on a single board.
Besides the usual begin/end/forward/backward buttons the control panel offers options to
play the game automatically and also to flip the board.
The program comes provided with several different chess sets
and you may add your own if you wish. You may also generate your own image map for the
control panel buttons which means that you can completely
customise the look and feel of the board to your own needs.
Support for Cascading Style sheets means that you also have detailed control over the look of the text.
All text (including pgn text) can be changed. This allows versions to be generated in
any language you like.
The software also includes a small but useful additional program called Paldiag that generates static diagrams from a specified position
2. Who is it intended for?
This program is intended for use by webmasters wishing to display chess games on their site.
It provides a fast, flexible way of displaying games while allowing
maximum opportunity to customise the resulting pages. We believe that it is a much faster and safer way
of displaying games than the various java viewers that are currently available. It offers far more options
than any similar javascript viewer.
Use of the program, and this helpfile, assume a certain amount of familiarity with both html and pgn.
3. What do I have to download?
Download Palview.zip
This contains all necessary program files and additional font sets.
Warning:
This has changed from version one. We have decided that the difference in size between a very basic
version and the complete version was not big enough to be worth the trouble of issuing seperate downloads.
Please note though that the example and demo files are no longer included in the download.
You can consult them on the demo pages and download the examples you need from there.
4. How do I use the program?
First of all decompress all the files into a new directory.
If you decompres them with "Use folder names" checked, by default the directories "C:\Palview" and "C:\Palview\jpc" will be created.
If you first create your own directory "C:\Mydir" and unzip to this you'll get "C:\Mydir\Palview" and "C:\Mydir\Palview\jpc".
You may change these later if you wish.
You have now finished installing the program and are ready to actually use it.
You now have two choices:
- Palview was developed as a dos command line utility. You can still use it in this way. Just follow the instructions
below.
- A graphical windows interface called Winpal by Loic Magnin is now available.
Follow the link for details on downloading and using it.
Using Palview from the command line or from windows explorer (ie without the graphical interface Winpal)
Find a PGN file you wish to convert to html.
There are two ways of using the program.
- Drag and drop the pgn file onto the palview.exe file.
- Open a dos window and in the palview directory type: palview something.pgn (taking care to replace the word 'something' with the name of your pgn file)
The program will execute but leaves open a dos window. Hit enter and this window will close.
You will now have an .htm file of the same name as your pgn file. You can access this using the 'file/open' dialogue of your browser.
That's it, it's as simple as that.
For more information read the rest of this help file. It's full of fascinating insights into the workings of the program.
5. How much does it cost?
Nothing.
However a short email
telling Andrew how much you appreciate his work and mentioning the address of your site would be nice.
I'm serious, we really would love to know where the program is being used and an email is not much to ask for is it?
It would also be nice if you mentioned on your web page where the viewer comes from, this is however not an obligation.
6. Can I control the way the program operates?
Yes, you do this by modifying an ini file.
By default when you start the program it will look for an ini file called palview.ini.
A basic palview.ini is included in the release.
Various options may be specified in this file.
These options are documented below.
7. Can I call the ini file something else/have multiple ini files?
Yes. You may use another ini file.
This allows you to build standard ini files for different uses rather than always
modifying the same one.
In order to do this you drag and drop
*both* the pgn and the ini file you wish to use on the program.
By default the program will always look for a file called palview.ini (even if you rename the program).
8. What happens if I don't have an ini file?
If the program can't find an ini file it will use extremely sensible well chosen defaults.
These defaults are documented below.
9. Are different options available for the presentation of the board and pieces?
Yes. The following options are supplied in the standard package.
The sets Kingdom, Leipzig, Linares, Merida, Alpha, Tilburg, Linares, Adventurer, Lucena, Harlequin and Condal.
These pictures are based on the chess fonts of the same
name with the various authors' permission for which we thank them.
All sets supplied in 19, 24, 29 and 35 pixel sizes.
By default the board is handled by a separate image. This allows you to select board and pieces independently.
10. Can I use my own pictures for the board, pieces and control panel?
Yes. There are options that allow you to specify your own version of all the graphics used.
This allows you to give the board, pieces and control panel any 'look' you desire.
11. Can I use the programs to do problems or tactical exercises where there are only a few moves and the game starts from some position?
Yes. You may specify that the game/problem should start from some particular position and then give only moves from there on.
In addition even if you have a complete game you can ask the program to position the board at some particular move. This is useful
when you wish to highlight some critical move but still want the user to be able to consult the rest of the game as well.
12. Can I have more than one game on the same page?
Yes. You can generate a page with multiple games, either all played on the same board with a selection mechanism or
each with it's own board.
13. Does the program support different languages?
Yes. You can change all the text that appears and the PGN characters used.
14. Does this work with all browsers?
No. Sorry. Users wishing to view the pages must be running a version four or later browser.
As some users are still using version three browsers we recommend you include a warning about this.
Holes in the javascript implementation have prevented us from implementing it for version 3 browsers.
15. Where can I see some examples of the program in use?
Eric Bentzen has built a series of pages which demonstrate the basic features of the program.
Please consult these pages which also contain explanations and example ini files.
The following are just a few of the sites using Palview Chathurangam Chessopolis
Correspondence Chess.Com Nigel Davies and Baburin's GM Square.
16. Where can I find out more about PGN?
The standard reference document for PGN is here ftp://ftp.pitt.edu/group/student-activities/chess/PGN/Demo/pgnstd.zip. This also gives a definition of FEN diagram notation.
17. What about comments, nags, CSMs and figurine fonts?
This is an advanced option. It allows you to specify that your html page should use symbol and figurine fonts.
This has the disadvantage that if the user has not installed the relevant fonts the output is garbage. On the other
hand it allows you to serve figurine and sophisticated informator style comment markup to the user.
Further documentation is available here.
18. Where can I find program updates and additional help if needed?
The reference site for releases of the program is Nørresundby Chess Club's site En Passant
If you have any comments or require assistance please write to Alan Cowderoy at alan@cowderoy.com.
19. If I want to report a problem what information should I send?
Sending the pgn file should normally be sufficient if the program is showing an error reading it.
If the problem is with the generated html then please send that as well plus of course a description of the problem as you see it.
20. Don't forget that this program just generates a html/javascript file - anybody with
a text editor can go in there and customise the hell out of the generated source, including the javascript if they so desire.
Credits:
This program was written by
Andrew Templeton to whom goes most of the credit.
Alan Cowderoy, Eric Bentzen and Loïc Magnin assisted with design and testing.
We would also like to thank the following people for kindly allowing us to use their fonts:
Armando Marroquin for permission to use his fonts Kingdom, Leipzig, Merida and Condal.
Steve Smith's family at Alpine Electronics for Linares.
Eric Bentzen of En Passant for Alpha.
Eric Schiller for Tilburg. More stuff by Eric at his sites http://www.chesscity.com
, http://www.chessworks.com
(note that the program uses gif or jpeg images of the fonts. TTF versions are not supplied with this program)
The following people have also given us much help and advice for which we are gratefull: Tim Harding, John Knudson,
Jack Woodbury, Robert Ericsson, Mats Winther, Oscar van Rijswijk, Andreas
Sumerauer and Svante Vinther.
This help file by Alan Cowderoy.
Comments and corrections to alan@palamede.com
An example CSS file is supplied with the release. It contains definitions for all the classes
currently used by Palview. We recommend you use it as a base for generating your own
personalized versions.
You can add any number of other classes to your own particular CSS
file, but only the above classes will actually be used by palview.
The style sheet should be in the same folder as the HTML file that uses it.
Use of the special pf class causes all the moves in comments to be rendered with a figurine font.
Those who do not have the font installed will just see the regular letters.