Error messagesThis 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 DITA-OT Developer Reference.
Message IDSeverityMessage textAdditional detailsDOTA001FFatal"%1" is not a recognized transformation type. Supported transformation types are common-html, docbook, eclipsecontent, eclipsehelp, html5, htmlhelp, javahelp, odt, pdf, pdf2, tocjs, troff, wordrtf, xhtml.DOTA002FFatalInput file is not specified, or is specified using the wrong parameter. DOTA003FFatalCannot find the user specified XSLT stylesheet '%1'. DOTA004FFatalInvalid DITA topic extension '%1'. Supported values are '.dita' and '.xml'.DOTA006WWarningAbsolute paths on the local file system are not supported for the CSSPATH parameter. Please use a relative path or full URI instead.DOTA007EErrorCannot find the running-footer file "%1". Please double check the value to ensure it is specified correctly.DOTA008EErrorCannot find the running-header file "%1". Please double check the value to ensure it is specified correctly.DOTA009EErrorCannot find the specified heading file "%1". Please double check the value to ensure it is specified correctly.DOTA011WWarningArgument "%1" is deprecated. This argument is no longer supported in the toolkit.DOTA012WWarningArgument "%1" is deprecated. Please use the argument "%2" instead.DOTA013FFatalCannot find the specified DITAVAL '%1'. DOTA066FFatalCannot find the user specified XSLT stylesheet '%1'. DOTA067WWarningIgnoring index-see '%1' inside parent index entry '%2' because the parent indexterm contains indexterm children. DOTA068WWarningIgnoring index-see-also '%1' inside parent index entry '%2' because the parent indexterm contains indexterm children. DOTA069FFatalInput file '%1' cannot be located or read. Ensure that file was specified properly and that you have permission to access it.DOTA069WWarningTarget "%1" is deprecated. Remove references to this target from your custom XSLT or plug-ins.DOTJ005FFatalFailed to create new instance for '%1'. Please ensure that '%1' exists and that you have permission to access it.DOTJ007EErrorDuplicate condition in filter file for rule '%1'. The first encountered condition will be used.DOTJ009EErrorCannot 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.DOTJ012FFatalFailed to parse the input file '%1'. DOTJ013EErrorFailed to parse the referenced file '%1'. DOTJ014WWarningFound an indexterm element with no content. Setting the term to ***.DOTJ018IInformationalLog 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.DOTJ020WWarningAt 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.DOTJ021WWarningFile '%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.DOTJ022FFatalFailed 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.DOTJ023EErrorFailed to get the specified image file '%1', so it will not be included with your output. DOTJ025EErrorThe 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.DOTJ026EErrorThe "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.DOTJ028EErrorNo 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".DOTJ029IInformationalNo 'domains' attribute was found for element '<%1>'. This generally indicates that your DTD or Schema was not developed properly according to the DITA specification.DOTJ030IInformationalNo '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.DOTJ031IInformationalNo 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.DOTJ033EErrorNo valid content is found in topicref '%1' during chunk processing. Please specify an existing and valid topic for the topicref.DOTJ034FFatalFailed 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.DOTJ035FFatalThe 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.DOTJ036WWarningThe file "%1" referenced by "%2" is outside the scope of the input dita/map directory. DOTJ037WWarningThe 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.DOTJ038EErrorThe 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.DOTJ039EErrorThere is no target specified for conref push action "pushafter". Please add <elementname conref="pushtarget" conaction="mark"> before current element.DOTJ040EErrorAn element uses the attribute conaction="replace", but a conref attribute is not found in the expected location. DOTJ041EErrorThe 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.DOTJ042EErrorTwo elements both use conref push to replace the target "%1". Please delete one of the duplicate "replace" actions.DOTJ043WWarningThe conref push function is trying to replace an element that does not exist (element "%1" in file "%2"). DOTJ044WWarningThere is a redundant conref action "pushbefore". Please make sure that "mark" and "pushbefore" occur in pairs.DOTJ045IInformationalThe key "%1" is defined more than once in the same map file. The reference href="%2" is ignored. DOTJ046EErrorConkeyref="%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.DOTJ047IInformationalUnable to find key definition for key reference "%1" in root scope. The href attribute may be used as fallback if it existsDOTJ048IInformationalUnable to find key definition for key reference "%1" in scope "%2". The href attribute may be used as fallback if it existsDOTJ049WWarningThe 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: %4DOTJ050WWarningFound an <index-see> or <index-see-also> reference to the term '%1', but that term is not defined in the index. DOTJ051EErrorUnable to load target for coderef "%1". DOTJ052EErrorCode reference charset "%1" not supported. See the DITA-OT User guide for supported charset values on the format attribute.DOTJ053WWarningInput 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.DOTJ054EErrorUnable to parse invalid %1 attribute value "%2" DOTJ055EErrorInvalid key name "%1". DOTJ056EErrorInvalid xml:lang "%1". DOTJ057EErrorThe id attribute value "%1" is not unique within the topic that contains it. DOTJ058EErrorBoth %1 and %2 attributes defined. A single element may not contain both generalized and specialized values for the same attribute.DOTJ059EErrorInvalid key scope name "%1". DOTJ060WWarningKey "%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.DOTJ061EErrorTopic reference target is a DITA map but format attribute has not been set. Set format attribute value to "ditamap".DOTJ062EErrorInvalid %1 attribute value "%2". DOTJ063EErrorThe cols attibute is "%1" but number of colspec elements was %2. DOTJ064WWarningChunk attribute uses both "to-content" and "by-topic" that conflict with each other. Ignoring "by-topic" token.DOTJ065IInformationalBranch filter generated topic %1 used more than once. Renaming %1 to %2.DOTJ066EErrorNo id attribute on topic type element %1. Using generated id %2.DOTJ067EErrorNo id attribute on topic type element %1. DOTJ068EErrorConref action "mark" without conref target. DOTJ069EErrorCircular key definition %1. DOTX001WWarningNo 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'.DOTX002WWarningThe title element or attribute in the ditamap is required for Eclipse output. DOTX003IInformationalThe anchorref attribute should either reference another dita map or an Eclipse XML TOC file. The value '%1' does not appear to reference either. DOTX004IInformationalFound a navref element that does not reference anything. The navref element should either reference another dita map or an Eclipse XML file.DOTX005EErrorUnable to find navigation title for reference to '%1'. The build will use '%1' as the title in the Eclipse Table of Contents.DOTX006EErrorUnknown 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').DOTX007IInformationalOnly 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.DOTX008EErrorFile '%1' does not exist or cannot be loaded. DOTX008WWarningFile '%1' cannot be loaded, and no navigation title is specified for the table of contents. DOTX009WWarningCould not retrieve a title from '%1'. Using '%2' instead. DOTX010EErrorUnable to find target for conref="%1". DOTX011WWarningThere 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.DOTX012WWarningWhen 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.DOTX013EErrorA element with attribute conref="%1" indirectly includes itself, which results in an infinite loop. DOTX014EErrorThe attribute conref="%1" uses invalid syntax. Conref references to a map element should contain '#' followed by an ID, such as mymap.ditamap#mytopicrefid.DOTX015EErrorThe 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.DOTX016WWarningA 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. DOTX017EErrorFound a link or cross reference with an empty href attribute (href=""). Remove the empty href attribute or provide a value.DOTX018IInformationalThe 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. DOTX019WWarningThe 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. DOTX020EErrorMissing navtitle attribute or element for peer topic "%1". References must provide a local navigation title when the target is not a local DITA resource.DOTX021EErrorMissing 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.DOTX022WWarningUnable to retrieve navtitle from target: '%1'. Using linktext (specified in topicmeta) as the navigation title. DOTX023WWarningUnable to retrieve navtitle from target: '%1'. DOTX024EErrorMissing linktext and navtitle for peer topic "%1". References must provide a local navigation title when the target is not a local DITA resource.DOTX025EErrorMissing linktext and navtitle for non-DITA resource "%1". References must provide a local navigation title when the target is not a local DITA resource.DOTX026WWarningUnable to retrieve linktext from target: '%1'. Using navigation title as fallback. DOTX027WWarningUnable to retrieve linktext from target: '%1'. DOTX028EErrorLink or cross reference must contain a valid href or keyref attribute; no link target is specified. DOTX029IInformationalThe 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. DOTX030WWarningThe 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. DOTX031EErrorThe file %1 is not available to resolve link information. DOTX032EErrorUnable 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.DOTX033EErrorUnable to generate link text for a cross reference to a list item: '%1' DOTX034EErrorUnable to generate link text for a cross reference to an undered list item: '%1' DOTX035EErrorUnable to generate the correct number for a cross reference to a footnote: '%1' DOTX036EErrorUnable to generate link text for a cross reference to a dlentry (the dlentry or term could not be found): '%1' DOTX037WWarningNo title found for this document; using "***" in XHTML title bar. DOTX038IInformationalThe longdescref attribute on tag '%1' will be ignored. Accessibility for object elements needs to be handled another way. DOTX039WWarningRequired cleanup area found. To remove this message and hide the content, build your content without using the DRAFT parameter.DOTX040IInformationalDraft comment area found. To remove this message and hide the comments, build your content without using the DRAFT parameter.DOTX041WWarningFound more than one title element in a %1 element. Using the first one for the %1's title. DOTX042IInformationalDITAVAL based flagging is not currently supported for inline phrases in XHTML; ignoring flag value on '%1' attribute. DOTX043IInformationalThe link to '%1' may appear more than once in '%2'. DOTX044EErrorThe 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.DOTX045WWarningThe 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.DOTX046WWarningArea shape should be: default, rect, circle, poly, or blank (no value). The value '%1' is not recognized. DOTX047WWarningArea coordinates are blank. Coordinate points for the shape need to be specified. DOTX048IInformationalIn 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. DOTX049IInformationalReferences to non-dita files will be ignored by the PDF, ODT, and RTF output transforms. DOTX050WWarningDefault 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.DOTX052WWarningNo string named '%1' was found when creating generated text; using the value '%1' in your output file. DOTX053EErrorA element that references another map indirectly includes itself, which results in an infinite loop. The original map reference is to '%1'. DOTX054WWarningConflict 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.DOTX055WWarningCustomized 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".DOTX056WWarningThe file '%1' is not available to resolve link information. DOTX057WWarningThe link or cross reference target '%1' cannot be found, which may cause errors creating links or cross references in your output file. DOTX058WWarningNo 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. DOTX060WWarningKey '%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.DOTX061WWarningID '%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. DOTX062IInformationalIt 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.DOTX063WWarningThe 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.DOTX064WWarningThe copy-to attribute [copy-to="%1"] uses the name of a file that already exists, so this attribute is ignored. DOTX065WWarningTwo unique source files each specify copy-to="%2", which results in a collision. The value associated with href="%1" is ignored. DOTX066WWarningTemplate "%1" is deprecated. Remove references to this template from your custom XSLT or plug-ins.DOTX067EErrorNo string named '%1' was found for language '%2'. Add a mapping for the string '%1'.DOTX068WWarningA topicref element that references a map contains child topicref elements. Child topicref elements are ignored.DOTX069WWarningTemplate mode "%1" is deprecated. Remove references to this template mode from your custom XSLT or plug-ins.DOTX070WWarningTarget "%1" is deprecated. Remove references to this target from your custom Ant files.DOTX071EErrorConref range: Unable to find conref range end element with ID "%1". DOTX071WWarningParameter "%1" on template "%2" is deprecated. Use parameter "%3" instead.PDFJ001EErrorThe PDF indexing process could not find the proper sort location for '%1', so the term has been dropped from the index. PDFJ002EErrorThe build failed due to problems encountered when sorting the PDF index. Please address any messages located earlier in the log.PDFJ003IInformationalIndex entry '%1' will be sorted under the "Special characters" heading. PDFX001WWarningThere is an index term specified with start="%1", but there is no matching end for this term. Add an index term in a valid location with end="%1".PDFX002WWarningThere are multiple index terms specified with start="%1", but there is only one term to end this range, or the ranges for this term overlap. Ensure that each term with this start value has a matching end value, and that the specified ranges for this value do not overlapPDFX003WWarningThere are multiple index entries found to close the index range for "%1". Ensure that any index term with start="%1" has only one matching end term with end="%1".PDFX004FFatalA topic reference was found with href="". Please specify a target or remove the href attribute.PDFX005FFatalThe topic reference href="%1" could not be found. Please correct the reference, or set the scope or format attribute if the target is not a local DITA topic.PDFX007WWarningFound an index term with end="%1", but no starting term was found for this entry. PDFX008WWarningFont definition not found for the logical name or alias '%1'. PDFX009EErrorAttribute set reflection cannot handle XSLT element %1. PDFX011EErrorThe index term '%2' uses both an index-see element and %1 element. Convert the index-see element to index-see-also.XEPJ001WWarning%1XEPJ002EError%1XEPJ003EError%1