User:Jholsenback/WikiDocGen

From POV-Wiki
< User:Jholsenback
Revision as of 17:12, 20 December 2010 by Jholsenback (talk | contribs) (updates)
Jump to navigation Jump to search

The Setup

In the directory  /a/home/jholsenback/testbed  this is the expected directory structure:

documentation
mac
images
unx
images
win
images

You should be in the above mentioned directory to run the scripts, however, the batch-files wander a bit but always end up back home.

The Files

These are the files that make up the povdocgen process:

  1. batchMacFiles
    • a bash script that processes the Mac OS documentation set
  2. batchWinFiles
    • a bash script that processes the Windows documentation set
  3. batchUnxFiles
    • a bash script that processes the Unix documentation set
  4. getWikiPages.php
    • gets the files from the POV-Wiki and processes them
  5. mkContentsPages.php
    • builds the various table of contents files and an index.html file for a given doc set
  6. mkImagePackage.php
    • builds the images directory structure and copies files from the POV-Wiki
  7. getStyleSheet.php
    • gets the povray37.css style sheet and copies it to a given doc set directory
  8. common.php
    • frequently used functions associated with the povdocgen process
  9. utilities.php
    • frequently used functions associated with the povdocgen process, an attempt to organize
  10. documentation/WikiImages
    • a symbolic link to the POV-Wiki images directory
  11. documentation/favicon.ico
    • copied to a given doc set directory

Besides the content files on the POV-Wiki these files are also part of the process:

  1. Page Header
  2. Content Header Footer
  3. Style Sheet
  4. Index Page

Notes

The most important part of this process is that it is driven off these files:

The GatherTOCfiles and BuildDocMap functions reads and processes those files. They are located in utilities and common respectively, they depend on the class DocumentMap definition located in common. During batch processing if an exception message is seen, most likely something isn't correct with an associated table of contents entry and how it appears in the content body. The title portion of the toc entry and the heading entry in the content body MUST be and exact match. Batch processing will continue and the offender will appear in the content body as wiki markup.

Hint: look for the wiki tag  Documentation:

The content on the Wiki is organized such that a given section can span more than one file, the script getWikiPages.php effectively concatenates the files together, so look near the bottom of that script to find a place to tap into the stream as it were!