Skip to content
Smart Docs with DITA

Technology Watch

Check my latest blog post!
Create different documents from the same sources via Jinja (object method) Profiling content with Jinja by defining objects (audience, platform, version, etc.) to include or exclude blocks according to their attributes using a Python script profiling.py.
Create different documents from the same sources using Jinja The Python profiling.py script below allows you to profile content in preprocessing using the powerful Jinja template engine.
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 DITA XML is a structured authoring language that lets you create documents without worrying about their final appearance on different media. XSL-FO is a language that lets you reorganize and filter XML content and apply a layout to it using a style sheet.
Regular expressions in Python Python's regular expression library helps you manipulate text, especially if you're not familiar with sed or awk.
Automatically insert data into a reStructuredText file Suppose you need to present 3 products, Dianthus, Geum and Prunus, each in three versions 1.0, 1.5 and 2.3.
Automatically insert SQL data into a reStructuredText file We're going to create a database of products with their versions, then format this information in a reStructuredText file.
Shuffling words Like the philosophy master in Molière's Bourgeois gentilhomme, a Python script can easily switch words in a sentence to say the same thing in a more convoluted way.
Managing a project from start to finish It's quite rare, in a professional context, to be able to manage a project from (almost) A to Z, from conception to realization and communication.
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 Unix clones are rarely used to manage technical documentation.