"Unknown file extension in href" How do I fix them

[Charlie Williams]

Hello,
I have "transformed" a .dita file, and the tranformation was successful; however, I got five warnings. I don't understand how to fix them. Right now the links work as intended. Should I leave them alone, or should I fix them. I tried to set the format attribute to "dita" or "xml." but then the links didn't work. I don't think I know all I should about Attributes.

Thanks for any infomation,
Charlie

Here are the warnings:

SystemID: C:\projects\AdminPassword\frameworks\dita\DITA-OT\xsl\dita2html.xsl
Description: [DOTX006E][ERROR]: Unknown file extension in href: 'http://sagemasterbuilder.com/customer_c ... ordXMLtest'. 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'.The location of this problem was at - - 1:0

SystemID: C:\projects\AdminPassword\frameworks\dita\DITA-OT\xsl\dita2html.xsl
Description: [DOTX006E][ERROR]: Unknown file extension in href: 'http://sagemasterbuilder.com/customer_c ... ordXMLtest'. 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'.The location of this problem was at - - 1:0

SystemID: C:\projects\AdminPassword\frameworks\dita\DITA-OT\xsl\dita2html.xsl
Description: [DOTX006E][ERROR]: Unknown file extension in href: 'ChangePassword'. 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'.The location of this problem was at - - 1:0

SystemID: C:\projects\AdminPassword\frameworks\dita\DITA-OT\xsl\dita2html.xsl
Description: [DOTX006E][ERROR]: Unknown file extension in href: 'SetPassword'. 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'.The location of this problem was at - - 1:0

SystemID: C:\projects\AdminPassword\frameworks\dita\DITA-OT\xsl\dita2html.xsl
Description: [DOTX006E][ERROR]: Unknown file extension in href: 'Re-setPassword'. 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'.The location of this problem was at - - 1:0

[Dan]

Hello,

A small section from your document would be very helpful in identifying the problem.

"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'."

http://dita-ot.sourceforge.net/doc/ot-u ... olkit.html

[Charlie Williams]

Hello,
Thanks for the reply. The warnings are coming from the area of the document that contains hypertext links.
Regards,
Charlie

<!-- Links to external HFS -->
<postreq>
<lines>
<b>Did this topic help you?</b>
<xref href="http://sagemasterbuilder.com/customer_c ... MLtest">If yes, click this link to let us know. </xref>
<xref href="http://sagemasterbuilder.com/customer_c ... MLtest">If not or to leave a comment, then click here.</xref>
(Require access to the Internet.)
</lines>
</postreq>
<!-- /Links to external HFS -->

</taskbody>

<!-- help system internal links -->
<related-links>
<linklist>
<title>
<b>Links to more information</b>
</title>
<link href="AboutPassword">
<linktext>About the adminstrator user password</linktext>
</link>
<link href="ChangePassword">
<linktext>Change the administrator password</linktext>
</link>
<!-- <link href="SetPassword">
<linktext>Set the administrator password</linktext>
</link> -->
<link href="Re-setPassword">
<linktext>Re-set the administrator password</linktext>
</link>
</linklist>
</related-links>
<!-- help system internal links -->

[Dan]

For the first two xref, it is necessary to add the format attribute:

Code: Select all

 <xref  format="html" href="http://sagemasterbuil.....

The next three links are a bit of a problem, because I do not know what you want to refer. If the "AboutPassword", "ChangePassword" and "Re-setPassword" are IDs in the same file you will have to prefix them with "#":

Code: Select all

            <link href="#AboutPassword">

                <linktext>About the adminstrator user password</linktext>

            </link>

            <link href="#ChangePassword">

                <linktext>Change the administrator password</linktext>

            </link>

            <link href="#Re-setPassword">

                <linktext>Re-set the administrator password</linktext>

            </link>

Otherwise, if they are some dita files, you have to change the names of the files to have the .dita or .xml extension.

Code: Select all

  <link format="dita" href="AboutPassword.xml">

       <linktext>About the adminstrator user password</linktext>

  </link>

More information here:http://docs.oasis-open.org/dita/v1.0/langspec/xref.html

Regards,
Dan