File Organization


It is advisable to organize your files in a way which will make maintaining them easy. The most common problem encountered in setting up a Mi Ni Pai edition is misnamed (or misplaced) files, so having a clear, simple directory structure is helpful.

Controlling Directories

Normally, Mi Ni Pai will look for the files it needs in the same directory as the applet HTML. Generally, you will wish to place different types of files in different directories beneath the location of the applet HTML.

All directory references are relative to the applet html. To refer to directories completely outside of the applet directory (i.e. above or parallel), use "../" to "move up" one directory. Normally, it is advisable to place all directories/files beneath the applet HTML.

The location of the java class files is controlled by the "classes" parameter within the applet tag. Note that this parameter is established by Java, not by Mi Ni Pai. It does not use the <PARAM NAME="" VALUE=""> syntax.

The location of the tile image, bonus image, zoom image, background image and sound (including music) files are each controlled by a separate parameter; tileFolder, bonusFolder, zoomFolder, backgroundFolder and soundFolder. It is also possible to place all of these files in the same folder by using fileFolder (and excluding the other parameters), but this is not recommended.

The help text file and shareware GIF must reside in the same directory as the applet HTML.

Suggested Organization

It is strongly suggested that you place each type of file in a separate folder directly beneath the applet HTML; sounds, tile images, bonus images, zoom images, background images and classes. Typical folder names are "sound", "tile", "bonus", "zoom", "background" (or "bkgrnd") and "classes".

Back to the Host Kit Main Page