Page 1 of 1

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

Posted: Tue Jul 25, 2023 6:16 pm
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

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

Posted: Tue Jul 25, 2023 6:58 pm
by jdeverea
I think it has to do with the 'missing' scope="external"

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

Posted: Wed Jul 26, 2023 6:52 am
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

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

Posted: Wed Jul 26, 2023 5:37 pm
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.

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

Posted: Thu Oct 05, 2023 4:42 pm
by jdeverea
Are we still expecting an Autumn release? I'm ready to download now. : D

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

Posted: Thu Oct 05, 2023 5:11 pm
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

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

Posted: Thu Oct 05, 2023 9:45 pm
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

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

Posted: Mon Oct 09, 2023 7:32 am
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