Error messagesThis topic defines all error messages generated by the DITA-OT.error messages
Plug-ins may be used to add additional error messages into the toolkit;
for more information, see Customizing DITA-OT.
Message IDSeverityMessage textAdditional detailsDOTA001FDOTA001FFatal"%1" is not a recognized transformation type. Supported transformation types are dita, eclipsehelp, html5, htmlhelp, markdown, markdown_gitbook, markdown_github, pdf, pdf2, xhtml.DOTA002FDOTA002FFatalInput file is not specified, or is specified using the wrong parameter. DOTA003FDOTA003FFatalCannot find the user specified XSLT stylesheet '%1'. DOTA004FDOTA004FFatalInvalid DITA topic extension '%1'. Supported values are '.dita' and '.xml'.DOTA006WDOTA006WWarningAbsolute paths on the local file system are not supported for the CSSPATH parameter. Please use a relative path or full URI instead.DOTA007EDOTA007EErrorCannot find the running-footer file "%1". Please double check the value to ensure it is specified correctly.DOTA008EDOTA008EErrorCannot find the running-header file "%1". Please double check the value to ensure it is specified correctly.DOTA009EDOTA009EErrorCannot find the specified heading file "%1". Please double check the value to ensure it is specified correctly.DOTA011WDOTA011WWarningArgument "%1" is deprecated. This argument is no longer supported in the toolkit.DOTA012WDOTA012WWarningArgument "%1" is deprecated. Please use the argument "%2" instead.DOTA013FDOTA013FFatalCannot find the specified DITAVAL '%1'. DOTA014WDOTA014WWarningAttribute @%1 is deprecated. Use attribute @%2 instead.DOTA066FDOTA066FFatalCannot find the user specified XSLT stylesheet '%1'. DOTA067WDOTA067WWarningIgnoring index-see '%1' inside parent index entry '%2' because the parent indexterm contains indexterm children. DOTA068WDOTA068WWarningIgnoring index-see-also '%1' inside parent index entry '%2' because the parent indexterm contains indexterm children. DOTA069FDOTA069FFatalInput file '%1' cannot be located or read. Ensure that file was specified properly and that you have permission to access it.DOTA069WDOTA069WWarningTarget "%1" is deprecated. Remove references to this target from your custom XSLT or plug-ins.DOTJ005FDOTJ005FFatalFailed to create new instance for '%1'. Please ensure that '%1' exists and that you have permission to access it.DOTJ007EDOTJ007EErrorDuplicate condition in filter file for rule '%1'. The first encountered condition will be used.DOTJ007IDOTJ007IInfoDuplicate condition in filter file for rule '%1'. The first encountered condition will be used.DOTJ007WDOTJ007WWarningDuplicate condition in filter file for rule '%1'. The first encountered condition will be used.DOTJ009EDOTJ009EErrorCannot 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.DOTJ012FDOTJ012FFatalFailed to parse the input file '%1'. DOTJ013EDOTJ013EErrorFailed to parse the referenced file '%1'. DOTJ014WDOTJ014WWarningFound an indexterm element with no content. Setting the term to ***.DOTJ018IDOTJ018IInfoLog 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 documentation.DOTJ020WDOTJ020WWarningAt 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.DOTJ021EDOTJ021EErrorFile '%1' will not generate output because because all content has been filtered out by DITAVAL "exclude" conditions, or because the file is not valid DITA. DOTJ021WDOTJ021WWarningFile '%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.DOTJ022FDOTJ022FFatalFailed 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.DOTJ023EDOTJ023EErrorFailed to get the specified image file '%1', so it will not be included with your output. DOTJ025EDOTJ025EErrorThe 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 documentation for additional causes.DOTJ026EDOTJ026EErrorThe "topic merge" did not generate any output. Correct any earlier transform errors and try the build again, or see the DITA-OT documentation for additional causes.DOTJ028EDOTJ028EErrorNo 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".DOTJ029IDOTJ029IInfoNo 'domains' attribute was found for element '<%1>'. This generally indicates that your DTD or Schema was not developed properly according to the DITA specification.DOTJ030IDOTJ030IInfoNo 'class' attribute for was found for element '<%1>'. The element will be processed as an unknown or non-DITA element.DOTJ031IDOTJ031IInfoNo 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.DOTJ033EDOTJ033EErrorNo valid content is found in topicref '%1' during chunk processing. Please specify an existing and valid topic for the topicref.DOTJ034FDOTJ034FFatalFailed 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.DOTJ035FDOTJ035FFatalThe file "%1" 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.DOTJ036WDOTJ036WWarningThe file "%1" is outside the scope of the input dita/map directory. DOTJ037WDOTJ037WWarningThe 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.DOTJ038EDOTJ038EErrorThe 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.DOTJ039EDOTJ039EErrorThere is no target specified for conref push action "pushafter". Please add <elementname conref="pushtarget" conaction="mark"> before current element.DOTJ040EDOTJ040EErrorAn element uses the attribute conaction="replace", but a conref attribute is not found in the expected location. DOTJ041EDOTJ041EErrorThe 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.DOTJ042EDOTJ042EErrorTwo elements both use conref push to replace the target "%1". Please delete one of the duplicate "replace" actions.DOTJ043WDOTJ043WWarningThe conref push function is trying to replace an element that does not exist (element "%1" in file "%2"). DOTJ044WDOTJ044WWarningThere is a redundant conref action "pushbefore". Please make sure that "mark" and "pushbefore" occur in pairs.DOTJ045IDOTJ045IInfoThe key "%1" is defined more than once in the same map file. DOTJ046EDOTJ046EErrorConkeyref="%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.DOTJ047IDOTJ047IInfoUnable to find key definition for key reference "%1" in root scope. The href attribute may be used as fallback if it existsDOTJ048IDOTJ048IInfoUnable to find key definition for key reference "%1" in scope "%2". The href attribute may be used as fallback if it existsDOTJ049WDOTJ049WWarningThe 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: %4DOTJ050WDOTJ050WWarningFound an <index-see> or <index-see-also> reference to the term '%1', but that term is not defined in the index. DOTJ051EDOTJ051EErrorUnable to load target for coderef "%1". DOTJ052EDOTJ052EErrorCode reference charset "%1" not supported. See the DITA-OT documentation for supported charset values on the format attribute.DOTJ053WDOTJ053WWarningInput 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.DOTJ054EDOTJ054EErrorUnable to parse invalid %1 attribute value "%2" DOTJ055EDOTJ055EErrorInvalid key name "%1". DOTJ056EDOTJ056EErrorInvalid xml:lang "%1". DOTJ057EDOTJ057EErrorThe id attribute value "%1" is not unique within the topic that contains it. DOTJ058EDOTJ058EErrorBoth %1 and %2 attributes defined. A single element may not contain both generalized and specialized values for the same attribute.DOTJ059EDOTJ059EErrorInvalid key scope name "%1". DOTJ060WDOTJ060WWarningKey "%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.DOTJ061EDOTJ061EErrorTopic reference target is a DITA map but format attribute has not been set. Set format attribute value to "ditamap".DOTJ062EDOTJ062EErrorInvalid %1 attribute value "%2". DOTJ063EDOTJ063EErrorThe cols attribute is "%1" but number of colspec elements was %2. DOTJ064WDOTJ064WWarningChunk attribute uses both "to-content" and "by-topic" that conflict with each other. Ignoring "by-topic" token.DOTJ065IDOTJ065IInfoBranch filter generated topic %1 used more than once. Renaming %1 to %2.DOTJ066EDOTJ066EErrorNo id attribute on topic type element %1. Using generated id %2.DOTJ067EDOTJ067EErrorNo id attribute on topic type element %1. DOTJ068EDOTJ068EErrorConref action "mark" without conref target. DOTJ069EDOTJ069EErrorCircular key definition %1. DOTJ070IDOTJ070IInfoInvalid 'class' attribute '%1' for was found for element '<%2>'. The element will be processed as an unknown or non-DITA element.DOTJ071EDOTJ071EErrorCannot find the specified DITAVAL '%1'. DOTJ072EDOTJ072EErrorEmail link without correct 'format' attribute. Using 'format' attribute value 'email'.DOTJ073EDOTJ073EErrorEmail link without correct 'scope' attribute. Using 'scope' attribute value 'external'.DOTJ074WDOTJ074WWarningRev attribute cannot be used with prop filter. DOTJ075WDOTJ075WWarningAbsolute link '%1' without correct 'scope' attribute. Using 'scope' attribute value 'external'.DOTJ076WDOTJ076WWarningAbsolute link '%1' without correct 'scope' attribute. DOTJ077FDOTJ077FFatalInvalid action attribute '%1' on DITAVAL property. DOTJ078FDOTJ078FFatalInput file '%1' could not be loaded. Ensure that grammar files for this document type are referenced and installed properly.DOTJ079EDOTJ079EErrorFile '%1' could not be loaded. Ensure that grammar files for this document type are referenced and installed properly.DOTJ080WDOTJ080WWarningIntegrator configuration '%1' has been deprecated. Use plugin configuration '%1' instead.DOTJ081WDOTJ081WWarningIgnoring empty conref attribute conref="". DOTJ082EDOTJ082EErrorProcessing table cell failed. DOTJ083EDOTJ083EErrorThe resource referenced as %1 is capitalized differently on disk DOTX001WDOTX001WWarningNo 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'.DOTX002WDOTX002WWarningThe title element or attribute in the ditamap is required for Eclipse output. DOTX003IDOTX003IInfoThe anchorref attribute should either reference another dita map or an Eclipse XML TOC file. The value '%1' does not appear to reference either. DOTX004IDOTX004IInfoFound a navref element that does not reference anything. The navref element should either reference another dita map or an Eclipse XML file.DOTX005EDOTX005EErrorUnable to find navigation title for reference to '%1'. The build will use '%1' as the title in the Eclipse Table of Contents.DOTX006EDOTX006EErrorUnknown 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').DOTX007IDOTX007IInfoOnly 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.DOTX008EDOTX008EErrorFile '%1' does not exist or cannot be loaded. DOTX008WDOTX008WWarningFile '%1' cannot be loaded, and no navigation title is specified for the table of contents. DOTX009WDOTX009WWarningCould not retrieve a title from '%1'. Using '%2' instead. DOTX010EDOTX010EErrorUnable to find target for conref="%1". DOTX011WDOTX011WWarningThere 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.DOTX012WDOTX012WWarningWhen 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.DOTX013EDOTX013EErrorA element with attribute conref="%1" indirectly includes itself, which results in an infinite loop. DOTX014EDOTX014EErrorThe attribute conref="%1" uses invalid syntax. Conref references to a map element should contain '#' followed by an ID, such as mymap.ditamap#mytopicrefid.DOTX015EDOTX015EErrorThe 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.DOTX016WDOTX016WWarningA 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. DOTX017EDOTX017EErrorFound a link or cross reference with an empty href attribute (href=""). Remove the empty href attribute or provide a value.DOTX018IDOTX018IInfoThe 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. DOTX019WDOTX019WWarningThe 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. DOTX020EDOTX020EErrorMissing navtitle attribute or element for peer topic "%1". References must provide a local navigation title when the target is not a local DITA resource.DOTX021EDOTX021EErrorMissing 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.DOTX022WDOTX022WWarningUnable to retrieve navtitle from target: '%1'. Using linktext (specified in topicmeta) as the navigation title. DOTX023WDOTX023WWarningUnable to retrieve navtitle from target: '%1'. DOTX024EDOTX024EErrorMissing linktext and navtitle for peer topic "%1". References must provide a local navigation title when the target is not a local DITA resource.DOTX025EDOTX025EErrorMissing linktext and navtitle for non-DITA resource "%1". References must provide a local navigation title when the target is not a local DITA resource.DOTX026WDOTX026WWarningUnable to retrieve linktext from target: '%1'. Using navigation title as fallback. DOTX027WDOTX027WWarningUnable to retrieve linktext from target: '%1'. DOTX028EDOTX028EErrorLink or cross reference must contain a valid href or keyref attribute; no link target is specified. DOTX029IDOTX029IInfoThe 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. DOTX030WDOTX030WWarningThe 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. DOTX031EDOTX031EErrorThe file %1 is not available to resolve link information. DOTX032EDOTX032EErrorUnable 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.DOTX033EDOTX033EErrorUnable to generate link text for a cross reference to a list item: '%1' DOTX034EDOTX034EErrorUnable to generate link text for a cross reference to an undered list item: '%1' DOTX035EDOTX035EErrorUnable to generate the correct number for a cross reference to a footnote: '%1' DOTX036EDOTX036EErrorUnable to generate link text for a cross reference to a dlentry (the dlentry or term could not be found): '%1' DOTX037WDOTX037WWarningNo title found for this document; using "***" in XHTML title bar. DOTX038IDOTX038IInfoThe longdescref attribute on tag '%1' will be ignored. Accessibility for object elements needs to be handled another way. DOTX039WDOTX039WWarningRequired cleanup area found. To remove this message and hide the content, build your content without using the DRAFT parameter.DOTX040IDOTX040IInfoDraft comment area found. To remove this message and hide the comments, build your content without using the DRAFT parameter.DOTX041WDOTX041WWarningFound more than one title element in a %1 element. Using the first one for the %1's title. DOTX042IDOTX042IInfoDITAVAL based flagging is not currently supported for inline phrases in XHTML; ignoring flag value on '%1' attribute. DOTX043IDOTX043IInfoThe link to '%1' may appear more than once in '%2'. DOTX044EDOTX044EErrorThe 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.DOTX045WDOTX045WWarningThe 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.DOTX046WDOTX046WWarningArea shape should be: default, rect, circle, poly, or blank (no value). The value '%1' is not recognized. DOTX047WDOTX047WWarningArea coordinates are blank. Coordinate points for the shape need to be specified. DOTX048IDOTX048IInfoIn 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. DOTX049IDOTX049IInfoReferences to non-dita files will be ignored by the PDF, ODT, and RTF output transforms. DOTX050WDOTX050WWarningDefault 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.DOTX052WDOTX052WWarningNo string named '%1' was found when creating generated text; using the value '%1' in your output file. DOTX053EDOTX053EErrorA element that references another map indirectly includes itself, which results in an infinite loop. The original map reference is to '%1'. DOTX054WDOTX054WWarningConflict 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.DOTX055WDOTX055WWarningCustomized 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".DOTX056WDOTX056WWarningThe file '%1' is not available to resolve link information. DOTX057WDOTX057WWarningThe link or cross reference target '%1' cannot be found, which may cause errors creating links or cross references in your output file. DOTX058WDOTX058WWarningNo 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. DOTX060WDOTX060WWarningKey '%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.DOTX061WDOTX061WWarningID '%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. DOTX062IDOTX062IInfoIt 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.DOTX063WDOTX063WWarningThe 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.DOTX064WDOTX064WWarningThe copy-to attribute [copy-to="%1"] uses the name of a file that already exists, so this attribute is ignored. DOTX065WDOTX065WWarningTwo unique source files each specify copy-to="%2", which results in a collision. The value associated with href="%1" is ignored. DOTX066WDOTX066WWarningTemplate "%1" is deprecated. Remove references to this template from your custom XSLT or plug-ins.DOTX067EDOTX067EErrorNo string named '%1' was found for language '%2'. Add a mapping for the string '%1'.DOTX068WDOTX068WWarningA topicref element that references a map contains child topicref elements. Child topicref elements are ignored.DOTX069WDOTX069WWarningTemplate mode "%1" is deprecated. Remove references to this template mode from your custom XSLT or plug-ins.DOTX070WDOTX070WWarningTarget "%1" is deprecated. Remove references to this target from your custom Ant files.DOTX071EDOTX071EErrorConref range: Unable to find conref range end element with ID "%1". DOTX071WDOTX071WWarningParameter "%1" on template "%2" is deprecated. Use parameter "%3" instead.DOTX072IDOTX072IInfoIgnoring navtitle within topicgroup. DOTX073IDOTX073IInfoRemoving broken link to "%1". DOTX074WDOTX074WWarningNo formatting defined for unknown class attribute value "%1". DOTX075WDOTX075WWarningA content reference in a constrained document type is pulling content from an unconstrained document type. The reference will resolve, but may result in content that violates one of the document constraints in "%1". DOTX076EDOTX076EErrorA content reference in a constrained document type cannot be resolved because it would violate one of the document constraints "%1". The current constrained document may only reuse content from documents with equivalent constraints.INDX001IINDX001IInfoIndex entry '%1' will be sorted under the "Special characters" heading. INDX002EINDX002EErrorThe PDF indexing process could not find the proper sort location for '%1', so the term has been dropped from the index. INDX003EINDX003EErrorThe build failed due to problems encountered when sorting the PDF index. PDFJ001EPDFJ001EErrorThe PDF indexing process could not find the proper sort location for '%1', so the term has been dropped from the index. PDFJ002EPDFJ002EErrorThe build failed due to problems encountered when sorting the PDF index. Please address any messages located earlier in the log.PDFJ003IPDFJ003IInfoIndex entry '%1' will be sorted under the "Special characters" heading. PDFX001WPDFX001WWarningThere 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".PDFX002WPDFX002WWarningThere 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 overlapPDFX003WPDFX003WWarningThere 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".PDFX004FPDFX004FErrorA topic reference was found with href="". Please specify a target or remove the href attribute.PDFX005FPDFX005FErrorThe 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.PDFX007WPDFX007WWarningFound an index term with end="%1", but no starting term was found for this entry. PDFX008WPDFX008WWarningFont definition not found for the logical name or alias '%1'. PDFX009EPDFX009EErrorAttribute set reflection cannot handle XSLT element %1. PDFX011EPDFX011EErrorThe index term '%2' uses both an index-see element and %1 element. Convert the index-see element to index-see-also.PDFX012EPDFX012EErrorFound a table row with more entries than allowed. PDFX013FPDFX013FFatalThe PDF file '%1' could not be generated. XEPJ001WXEPJ001WWarning%1XEPJ002EXEPJ002EError%1XEPJ003EXEPJ003EError%1