Error messages

This topic defines all error messages generated by the DITA-OT.

Plug-ins may be used to add additional error messages into the toolkit; for more information, see the Developer reference section of the User Guide.

Message ID Severity Message text Additional details
DOTA001F Fatal "%1" is not a recognized transformation type. Supported transformation types are docbook, eclipsecontent, eclipsehelp, htmlhelp, javahelp, net.sourceforge.dita-ot.html, odt, pdf, pdf2, tocjs, troff, wordrtf, xhtml.  
DOTA002F Fatal Input file is not specified, or is specified using the wrong parameter.  
DOTA003F Fatal Cannot find the user specified XSLT stylesheet '%1'.  
DOTA004F Fatal Invalid DITA topic extension '%1'. Supported values are '.dita' and '.xml'.  
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.  
DOTA007E Error Cannot find the running-footer file "%1". Please double check the value to ensure it is specified correctly.  
DOTA008E Error Cannot find the running-header file "%1". Please double check the value to ensure it is specified correctly.  
DOTA009E Error Cannot find the specified heading file "%1". Please double check the value to ensure it is specified correctly.  
DOTA010E Error The Apache FOP program cannot be found in the default location. Please place FOP into the default directory demo/fo/fop/ or update the build file to support your local configuration.  
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'.  
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.  
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.  
DOTA069F Fatal Input file '%1' cannot be located or read. Ensure that file was specified properly and that you have permission to access it.  
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.  
DOTJ002F Fatal Unsupported parameter '%1'. Please refer to the DITA-OT User Guide for supported parameters.  
DOTJ003F Fatal Parameter '%1' was specified without a value. Parameters to the command line tool should use the syntax /parameter:value.  
DOTJ004F Fatal Cannot create temporary processing directory '%1'. Please ensure that you have permission to create the directory '%1'.  
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".  
DOTJ007E Error Duplicate condition in filter file for rule '%1'. The first encountered condition 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.  
DOTJ012F Fatal Failed to parse the input file '%1'. The XML parser reported the following error:  
DOTJ013E Error Failed to parse the referenced file '%1'. The XML parser reported the following error:  
DOTJ014W Warning Found an indexterm element with no content. Setting the term to ***.  
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.  
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.  
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.  
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.  
DOTJ023E Error Failed to get the specified image file '%1', so it will not be included with your output.  
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.  
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.  
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".  
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.  
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.  
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.  
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.  
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.  
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.  
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.  
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.  
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.  
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".  
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.  
DOTJ042E Error Two elements both use conref push to replace the target "%1". Please delete one of the duplicate "replace" actions.  
DOTJ043W Warning The conref push function is trying to replace an element that does not exist (element "%1" in file "%2").  
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.  
DOTJ045I Informational The key "%1" is defined more than once in the same map file. The reference href="%2" is ignored.  
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.  
DOTJ047I Informational Unable to find key definition for keyref="%1", href may be used as fallback if it exists.  
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  
DOTJ050W Warning Found an <index-see> or <index-see-also> reference to the term '%1', but that term is not defined in the index.  
DOTJ051E Error Unable to load target for coderef "%1".  
DOTJ052E Error Code reference charset "%1" not supported. See the DITA-OT User guide for supported charset values on the format attribute.  
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.  
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.  
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'.  
DOTX002W Warning The title element or attribute in the ditamap is required for Eclipse 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.  
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.  
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.  
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').  
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.  
DOTX008E Error File '%1' does not exist or cannot be loaded.  
DOTX008W Warning File '%1' cannot be loaded, and no navigation title is specified for the table of contents.  
DOTX009W Warning Could not retrieve a title from '%1'. Using '%2' instead.  
DOTX010E Error Unable to find target for conref="%1".  
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.  
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.  
DOTX013E Error A element with attribute conref="%1" indirectly includes itself, which results in an infinite loop.  
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.  
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.  
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.  
DOTX017E Error Found a link or cross reference with an empty href attribute (href=""). Remove the empty href attribute or provide 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.  
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.  
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.  
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.  
DOTX022W Warning Unable to retrieve navtitle from target: '%1'. Using linktext (specified in topicmeta) as the navigation title.  
DOTX023W Warning Unable to retrieve navtitle from target: '%1'.  
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.  
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.  
DOTX026W Warning Unable to retrieve linktext from target: '%1'. Using navigation title as fallback.  
DOTX027W Warning Unable to retrieve linktext from target: '%1'.  
DOTX028E Error Link or cross reference must contain a valid href or keyref attribute; no link target is specified.  
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.  
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.  
DOTX031E Error The file %1 is not available to resolve link information.  
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.  
DOTX033E Error Unable to generate link text for a cross reference to a list item: '%1'  
DOTX034E Error Unable to generate link text for a cross reference to an undered list item: '%1'  
DOTX035E Error Unable to generate the correct number for a cross reference to a footnote: '%1'  
DOTX036E Error Unable to generate link text for a cross reference to a dlentry (the dlentry or term could not be found): '%1'  
DOTX037W Warning No title found for this document; using "***" in XHTML title bar.  
DOTX038I Informational The longdescref attribute on tag '%1' will be ignored. Accessibility for object elements needs to be handled another way.  
DOTX039W Warning Required cleanup area found. To remove this message and hide the content, build your content without using the DRAFT parameter.  
DOTX040I Informational Draft comment area found. To remove this message and hide the comments, build your content without using the DRAFT parameter.  
DOTX041W Warning Found more than one title element in a section. Using the first one for the section's title.  
DOTX042I Informational DITAVAL based flagging is not currently supported for inline phrases in XHTML; ignoring flag value on '%1' attribute.  
DOTX043I Informational The link to '%1' may appear more than once in '%2'.  
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.  
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.  
DOTX046W Warning Area shape should be: default, rect, circle, poly, or blank (no value). The value '%1' is not recognized.  
DOTX047W Warning Area coordinates are blank. Coordinate points for the shape need to be specified.  
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.  
DOTX049I Informational References to non-dita files will be ignored by the PDF, ODT, and RTF output transforms.  
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.  
DOTX052W Warning No string named '%1' was found when creating generated text; using the value '%1' in your output file.  
DOTX053E Error A element that references another map indirectly includes itself, which results in an infinite loop. The original map reference is to '%1'.  
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.  
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".  
DOTX056W Warning The file '%1' is not available to resolve link information.  
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.  
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.  
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.  
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.  
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.  
DOTX064W Warning The copy-to attribute [copy-to="%1"] uses the name of a file that already exists, so this attribute is ignored.  
DOTX065W Warning Two unique source files each specify copy-to="%2", which results in a collision. The value associated with href="%1" is ignored.  
DOTX066W Warning Template "%1" is deprecated. Remove references to this template from your custom XSLT or plug-ins.  
DOTX067E Error No string named '%1' was found for language '%2'. Add a mapping for the string '%1'.  
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.  

Was this helpful?