Numbering Types

The type of numbering that appears in your publication is controlled by the args.css.param.numbering parameter.

This parameter activates various sets of CSS rules from the built-in CSS. By default, only the first-level topics (the chapters) are numbered (shallow numbering). The following values are accepted:

Table 1. Types of Numbering
Value	Chapters	Sections/ Nested Topics	Figures & Tables	Pages
shallow	numbered	no	counted from the start of the publication	from the start of the publication
deep	numbered	numbered	counted from the start of the publication	from the start of the publication
deep-chapter-scope	numbered	numbered	numbering is restarted at the beginning of each chapter, adds the chapter number in their titles (and in the links to them), and in the list of tables and list of figures sections	restarted at the beginning of each chapter
deep-chapter-scope-no-page-reset	numbered	numbered	numbering is restarted at the beginning of each chapter, adds the chapter number in their titles (and in the links to them), and in the list of tables and list of figures sections	from the start of the publication

Note:

When using any of the deep numbering types, no distinction is made between sections and nested topics. For example, if a topic contains two sections, followed by another nested topic, the sections will be numbered with 1 and 2, and the nested topic with 3.

Notice:

The deep-chapter-scope and deep-chapter-scope-no-page-reset values are only available for the DITA Map PDF - based on HTML5 & CSS transformation scenario.

Examples

Shallow

Each chapter (or first-level topic) is numbered, but sections/nested topics are not numbered. Figures, tables, and pages are numbered sequentially from the start of the publication and they do not reset.

Chapter 1. First Chapter
    Page 1
      Topic
        Section
          Table 1
          Table 2
      Topic
        Section
    Page 2
        Table 3
Chapter 2. Second Chapter
    Page 3
      Topic
        Table 4
        Table 5
      Topic
    Page 4

It will result in the following content inside the PDF:

Chapter 1. Introduction..............................................................1
Chapter 2. Care and Preparation......................................................2
  Pruning............................................................................2
  Garden Preparation.................................................................3
Chapter 3. Flowers by Season.........................................................4
  Spring Flowers.....................................................................4
    Iris.............................................................................4
    Snowdrop.........................................................................6
  ...

List of Figures
  Figure 1: Iris

List of Tables
  Table 1: Flowers

Deep

All chapters (or first-level topics) and sections/nested topics are numbered (these are also prefixed with the chapter number). Figures, tables, and pages are numbered sequentially from the start of the publication and they do not reset.

1. First Chapter
    Page 1
      Topic 1.1
        Table 1
      Topic 1.2
        Table 2
    Page 2
        Table 3
2. Second Chapter
    Page 3
      Topic 2.1
        Table 4
        Table 5
      Topic 2.2
    Page 4

It will result in the following content inside the PDF:

1. Introduction......................................................................1
2. Care and Preparation..............................................................2
  2.1. Pruning.......................................................................2
  2.2. Garden Preparation............................................................3
3. Flowers by Season.................................................................4
  3.1. Spring Flowers................................................................4
    3.1.1. Iris......................................................................4
    3.1.2. Snowdrop..................................................................6
  ...

List of Figures
  Figure 1: Iris

List of Tables
  Table 1: Flowers

Deep Chapter Scope

Each chapter (or first-level topic) is independent (so it can be read separately, as a separate part of your publication). The sections/nested topics, pages, figures, and table counters (and links to them) restart at each chapter. The general cross reference links also display the chapter number before the page number to clearly specify the target.

1. First Chapter
    Page 1.1
      Topic 1.1
        Table 1-1
        Link to page 2.2
      Topic 1.2
    Page 1.2
        Table 1-2
2. Second Chapter
    Page 2.1
      Topic 2.1
        Table 2-1
        Table 2-2
        Table 2-3
      Topic 2.2
        Table 2-4
    Page 2.2
       Link to page 1.1

It will result in the following content inside the PDF:

1. Introduction......................................................................1
2. Care and Preparation..............................................................1
  2.1. Pruning.......................................................................1
  2.2. Garden Preparation............................................................2
3. Flowers by Season.................................................................1
  3.1. Spring Flowers................................................................1
    3.1.1. Iris......................................................................1
    3.1.2. Snowdrop..................................................................3
  ...

List of Figures
  Figure 3-1: Iris

List of Tables
  Table 2-1: Flowers

Deep Chapter Scope No Page Reset

Each chapter (or first-level topic) is independent (so it can be read separately, as a separate part of your publication). The sections/nested topics, figures, and table counters (and links to them) restart at each chapter, but the page numbers do not reset. The generic cross reference links contain only the page number.

1. First Chapter
    Page 1
      Topic 1.1
        Table 1-1
        Link to page 4
      Topic 1.2
    Page 2
        Table 1-2
2. Second Chapter
    Page 3
      Topic 2.1
        Table 2-1
        Table 2-2
        Table 2-3
      Topic 2.2
        Table 2-4
    Page 4
       Link to page 1

It will result in the following content inside the PDF:

1. Introduction......................................................................1
2. Care and Preparation..............................................................2
  2.1. Pruning.......................................................................2
  2.2. Garden Preparation............................................................3
3. Flowers by Season.................................................................4
  3.1. Spring Flowers................................................................4
    3.1.1. Iris......................................................................4
    3.1.2. Snowdrop..................................................................6
  ...

List of Figures
  Figure 3-1: Iris

List of Tables
  Table 2-1: Flowers

Tip:

When using deep numbering, if you want to exclude sections from being numbered, see How to Include Topic Sections in TOC.