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 Jinja A 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 tutorials Step-by-step tutorials for authoring in DITA XML and generating PDF output with XSL-FO style sheets.

Regular expressions in Python Python'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 file Automate DITA XML file generation with Python: dynamically insert product data into DITA topics to industrialize technical documentation.

Automatically insert data into a reStructuredText file Template 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 file Query a product database and render the results directly into a reStructuredText file — keep docs in sync with the source of truth.

Shuffling words An interactive Python/Flask web app that randomly rearranges words in a sentence — script included if you want to run your own.

Managing a project from start to finish A 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 platform With 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 files Run targeted find-and-replace across hundreds of documentation files in one command — how sed handles batch text changes without opening a single file.