Messages generated by the Toolkit

Ant messages

Message number Type Message text Action
DOTA001F FATAL Invalid transformation type. Please provide the correct transormation types using Ant parameter 'transtype': xhtml, eclipsehelp, eclipsecontent, javahelp, htmlhelp, pdf, pdf2, troff, docbook, wordrtf.
DOTA002F FATAL Invalid input. Please provide the correct input.
DOTA003F FATAL Can't find the user specified stylesheet '%1'. Please provide the correct sytlesheet using Ant parameter 'args.xsl'.
DOTA004F FATAL Invalid dita extensition '%1'. Please input the correct dita extension using Ant parameter 'dita.extname': dita, .dita, xml, .xml.
DOTA005W WARN Input parameter 'dita.input' and 'dita.input.dirname' are deprecated. Please use 'args.input' instead.
DOTA006W WARN Local absolute 'csspath' is not supported, use the default instead. Please use relative or URL like csspath.

Java messages

Message number Type Message text Action
DOTJ001F FATAL Input argument error: no ':' found in the parameter '%1'. Please add a colon character ':' between the name and value of the parameter '%1'. For detail information, please refer to User Guide.
DOTJ002F FATAL Unsupported parameter '%1'. Please refer to User Guide for supported parameters.
DOTJ003F FATAL Param value can't be null for the parameter '%1'. Please provide a value for the parameter '%1'.
DOTJ004F FATAL Can't create temp directory '%1'. Please check if you have the right to create the directory '%1'.
DOTJ005F FATAL Failed to create new instance for '%1'. Please ensure that '%1' exists and you have right to access it.
DOTJ006F FATAL Invalid value '%1' for attribute 'extparam' of AntInvoker. Please use correct way to call AntInvoker, e.g. extparam="maplinks=XXXX;other=YYYY".
DOTJ007E ERROR Duplicate condition in filter file for rule '%1'. Check to make sure that there is none duplicate rule specified.
DOTJ008E ERROR MapIndexReader is not used in correct way. matchList is null. Please check the code to see whether method setMatch(String matchPattern) is called before read(String filename).
DOTJ009E ERROR Cannot overwrite file '%1' with file '%2'. The modified result may not be consumed by the following steps. Check to see whether the file is locked by other application during the transformation process.
DOTJ010E ERROR Can't find %1 in the extparam for index generation. Please specify %1 in the extparam.
DOTJ011E ERROR Failed to load the input file '%1' for index generation due to below exception, and no index information generated. Please ensure '%1' exists and you have right to access it.
DOTJ012F FATAL Failed to parse the input file '%1' due to below exception. Please correct the input base on the exception message.
DOTJ013E ERROR Failed to parse the referenced file '%1' due to below exception. Please correct the reference base on the exception message.
DOTJ014W WARN The indexterm element does not have any content. Setting the term to ***. Please add content to the indexterm.
DOTJ015F FATAL Log directory can't be null. Please specify the correct log directory using ant parameter 'args.logdir'.
DOTJ016F FATAL Failed to create log directory '%1'. Please specify the correct log directory using ant parameter 'args.logdir'.
DOTJ017F FATAL Failed to init log filename with input file. Please specify input file using ant parameter 'args.input'.
DOTJ018I INFO Log file '%1' was generated successfully at directory '%2'. You can find the detailed messages from the transformation process in this log file.
DOTJ019E ERROR Failed to generated log file. Please correct the errors.
DOTJ020W WARN Plugin '%1' is required by plugin '%2'. Plugin '%2' cannot be loaded because of missing plugin '%1'. Check and see whether all of the plugins required are installed in toolkit.
DOTJ021W WARN File '%1' was excluded from the 'dita.list' file since it is invalid and all 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' due to all of its content has been filtered out. Please check the input file '%1' and the ditaval file, and ensure that the input is valid.
DOTJ023E ERROR Failed to get the image file specified '%1' in RTF generation Check whether the image exists and copied to output directory before the final step of RTF generation.
DOTJ024W WARN Extension name of picture file '%1' not supported. Please convert your picture to JPEG or GIF style.
DOTJ025E ERROR The input of topic merge cannot be found. Please check whether the input message for topic merge is absolute path.
DOTJ026E ERROR The output of topic merge is null. Please check whether you have set output for topic merge correctly.
DOTJ027W WARN The file '%1' contains space in its file name. This file might not be transformed. Remove the space in the file name and restart the transformation.

XSLT messages

