The validation of DITA maps is done with the action
Validate and Check for
Completeness that is available on the DITA Maps
Manager view toolbar and on the DITA Maps
menu.
DITA Map Completeness Check
The validation process does the following:
- Checks the file paths of the topic references. If a href attribute
points to an invalid file path it is reported as a separate error in the
Errors view.
- Validate each referred topic and map. Each topic file is opened and validated against
the appropriate DITA DTD. If other map is referred in the main map, it is checked
recursively applying the same algorithm as for the main map.
You can customize the operation setting the following options:
- Check the existence of non-DITA references resources - extends
the validation of referred resources to non-DITA files. You can also choose to include in
the validation also the remote resources;
- Use DITAVAL file - profiling conditions are applied. First the
content of the map is filtered by applying a profiling condition set. The condition set can be either the one
applied currently in the DITA Maps Manager view (the radio button From the
current condition set) or the one specified explicitly as a DITAVAL file in
the current transformation scenario associated with the DITA map (the radio button
From the associated transformation scenario). If a link is
invalid in the content that resulted from the filtering process then it is reported as
error.
- Check for duplicate element IDs within a topic - if an ID is
duplicated after assembling all topics referred in the map, it is reported as error.
- Report links to topics not referenced in DITA Maps - checks that
all referred topics are linked in the DITA map.
- Identify possible conflicts in profile attribute values - when a
topic's profiling attributes contain values that are not found in parent topics profiling
attributes, the content of the topic is overshadowed when generating profiled output. This
option reports such possible conflicts.
- Report attributes and values that conflict with profiling
preferences - looks for profiling attributes and values not defined in the
Profiling / Conditional Text preferences page. It also checks if profiling
attributes defined as single-value have multiple values set in the searched
topics.