importing XML

This forum is for all Flare issues related to importing files or projects.

importing XML

Postby meggs on Tue Mar 03, 2009 12:16 am

Hello there,

just one short question: how do i import XML-files into Flare? We´ve got several projects done in Help & Manual and would like to turn it to Flare. Any suggestions (not via Word, this is not satisfying)

thx
meggs
Jr. Propeller Head
 
Posts: 12
Joined: Mon Mar 02, 2009 2:01 am

Re: importing XML

Postby alaltenburg on Tue Mar 03, 2009 1:56 pm

One idea would be to create a new topic in Flare. Then right click on the topic and open in xml editor. Then you could just copy and paste the text in. You would have to bring in any pictures separately.
The Moon is the first milestone on the road to the stars.

— Arthur C. Clarke
User avatar
alaltenburg
Sr. Propeller Head
 
Posts: 342
Joined: Mon Nov 03, 2008 9:33 am
Location: The heart of America

Re: importing XML

Postby meggs on Wed Mar 04, 2009 1:30 am

Thanks for your reply,

but the the result also isn´t satisfying. Flare can´t handle the tags, only pure text is displayed.

other ideas?
meggs
Jr. Propeller Head
 
Posts: 12
Joined: Mon Mar 02, 2009 2:01 am

Re: importing XML

Postby RamonS on Wed Mar 04, 2009 6:23 am

Can you load the project in Help&Manual and create a WebHelp of any kind? You could then import the XHTML files assuming they have valid markup. XML is a loose term just describing a set of rules the file format has to follow, but what the contents are is up the one creating the XML. That is why Flare won't understand what is in the XML files in regards to formatting.
How many files do you need to import? If it is just a few dozen I'd go and do it the hard way manually. That will be a grueling task, but it will be quicker than coming up with a tricked out process that produces halfway satisfying results.
Uuhm, you could also create CHM and then decompile that to get to the HTML files.
User avatar
RamonS
Senior Propellus Maximus
 
Posts: 6132
Joined: Thu Feb 02, 2006 9:29 am
Location: The Electric City

Re: importing XML

Postby Richard Ferrell on Wed Mar 04, 2009 8:36 am

if you can save the files as Xhtml then You can drop these files into Flare and have anaylzer do a batch convert of them
Richard Ferrell

Certified Madcap Trainer
Image
Richard Ferrell
Senior Propellus Maximus
 
Posts: 3549
Joined: Mon May 01, 2006 10:11 am
Location: SomeWhere in Arizona

Re: importing XML

Postby KevinDAmery on Wed Mar 04, 2009 2:01 pm

RamonS wrote:Uuhm, you could also create CHM and then decompile that to get to the HTML files.


The other advantage of this method is it should automatically create a TOC for you in Flare. It may also bring in things like your index, alias, etc.
Until next time....
Image
Kevin Amery
Certified MAD for Flare
User avatar
KevinDAmery
Senior Propellus Maximus
 
Posts: 3639
Joined: Tue Jan 23, 2007 8:18 am
Location: Darn, I knew I was around here somewhere...

Re: importing XML

Postby ENJ on Wed Apr 15, 2009 11:01 am

I've got a similar problem. I have no idea what the XML docs were created in (the developer who created them is no longer around). I am able to import the XML files into Flare but when you view them, you cannot edit the files and apply a stylesheet. The XML files consist mainly of tables. The content is still grouped (somewhat) in the tables but the formatting is obviously wrong.
Unless I recreate each file (at least 50 of them), I can't seem to make them look right.
ENJ
Jr. Propeller Head
 
Posts: 11
Joined: Fri Oct 10, 2008 8:35 am

Re: importing XML

Postby doc_guy on Wed Apr 15, 2009 12:20 pm

If you want to use the XML files in Flare, you need to convert them into a format that Flare recognizes. For example, the following is legitimate XML markup:

Code: Select all
<xml>
<person>
  <name>DocGuy</name>
  <posts count="1553" />
  <location>Crossroads of the West</location>
  <job title="Technical Writer" />
</person>
</xml>


But how do you expect Flare to import that content?

Even if I have the following XML:

Code: Select all
<xml>
<topic>
   <content>
     <p>This is the content of my topic.</p>
   </content>
  </topic>
  <topic>
   <content>
    <p>This is the content in a second topic.</p>
   </content>
  </topic>
</xml>


You can recognize how this topic is to be organized, but how is Flare supposed to guess?

The reality is that you need to transform the content to be valid XHTML. Then you can import it into Flare. One way of doing this is hiring a programmer to write an XSLT transform that will convert the existing content into valid XHTML. Or create a different output from the original help files (as discussed earlier in this thread) and then use THAT format to get the files into Flare.

But it is too much to expect that Flare will take any old XML file and assume that Flare will know how to map the tags to Flare's schema.
Paul Pehrson
My Blog | My portfolio

I'm speaking at MadWorld 2015! Join us next April in San Diego!
Image Image
User avatar
doc_guy
Senior Propellus Maximus
 
Posts: 2302
Joined: Tue Nov 28, 2006 11:18 am
Location: Crossroads of the West


Return to Importing

Who is online

Users browsing this forum: No registered users and 2 guests