Skip navigation
Limiz
Currently Being Moderated

TOC and Index not displaying in live Webhelp

Jun 17, 2013 12:37 AM

I am working in a RH 10 project upgraded from a RH 9 project. When generating Webhelp, local output displays fine, but after compiling and uploading to our online app, the TOC and Index do not display - what I mean is that the tabs exist, you can click them, but they are empty. Search doesn't work either, plus the logo in the header doesn't appear, though it is in the images folder that is uploaded.

 

Some more details:

  • I am outputing the project to a folder external to the root folder of the project. To clarify, the project is in a folder named 'Help', and the output is in a separate folder named '9.1 Help' at the same level of the Help folder. When I provide the output, I only provide the '9.1 Help folder'. Could this be causing the problem?
  • After looking into similar issues, I find that the HCC project file doesn't exist in my output folder, nor do the .glo, .hhk, etc. I suspect that this could be the problem. However, as far as I understand, it isn't possible to output the final .htm file for the project to the same folder that holds these files. You have to publish to a different output folder outside the root path.
  • I tried to change the default TOC and Index under Webhelp settings  > Content Categories > Content from default to the specific TOC in my project (it's the only TOC and Index, so this shouldn't cause mistaked, but I'm not sure if this change means anything).

 

I'd be glad to provide any other details if needed.

 

Thanks!

 
Replies
  • RoboColum(n)
    5,357 posts
    Oct 8, 2004
    Currently Being Moderated
    Jun 17, 2013 4:14 AM   in reply to Limiz

    This sounds like you are missing some of the output files. How are you getting the files into the application?

     
    |
    Mark as:
  • RoboColum(n)
    5,357 posts
    Oct 8, 2004
    Currently Being Moderated
    Jun 17, 2013 4:51 AM   in reply to Limiz

    It sounds that way. Have you checked that:

     

    1. The generated output looks OK before you check it into Perforce.

    2. Perforce has all the output files.

     

    If the answer to both these questions is Yes, it is time to suspect the application build process.

     
    |
    Mark as:
  • RoboColum(n)
    5,357 posts
    Oct 8, 2004
    Currently Being Moderated
    Jun 17, 2013 7:36 AM   in reply to Limiz

    Unless your project references these package_xx.html files in some way I have no idea whart they are. They are certainly not part of the normal webhelp output. Try this:

     

    1. Delete the contents of your output directory.

    2. Ensure your WebHelp SSL has the "Republish all" option set in the final dialog.

    3. Regenerate your help.
     
    |
    Mark as:
  • RoboColum(n)
    5,357 posts
    Oct 8, 2004
    Currently Being Moderated
    Jun 19, 2013 3:27 AM   in reply to Limiz

    Can you tell us what browsers you and your colleaques are using?

     
    |
    Mark as:
  • Currently Being Moderated
    Jun 19, 2013 5:39 AM   in reply to Limiz

    Hi there

     

    Just a side note. The option for Mark of the Web is only going to apply when you view content from your local hard drive and you are using Microsoft Internet Explorer as your browser. If you are uploading this content to a server, the option may as well not exist. So it won't matter if it's enabled or not and would have no bearing on this situation.

     

    Changing the option from DHTML shouldn't really affect it either.

     

    @Colum - The package_xx.html files are certainly part of RoboHelp output. After you generate WebHelp, you should see them in the whxdata folder.

     

    I think we have established that the files display fine immediately after generating, no? That would then suggest that the issue is entirely in the lap of perforce and what the development team is doing. (or, more accurately, NOT doing)

     

    Cheers... Rick

     
    |
    Mark as:
  • Currently Being Moderated
    Jun 19, 2013 5:59 AM   in reply to Limiz

    Hi there

     

    I do suppose it's possible. But I don't think it's likely. Adobe simply changed the file naming conventions of those small chunks of data that make up the TOC and Index and Search. It's possible that your dev team may not know to include them in the build. And if that's the case, it would certainly explain why it works for you locally immediately after you generate but not after the dev team puts their hands on it.

     

    Essentially you just need to show one of them that it works on your PC before you commit the files to source control, and ensure ALL the output files are actually being uploaded to Perforce.

     

    I suppose one test would be to just grab a copy of all the files you are placing into Perforce and plop them on a machine. Try to open WebHelp. If it works, you know beyond a shadow of a doubt that your developers are doing something wrong or not managing to get all the files. But if it fails for you, I'd suspect that you aren't managing to get all the content uploaded properly into Perforce.

     

    Cheers... Rick

     
    |
    Mark as:
  • Currently Being Moderated
    Jun 19, 2013 8:21 AM   in reply to Limiz

    Did you hear that sound?

     

    That was the sound of applause coming from Kansas City, MO!

     

    Pleased ti see that you got it sorted! And thanks for posting back what the issue was. It may help someone down the road!

     

    Cheers... Rick

     
    |
    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