Skip navigation
melmohl
Currently Being Moderated

Eclipse help toc xml files. Why are things included/excluded?

Apr 5, 2012 3:41 PM

Tags: #help #toc #xml #output #eclipse #robohelp_html_v9

I've been experimenting with generating Eclipse help, because down the road I'll need to provide content for a product developed with Eclipse.

I'm using RoboHelp HTML v9 and FrameMaker 10 (TCS 3).

 

First, I opened a project created from scratch in RoboHelp by manually adding the topics one at a time. Then I generated Eclipse help. (I selected

Tools > Scripts > Eclipse Help Generator.)

 

Next, I opened another project that I created by linking a FrameMaker book to RoboHelp. Then I generated Eclipse help for it as well.

When I looked at the output files for each project, I noticed some differences.


The TOC XML file generated from the project I created from scratch shows every topic in the TOC for that project.
For example:
<?xml version="1.0" encoding="UTF-8" ?>
- <toc label="My Product Guide">
  <topic label="Introduction" href="first_topic.htm" />
  <topic label="The Work Area" href="work_area.htm" />
  <topic label="Basic Tasks" href="basic_tasks.htm" />
  <topic label="Technical Support" href="tech_support.htm" />
- <topic label="Usign My Product">
   ...and so on.

 

The TOC XML file generated from the project that has a linked FM book only shows this:
<?xml version="1.0" encoding="UTF-8" ?>
  <toc label="ProductGuideHelp" /> NOTE: ProductGuideHelp was the name of the RoboHelp project.

 

Furthermore, the output for the project created from scratch includes an HTML file for each topic added in that project. The output for the project

created by linking an FM book does not include a separate HTML file for each topic. When I can find the content, it's in HTML files that I wouldn't expect.

For example, a topic from a middle section of the project is in the file titled whskin_homepage.hmtl.


So...what's going on?

Thank you.

Mel

 
Replies
  • Currently Being Moderated
    Apr 6, 2012 10:12 AM   in reply to melmohl

    I cannot help you with Eclipse Help but maybe this problem is not related to that.

     

    Generate a webhelp output and see if you have similar problems with that. If you do, then the problem is likely the link with FM and I will then move this thread to a forum category better suited to your question.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Apr 7, 2012 2:19 AM   in reply to melmohl

    That wasn't the answer I expected when I wrote my reply but the fact that you then got Eclipse help working made me realise what the problem was. Eclipse help is produced by RoboHelp running a script. It uses the default WebHelp layout. Once you had set up WebHelp to generate the required output, the script was then able to work.

     

    If you go to View > Pods and open the Script Explorer pod, you will see the script. You can right click and edit the script. I am not suggesting you do change it but on line 517 you will see the script is checking for the existence of the webhelp.

     

    What you should do now is add one or two topics to the source but not generate a new webhelp output, then run the script and see if they are in the Ecliplse help. That will tell you whether or not you always need to run the webhelp layout first. I expect that it will be necessary but please test and post back.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Apr 7, 2012 2:23 AM   in reply to Peter Grainge

    Curiosity got the better of me.

     

    It seems that all that is necessary is to define the WebHelp layout to generate what you want and Save it.

     

    I added another topic and ran the script without running the WebHelp layout again. The new topic was included and amended TOC was correct.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:

More Like This

  • Retrieving data ...

Bookmarked By (0)

Answers + Points = Status

  • 10 points awarded for Correct Answers
  • 5 points awarded for Helpful Answers
  • 10,000+ points
  • 1,001-10,000 points
  • 501-1,000 points
  • 5-500 points