generate-bookmap

name	generate-bookmap
description	Generates a valid DITA 1.3 bookmap template. Use this skill when you need a correctly structured starting point for a DITA bookmap with booktitle, bookmeta, frontmatter, chapter placeholders, appendix, and backmatter scaffolding. Output includes the correct DOCTYPE declaration.
compatibility	Python 3.9+. No third-party dependencies.

Overview

Generates a DITA 1.3 <bookmap> template from a title, ID, and optional chapter list.

Usage

python scripts/generate_bookmap.py "My Book Title" my-book-id

# Pre-fill chapters
python scripts/generate_bookmap.py "My Book Title" my-book-id \
  --chapters chapter1.dita chapter2.dita chapter3.dita \
  --appendix appendixA.dita

Output

Well-formed XML to stdout including:

• <?xml?> + <!DOCTYPE bookmap PUBLIC "-//OASIS//DTD DITA 1.3 BookMap//EN">
• <booktitle> with <mainbooktitle> and <booktitlealt> placeholder
• <bookmeta> with <publisherinformation> and <bookid> scaffolding
• <frontmatter> with <toc/>, <figurelist/>, <tablelist/>
• One <chapter> per --chapters argument (or two placeholders)
• One <appendix> per --appendix argument (or one placeholder)
• <backmatter> with <indexlist/>

Common edge cases

• DTD order is enforced: front → chapters → appendix → back
• <part> grouping is not generated by default; add manually if needed
• <booktitlealt> is for subtitles; remove if not needed