Embedding an HTML file in DITA directly from Github

Oxygen general issues.
d_croft
Posts: 20
Joined: Fri Feb 20, 2015 10:25 am

Embedding an HTML file in DITA directly from Github

Post by d_croft »

Hi,

I was wondering if it's possible to embed HTML files into DITA XML directly from Github, so that the content of the HTML files would be shown in the XHTML deliverable of the DITA file - preferably inside a <codeblock> element. We would like to demonstrate our front-end files in our documentation, and by doing it like this, the demonstration files would always stay up-to-date, because they'd be served from their original source.

I tried playing with the <object> element, but I only managed to create a link to the file in Github. I also tried Gist-it http://gist-it.appspot.com/, but couldn't figure out, how to get the Javascript to print anything in the resulting XHTML file.

I'd appreciate any ideas :)
Radu
Posts: 9018
Joined: Fri Jul 09, 2004 5:18 pm

Re: Embedding an HTML file in DITA directly from Github

Post by Radu »

Hi,

In DITA a codeblock element can have a coderef element inside it like:

Code: Select all

<codeblock outputclass="language-xml"><coderef href="http://www.oxygenxml.com/doc/ug-oxygen/#topics/installation.intro.html" format="html"/></codeblock>
A problem would be that the DITA Open Toolkit publishing engine does not retrieve contents from resources other than local files on disk.
But if you are running the transformation from Oxygen and you edit the transformation scenario, there is a parameter called fix.external.refs.com.oxygenxml which can be set to yes in order to make this work.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
d_croft
Posts: 20
Joined: Fri Feb 20, 2015 10:25 am

Re: Embedding an HTML file in DITA directly from Github

Post by d_croft »

Yes, we are running the transformation from Oxygen. I have to try this out, thanks a lot :)
Post Reply