By name: generate-ditamap description: Generates a valid DITA 1.3 map template. Use this skill when you need a correctly structured starting point for a DITA map with topicref placeholders, key definitions, and an optional relationship table. Output includes the correct DOCTYPE declaration. compatibility: Python 3.9+. No third-party dependencies.
Overview
Generates a DITA 1.3 <map> template from a title and ID.
Usage
python scripts/generate_ditamap.py "My Map Title" my-map-id
# With topic hrefs pre-filled
python scripts/generate_ditamap.py "My Map Title" my-map-id --topics intro.dita config.dita usage.dita
Output
Well-formed XML to stdout including:
<?xml?>+<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA 1.3 Map//EN"><title>, one<topicref>per--topicsargument (or two placeholder refs)- A
<keydef>block for each topic ref - A skeleton
<reltable>with two columns
Common edge cases
hrefvalues use forward slashes even on Windows (DITA convention)<keydef>keysattribute is derived from the filename stem (e.g.,intro.dita→key-intro)<reltable>is scaffolded but empty; remove it if not needed