Products

What Are Products?

In addition to quick export, you can also save outputs as a product. This way, your settings for format, style, and attributes are retained. You can re-export the product at any time with the same settings.

Products are ideal for recurring outputs:

  • A manual for different platforms (Mac, iPad, iPhone)

  • Different versions (quick guide vs. complete manual)

  • Different target audiences (beginners vs. experts)

Products with Attributes

Each product can define its own attributes. This enables single-source publishing: one source document, many outputs.

Let’s take our manual as an example. In many places, we use:

image::{platform}/screenshot.png[]

In the product "iPad Manual", the attribute :platform: ipad is defined. This changes the path to ipad/screenshot.png. In the product "Mac Manual", :platform: mac is set, so mac/screenshot.png is loaded.

attributes product

This way, you maintain only one document and automatically generate platform-specific outputs.

Creating Products

To create a new product:

  1. Open the project settings

  2. Switch to the "Products" tab

  3. Click the plus sign

  4. Choose format, style, and define your attributes

Combine products with conditions to selectively show or hide text sections. More on this in the chapter Conditions.