Using DynaDoc

DynaDoc is PHP program that is executed by entering its URL in a browser. It reads "raw" document source files and generates the final document as set of linked HTML pages. Documents to be created using DynaDoc are written as "content blocks" in HTML (one file per page). DynaDoc also requires a page layout template and text "script" to define the sequence of the pages.

Document Creation Process

Creating a document requires some set up steps.

1. Create a folder structure for your project.

2. Create templates defining the layout of the view and print pages. The templates needs to include tags for where content will be placed.

3. Create any desired CSS. External CSS files are recommended.

4. Create a script. The script is like the outline of the document. For each page of output, there needs to be one line in the script. The script also contains some commands that define various parameters of the document.

5. Create content blocks. Each content block is an HTML file. HTML should be limited to simple elements, such as headings, paragraph control, images, links, etc. Page layout is handled by the template.

6. Create any JavaScript (general or page specific).

Once the set up is complete, the only remaining step is to run DynaDoc. This is accomplished by providing the URL to DynaDoc in a browser. DynaDoc requires the Project Name and Project Directory. The project directory must include the trailing slash.

Example:

• http://localhost/dynadoc?proj=<projectName>&projDir=<projectDir>/

When working on multiple projects, DynaDoc is also set up to work with project lists as input. See the Advanced Techniques section.

DynaDoc will do the following:

1. Using the script, a linked menu is created in HTML format.

2. For each page definition in the script, the project name, version, menu, content blocks and JavaScript (optional) will be merged with the template to create a corresponding output page.

A graphic representation of this process is provided below:

DynaDoc will actually create two sets of output. One for viewing, and two print versions. Typically, the viewing version will be complete (it is easy to navigate and disk space is cheap), and the print version will be a subset (think green). The print versions will consolidate all pages to single files for printing purposes. One print version will include only those pages specified to be included in the print version. The second print version will include all pages from the viewing version.

Document Viewing Process

The final document will be contained in a folder structure defined by the user. The root folder of this set can be posted on a domain or a local file system. Any HTML file within the output can be opened in a browser for viewing, either by specifying the URL, or dragging and dropping the file on a browser window. Typically, the first page of the document will be named index.html for ease of use.

Advanced Features

There are other advanced features and capabilities of DynaDoc that are described later in this document.