By 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--chaptersargument (or two placeholders) - One
<appendix>per--appendixargument (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