3.1. Headings


3.1.1. Chapter Headings

Headings are specified using the tags H1 .. H6:

The actual presentation of H-style headings (e.g. numbered or unnumbered) is decided by the target format and document style.


3.1.2. Other Headings

The following heading tags are also supported:

P-style headings are always unnumbered so are commonly used in memos.

In normal documents, it is often unnecessary to use A-style or P-style tags. The preferred approach is to:

For example:

  !include "budget.sdf"; appendix

Using this approach, sections can easily be reused in different ways in different documents.


3.1.3. Generating a Table of Contents

A table of contents can be generated from the heading paragraphs. All types of heading tags (i.e. H, A and P) are included. The depth of the table of contents is specified by the DOC_TOC variable. For example, to generate a table of contents including headings up to and including level 4:

   doccvt -o -DDOC_TOC=4 mydoc.sdf


Note: For normal documents, the build_title macro defaults this variable to 3.

Individual headings can be excluded from the table of contents by specifying the notoc attribute. For example:

   H3[notoc] Yet Another Heading

See Attributes for further details on attribute syntax.


3.1.4. Controlling Page Breaks

Generally speaking, page breaks are controlled by rules associated with heading tags. For example:

The top paragraph attribute can be used to position a paragraph at the top of the next page. For example:

  H3[top] Abc Module

Page breaks can also be explicitly specified using the PB tag. For example:

  text on one page.
  PB:
  H3: Another Section


Note: SDF is designed to be a logical markup language. While it is sometimes necessary to explicitly specify page breaks in order to get the layout you want, doing so can reduce the portability of your document to different styles, page sizes and target formats.