Composite Documents

Organizing Documents in Chapters

Documents don’t always consist of a single long text. In many cases, it makes sense to divide your document into chapters. For this purpose, adoc Studio provides composite documents.

new component

To create a new composite document:

  1. Click the plus sign in the sidebar or use ⌘+N

  2. Select "Composite Document" and click "Next"

  3. Enter a title and choose the number of chapters

You can adjust the title later and add more chapters at any time.

Structure of a Composite Document

The start file contains the title of the composite document. Here you can also write the preamble text (introduction directly under the title).

Each chapter is its own file and begins with a level 2 heading (==). The chapters are displayed in the sidebar and can be reordered via drag & drop.

Document attributes like :toc: or :icons: font must be placed in the start file above the title line for them to apply to the entire composite document.

Additional Components

You can extend your document with additional elements:

  • Folders: For further structuring of your documents

  • Media folders: For platform-specific images (e.g., one folder for Mac, one for iPad)

  • Existing files: Import existing AsciiDoc files

We use the concept of multiple media folders for our manual, for example: Each platform has its own media folder with the corresponding screenshots. With Products and Conditions, the correct folder is then automatically used.