Skip to main content
L
Luyao5C59
Participant
February 9, 2021
Question

Import XML from Author-it to RoboHelp

  • February 9, 2021
  • 3 replies
  • 771 views

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. 

 

    This topic has been closed for replies.

    3 replies

    S
    Community Manager
    Stefan GentzCommunity Manager
    Community Manager
    February 10, 2021

    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.

    L
    Luyao5C59Author
    Participant
    February 10, 2021

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

    S
    Community Manager
    Stefan GentzCommunity Manager
    Community Manager
    February 10, 2021

    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.

    Jeff_Coatsworth
    Community Expert
    Jeff_CoatsworthCommunity Expert
    Community Expert
    February 10, 2021

    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?

    Jeff_Coatsworth
    Community Expert
    Jeff_CoatsworthCommunity Expert
    Community Expert
    February 9, 2021

    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...

    L
    Luyao5C59Author
    Participant
    February 10, 2021

    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.

     

    S
    Community Manager
    Stefan GentzCommunity Manager
    Community Manager
    February 10, 2021

    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.

    Terms & ConditionsAccessibility statement
    Using the community Terms of use Privacy Cookie preferences Do not sell or share my personal information ad choicesAdChoices