IntroductionPalview3 is a Win32 Console program for Windows. It is used to create Html with JavaScript for replaying chess games. The easiest way to use the program is to use Eric Bentzen's excellent GUI program, PalMate, written specifically to work with Palview3. But this manual will explain how to use Palview3 by itself, without reference to another program. To learn how to use Eric's PalMate program, please consult his documentation. While we highly recommended that you use Eric's PalMate program, please read this manual thoroughly, as it will explain all you need to know about the features that Palview3 offers and how to use them. The actual chess games that Palview3 will convert are read from a PGN file. PGN is Portable Game Notation. This file is a simple text file with the .PGN extension and its creation was the work of the chess newsgroup(s) and Steven Edwards. Your own chess software will allow you to create games and export them to a PGN file. (Consult your software's manual on how to do this.) You can obtain a copy of the PGN Standard here: PGN Standard . For more information on Palview3 and PGN, please read the section, Palview3 and Portable Game Notation PGN. Once you have a game, or a collection of games, in a PGN file, you can get Palview3 to generate an Html-JavaScript page for you. But just what kind of page, with what features, would you like? You determine these options through the use of another file with the extension, INI. This is another simple text file that contains a number of lines that set the various options that are available with Palview3. For now just accept that you can edit this INI file to change the settings. It is very easy, really. The many options that are available with Palview3 will be explained in more detail in the section The Palview3 INI File. They will also be discussed in various sections where they are of importance to the topic at hand. Once you have created an INI file that contains the settings for the various options that you want, you are ready to get Palview3 to create the Html-JavaScript page for you. You do this by passing, or sending, the PGN and INI files to Palview3. You can do this in a number of ways, but the safest is to use the Windows Console. Under Win95, Win98, and WinMe, the Console is also called the MSDOS Prompt. Under WinNT and Win2000, the Console is a program called CMD.EXE. Essentially what you do is start either of these two programs and then switch to the directory, or folder, that contains your Palview3 program. If we assume that you installed Palview3 on your desktop, then you would type cd desktop\palview3. This sets the current working directory to the palview3 folder on your desktop. Now you need to type the name of the Palview3 program, followed by the name of the PGN file. You would type something like: palview3 filename.pgn. All you have to do at this point is hit the ENTER key to start the program. Once the program is finished, you can hit the ENTER key again. Finally, you can type exit and hit ENTER to close the Console Window. Here is a picture of what all this would look like:  The reason why using the Windows Console is the safest way to use Palview3 by itself has to do with the way longfilenames are treated under the various Windows OS. The Console method is the best way of preserving your longfilenames under every OS. Other methods of passing the PGN file to Palview3 are likely to result in shortened filenames. Mind you, the very best advice is to simply use short filenames at all times. Any filename of eight characters (plus three more for the .PGN at the end) should insure that any of the other passing methods described below will also work. These other methods are also more convenient, so use short names and one of the methods below, but if you must use a longfilename then please use the Console method described above. (Better yet -- use Eric Bentzen's excellent PalMate program and let Eric worry about all these details!) Another way to pass files to Palview3 is to drag & drop the PGN and INI file onto the Palview3 program icon itself. To do this, click on the PGN file and then, while pressing down the Ctrl key, click on the INI file. This will 'highlight' both of the files, usually by turning their icons a bluish color. You can now grab the two files by holding down the left-mouse button on either of the highlighted icons and dragging them onto the Palview3 program's icon. The easiest way to accomplish this is to have a single folder that contains the Palview3 program and all your PGN and INI files that you intend to work with so that everything is visible. If you decide to place Palview3 in a folder that is separate from your working folder, then you will need to have your Palview3 folder open on the desktop in order to be able to drag the files onto it. Yet another way to pass the PGN and INI files to Palview3, and much easier too, is to use a Shortcut placed in Window's SendTo folder. From the Win98 Help: You can add other destinations to Send To. In the Send To folder, which is located in your Windows folder, create shortcuts to the destinations you send files to often, such as a printer, fax machine, or particular folder. You can create this shortcut easily by first opening the SendTo folder, located in the WINDOWS folder, and then dragging the Palview3 program icon into the SendTo folder using the right mouse button. When you release the mouse button, you will be shown a short menu by Windows. Select the option 'Create Shortcut Here'. Another way is to click on the File menu of the SendTo folder, select New, then Shortcut. Then follow the instruction by Windows to locate the Palview3 program to complete the shortcut. Once you have created the Palview3 shortcut in the Windows SendTo folder, you can very easily pass the PGN and INI files to Palview3. You select the PGN and INI files that you want to send to Palview3 by clicking on them as described above to highlight them. Now you can right click on any of the highlighted files and a menu will pop up. Select the SendTo option, and then click on Palview3. Sending, or passing, the PGN and INI files to Palview3 will start the program itself. Palview3 will first attempt to read the INI file you passed it, or, if you didn't pass one, it will try to read the default palview.INI file located in the same folder as the PGN file. If no palview.INI file is found in the same directory as the PGN file, then Palview3 will try to read the default palview.INI file from the same folder as the Palview3 program itself. If there is still no INI file that can be located, then Palview will simply use the default values for the options as set by the program. Once the INI file has been read, the program will attempt to read the PGN file itself. If all this has been successful, Palview3 will then generate the HTM, an Html file, and possibly a JS, JavaScript file. These files will be created in the same folder as the PGN file. For more information on the types of Html pages that Palview3 can generate, please see the section The Palview3 Page Types. After Palview3 has created your HTM file, you can still make further changes to the 'look' of the page by editing the various class properties in the CSS file linked to the page. CSS is short for 'Cascading Style Sheet'. You will no longer need to use Palview3 to generate a new HTM page just to affect changes in fonts, color, backgrounds, etc. You can simply change the CSS. For more information on Palview3 and CSS, please see the section Palview3 and Cascading Stylesheets. All you need to know right now is that you can edit this CSS file quite easily to create a great many changes in the appearance of your HTM file. Once you have created the 'look' that you want, you can reuse the same CSS file over and over for all the pages you create with Palview3. Once you have your Html page(s) and your CSS file all prepared, it is time to upload them to the server so that others can enjoy your work. It is important to note that many of the servers in operation today are Linux or UNIX based. These servers do not like mixed upper and lower case filenames in their Html references. For this reason we recommend that you always set your FTP program to automatically convert all filenames to lowercase when uploading your Palview3 generated files. This will save you a great deal of trouble. While we are on the subject, it is probably best for you to use lowercase filenames at all times since this will avoid any such problems right from the start. You do not actually have to install Palview3. Since it is just a Win32 Console program, you only need to place the program in the folder that you wish to keep it in. By the same reasoning, if you should ever decide to uninstall Palview3, all you have to do is delete it. One thing that you should avoid when deciding on the folder to keep Palview3, is that you should NOT use a folder whose name contains a SPACE -- that will cause the program to become inoperable, since Win32 Console programs can't understand such folder names. So DO NOT place Palview3 in the 'Program Files' folder! Ideally, I would recommend that you create a palview3 folder on your C: hardrive and place the program there. There are a couple of other limitations to be aware of when using Palview3. These are not at all difficult to live with. The first is that you should avoid using any SPACEs in the names of the files you pass to Palview3, such as the PGN and INI files. (This is the same limitation as above.) You should also avoid long filenames If you are not using Eric Bentzen's PalMate program or the Windows Console. We recommend that you use filenames of eight or less characters (not including the extension name, such as PGN). You should also be aware that Palview3 currently has a limit of three levels of variation moves on top of the actual game move. This should be plenty for any annotated game, but sometimes you will see a PGN file that contains a single game that quite literally contains nearly every other game ever played as variations to this game! Such database dumps will not work with Palview3 (and I can't really imagine why anyone would want to look at such a game on a website in any case). Lastly, Palview3 allows a maximum of 1000 possible games in any PGN file you send to it. But that is far more than you will ever need for creating a webpage, so this is really not a limitation at all, but we give you fair warning up front! Finally, the last limitation deals with the browsers that will be used to view the HTM pages that Palview3 creates for you and your website visitors. For most of these pages your visitors will need to have a version 4 or greater browser. Some of the more advanced, and newer pages, will require a version 5 browser. Much of this depends upon what type of page you decide to create and what features you select. These details will be expanded upon in the various sections devoted to each page type. We highly recommend the Internet Explorer 5.) or greater browser or the new Netscape 6.2 browser. You can use the browser statistics below collected by the chess organization FIDE to get a better grasp of just what most of you chess site visitors will be using to view your pages. One thing of note about the stats below is that you can clearly see the dominance of Microsoft's OS and Internet Explorer browser. Almost 98% of all FIDE's visitors were running a Microsoft OS and nearly 79% were using Internet Explorer 4.x or greater. So even those that report to be using a Netscape 4.x browser, almost certainly are using it on an Microsoft OS so they almost certainly have a copy of Internet Explorer 4.x or greater on their machine that they could use if they wanted to.
Browser Statistics: Display Statistics: MSIE 5.0 36.55% 800x600 51.47% MSIE 5.5 17.91% 1024x768 31.96% MSIE 5.01 13.45% 640x480 6.12% MSIE 4.01 11.51% 1280x1024 4.42% Netscape 4.7 3.69% 1152x864 2.59% Other 16.89% Other 3.44% OS Statistics: Pixel Depth: Windows 98 59.69% 16 54.55% Windows 95 18.56% 32 24.62% Windows NT 18.48% 24 12.92% Macintosh 1.45% 8 7.55% Linux 2.2.16 0.34% 1 0.29% Other 1.48% Other 0.07% |
