#### 8.5.2 Defining number streams

You use number streams to coordinate numbering for those elements whose occurrences in your document should be numbered sequentially, or should appear with a constant prefix or suffix (or both). As a convention, the name of any number stream should end in Stream; the DITA2Go Configuration Manager relies on this convention.

These are the default stream names defined in format components configuration templates:

PartStream | Part numbers, like volume numbers
ChapterStream | Chapter title, all numbered subheads in chapter
AppendixStream | Appendix title, all numbered subheads in appendix
ListStream | Ordered lists, and ordered lists nested within them
FootnoteStream | Footnotes referenced in text
TblFootnoteStream | Footnotes referenced in table cells

You can add names for other number streams of your own, and you can change the default names. However, if you change a default name, you must change it in every place the name is referenced.

If you add your own number streams, you must define their properties. Table 8-2 lists the available properties and the values you can assign to those properties.

Table 8-2 Properties of number streams

Property | Default | Description
    id
    X
| (RTF only) Stream ID to use in Word SEQ fields, preferably a single alphabetic character
    counters
    1
| Maximum number of counters available in stream
    counter types
    Num
| Space-delimited list of types, one for each counter, from the following list:
    Num
| Arabic numeral
    UCRom
| Uppercase Roman numeral
    LCRom
| Lowercase Roman numeral
    UCAlpha
| Uppercase letter
    LCAlpha
| Lowercase letter
    Sym
| Symbol
    repeat
    last
| Which counter types to repeat, if there are more counters than counter types:
    last
| Repeat only the last counter type
    all
| Repeat the entire sequence of types, from the beginning
    reset
    none
| When to restart footnote numbering:
    topic
| (HTML only) At the start of each topic, for all footnotes (RTF only) At each page boundary, for all footnotes
    table
| At the start of each table, for table footnotes
    none
| Footnote numbers continue through entire document; for example, for endnotes
symbols |
    *
| Space-delimited list of symbols to use when counter type is Sym

The value for symbols can consist of more than one character. If more are needed than are listed here, they continue with an increasing number of the last symbol listed. So if you use the default, a single asterisk, the sequence is *, **, ***, ****, and so forth. Symbols can be <u+NNNN/> for a Unicode character, where NNNN is the hexadecimal code point, as in <u+2020/> for a dagger.

For example (these are default definitions):

    [ChapterStream]
    help = Number stream for chapters
    id = C
    counters = 10
    counter types = Num

    [AppendixStream]
    help = Number stream for appendixes
    id = A
    counters = 10
    counter types = UCAlpha Num
    repeat = last

    [List1Stream]
    help = Number stream for tier 1 ordered lists
    id = L
    counters = 3
    counter types = Num LCAlpha LCRom

Previous Topic: 8.5.1 Understanding numbering properties

Next Topic: 8.5.3 Defining number format components

Parent Topic: 8.5 Configuring output numbering properties

Sibling Topics:

8.5.1 Understanding numbering properties

8.5.3 Defining number format components

8.5.4 Defining footnote numbering

8.5.5 Considering examples of numbering schemes

Table of Contents • Index