DEV Community
Follow
Structured authoring without XML - how it works
Structured authoring creates content from reusable semantic building blocks, a concept formalized by DITA XML. Topicary implements these principles without requiring XML knowledge. A core feature is content components, which are written once and can be reused across multiple topics. Updating a component automatically propagates changes to all its references. Users can easily save any block of text as a component using a simple command. Components offer robust "where-used" tracking, allowing authors to assess the impact of edits. Conditional content enables a single topic to be tailored for different audiences by tagging blocks with specific conditions. Authors can preview these conditional views directly within the editor for immediate feedback. Variables streamline content management by allowing single-point updates for recurring elements like product names or version numbers. Topicary supports importing content from various formats, including Markdown, DITA, and MadCap Flare, preserving existing structures and features.