Validation errors

writedoc
Posts: 6
Joined: Fri Apr 06, 2012 10:19 pm

Validation errors

Post by writedoc » Fri Apr 06, 2012 10:43 pm

I have created a DITA 1.2 bookmap with links to DITA concept, task, and reference topics. When I run a validation check I get a number of errors that indicate that files are not present; however, when I open the file referenced in the error message, the reported missing file is present! What's going on, is this a known problem with Oxygen 13.2 validation? Sample error message:

Code: Select all

System ID: D:\My Documents\WIP\dita_projects\ePublisher\RCS_Implementation_Guide_ePublisher\reference\abstract.dita
Engine name: oXygen
Severity: error
Description: Reference "file:/D:/My%20Documents/WIP/dita_projects/ePublisher/overview/intro.dita" does not exist.
Type: Reference
Start location: 64:6
End location: 65:21
Know yourself first; help others know themselves

Radu
Posts: 6388
Joined: Fri Jul 09, 2004 5:18 pm

Re: Validation errors

Post by Radu » Mon Apr 09, 2012 1:48 pm

Hi,

That's strange.

So you are saying that this file:

D:/My Documents/WIP/dita_projects/ePublisher/overview/intro.dita

exists on disk but Oxygen reports it as non existing.

We have not received any previous feedback about such an issue.
Could you make up a small DITA Map Project and send us some samples to support@oxygenxml.com?

Could you also copy your DITA Map project to another location and try from there?

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

writedoc
Posts: 6
Joined: Fri Apr 06, 2012 10:19 pm

Re: Validation errors

Post by writedoc » Tue Apr 10, 2012 3:03 pm

Validation errors that indicate missing files is only occurring at the map level. Validation on individual files is OK. As requested, send samples via email.
Know yourself first; help others know themselves

Radu
Posts: 6388
Joined: Fri Jul 09, 2004 5:18 pm

Re: Validation errors

Post by Radu » Tue Apr 10, 2012 3:24 pm

Hi Malcolm,

Thanks for the samples.

I found the problem, there are many places in your DITA Project in which the references to topics use the Windows-syntax path separator like:

Code: Select all

 <topicref href="topics\LogsAlarmsIntro.dita"...
The DITA 1.2 specification:

http://docs.oasis-open.org/dita/v1.2/os ... ibute.html

States that:
Note that the path separator character in an URI is always the forward slash ("/"); the backward slash character ("\") is not permitted unescaped within URIs.
So you should search (using the Oxygen Find/Replace in Files for example) in all your topics for \ and where it is used to reference between DITA resources, replace it with / like:

Code: Select all

<topicref href="topics/LogsAlarmsIntro.dita".
But Oxygen should have definitely reported a proper and clear error message in such situation so we'll try to fix this issue on our side as well.

The benefit of this approach will also be the fact that your DITA Map will be valid also on Linux and Mac.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com

writedoc
Posts: 6
Joined: Fri Apr 06, 2012 10:19 pm

Re: Validation errors

Post by writedoc » Tue Apr 10, 2012 3:38 pm

Thank you for your prompt response. That fixed the problem. All the map files now validate successfully.
Know yourself first; help others know themselves

Post Reply