Skip navigation
dennetti
Currently Being Moderated

CSS not applied when compiling HTML help - RoboHelp 10

Jan 17, 2013 9:48 AM

All topics preview OK, but when the CHM file is compiled, the CSS file does not get applied. The CSS is specfied using master pages. A large number of HHC3004: Warning messages are displayed in the Outview View when the CHM file is compiled. The project has recently been upgraded from RoboHelp 5.

 

Some further info: when compiling the CHM file, it appears that this process finishes prematurely as the Outview View shows half of a HHC3004 warning message!

 

I think the root cause of the problem is that this is a large project, with over 2000 topics, and it has become corrupt in some way. As this is a major problem, I'd really appreciate some advice....

 
Replies
  • Currently Being Moderated
    Jan 22, 2013 12:42 AM   in reply to dennetti

    I've had over 4000 files in a project so I wouldn't worry about the number itself. However, any project can get to the point where the CPD file gets corrupted. Start by deleting that and reopening the project.

     

    In Tools > Options you can tell Rh to always clear the cache (CPD) when it opens.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Jan 22, 2013 3:43 AM   in reply to dennetti

    I'm not a user of CHMs so others with more knowledge there might be able to suggest something more. Meantime...

     

    You have now thrown in baggage files and merged help.

     

    One way to see if baggage files are being loaded is to reverse engineer the CHM and see if the baggage files are there. How is on my site. I believe FAR from Helpware also enables you to examine the content of a CHM. However, I am not seeing a link between baggage files and this problem.

     

    Does this problem occur when you view the CHMs in the merge individually or only when you open the parent project?

     

    Are you talking about parent and a number of child projects or many parents with their own children?

     


    See www.grainge.org for RoboHelp and Authoring tips

     

     

    @petergrainge

     
    |
    Mark as:
  • RoboColum(n)
    5,356 posts
    Oct 8, 2004
    Currently Being Moderated
    Jan 22, 2013 8:55 AM   in reply to dennetti

    Can you check that all the projects (including the parent) have exactly the same setup and file versions.

     
    |
    Mark as:
  • Currently Being Moderated
    Jan 23, 2013 1:11 AM   in reply to RoboColum(n)

    And while you are checking, put a copy of the parent in a folder on its own. Does the CSS work then?

     


    See www.grainge.org for RoboHelp and Authoring tips

     

     

    @petergrainge

     
    |
    Mark as:
  • RoboColum(n)
    5,356 posts
    Oct 8, 2004
    Currently Being Moderated
    Jan 23, 2013 5:21 AM   in reply to dennetti

    I wonder whether the issue is your merged CHM's being copied into the project folder. Can you check something. If you look in the project folder for your parent CHM, are there other CHMs from the child projects there? If so, delete them and recompile. It would be worth doing the same on the child projects as well.

     

    The way that merged CHMs work means that when a project that contains references to another CHM is compiled and that other CHM is in the project directory, it uses that CHM file. The problem is, this may not be the most up to date as it is copied into the project directory at the point the reference was added. If the actual project the CHM comes from is amended, the copied CHM remains blistfully unaware of the change.

     

    By ensuring the project directories are clear of all this clutter, the inter project references remain. Also as long as all the CHMs are placed in the same location, all appears well.

     
    |
    Mark as:
  • RoboColum(n)
    5,356 posts
    Oct 8, 2004
    Currently Being Moderated
    Jan 23, 2013 6:35 AM   in reply to dennetti

    I think deleting the CHMs from the parent project directory is only half the story. Have you CHMs in the child project directories also? If so, delete those as well and recompile each child before recompiling the parent.

     
    |
    Mark as:
  • RoboColum(n)
    5,356 posts
    Oct 8, 2004
    Currently Being Moderated
    Jan 23, 2013 8:22 AM   in reply to dennetti

    OK. Let us take stock here. You have recreated the parent CHM on its own in a new directory successfully and the CSS was applied. You then recreated the child CHMs and added these to the same directory and now the CSS isn't applied. Try recompiling each child to a new directory, check that the CSS is applied, delete the CHM references from the parent project's TOC, add them all back from the new locations and recompile the parent.

     

    If this doesn't work I reserve the right to go home and sulk

     
    |
    Mark as:
  • Currently Being Moderated
    Jan 23, 2013 8:26 AM   in reply to RoboColum(n)

    @Colum - this just reconfirms my desire not to work with CHMs or merged projects </grin

     
    |
    Mark as:
  • RoboColum(n)
    5,356 posts
    Oct 8, 2004
    Currently Being Moderated
    Jan 23, 2013 8:37 AM   in reply to Jeff_Coatsworth

    LOL Jeff. There are a lot better than JavaHelp which is what I inherited here many moons ago. The problem with CHMs is that Microsoft never intended them to be merged or do anything fancy. Awkward people like us just like a challenge

     
    |
    Mark as:
  • Currently Being Moderated
    Jan 24, 2013 5:04 AM   in reply to dennetti

    Hi, Dinnetti

     

    There are quite a few results mentioning HHC3004 on this forum as well as via Google. Apparently this occurs with many different help authoring tools which are all dependent on the Microsoft Help Compiler which Adobe licenses from MS because it is their proprietary format.

    I am pointing to the threads that seem to hold the best clues. You can see if these contain your answer.

    The most interesting one is from longtime help expert, Dana Worley, a Microsoft MVP who says this:

    "Check to make sure the directory path does not include a "dot" in it, and particularly some

    form of .h (for instance, c:\my.help.dir).


    This particular scenario is a known issue that will cause the HTML Help compiler to return

    error HHC3004"

     

    So, from what I can tell, that non alphanumeric character issue seems to be the common culprit among those who experience the problem and a good place to start.

    Here are the relevant links I found.

    http://forums.adobe.com/thread/680087

     

    http://geekswithblogs.net/mapfel/archive/2009/03/11/130017.aspx

     

    http://forums.adobe.com/thread/551443

     

    Also, because you are converting from the ancient RoboHelp X5, this might be worth noting. The encoding in modern versions of RH use UTF 8 and I wonder if something did not get "converted" in the upgrade of your project. (Just guessing here.)

    Let us know how you make out.

    john

    John Daigle

    Adobe Certified RoboHelp and Captivate Instructor

    Evergreen, Colorado

    www.showmethedemo.com

    @hypertexas

     
    |
    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