markdown failure with OT 3.6 #DITA-OT #markdown


Ben Colborn
 

Hi dita-users. After quite some time away (since before the move to groups.io in fact), I'm dipping my toes into the lightweight DITA world and running into some issues. Right now I'm using the remotelighting.ditamap sample with just the markdown topics. Using Oxygen 23.0 (which I believe has OT 3.6) it transforms to HTML5 or PDF without any issues.

Not so with the dita command in a fresh install of OT 3.6 or 3.6.1, which I can see includes the org.lwdita plugin. The files fail to parse.
gen-list:                                                                                   
 [gen-list] Using Xerces grammar pool for DTD and schema caching.                           
 [gen-list] Processing file:/C:/Users/ben/Documents/tech-content/tech-content-tools/sample/r
emotelighting-md.ditamap                                                                    
 [gen-list] Processing file:/C:/Users/ben/Documents/tech-content/tech-content-tools/sample/m
dita/led-specs.md                                                                           
 [gen-list] [DOTJ013E][ERROR] Failed to parse the referenced file 'file:/C:/Users/ben/Docume
nts/tech-content/tech-content-tools/sample/mdita/led-specs.md'.: com.elovirta.dita.markdown.
MDitaReader                                                                                 
 [gen-list] Processing file:/C:/Users/ben/Documents/tech-content/tech-content-tools/sample/m
dita/product-specs.md                                                                       
 [gen-list] [DOTJ013E][ERROR] Failed to parse the referenced file 'file:/C:/Users/ben/Docume
nts/tech-content/tech-content-tools/sample/mdita/product-specs.md'.: com.elovirta.dita.markd
own.MDitaReader                                                                             

Output of docsrc/userguide.ditamap to html5 using the dita command works fine. Am I missing something that's needed to process the markdown topics? Thank you for any insight.

Ben


Aliza Merzel
 

Hi, Ben,

 

I had the same issue

It is a known issue

 

It happens when you call the dita-ot using the ant command

When using the dita command, it should be fine

 

https://github.com/jelovirt/dita-ot-markdown/issues/59

 

Aliza

 

 

Aliza Merzel

Senior Developer and XML Specialist

Phone: +972 8-976-0323

Email: alizam@...

 

Connect with us:  twitter.png   linked-in.png  youtube.png

 

Logo-for-email-signatures - smaller

 

From: main@dita-users.groups.io [mailto:main@dita-users.groups.io] On Behalf Of Ben Colborn via groups.io
Sent: Wednesday, April 14, 2021 9:45 PM
To: main@dita-users.groups.io
Subject: [dita-users] markdown failure with OT 3.6 #DITA-OT #markdown

 

Hi dita-users. After quite some time away (since before the move to groups.io in fact), I'm dipping my toes into the lightweight DITA world and running into some issues. Right now I'm using the remotelighting.ditamap sample with just the markdown topics. Using Oxygen 23.0 (which I believe has OT 3.6) it transforms to HTML5 or PDF without any issues.

Not so with the dita command in a fresh install of OT 3.6 or 3.6.1, which I can see includes the org.lwdita plugin. The files fail to parse.

gen-list:                                                                                   
 [gen-list] Using Xerces grammar pool for DTD and schema caching.                           
 [gen-list] Processing file:/C:/Users/ben/Documents/tech-content/tech-content-tools/sample/r
emotelighting-md.ditamap                                                                    
 [gen-list] Processing file:/C:/Users/ben/Documents/tech-content/tech-content-tools/sample/m
dita/led-specs.md                                                                           
 [gen-list] [DOTJ013E][ERROR] Failed to parse the referenced file 'file:/C:/Users/ben/Docume
nts/tech-content/tech-content-tools/sample/mdita/led-specs.md'.: com.elovirta.dita.markdown.
MDitaReader                                                                                 
 [gen-list] Processing file:/C:/Users/ben/Documents/tech-content/tech-content-tools/sample/m
dita/product-specs.md                                                                       
 [gen-list] [DOTJ013E][ERROR] Failed to parse the referenced file 'file:/C:/Users/ben/Docume
nts/tech-content/tech-content-tools/sample/mdita/product-specs.md'.: com.elovirta.dita.markd
own.MDitaReader                                                                             


Output of docsrc/userguide.ditamap to html5 using the dita command works fine. Am I missing something that's needed to process the markdown topics? Thank you for any insight.

Ben


Ben Colborn
 

Thank you Aliza, that certainly looks like the same error. However, I was using the dita command, not calling ant directly. This is in a Git Bash window, which is mingw. I saw the same behavior on my colleague's Windows machine (also Git Bash/mingw). However, the same failure is NOT seen on a Mac. Then I tried running dita.bat rather than dita (which is a Bourne shell script) and the md files DID parse correctly.

The conclusion is that dita.bat works in mingw, and dita works on Mac. So it seems to be a corner case with the dita shell script in mingw terminals.

Ben