Can't transform markdown ![image] references from github

Post here questions and problems related to editing and publishing DITA content.
jdeverea
Posts: 5
Joined: Mon Jul 24, 2023 6:06 pm

Can't transform markdown ![image] references from github

Post by jdeverea »

Hi all -
I have a ditamap that includes references to .md files that my engineers host on their github wiki. Unfortunately, I can't transform them to pdf
because I get the following error:
Transformation failed. C:\Program Files\Oxygen XML Editor 25\frameworks\dita\DITA-OT3.x\plugins\org.dita.base\build_preprocess.xml:369: java.lang.IllegalArgumentException: URI scheme is not "file"

But if I convert the ![image] (https://github.com/..... to instead use html such as <img scope="external" src="http..... then it works...well sometimes. Github seems to play a shell game with image files on their wiki. But at least I don't get the transformation error above.

Changing all image reference to html is not a long term solution because the developers just copy/paste images into the wiki which by default uses the markdown syntax.

*. Should OxygenXML/DITA-OT be able to handle the markdown ![image](https:.... syntax? Or do I need to convert all of these to html?

Puzzle pieces:
OxygenXML 25.1, github wiki repository, markdown called from dita map
Last edited by jdeverea on Wed Jul 26, 2023 5:53 pm, edited 1 time in total.
jdeverea
Posts: 5
Joined: Mon Jul 24, 2023 6:06 pm

Re: Can't transform markdown ![image] references from github

Post by jdeverea »

I think it has to do with the 'missing' scope="external"
Radu
Posts: 9421
Joined: Fri Jul 09, 2004 5:18 pm

Re: Can't transform markdown ![image] references from github

Post by Radu »

Hi,
You are right, it's about the missing scope=external.
Oxygen 25.1 comes bundled with DITA OT 3.7.
This particular problem was fixed in DITA OT 4.0:
https://github.com/dita-ot/dita-ot/issues/4032
Oxygen 26 (Autumn this year) will be bundled with DITA OT 4.1.1.
If you are publishing to plain output types like HTML5, you can also download DITA OT 4.1.1 from the DITA OT web site and use it from Oxygen to publish.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
jdeverea
Posts: 5
Joined: Mon Jul 24, 2023 6:06 pm

Re: Can't transform markdown ![image] references from github

Post by jdeverea »

Radu wrote: Wed Jul 26, 2023 6:52 am
This particular problem was fixed in DITA OT 4.0:
https://github.com/dita-ot/dita-ot/issues/4032
Oxygen 26 (Autumn this year) will be bundled with DITA OT 4.1.1.
So close to Autumn! : ) Thanks for the reply.
jdeverea
Posts: 5
Joined: Mon Jul 24, 2023 6:06 pm

Re: Can't transform markdown ![image] references from github

Post by jdeverea »

Are we still expecting an Autumn release? I'm ready to download now. : D
Radu
Posts: 9421
Joined: Fri Jul 09, 2004 5:18 pm

Re: Can't transform markdown ![image] references from github

Post by Radu »

Hi,
We plan to release Oxygen 26 next week (around October 10'th).
But you can also try using Oxygen 26 from our nightly builds page available in our beta program:
https://www.oxygenxml.com/oxygen_beta_p ... ister.html
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
jdeverea
Posts: 5
Joined: Mon Jul 24, 2023 6:06 pm

Re: Can't transform markdown ![image] references from github

Post by jdeverea »

It works! I just tried it with a small example map. I'm so excited to try it on some of our larger docs.
Thanks oodles,
J
Radu
Posts: 9421
Joined: Fri Jul 09, 2004 5:18 pm

Re: Can't transform markdown ![image] references from github

Post by Radu »

Hi,
Great, thanks for confirming this!
There is also other supported stuff like support for notes:
https://www.dita-ot.org/dev/reference/m ... ntax#notes
Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply