Syntax #
map-filename(filename)
map-filename-words(filename)
map-filename-lower-case(filename)
filename
name of the file
Purpose #
The map filename annotations are used to create nested DITA maps. DITA allows you to physically split a map into separate files. The map file name annotations are used to pin point where a new physical DITA map should start, and what its file name should be.
Typically, this annotation is applied on elements which have also had a title annotation applied.
The variations of the map file name annotations apply different filtering logic to the file name parameter. Consider the text “vegetable recipes”:
| annotation | description | computed file name |
|---|---|---|
| map-filename(\*.ditamap) | no filtering | vegetable recipes.ditamap |
| map-filename-lower-case(\*.ditamap) | lower case text | vegetable recipes.ditamap |
| map-filename-words(\*.xml) | replace funny charaters with an underscore | vegetable_recipes.xml |
