Import XML from Author-it to RoboHelp

New Here ,
Feb 09, 2021

Copy link to clipboard

Copied

I am importing a book from Author-it to the RoboHelp. The book is saved in the XML format.

I tried to import this XML file to RoboHelp using the importing tool in RoboHelp, but it failed. Below you can find the dialog box that shows the failure.

It seems that RoboHelp cannot recognize the elements in this XML file. My knowledge on XML is quite limited. So should I first map the elements in the XML file to some elements that RoboHelp can recognize in order to import the XML file?

Any input would be appreciated. 

Luyao5C59_0-1612885818631.png

 

Views

108

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Adobe Community Professional ,
Feb 09, 2021

Copy link to clipboard

Copied

Is this a "one-off" or are you planning to do it over & over again? Are you planning to author in a structured fashion in RH? If this is just a one-time thing, you might find it easier to import HTML into RH...

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
New Here ,
Feb 10, 2021

Copy link to clipboard

Copied

Thank you for your input, Jeff!

It is not a "one-off" task. In fact, we have quite some books that need to be imported to RH. In that case, should I first map all the elements from the XML file to some elements that RH recognizes? I hope that once the mapping is set up, the import would become easier for the other books.

 

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Adobe Employee ,
Feb 10, 2021

Copy link to clipboard

Copied

Yes, bascially, the process would be to run the XML coming from AuthorIT against an XSLT to transform it into XHTML 1.0. However, as you seeem to use RoboHelp 2017, I suggest looking into upgrading to RoboHelp 2020. RoboHelp 2020 is using XHTML5 which is semantically much richer than XHMTL 1.0 and has elements like article, section, etc. that make it more compatible with architectural more complex XML.

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Adobe Community Professional ,
Feb 10, 2021

Copy link to clipboard

Copied

Ok, then you're entering an area of structured authoring in RH that I have no idea how to accomplish. Is the Author-IT content organized using DITA or some other structured schema?

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Adobe Employee ,
Feb 10, 2021

Copy link to clipboard

Copied

Can you open the Author-it.xml file in Notepad++ or some similar text editor and copy / paste the first 10, 20 lines here?

The error messge says, that RoboHelp is firing up the Docbook import filter, but without looking into the code of the file you are trying to import it's difficult to tell more.

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
New Here ,
Feb 10, 2021

Copy link to clipboard

Copied

Thank you for the help, Stefan. I attach the file to this post. Could you tell more from it?

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Adobe Employee ,
Feb 10, 2021

Copy link to clipboard

Copied

Thanks. This is proprietary AuthorIT XML. It does not contain the actual content of the manual. You can think of it as some sort of "project file" that lists which files are part of the book, folders, available projects statusses, variables, etc.

This file would be something you could transform with XSLT into the corresponding files of a RoboHelp-Project. Do you also have the actualy content? This is primarily what you will want to transform.

Likes

Translate

Translate

Report

Report
Reply
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more