Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
titleControl the starting Number on a Document

In case you have a large document, like a specification or a architecture description using the arc42 Template, you may need more fine grained control of the numbering of a page.

Section
titleExtracting SectionSections in their own Documents

Suppose you need to extract the sections Space Relation, Providing Spaces, and Collaboration Spaces to their own documents. This way you may have easier content reuse, you may collaborate easier if each content is created by another author, any you may reference the individual sections easier if they have their own unique URL.

Let's use the Section Doctype to create a document for each of the three sections we extract and the Transclude Documents Macro to integrate them with the original document.

Screenshot of the document using transclusion to include sectionse

A section document looks like this:

The first section of the document as a separate document

Section
titleConfiguration of Section Documents

To create the same heading number in the section documents as shown in the transcluding document, you need to set the number start (heading-number-start) to 1 and switch on the numbering of the document title (set use-document-heading-number to true).

Now the section headings align with the numbers shown in the transcluding document.

Note Box
titleOnly works for strict structures

Now the topic is closely bound to the document it is transcluding. In the case of sections this is typically okay. But you would need to update the document properties in case you alter the position of a section in the transcluding document.

There is no control in case you have a Module or a Topic that is used by more than one document. In this case the numbering would need to be different for each transcluding document, which is not possible for the same document.

...