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 filters - the content of the map is filtered by
applying a profiling condition set before validation.
- From the current condition set - the map is filtered using
the condition set applied currently in the DITA Maps Manager view.
- From all available condition sets - for each available
condition set, the map content is filtered using the condition set before
validation.
- From the associated transformation scenario - the filtering
condition set is specified explicitly as a DITAVAL file in the current transformation
scenario associated with the DITA map.
- Other DITAVAL files - for each DITAVAL file, the map content
is filtered using the DITAVAL file before validation.
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.