Packaging for upload
There's really nothing to this part. Anyone who knows how to make pk3 files for Quake 3 map distribution should already know how to create zip archives that have the necessary paths preserved for various files. Just make sure you get everything into the archive:
- You'll need to include the overview HTML page (or pages) that you generated, of course.
- iconmanager.js must be included as well, in the same location as the HTML pages.
- Include the "page_graphics" folder, which is a subfolder of the location of the HTML pages, and its contents.
- Include the folder that contains the overview icons, and of course the icons themselves (and "transpixel.gif") inside that folder. The path for this folder is whatever was specified for "--iconpath" when building the page; by default that would be "entity_icons". Note that your map overview almost certainly won't be using all the entity icons, but it doesn't really hurt to just include them all, as they are small files.
- Include the map overhead image graphic and the levelshot graphic at the appropriate paths, according to whatever was specified for "--mappath" and "--thumbpath" when building the page. By default those paths would be "overheads" and "levelshots", respectively.
- If you have created an index page to go along with multiple overview pages, include that HTML page as well, along with whatever else is necessary to view it.
That's all that is required to create a self-contained package for using the overview(s) you have created. You can then distribute it in that zipfile, or upload it and extract the files from it to make your overview accessible online. The map overviews section of the Threewave manual itself is a perfect example.
If you're going to be distributing your overview for people to download and view offline, test the package yourself to make sure that it works!
You may want to give some thought about providing instructions on how to use your map overview(s), as I did in the index page for the Threewave map overviews. If you want to borrow from the Threewave manual the graphics and tables that illustrate the use of overview pages, go right ahead, but please use them in an overall page design of your own creation, rather than copying the page design from the Threewave manual.
< Interpreting the messages Introduction >