Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Single-source publishing is a content workflow in which material is maintained in reusable source content and assembled into multiple publications or deliverables. The outputs can differ in format, audience, or included content; they do not have to look identical. DITA is one structured XML architecture for doing this, not a requirement for every single-source workflow.

How does single-source publishing work?

Instead of maintaining separate copies of the same information for every publication, a team keeps shared material in reusable pieces and assembles those pieces for specific outputs. A publishing process then transforms the selected content into deliverables such as web pages or PDFs. The source supports production, but the rendering and final design depend on the compatible processing tools and publishing pipeline.

  1. Write reusable content. Break material into units that can be maintained and reused where they make sense.
  2. Organize a publication. Select and arrange those units for a particular guide, product, audience, or release.
  3. Apply variations. Where the workflow supports it, use metadata and processing rules to include, exclude, or adapt content for different configurations or audiences.
  4. Generate deliverables. Run the assembled source through compatible publishing tools to create the required formats.

The core benefit is maintaining shared content as shared content, rather than trying to keep multiple independent copies in sync. This is most useful when reuse and variation are real recurring needs; single sourcing alone does not guarantee lower costs or fewer errors.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What is DITA, and how does it relate?

DITA (Darwin Information Typing Architecture) is an XML-based architecture for authoring, producing, and delivering topic-oriented, information-typed content that can be reused and single-sourced in different ways. That is the OASIS DITA Technical Committee’s definition in its Version 1.3 introduction. DITA is one way to implement single-source publishing; the broader method does not require DITA or XML.

Topics and maps

In DITA, a topic is a basic unit of authoring and reuse. Topics can be grouped and related through maps, which organize them into collections for a publication or other use. See OASIS’s basic concepts resources for the topic-and-map model.

Processing and outputs

DITA source content is not, by itself, a finished web page or designed PDF. Compatible processors and publishing tools perform the transformations, and the available output and its appearance depend on the toolchain. The official DITA overview describes the architecture, reuse, and publishing capabilities.

When should a team use single sourcing?

Consider the workflow when the same material appears in several products, topics, releases, or publications, or when audiences, product configurations, formats, or languages require recurring variations. Structured authoring can also help when multiple contributors need shared rules for organizing content. These needs make the investment in defined structure, compatible tools, and a maintained publishing pipeline more worthwhile.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A lighter approach may be more practical when content is written once, has one output format, or the team needs to keep setup and maintenance overhead low. Markdown, AsciiDoc, Word, or another familiar authoring method may be enough if advanced reuse and conditional publishing features would go unused. DITA is not automatically the best choice for every team.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Questions to ask before choosing an approach

  • Reuse: Is material genuinely shared across publications, products, or releases, or are the documents merely similar?
  • Outputs: Must one maintained source produce more than one publication or format?
  • Variation: Do audiences or product configurations require content to be included or excluded differently?
  • Localization: Is translation a recurring part of the publishing workflow?
  • Structure: Would contributors benefit from defined, validated content organization?
  • Operating cost: Can the team support the authoring tools, processing pipeline, and ongoing maintenance?

There is no universal savings figure that establishes when the change pays off. The decision depends on how much content is reused, how often outputs vary, and whether the team can sustain the required workflow.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.