DITA-OT error messages
The error messages generated by the DITA Open Toolkit contain a message ID, severity information, and message text. This topic lists each error message generated by the toolkit and provides additional information that might be helpful in understanding and resolving the error condition.
Each message ID is composed of a message prefix, a message number, and a letter that indicates
the severity (I, W, E, or F). The toolkit uses the following severity scale:
- Informational (I)
- The toolkit encountered a condition of which you should be aware. For example, draft comments are enabled and will be rendered in the output.
- Warning (W)
- The toolkit encountered a problem that should be corrected. Processing will continue, but the output might not be as expected.
- Error (E)
- The toolkit encountered a more severe problem, and the output is affected. For example, some content is missing or invalid, or the content is not rendered in the output
- Fatal (F)
- The toolkit encountered a severe condition, processing stopped, and no output is generated.
| Message ID | Severity | Message text | Additional details |
|---|---|---|---|
| DOTA001F | Fatal | "%1" is not a recognized transformation type. Supported transformation types are docbook, eclipsecontent, eclipsehelp, html5, htmlhelp, javahelp, net.sourceforge.dita-ot.html, odt, pdf, pdf2, tocjs, troff, wordrtf, xhtml. | Default transformation types that ship with the toolkit include xhtml, eclipsehelp, pdf (or pdf2), tocjs, htmlhelp, javahelp, odt, eclipsecontent, troff, docbook, and wordrtf. Additional transformation types may be available if toolkit plug-ins are installed. |
| DOTA002F | Fatal | Input file is not specified, or is specified using the wrong parameter. | The input parameter was not specified, so there is no DITA or DITAMAP file to transform. Ensure the parameter is set properly; see DITA-OT Ant arguments or DITA-OT Command line tool arguments if you are unsure how to specify the input file. |
| DOTA003F | Fatal | Cannot find the user specified XSLT stylesheet '%1'. | An alternate stylesheet was specified to run in place of the default XSLT output process, but that stylesheet could not be loaded. Please correct the parameter to specify a valid stylesheet. |
| DOTA004F | Fatal | Invalid DITA topic extension '%1'. Supported values are '.dita' and '.xml'. | This optional parameter is used to set an extension for DITA topic documents in the temporary processing directory. Only "dita", ".dita", "xml", or ".xml" are allowed. |
| DOTA006W | Warning | Absolute paths on the local file system are not supported for the CSSPATH parameter. Please use a relative path or full URI instead. | If the CSSPATH uses an absolute path, it should be one that can still be accessed after the files are moved to another system (such as http://www.example.org/). Absolute paths on the local file system will be broken if the content is moved to a new system. |
| DOTA007E | Error | Cannot find the running-footer file "%1". Please double check the value to ensure it is specified correctly. | The running footer file, which contains content to be added to the bottom of each XHTML output topic, cannot be located or read. This is usually caused by a typo in the parameter value. You should also ensure that the value is not specified with "file:" as a prefix. |
| DOTA008E | Error | Cannot find the running-header file "%1". Please double check the value to ensure it is specified correctly. | The running header file, which contains content to be added to the top of each XHTML output topic, cannot be located or read. This is usually caused by a typo in the parameter value. You should also ensure that the value is not specified with "file:" as a prefix. |
| DOTA009E | Error | Cannot find the specified heading file "%1". Please double check the value to ensure it is specified correctly. | The running heading file, which contains content to be added to the <head> section of each XHTML output topic, cannot be located or read. This is usually caused by a typo in the parameter value. You should also ensure that the value is not specified with "file:" as a prefix. |
| DOTA011W | Warning | Argument "%1" is deprecated. This argument is no longer supported in the toolkit. | |
| DOTA012W | Warning | Argument "%1" is deprecated. Please use the argument "%2" instead. | |
| DOTA066F | Fatal | Cannot find the user specified XSLT stylesheet '%1'. | An alternate stylesheet was specified to run in place of the default XSL-FO output process, but that stylesheet could not be loaded. Please correct the parameter to specify a valid stylesheet. |
| DOTA067W | Warning | Ignoring index-see '%1' inside parent index entry '%2' because the parent indexterm contains indexterm children. According to the DITA Specification, the index-see element should be ignored if the parent indexterm contains other indexterm children. | This condition is ignored, as instructed in the OASIS DITA Standard. |
| DOTA068W | Warning | Ignoring index-see-also '%1' inside parent index entry '%2' because the parent indexterm contains indexterm children. According to the DITA Specification, the index-see-also element should be ignored if the parent indexterm contains other indexterm children. | This condition is ignored, as instructed in the OASIS DITA Standard. |
| DOTA069F | Fatal | Input file '%1' cannot be located or read. Ensure that file was specified properly and that you have permission to access it. | Please ensure that the input file path and file name were entered correctly. |
| DOTA069W | Warning | Target "%1" is deprecated. Remove references to this target from your custom XSLT or plug-ins. | |
| DOTJ001F | Fatal | Invalid command line syntax for the parameter '%1'. Parameters to the command line tool should use the syntax /parameter:value. | See Command-line tool parameters for a list of available parameters and values. |
| DOTJ002F | Fatal | Unsupported parameter '%1'. Please refer to the DITA-OT User Guide for supported parameters. | See Command-line tool parameters for a list of available parameters and values. |
| DOTJ003F | Fatal | Parameter '%1' was specified without a value. Parameters to the command line tool should use the syntax /parameter:value. | See Command-line tool parameters for a list of available parameters and values. |
| DOTJ004F | Fatal | Cannot create temporary processing directory '%1'. Please ensure that you have permission to create the directory '%1'. | The transform was unable to create a temporary processing directory; this is usually caused by account control settings that prevent creating a temporary directory in the specified location. Please verify that you have permission to write to the default location, or specify an alternate temporary directory location. See DITA-OT Ant arguments or DITA-OT Command line tool arguments for details on how to specify the temporary directory. |
| DOTJ005F | Fatal | Failed to create new instance for '%1'. Please ensure that '%1' exists and that you have permission to access it. | |
| DOTJ006F | Fatal | An Ant build file used the following illegal syntax when calling AntInvoker: extparam='%1'. Please correct the call to AntInvoker when directly calling DITA-OT Java code from Ant; for example, extparam="maplinks=XXXX;other=YYYY". | This message occurs when an Ant build calls a DITA-OT pipeline module directly instead of using the default call to that module. Please check that all parameters are set correctly in your Ant build. The syntax for extparam is "name1=value1;name2=value2". |
| DOTJ007E | Error | Duplicate condition in filter file for rule '%1'. The first encountered condition will be used. | If a condition is defined more than once (such as setting audience="all" to include, then resetting it to exclude), only the first definition will be used. |
| DOTJ009E | Error | Cannot overwrite file '%1' with file '%2'. The modified result may not be consumed by the following steps in the transform pipeline. Check to see whether the file is locked by some other application during the transformation process. | The transform was unable to create files properly during the transform; results may not be as expected. |
| DOTJ012F | Fatal | Failed to parse the input file '%1'. The XML parser reported the following error: | This message may indicate an invalid input file (such as accidentally specifying a PDF file as input rather than a DITA map file), an input file that uses elements which are not allowed, are not part or a DITA file that has errors and cannot be parsed as XML. You could also be using a specialized DITA document type that needs external plug-ins in order to be parsed correctly. The message issued by the XML parser should provide additional information to help diagnose the cause. |
| DOTJ013E | Error | Failed to parse the referenced file '%1'. The XML parser reported the following error: | This message may indicate a reference to an invalid file (such as accidentally referencing a PDF or unknown XML file as if it was DITA), a referenced file that uses elements which are not allowed, or a referenced DITA file that has errors and cannot be parsed as XML. You could also be using a specialized DITA document type that needs external plug-ins in order to be parsed correctly. The message issued by the XML parser should provide additional information to help diagnose the cause. |
| DOTJ014W | Warning | Found an indexterm element with no content. Setting the term to ***. | An empty <indexterm> element was found, and will appear in the index as ***. This index term should be removed from the source. |
| DOTJ015F | Fatal | Log directory cannot be null. Please specify a valid directory for the build log. | |
| DOTJ016F | Fatal | Failed to create log directory '%1'. Please specify a valid directory for the build log. | |
| DOTJ017F | Fatal | No input file was specified; failed to initialize log name based on input file. | The transform failed because the input file was not specified; log file names are based on the name of the input file, so no log could be generated. |
| DOTJ018I | Informational | Log file '%1' was generated successfully in directory '%2'. Any messages from the transformation process are available in the log file; additional details about each message are available in the DITA-OT user guide. | |
| DOTJ020W | Warning | At least one plug-in in '%1' is required by plug-in '%2'. Plug-in '%2' cannot be loaded. Check and see whether all prerequisite plug-ins are installed in toolkit. | This will appear when one installed plug-in requires another in order to function correctly, but the required plug-in is not found. The installed plug-in will be ignored. |
| DOTJ021W | Warning | File '%1' will not generate output since it is invalid or all of its content has been filtered out by the ditaval file. Please check the file '%1' and the ditaval file to see if this is the intended result. | This may appear if filter conditions on the root element of a topic cause the entire topic to be filtered out. To remove this message, you could place any filter conditions on the reference to this file, which will prevent the build from accessing this file. |
| DOTJ022F | Fatal | Failed to parse the input file '%1' because all of its content has been filtered out. This will happen if the input file has filter conditions on the root element, and a ditaval excludes all content based on those conditions. | Either the input file or the ditaval file should change, otherwise your build is explicitly excluding all content. |
| DOTJ023E | Error | Failed to get the specified image file '%1', so it will not be included with your output. | Check whether the image exists in the source location or already exists in the output directory. |
| DOTJ025E | Error | The input to the "topic merge" transform process could not be found. Correct any earlier transform errors and try the build again, or see the DITA-OT User Guide for additional causes. | This message
should only appear in the following cases:
|
| DOTJ026E | Error | The "topic merge" did not generate any output. Correct any earlier transform errors and try the build again, or see the DITA-OT User Guide for additional causes. | This message should only appear if an Ant build or plug-in is directly calling the toolkit's topic merge module, or if earlier errors resulted in problems with some of the content. If the topic merge module is called correctly, then this indicates a program error that should be reported to the DITA-OT development team, at DITA-OT bug and feature tracker. |
| DOTJ028E | Error | No format attribute was found on a reference to file '%1', which does not appear to be a DITA file. If this is not a DITA file, set the format attribute to an appropriate value, otherwise set the format attribute to "dita". | When referencing a non-DITA file, the format attribute should indicate the type of file referenced (such as "html" for HTML topics or "pdf" for PDF files). Otherwise, the transform may attempt to parse the referenced document as a DITA topic. |
| DOTJ029I | Informational | No 'domains' attribute was found for element '<%1>'. This generally indicates that your DTD or Schema was not developed properly according to the DITA specification. | The domains attribute is used in specialized DITA documents to help determine which domain elements are legal. This message will only appear if DITA specialization was not defined properly. |
| DOTJ030I | Informational | No 'class' attribute for was found for element '<%1>'. This generally indicates that your DTD or Schema was not developed properly according to the DITA specification. | All specialized DITA elements must define a class attribute to provide ancestry information. This message will only appear a specialized DITA element did not define a class attribute. |
| DOTJ031I | Informational | No specified rule for '%1' was found in the ditaval file. This value will use the default action, or a parent prop action if specified. To remove this message, you can specify a rule for '%1' in the ditaval file. | This informational message is intended to help you catch filter conditions that may have been specified improperly; if the value is correct, no action is needed. |
| DOTJ033E | Error | No valid content is found in topicref '%1' during chunk processing. Please specify an existing and valid topic for the topicref. | |
| DOTJ034F | Fatal | Failed to parse the input file '%1' (the content of the file is not valid). If the input file '%1' does not have a DOCTYPE declaration, please make sure that all class attributes are present in the file. | DITA processing is based on class attributes defined for every element. Usually these are defaulted in the DTD or Schema; if no DTD or Schema is used, the class attributes must be explicitly included in the map or topic. |
| DOTJ035F | Fatal | The file "%1" referenced by "%2" is outside the scope of the input dita/map directory. If you want to lower the severity level, please use the Ant parameter 'outer.control', and set the value to "warn" or "quiet". Otherwise, move the referenced file "%1" into the input dita/map directory. | This will appear when a topic is outside the scope of the map; for example, if the main input map references "../other-directory/some.dita". The result would cause an output file to be created outside of the output directory. Please see DITA-OT Ant arguments (outer.control and generate.copy.outer) or DITA-OT Command line tool arguments (/outercontrol and /generateouter) for more details. |
| DOTJ036W | Warning | The file "%1" referenced by "%2" is outside the scope of the input dita/map directory. If you do not want to see the warning message, please use the Ant parameter 'outer.control', and set the value to "quiet". Otherwise, move the referenced file "%1" into the input dita/map directory. | This will appear when a topic is outside the scope of the map; for example, if the main input map references "../other-directory/some.dita". The result would cause an output file to be created outside of the output directory. Please see DITA-OT Ant arguments (outer.control and generate.copy.outer) or DITA-OT Command line tool arguments (/outercontrol and /generateouter) for more details. |
| DOTJ037W | Warning | The XML schema and DTD validation function of the parser is turned off. Please make sure the input is normalized DITA with class attributes included, otherwise it will not be processed correctly. | DITA processing is based on class attributes defined for every element. Usually these are defaulted in the DTD or Schema; if validation against the DTD or Schema is turned off, the class attributes must be explicitly included in the map or topic. |
| DOTJ038E | Error | The tag "%1" is specialized from unrecognized metadata. Please make sure that tag "%1" is specialized from an existing metadata tag in the core DITA vocabulary. | This appears to indicate an error in creating specialized metadata elements. Please verify that the document type you are using is complete and complies with DITA Specialization rules. |
| DOTJ039E | Error | There is no target specified for conref push action "pushafter". Found in file="%1", element="%2". Please add <elementname conref="pushtarget" conaction="mark"> before current element. | Please see the topic on Conref Push in the DITA specification for details on expected syntax for this function. |
| DOTJ040E | Error | An element uses the attribute conaction="replace", but a conref attribute is not found in the expected location. Found in file="%1", element="%2". | Please see the topic on Conref Push in the DITA specification for details on expected syntax for this function. |
| DOTJ041E | Error | The attribute conref="%1" uses invalid syntax. The value should contain '#' followed by a topic or map ID, optionally followed by '/elemID' for a sub-topic element. | The conref attribute must be a URI reference to a DITA element. Please see the topic on URI-based addressing in the DITA specification for details on the expected syntax. |
| DOTJ042E | Error | Two elements both use conref push to replace the target "%1". Please delete one of the duplicate "replace" actions. | The conref push function was used to replace a single element with two or more alternatives. Only one element may directly replace another using conref push. See Conref Push in the DITA specification for more information about the conref push "replace" function. |
| DOTJ043W | Warning | The conref push function is trying to replace an element that does not exist (element "%1" in file "%2"). | The target for a conref push action does not exist; please make sure that the syntax is correct and that the target exists. See the topic on URI-based addressing in the DITA specification for details on the expected syntax. If the syntax is correct, it is possible that the target was filtered out of your build using a DITAVAL file. |
| DOTJ044W | Warning | There is a redundant conref action "pushbefore". Found in file="%1", element="%2". Please make sure that "mark" and "pushbefore" occur in pairs. | Please see the topic on Conref Push in the DITA specification for details on expected syntax for this function. |
| DOTJ045I | Informational | The key "%1" is defined more than once in the same map file. The reference href="%2" is ignored. | No response is needed if the keys are defined as expected; this is informational only, to help catch incorrectly defined keys. |
| DOTJ046E | Error | Conkeyref="%1" can not be resolved because it does not contain a key or the key is not defined. The build will use the conref attribute for fallback, if one exists. | See the conkeyref definition for details on expected syntax and usage. |
| DOTJ047I | Informational | Unable to find key definition for keyref="%1", href may be used as fallback if it exists. | This message is intended to help you locate incorrectly specified keys; if the key was specified correctly, this message may be ignored. |
| DOTJ049W | Warning | The attribute value %1="%3" on element "%2" does not comply with the specified subject scheme. According to the subject scheme map, the following values are valid for the %1 attribute: %4 | A DITA Subject Scheme map was used to limit values that are available to the specified attribute. Please correct the attribute so that it uses one of the allowed values. |
| DOTJ050W | Warning | Found an <index-see> or <index-see-also> reference to the term '%1', but that term is not defined in the index. | The Eclipse index will contain a value such as "See also otherEntry", but otherEntry does not exist in this index. The index reference will be broken unless this plug-in is always loaded into Eclipse with another plug-in that defines otherEntry as an index term. |
| DOTJ051E | Error | Unable to load target for coderef "%1". | The target for
a coderef element, which specifies an external text-based file, could not be located or loaded. Please
verify that the reference is correct. Note that for security reasons, references to code samples outside of the scope of the map directory are not supported by default, as this could allow a reference to access and display any restricted or hidden file on the system. If you are certain that the path is valid and the file should be loaded, the current workaround is to set a parameter to allow these references. See DITA-OT Ant arguments (outer.control and generate.copy.outer) or DITA-OT Command line tool arguments (/outercontrol and /generateouter) for details. |
| DOTJ052E | Error | Code reference charset "%1" not supported. See the DITA-OT User guide for supported charset values on the format attribute. | The DITA-OT supports a special syntax on coderef elements to specify the character set of the target document. See Extended functionality for details on the expected syntax. |
| DOTJ053W | Warning | Input file '%1' is not valid DITA file name. Please check '%1' to see if it is correct. The extensions ".dita" or ".xml" are supported for DITA topics. | By default, the DITA-OT supports the extensions "dita" and "xml" for DITA topics, as mandated by the DITA Specification. Please verify that your topics use one of these extensions, or configure the toolkit to allow additional extensions. |
| DOTJ054E | Error | Unable to parse invalid %1 attribute value "%2" | |
| DOTJ055E | Error | Invalid key name "%1". | |
| DOTJ056E | Error | Invalid xml:lang "%1". | |
| DOTJ057E | Error | The id attribute value "%1" is not unique within the topic that contains it. | |
| DOTJ058E | Error | Both %1 and %2 attributes defined. A single element may not contain both generalized and specialized values for the same attribute. | |
| DOTJ059E | Error | Invalid key scope name "%1". | |
| DOTJ060W | Warning | Key "%1" was used in conkeyref but is not bound to a DITA topic or map. Cannot resolve conkeyref value "%2" as a valid conref reference. | |
| DOTX001W | Warning | No string named '%1' was found for language '%2'. Using the default language '%3'. Add a mapping between default language and desired language for the string '%1'. | This build uses generated text, such as the phrase "Related information" (which is generated above many link groups). The toolkit was unable to locate the string %1 for your specified language, so the string will appear in the default language. This generally indicates that the toolkit's strings needs to be updated to support your language, or that your language setting is incorrect. |
| DOTX002W | Warning | The title element or attribute in the ditamap is required for Eclipse output. | The Eclipse help system requires a title in the project files generated from your map. Please add a title to your input map to get valid Eclipse help output. |
| DOTX003I | Informational | The anchorref attribute should either reference another dita map or an Eclipse XML TOC file. The value '%1' does not appear to reference either. | Eclipse uses anchor references to connect with other TOC files. For this to work in content generated from a DITA map, the anchorref element must reference either an existing Eclipse TOC XML file, or another DITA map (which will presumably also be converted to an Eclipse TOC). |
| DOTX004I | Informational | Found a navref element that does not reference anything. The navref element should either reference another dita map or an Eclipse XML file. | Eclipse builds use DITA's <navref> element to pull in other Eclipse TOC files. The build found a <navref> element that does not reference any other file; the element will be ignored. |
| DOTX005E | Error | Unable to find navigation title for reference to '%1'. The build will use '%1' as the title in the Eclipse Table of Contents. | To remove this message, provide a navigation title for the referenced object in the map or topic, or ensure that you are referencing a valid local DITA target. |
| DOTX006E | Error | Unknown file extension in href="%1". References to non-DITA resources should set the format attribute to match the resource (for example, 'txt', 'pdf', or 'html'). | Set the format attribute to identify the format of the file. If the reference is to a DITA document, ensure that the document uses a valid DITA extension (default supported extensions are "dita" and "xml"). |
| DOTX007I | Informational | Only DITA topics, HTML files, and images may be included in your compiled CHM file. The reference to "%1" will be ignored. To remove this message, you can set the toc="no" or processing-role="resource-only" attribute on your topicref. | The HTML Help compiler will only include some types of information in the compiled CHM file; the current reference will not be included. |
| DOTX008E | Error | File '%1' does not exist or cannot be loaded. | Ensure that the file exists and can be read. Note that the name of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'), instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. |
| DOTX008W | Warning | File '%1' cannot be loaded, and no navigation title is specified for the table of contents. | To fix the table of contents, specify a navigation title in your map or ensure that the referenced file is local and can be accessed. Note that the name of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'), instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. |
| DOTX009W | Warning | Could not retrieve a title from '%1'. Using '%2' instead. | No title was found in the specified topic, so the table of contents will use the indicated fallback value for this topic. |
| DOTX010E | Error | Unable to find target for conref="%1". | The conref
attribute must be a URI reference to an existing DITA element. Please see the topic on
URI-based
addressing in the DITA specification for details on the expected syntax. Note that the name
of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'),
instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. If the target element exists in your source file, check to make sure it is not filtered out of the build with a DITAVAL file (which will remove the target before conref processing runs). |
| DOTX011W | Warning | There is more than one possible target for the reference conref="%1". Only the first will be used. Remove the duplicate id in the referenced file. | When pulling content with a conref attribute, you may only pull from a single element, but the target ID appears twice in the referenced topic. Note that the name of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'), instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. |
| DOTX012W | Warning | When you conref another topic or an item in another topic, the domains attribute of the target topic must be equal to or a subset of the current topic's domains attribute. Put your target under an appropriate domain. You can see the messages guide for more help. | This message is deprecated and should no longer appear in any logs. |
| DOTX013E | Error | A element with attribute conref="%1" indirectly includes itself, which results in an infinite loop. | This may appear if (for example) you have a <ph> element that references another phrase, but that phrase itself contains a reference to the original. This will result in an infinite loop. The toolkit will stop following the conref trail when this is detected; you will need to correct the reference in your source files. Note that the name of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'), instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. |
| DOTX014E | Error | The attribute conref="%1" uses invalid syntax. Conref references to a map element should contain '#' followed by an ID, such as mymap.ditamap#mytopicrefid. | The conref attribute must be a URI reference to a DITA element. Please see the topic on URI-based addressing in the DITA specification for details on the expected syntax. |
| DOTX015E | Error | The attribute conref="%1" uses invalid syntax. The value should contain '#' followed by a topic or map ID, optionally followed by '/elemID' for a sub-topic element. | The conref attribute must be a URI reference to a DITA element. Please see the topic on URI-based addressing in the DITA specification for details on the expected syntax. Note that the name of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'), instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. |
| DOTX016W | Warning | A reference to "%2" appears to reference a DITA document, but the format attribute has inherited a value of "%1". The document will not be processed as DITA. | This warning is intended to catch instances where a non-DITA format setting unexpectedly cascades to a DITA topic, which will prevent the topic from being processed. To remove this message, set the format attribute directly on the indicated reference. Note that the name of the file in this message may have be changed to use a standard dita topic file extension ('.dita' or '.xml'), instead of the original extension used by the file; it may also include a path to the temporary directory rather than to the original. |
| DOTX017E | Error | Found a link or cross reference with an empty href attribute (href=""). Remove the empty href attribute or provide a value. | Found a value such as <xref href="">link text</xref>. The empty href attribute is not serving a purpose and has caused problems with some tools in the past; you should remove the attribute entirely or specify a value. |
| DOTX018I | Informational | The type attribute on a topicref was set to '%1', but the topicref references a more specific '%2' topic. Note that the type attribute cascades in maps, so the value '%1' may come from an ancestor topicref. | The type attribute in DITA is intended to describe the type of the target; for example, a reference to a concept topic may use type="concept". Generally, this attribute is optional, and the DITA-OT build will automatically determine the value during processing. In this case, the type attribute lists a more general type than what is actually found. This is not an error but may result in unexpected sorting for links to this topic. |
| DOTX019W | Warning | The type attribute on a topicref was set to '%1', but the topicref references a '%2' topic. This may cause your links to sort incorrectly in the output. Note that the type attribute cascades in maps, so the value '%1' may come from an ancestor topicref. | The type attribute in DITA is intended to describe the type of the target; for example, a reference to a concept topic may use type="concept". Generally, this attribute is optional, and the DITA-OT build will automatically determine the value during processing. In this case, the specified type value does not match the target, which may cause your links to sort inappropriately. |
| DOTX020E | Error | Missing navtitle attribute or element for peer topic "%1". References must provide a local navigation title when the target is not a local DITA resource. | The DITA-OT is only able to dynamically retrieve titles when the target is a local (not peer or external) DITA resource. |
| DOTX021E | Error | Missing navtitle attribute or element for non-DITA resource "%1". References must provide a local navigation title when the target is not a local DITA resource. | The DITA-OT is only able to dynamically retrieve titles when the target is a local DITA resource. |
| DOTX022W | Warning | Unable to retrieve navtitle from target: '%1'. Using linktext (specified in topicmeta) as the navigation title. | The build was unable to get a title from the referenced topic; instead, a navigation title will be created based on the specified <linktext> element inside of <topicmeta>. |
| DOTX023W | Warning | Unable to retrieve navtitle from target: '%1'. | If the target is a local DITA topic, ensure the reference is correct and the topic is available. Otherwise, provide a navigation title, and ensure the scope and format attributes are set appropriately. |
| DOTX024E | Error | Missing linktext and navtitle for peer topic "%1". References must provide a local navigation title when the target is not a local DITA resource. | The DITA-OT is only able to dynamically retrieve titles and link text when the target is a local (not peer or external) DITA resource. |
| DOTX025E | Error | Missing linktext and navtitle for non-DITA resource "%1". References must provide a local navigation title when the target is not a local DITA resource. | The DITA-OT is only able to dynamically retrieve titles when the target is a local DITA resource. |
| DOTX026W | Warning | Unable to retrieve linktext from target: '%1'. Using navigation title as fallback. | The referenc to this document did not specify any link text for generated map-based links; the navigation title will be used as fallback. |
| DOTX027W | Warning | Unable to retrieve linktext from target: '%1'. | The referenced file did not specify any link text for generated map-based links, and no fallback text could be located. Any links generated from this reference will have incorrect link text. |
| DOTX028E | Error | Link or cross reference must contain a valid href or keyref attribute; no link target is specified. | The link or cross reference has no target specified and will not generate a link. |
| DOTX029I | Informational | The type attribute on a %1 element was set to %3, but the reference is to a more specific %4 %2. This may cause your links to sort incorrectly in the output. | The type attribute in DITA is intended to describe the type of the target; for example, a reference to a concept topic may use type="concept". Generally, this attribute is optional, and the DITA-OT build will automatically determine the value during processing. In this case, the type attribute lists a more general type than what is actually found. This is not an error but may result in unexpected sorting for links to this topic. |
| DOTX030W | Warning | The type attribute on a %1 element was set to %3, but the reference is to a %4 %2. This may cause your links to sort incorrectly in the output. | The type attribute in DITA is intended to describe the type of the target; for example, a reference to a concept topic may use type="concept". Generally, this attribute is optional, and the DITA-OT build will automatically determine the value during processing. In this case, the specified type value does not match the target, which may cause your links to sort inappropriately. |
| DOTX031E | Error | The file %1 is not available to resolve link information. | The build attempted to access the specified file in order to retrive a title or short description, but the file could not be found. If the file exists, it is possible that a DITAVAL file was used to remove the file's contents from the build. Be aware that the path information above may not match the link in your topic. |
| DOTX032E | Error | Unable to retrieve link text from target: '%1'. If the target is not accessible at build time, or does not have a title, provide the link text inside the reference. | When a link or cross reference does not have content, the build will attempt to pull the target's title for use as link text. If the target is unavailable, be sure to set the scope attribute to an appropriate value. If the target does not have a title (such as when linking to a paragraph), be sure to provide link text inside the cross reference. |
| DOTX033E | Error | Unable to generate link text for a cross reference to a list item: '%1' | An <xref> element specifies type="li", which indicates a link to a list item, but the item number could not be determined to use as link text. Please specify link text inside the reference, or ensure that you are referencing an available list item. |
| DOTX034E | Error | Unable to generate link text for a cross reference to an undered list item: '%1' | The cross reference goes to a list item in an unordered list. The process could not automatically generate link text because the list item is not numbered. Please provide link text within the cross reference. |
| DOTX035E | Error | Unable to generate the correct number for a cross reference to a footnote: '%1' | An <xref> element specifies type="fn", which indicates a link to a footnote, but the footnote number could not be determined to use as link text. Please specify link text inside the reference, or ensure that you are referencing an available footnote. |
| DOTX036E | Error | Unable to generate link text for a cross reference to a dlentry (the dlentry or term could not be found): '%1' | An <xref> element specifies type="dlentry", which indicates a link to a definition list entry, but the term could not be located to use as link text. Please specify link text inside the reference, or ensure that you are referencing an available definition list entry |
| DOTX037W | Warning | No title found for this document; using "***" in XHTML title bar. | No title was found for the current document, so the XHTML output file will set the <title> to "***". This value generally appears in the title bar at the top of a browser. |
| DOTX038I | Informational | The longdescref attribute on tag '%1' will be ignored. Accessibility for object elements needs to be handled another way. | The <object> element in XHTML does not support using longdescref for accessibility. To make the object accessible, you may need to add text before or after the element. You may also be able to handle it with a <param> element inside the object. |
| DOTX039W | Warning | Required cleanup area found. To remove this message and hide the content, build your content without using the DRAFT parameter. | This message is generated when creating draft output in order to help you locate all topics that need to be cleaned up; the cleanup items will appear in your output with styling that makes it stand out. The content will be hidden when the draft parameter is not active. |
| DOTX040I | Informational | Draft comment area found. To remove this message and hide the comments, build your content without using the DRAFT parameter. | This message is generated when creating draft output in order to help you locate all topics that have draft comments. Each comment will appear in your XHTML output; the comments will be hidden when the draft parameter is not active. |
| DOTX041W | Warning | Found more than one title element in a section. Using the first one for the section's title. | Because of the way XML and DITA are defined, it is generally not possible to prohibit adding a second title to a section during editing (or to force that title to come first). However, the DITA specification states that only one title should be used in a section. When multiple titles are found, only the first one will appear in the output. |
| DOTX042I | Informational | DITAVAL based flagging is not currently supported for inline phrases in XHTML; ignoring flag value on '%1' attribute. | If it is important to flag this piece of information, try placing a flag on the block element that contains your phrase. If you just want to have an image next to the phrase, you may place an image directly into the document. |
| DOTX043I | Informational | The link to '%1' may appear more than once in '%2'. | The DITA-OT is able to remove duplicate links in most cases. However, if two links to the same resource use different attributes or link text, it is possible for them to appear together. For example, if the same link shows up with role="next" and again with no specified role, it may show up as both the "Next topic" link and as a related link. Note that links generated from a <reltable> in a DITA Map will have the role attribute set to "friend". |
| DOTX044E | Error | The area element in an image map does not specify a link target. Please add an xref element with a link target to the area element. | The <area> element in an image map must provide a link target for the specified area. Please add an <xref> element as a child of <area> and ensure that it specifies a link target. |
| DOTX045W | Warning | The area element in an image map should specify link text for greater accessibility. Link text should be specified directly when the target is not a local DITA resource. | Cross reference text inside the <area> element is used to provide accessibility for screen readers that can identify different areas of an image map. If text cannot be retrieved automatically by referencing a DITA element, it should be specified directly in the cross reference. |
| DOTX046W | Warning | Area shape should be: default, rect, circle, poly, or blank (no value). The value '%1' is not recognized. | The specified value was passed as-is through to the area element in the XHTML. |
| DOTX047W | Warning | Area coordinates are blank. Coordinate points for the shape need to be specified. | The area element is intended to define a region in an image map; coordinates must be specified in order to define that region. |
| DOTX048I | Informational | In order to include peer or external topic '%1' in your help file, you may need to recompile the CHM file after making the file available. | The build will not look for peer or external topics before compiling your CHM file, so they may not be included. If you are referencing an actual HTML file that will not be available, it cannot be included in the project, and you should set the toc attribute to "no" on your topicref element. Otherwise, check to be sure your HTML file was included in the CHM; if it was not, you will need to place it in the correct location with your other output files and recompile. |
| DOTX049I | Informational | References to non-dita files will be ignored by the PDF, ODT, and RTF output transforms. | The PDF, ODT, and RTF output processes cannot automatically convert non-DITA content into DITA in order to merge it with the rest of your content. The referenced items are ignored. |
| DOTX050W | Warning | Default id "org.sample.help.doc" is used for Eclipse plug-in. If you want to use your own plug-in id, please specify it using the id attribute on your map. | Eclipse requires that an ID be specified when creating an Eclipse Help project; the toolkit expects to locate that ID on the root element of your input map. |
| DOTX052W | Warning | No string named '%1' was found when creating generated text; using the value '%1' in your output file. | The toolkit is attempting to add generated text, such as the string "Related information" that appears above links. The requested string could not be found in any language. Your output may contain a meaningful string, or it may contain a code that was intended to map to a string. This likely indicates an error in a plug-in or XSL override; either the string was requested incorrectly, or you will need to provide a mapping for the string in all of the languages you require. |
| DOTX053E | Error | A element that references another map indirectly includes itself, which results in an infinite loop. The original map reference is to '%1'. | This will occur if a map references another map, and then that second map (or another further nested map) references the original map. The result is an infinite nesting of maps; please correct the chain of map references to remove circular reference. |
| DOTX054W | Warning | Conflict text style is applied on the current element based on DITAVAL flagging rules. Please check ditaval and dita source to make sure there is no style conflict on the element which needs to be flagged. | This will occur when a DITAVAL file contains multiple styling rules that apply to the same element. |
| DOTX055W | Warning | Customized stylesheet uses deprecated template "flagit". Conditional processing is no longer supported using this template. Please update your stylesheet to use template "start-flagit" instead of deprecated template "flagit". | The "flagit" named template was deprecated in DITA-OT version 1.4, when the OASIS standard formalized the DITAVAL syntax. The template is removed in DITA-OT 1.6. Stylesheets that used this template need to be updated. |
| DOTX056W | Warning | The file '%1' is not available to resolve link information. | The build attempted to access the specified file in order to retrive a title or short description, but the file could not be found. If the file exists, it is possible that a DITAVAL file was used to remove the file's contents from the build. Another possibility is that the file is located outside of the scope of the main input directory, and was not available because the onlytopic.in.map or /onlytopicinmap parameter was specified. Be aware that the path information above may not match the link in your topic. |
| DOTX057W | Warning | The link or cross reference target '%1' cannot be found, which may cause errors creating links or cross references in your output file. | The link appears to use valid syntax to reference a DITA element, but that element cannot be found. Please verify that the element exists, and is not removed from the build by DITAVAL based filtering. |
| DOTX058W | Warning | No glossary entry was found associated with key '%1' on %2 element. The build will try to determine the best display text and hover text for terms and abbreviations. | Processing for terms, acronyms, or abbreviated forms will associate the key from the element's keyref attribute with a glossentry (glossary entry) topic. This message will appear if the key was defined, but was not associated with a glossentry topic. The process will try to use the best available fallback (usually the title of the referenced topic). |
| DOTX060W | Warning | Key '%1' was used in an abbreviated-form element, but the key is not associated with a glossary entry. Abbreviated-form should ONLY be used to reference to a glossary entry. | Processing for abbreviated form elements will associate the key from the element's keyref attribute with a glossentry (glossary entry) topic. This message will appear if the key was defined, but was not associated with a glossentry topic. This element is only supported with keys that are associated with glossary topics; the element will not generate any output. Please correct the reference, or use a different element to reference your topic. |
| DOTX061W | Warning | ID '%1' was used in topicref tag but did not reference a topic element. The href attribute on a topicref element should only reference topic level elements. | According to the DITA Specification, references from maps should either go to DITA Maps, DITA Topics, or any non-DITA resource. References below the topic level should only be made from cross references (using <xref> or similar) inside of a topic. For details, see the href attribute description in the OASIS standard's definition of the topicref element. |
| DOTX062I | Informational | It appears that this document uses constraints, but the conref processor cannot validate that the target of a conref is valid. To enable constraint checking, please upgrade to an XSLT 2.0 processor. | |
| DOTX063W | Warning | The dita document '%1' is linked to from your content, but is not referenced by a topicref tag in the ditamap file. Include the topic in your map to avoid a broken link. | This will appear when generating PDF or ODT output that includes a link to a local topic, but the referenced topic is not part of the map itself. This will result in a broken link. You should include the topic in your map or remove the link from the build. |
| DOTX064W | Warning | The copy-to attribute [copy-to="%1"] uses the name of a file that already exists, so this attribute is ignored. | The copy-to attribute is used to copy a topic over a document that already exists. Please make sure that any copy-to attributes use a unique name so that the copy will not overwrite existing content. |
| DOTX065W | Warning | Two unique source files each specify copy-to="%2", which results in a collision. The value associated with href="%1" is ignored. | Two different topics are copied to the same location using copy-to; as a result, one of these files would be over-written. Only the first instance of this copy-to value will be recognized. Please correct the use of copy-to attributes. |
| DOTX066W | Warning | Template "%1" is deprecated. Remove references to this template from your custom XSLT or plug-ins. | This message indicates that your custom XSLT or plug-ins rely on templates that will be removed in an upcoming release. Typically this occurs when a named template has been converted to a mode template; any code that uses the deprecated template should be updated. |
| DOTX067E | Error | No string named '%1' was found for language '%2'. Add a mapping for the string '%1'. | This PDF build uses generated text, such as the phrase "Related information" (which is generated above many link groups). The toolkit was unable to locate the string %1 for your specified language, so the string will appear in the default language. This generally indicates that the toolkit's strings needs to be updated to support your language, or that your language setting is incorrect. |
| DOTX068W | Warning | A topicref element that references a map contains child topicref elements. Child topicref elements are ignored. | |
| PDFJ001E | Error | Index entry '%1' is dropped, because corresponding group is not found. | |
| PDFJ002E | Error | Build stopped. Problems occured during Index preprocess task. Please check the messages above. | |
| PDFX001W | Warning | There is no index entry found which closing range for ID="%1". | |
| PDFX002W | Warning | There are multiple index entry found which is opening range for ID="%1" but there is only one which close it or ranges are overlapping. | |
| PDFX003W | Warning | There are multiple index entry found which closing range for ID="%1". | |
| PDFX004F | Fatal | Empty href was specified for some topic reference. Please correct your ditamap or bookmap file. | |
| PDFX005F | Fatal | Topic reference (href : %1) not found. Reference may be incorrect. Please correct your ditamap or bookmap file. | |
| PDFX006E | Error | Number of columns must be specified. | |
| PDFX007W | Warning | There is no index entry found which opening range for ID="%1". | |
| PDFX008W | Warning | Font definition not found for the logical name or alias '%1'. | |
| PDFX009E | Error | Attribute set reflection can't handle XSLT element %1. | |
| PDFX010W | Warning | Index generation is not supported in FOP. | |
| PDFX011E | Error | Both index-see and %1 defined for index entry '%2'. Recovering by treating the index-see as an index-see-also. | |
| PDFX012F | Fatal | Unrecognized PDF formatter '%1'. Use "fop" for FOP, "xep" for RenderX XEP, or "ah" for AH Formatter. | |
| XEPJ001W | Warning | %1 | |
| XEPJ002E | Error | %1 | |
| XEPJ003E | Error | %1 |
Parent topic: Error messages and troubleshooting