Message number Type Message text Action
DOTX001W WARN No string named '%1' was found for language '%2'. Use the default language '%3'. Add the mapping between default language and specific language for the string '%1'.
DOTX002W WARN The title attribute in ditamap is required for Eclipse output. Add a title attribute to map element in ditamap file.
DOTX003I INFO The anchorref attribute should either point to another dita map, or to an Eclipse XML file. The value '%1' does not point to either. Change the anchorref referring to ditamap or dita topic file.
DOTX004I INFO Found a navref that does not point to anything, the navref element should either point to another dita map, or to an Eclipse XML file. Change the navref referring to ditamap or dita topic file.
DOTX005E ERROR Unable to find navigation title, using href instead: '%1'. If the topic is not accessible at build time, provide the navigation title in the map, and set the format or scope attributes to indicate why it is not accessible. Note:'%1' might be changed to use default dita topic file extension name '.dita' or '.xml'. Provide the navigation title in the map or topic files.
DOTX006E ERROR Unknown file extension in href: '%1'. If this is a link to a non-DITA resource, set the format attribute to match the resource (for example, 'txt', 'pdf', or 'html'). If it's a link to a DITA resource, the file extension must be 'dita' or 'xml'. Set the format attribute and specify the format of the file if href link doesn't point to dita topic file. Otherwise, change the file extension name to 'dita' or 'xml'.
DOTX007I INFO 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" attribute on your topicref.
DOTX008W WARN File '%1' does not exist. Append the file '%1' into the source or change the href link to existing file. Note:'%1' might be changed to use standard dita topic file extension name '.dita' or '.xml'.
DOTX009W WARN Could not retrieve a title from '%1'. Using '%2' instead. Add a title in the target topic file.
DOTX010E ERROR Unable to find target for conref="%1". Check to make sure that the target element is available, and that it is a 'xxxx' element. Note:'%1' might be changed to use default dita topic file extension name '.dita' or '.xml'. Check to make sure the target of conref is correct.
DOTX011W WARN There is more than one possible target for conref="%1". Only the first will be used. Remove the duplicate ID from one of the targets. Note:'%1' might be changed to use default dita topic file extension name '.dita' or '.xml'. Remove the duplicated id in the conref target file.
DOTX012W WARN 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 a conref attribute indirectly includes itself, which is not possible. Please fix the target of the conref attribute. The conref attribute points to '%1'. Note:'%1' might be changed to use default dita topic file extension name '.dita' or '.xml'. Resolve the circle conref.
DOTX014E ERROR The element must provide the id of the target topicref you want to reuse. For example, mymap.ditamap#mytopicrefid. Put an id into the target position of the content which will be reused.
DOTX015E ERROR Incorrectly formed conref attribute: '%1', Make sure the syntax is correct and try again. Note:'%1' might be changed to use default dita topic file extension name '.dita' or '.xml'. Change the conref attribute to conform the correct syntax.
DOTX016W WARN An href value appears to point to a DITA file, but the format attribute is inherited a value of "%1". If the target '%2'is a DITA file, set the format attribute to "dita". If it does not point to a DITA file, set the format attribute locally. Note:'%2' might be changed to use standard dita topic file extension name '.dita' or '.xml'. Directly set the format attribute to correct value instead of inheriting from ancestor.
DOTX017E ERROR Found a topic reference with an empty HREF attribute. The attribute should point to a file or other valid address. Remove the empty href link or put in some content.
DOTX018I INFO The type attribute on a topicref element does not match the target topic. The type attribute was set to '%1', but the topicref points to a more specific '%2' topic. This may cause your links to sort incorrectly in the output. Note that the type attribute is inherited in maps, so the value '%1' may come from an ancestor topicref. Check and make the type of topicref match with the actual type of topic.
DOTX019W WARN The type attribute on a topicref element does not match the target topic. The type attribute was set to '%1', but the topicref points to a more specific '%2' topic. This may cause your links to sort incorrectly in the output. Note that the type attribute is inherited in maps, so the value '%1' may come from an ancestor topicref. Check and make the type of topicref match with the actual type of topic.
DOTX020E ERROR Missing navtitle attribute for: '%1' When you set scope="peer" you must provide a local navigation title, since the target is not accessible at build time. Provide a local navigation title in ditamap.
DOTX021E ERROR Missing navtitle attribute for: '%1' When you set format to a non-DITA resource type, you must provide a local navigation title, since the target is not accessible to DITA-aware transforms. Provide a local navigation title in ditamap.
DOTX022W WARN Unable to retrieve navtitle from target: '%1'. Using linktext under topicmeta of this topicref instead of the navigation title. Make sure the topicref type matches the target, and that the file name and topic id are correct.
DOTX023W WARN Unable to retrieve navtitle from target: '%1'. Make sure the topicref type matches the target, and that the file name and topic id are correct.
DOTX024E ERROR Missing linktext and navtitle for: '%1' When you set scope="peer" you must use the navtitle attribute, since the target is not accessible at build time. Provide a navtitle attribute for topicref.
DOTX025E ERROR Missing linktext and navtitle attribute for: '%1'. When you set format to a non-DITA resource type, you must provide a navtitle attribute, since the target is not accessible to DITA-aware transforms. Provide a navtitle attribute for topicref.
DOTX026W WARN Unable to retrieve linktext from target: '%1'. Using navtitle instead of linktext under topicmeta. Make sure the topicref type matches the target, and that the file name and topic id are correct.
DOTX027W WARN Unable to retrieve linktext from target: '%1'. Make sure the topicref type matches the target, and that the file name and topic id are correct.
DOTX028E ERROR Link or Xref must contain an unempty href attribute. Add an unempty href attribute for link or xref element.
DOTX029I INFO The type attribute on a %1 element does not match the target %2. The type attribute was set to %3, but the %1 points to a more specific %4 element. This may cause your links to sort incorrectly in the output, and link text may not be properly retrieved. Note that the type attribute is inherited in maps, so the value '%3' may come from an ancestor element. Check and make the type of element match with the actual type of target.
DOTX030W WARN The type attribute on a %1 element does not match the target %2. The type attribute was set to %3, but the %1 points to a more specific %4 element. This may cause your links to sort incorrectly in the output, and link text may not be properly retrieved. Note that the type attribute is inherited in maps, so the value '%3' may come from an ancestor element. Check and make the type of element match with the actual type of target.
DOTX031E ERROR The file %1 is not available to resolve link information. Either the file could not be found, or a DITAVAL file was used to remove the file's contents. Be aware that the path information above may not match the link in your topic. Check to make sure the file exists and DITAVAL file isn't used to remove the contents of the file.
DOTX032E ERROR Unable to retrieve link text from target: '%1'. Make sure the link type matches the target, the ids for topic and element are correct, and that the target has a title. If the target is not accessible at build time, or does not have a title, give the link text as content of the xref element.
DOTX033E ERROR Unable to find the target to determine the list item number. Make sure the link type matches the target, and that the ids for topic and element are correct.
DOTX034E ERROR You are cross-referencing a list item in an unordered list. The process could not automatically generate cross-reference text, since the list item is not numbered. You need to provide cross-reference text within the xref element, or you need to change the target to something the process can support. Using the id of the target as cross-reference text for now.
DOTX035E ERROR Unable to find the target to determine the footnote number. Make sure the link type matches the target, and that the ids for topic and element are correct.
DOTX036E ERROR Unable to find the dlentry target to determine the dlterm text. Make sure the link type matches the target, and that the ids for topic and element are correct.
DOTX037W WARN Topic contains no title; using "***". Add a title to your topic.
DOTX038I INFO The LONGDESCREF attribute on tag '%1' will be ignored. Accessibility needs to be handled another way. 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 WARN Required cleanup area found. If the output is only used as a draft, you do not need to do anything. If you are producing production-level output, you should not use the /DRAFT option.
DOTX040I INFO Draft comment area found. If the output is only used as a draft, you do not need to do anything. If you are producing production-level output, you should not use the /DRAFT option.
DOTX041W WARN More than one title element in a section. Using the first one for the section's title. Make sure that the title you wish to appear as a title is the first one. Then remove other title elements, or change them to a more appropriate element. As a last resort you could simply make them bold phrases.
DOTX042I INFO Flagging attribute found on '%1' attribute. Inline phrases cannot be flagged. 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 image, you may place an image directly into the document.
DOTX043I INFO The link to '%1' may appear more than once in '%2'. If you do not want to occurrences of a link to the same href, remove one of the links or define the same attributes on both link elements. Note that links generated from a <reltable> in a DITA Map will have the role attribute set to friend.
DOTX044E ERROR Area element has no cross-reference HREF attribute. The area requires a cross-reference with an HREF attribute. Add a href attribute to the xref element.
DOTX045W WARN Area element contains a cross-reference that is missing link text. The area recommends a cross-reference that contains link text; either from the referenced topic's title, or from the content of the cross-reference. Because there was no cross-reference content; the HREF attribute value is being used. Add link text to the xref element.
DOTX046W WARN Area shape should be: default, blank (no value), rect, circle, or poly. This value is not recognized: '%1'. It was passed as-is through to the area element in the XHTML. Correct the shape value.
DOTX047W WARN Area coordinates are blank. Coordinate points for the shape need to be specified. Correct the coords value.
DOTX048I INFO In order to include '%1' in your help file, you will need to recompile the CHM file locally. The automatically compiled CHM file will only contain formatted DITA files, not files that are already in HTML. For local HTML files, you will need to recompile your help project after all of your files have been returned. For external web sites, you can set the scope attribute to "external" to avoid this message. If you are linking to an actual HTML file that will not be available, it cannot be included in the project. You should set the toc attribute to "no" on your topicref element.
DOTX049I INFO Topicref to non-dita files will be ignored in PDF or Word transformation. If you want to include these files in PDF or Word output, you may need to change them to dita format.
DOTX050W WARN Cannot find id attribute in map element. Default id "org.sample.help.doc" is used for plugin. If you want to use your own id, please specify it in id attribute of map.
DOTX051W WARN The %1 to '%2' with @format='%3' can not be recognized, output it without creating a hyperlink. Set @format='dita' for %1 to DITA topic, set @format='html' for HTML files, other format is not supported.
DOTX052W WARN No string named '%1' was found. Using original value. Add translation for the string '%1' in the default language, then add mapping between default language and other languages for it.