Skip to content
Olivier CarrèreTechnical writing practice

Conditional text

Documentation pages on Conditional text (5 pages).

This topic brings together 5 pages across the manual:

4 Tasks1 Reference

  • Case study: NuFirewall documentation

    Reference

    Learning path: 4. Choose an authoring modelDITA

    NuFirewall's documentation, praised by the press as a product strength, was built with DITA XML - a case study in structured authoring for software product documentation.

  • Create different documents from the same ReST sources (conditional text)

    Task

    Learning path: 6. Automation & legacy techniques

    Generate multiple document variants - user guide, admin guide, lite edition - from the same reStructuredText sources using Sphinx conditional text directives.

  • Create different documents from the same sources using Jinja

    Task

    Learning path: 6. Automation & legacy techniquesJinja

    Profile reStructuredText content with Jinja and a Python preprocessing script to generate audience-specific document variants - user, admin, lite - from a single source.

  • Create different documents from the same sources via Jinja (object method)

    Task

    Learning path: 6. Automation & legacy techniquesJinja

    Profile content with Jinja by defining objects (audience, platform, version) to include or exclude blocks according to their attributes using a Python profiling script.

  • DITA XML and XSL-FO tutorials

    Task

    Learning path: 6. Automation & legacy techniques

    DITA XML structured authoring tutorials and XSL-FO stylesheet guides: create topic-based documentation and apply professional layouts for PDF and print output.

All topics