Tutorials

Create different documents from the same sources via Jinja (object method)Define audience, platform, and version as Python objects, then let Jinja filter your content at build time - cleaner than string-based flags.

Create different documents from the same sources using JinjaA Python preprocessing script that uses Jinja templates to include or strip content sections before passing sources to your doc generator.

Create different documents from the same ReST sources (conditional text)Generate document variants from the same ReST sources with Sphinx conditional text.

DITA XML and XSL-FO tutorialsStep-by-step tutorials for authoring in DITA XML and generating PDF output with XSL-FO style sheets.

Regular expressions in PythonPython's regular expression library helps you manipulate text, especially if you're not familiar with sed or awk.

Auto-insert data into a DITA XML fileAutomate DITA XML file generation with Python: dynamically insert product data into DITA topics to industrialize technical documentation.

Automatically insert data into a reStructuredText fileTemplate a reStructuredText file so Python fills in product names and versions at build time - no manual updates per release.

Automatically insert SQL data into a reStructuredText fileQuery a product database and render the results directly into a reStructuredText file - keep docs in sync with the source of truth.

Managing a project from start to finishA non-profit's scattered photo archive, a zero-euro budget, and a centralized solution: one project traced from intake through delivery.

The Raspberry Pi 3 as a documentation platformWith its modest resources, a Raspberry Pi 3 is all you need to create, manage and generate documentation in PDF, HTML or EPUB format.

sed: modify your text without opening your filesRun targeted find-and-replace across hundreds of documentation files in one command - how sed handles batch text changes without opening a single file.