Oxygen Newbie Seeking Info on Importing

<oXygen/> general issues.
Atticus
Posts: 2
Joined: Wed Sep 18, 2019 9:06 pm

Oxygen Newbie Seeking Info on Importing

Post by Atticus » Wed Sep 18, 2019 9:19 pm

Hello, All:

I'm a Tech Writer/BSA in the States. I'm loosely associated with a info dev team that uses Oxygen, and would like to bring a WebHelp project (created in MadCap Flare) into Oxygen so that my Help system can gain the attendant benefits of using the transforms and Help features that the team has implemented using Oxygen.


The problem is that I've been told that Oxygen does not support any kind of automatic importing of Help files (compiled, Web Help, HTML 5 or otherwise) into the platform. If this is true, then I have to manually copy and paste the text of over 300 topics, and copy and manually insert and format hundreds of screenshots, from my existing Help project into Oxygen. Considering I'm a one-person shop, this seems like a non-starter, and a large roadblock to ever getting my project into Oxygen.


The lack of an import function seems insane to me (especially from a marketing standpoint), so confirming with the resident experts here that there is, in fact, no easier way to get my Help project into Oxygen, other than cut and paste.

Thanks so much for your time, and looking forward to any responses!

Atticus

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

Re: Oxygen Newbie Seeking Info on Importing

Post by Radu » Thu Sep 19, 2019 7:48 am

Hi Atticus,

We created about a year ago a free add-on for Oxygen which converts a bunch of resources to various output formats. The add-on can be installed from here:

https://github.com/oxygenxml/oxygen-resources-converter

and it can batch convert HTML to DITA.

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

Atticus
Posts: 2
Joined: Wed Sep 18, 2019 9:06 pm

Re: Oxygen Newbie Seeking Info on Importing

Post by Atticus » Thu Sep 19, 2019 4:54 pm

Awesome! Thank you, Radu.

So in theory, should be able to convert my WebHelp topics?

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

Re: Oxygen Newbie Seeking Info on Importing

Post by Radu » Fri Sep 20, 2019 7:18 am

Hi Atticus,

You can try the add-on and see how it works for your HTML documents. Ideally the HTML documents should be as simple as possible, without the table of contents added inside them. An alternate option would be to convert the HTML to XHTML using the same add-on, then apply an XSLT stylesheet over the XHTML documents to remove the parts which are not really content (footers, headers, table of contents), and then with the add-on convert XHTML to DITA.

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

Post Reply