Tag: automation

10 articles tagged automation.

• Automatically insert data into a reStructuredText file

  Automatically insert product data into reStructuredText documentation with Python — generate product tables and version matrices from structured data files.

• Automatically insert SQL data into a reStructuredText file

  Create a product database with Python and SQLite, then automatically generate formatted reStructuredText documentation from the data — a practical docs-as-code tutorial.

• Create different documents from the same ReST sources (conditional text)

  Generate multiple document variants — user guide, admin guide, lite edition — from the same reStructuredText sources using Sphinx conditional text directives.

• Create different documents from the same sources using Jinja

  Profile reStructuredText content with Jinja and a Python preprocessing script to generate audience-specific document variants — user, admin, lite — from a single source.

• Create different documents from the same sources via Jinja (object method)

  Profile content with Jinja by defining objects (audience, platform, version) to include or exclude blocks according to their attributes using a Python profiling script.

• Managing a project from start to finish

  It's pretty rare, in a professional context, to be able to manage a project from (almost) A to Z, from conception to realization and communication.

• Regular expressions in Python

  Use Python's re library to search, extract, and transform text in documentation files — a practical regex guide for technical writers working with automation scripts.

• sed: modify your text without opening your files

  Learn to use sed, the Unix stream editor, to batch-edit technical documentation files without opening them — perfect for automating repetitive content updates.

• 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.

• The Raspberry Pi 3 as a documentation platform

  Set up a complete documentation platform on a Raspberry Pi 3: install Sphinx, generate PDF, HTML, and EPUB from reStructuredText, and manage content with Git.