25.1.1.1 Choosing whether to overwrite ditamaps

By default, DITA2Go rewrites .ditamap files each time you run a DITA conversion. Unless the changes you make between conversion runs (changes either to your document or to configuration files) have no effect at all on DITA structure, most likely something will be different in one or more generated maps. On the other hand, if you have edited book or chapter maps by hand, you would not want to lose your edits.

To prevent DITA2Go from overwriting existing DITA maps:

[DITAOptions]
; WriteDitamaps = Yes (default) overwrite existing maps, 
;  or No (when using hand-edited chapter and book-level maps)
WriteDitamaps=No

When WriteDitamaps=Yes (the default), existing maps are overwritten

If you change the setting of WriteDitamaps from Yes to No for subsequent conversions of the same project, and you make any changes that affect DITA structure, maps can get out of synchronization with topics.

If you set WriteDitamaps=No the first time you run a DITA conversion, DITA2Go will not produce any DITA maps.

Previous Topic:  25.1.1 Specifying options for ditamaps

Next Topic:  25.1.1.2 Choosing whether a ditamap references maps or topics

Parent Topic:  25.1.1 Specifying options for ditamaps

Sibling Topics:

25.1.1.2 Choosing whether a ditamap references maps or topics

25.1.1.3 Specifying the base file name for a ditamap

25.1.1.4 Specifying a title for a chapter or book ditamap

25.1.1.5 Specifying a navigation title for a ditamap