Next: Special option: smart   Previous: Including nested PerlPoint sources   Contents: Contents

Special option: headlinebase

When including nested PerlPoint, a special tag option "headlinebase" can be specified to define a headline base level used as an offset to all headlines in the included document.


 If "\INCLUDE{type=PP file=file headlinebase=20}" is
 specified and "file" contains a one level headline
 like "=Main topic of special explanations"
 this headline is detected with a level of 21.

Pass the special keyword CURRENT_LEVEL to this tag option if you want to set just the current headline level as an offset. This results in "subchapters".


 If "\INCLUDE{type=PP file=file headlinebase=CURRENT_LEVEL}"
 is specified in a chapter of level 4 and "file" contains a
 one level headline like "=Main topic of special explanations"
 this headline is detected with a level of 5.

Similar to CURRENT_LEVEL, BASE_LEVEL sets the current base headline level as an offset. The "base level" is the level above the current one. Using BASE_LEVEL results in parallel chapters.


 If "\INCLUDE{type=PP file=file headlinebase=BASE_LEVEL}"
 is specified in a chapter of level 4 and "file" contains a
 one level headline like "=Main topic of special explanations"
 this headline is detected with a level of 4 - similar to the
 level the nested source was included on.

A given offset is reset when the included document is parsed completely.

The "headlinebase" feature makes it easier to share partial documents with others, or to build complex documents by including seperately maintained parts, or to include one and the same part at different headline levels.

Next: Special option: smart   Previous: Including nested PerlPoint sources   Contents: Contents