Multiple Input Files and Sections

Multiple Input Files and Sections
contents, childtable, children
Discussion
parent_example.omh
Child Examples
Execute Example
Example In This Web Site

contents, childtable, children
The $contents, $childtable, and children commands can be used to specify input files. All of the sections in these files are children of the current section and are siblings of each other (see the drop down menu labeled start_multiple at the top of this web page).

Discussion
The file multiple_example.omh contains the root section for this example. There is more than one section in the corresponding web site because the root section contains a contents command. For this reason, a navigation links are included in the web page and the following navigation sections are automatically generated: _contents , _reference , _index , _search , _external .

parent_example.omh
Use the editor of your choice to create the file parent_example.omh in the xam directory with the following contents:

 
     $begin parent_example$$
     $spell
     	omh
     $$
     $section An Example Parent Section With Two Children$$
     
     $head child_1_example.omh$$
     $verbatim%omh/getstarted/child_1_example.omh%
     	5%BEGIN_CHILD_1_EXAMPLE%END_CHILD_1_EXAMPLE%0
     %$$
     
     $head child_2_example.omh$$
     $verbatim%omh/getstarted/child_2_example.omh%
     	5%BEGIN_CHILD_2_EXAMPLE%END_CHILD_2_EXAMPLE%0
     %$$
     
     $contents%
     	omh/getstarted/child_1_example.omh%
     	omh/getstarted/child_2_example.omh
     %$$
     
     $end

You can also just copy parent_example.omh from the omh/getstarted directory .

Child Examples
For j equal to 1, 2 do the following:

Copy omh/getstarted/child_j_example.omh from the omh/getstarted Directory to the xam directory .
In the copy of multiple_example.omh, change omh/getstarted/child_j_example.omh to child_j_example.omh .

Execute Example
Once you have copied the files mentioned above, you can execute omhelp with example_name equal to parent_example.

Example In This Web Site
You can view the result of making parent_example.omh part of the OMhelp help web site by selecting parent_example .

Input File: omh/getstarted/start_multiple.omh