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 ContentsIndex