Skip to main content
N
NavHarry
Participant
April 22, 2009
Answered

Searches in generated Help Files

  • April 22, 2009
  • 2 replies
  • 1037 views

Hi,

I create help files for multiple customers from the same project. I have multiple table of contents with lots of topics that need to be customized for different customers. After I generate the help files I do a search as a test. The problem is that the Robohelp search result includes topics that I did not include in the table of contents.

thanks for your help

    This topic has been closed for replies.
    Correct answer Peter Grainge

    That is by design and desirable. The TOC is simply a way of bringing a reader's attention to key topics. It does not have to include all the topics in the build. Let me give an example.


    I have a project with around 12,000 topics. Only a very small number of those would be in TOC, the rest being accessed from links in the topics.


    All topics in Project Manager will be in the build by default. If you have some reason for leaving them in the project but do not want them in the build, such as different versions, then you need to apply a Conditional Build Tag and then use a Build Expression to exclude those topics when you generate the output.

    You need to create different layouts for the different versions, each with the required build expression for that output.

    See www.grainge.org for RoboHelp and Authoring tips

    2 replies

    Peter Grainge
    Community Expert
    Peter GraingeCommunity ExpertCorrect answer
    Community Expert
    April 22, 2009

    That is by design and desirable. The TOC is simply a way of bringing a reader's attention to key topics. It does not have to include all the topics in the build. Let me give an example.


    I have a project with around 12,000 topics. Only a very small number of those would be in TOC, the rest being accessed from links in the topics.


    All topics in Project Manager will be in the build by default. If you have some reason for leaving them in the project but do not want them in the build, such as different versions, then you need to apply a Conditional Build Tag and then use a Build Expression to exclude those topics when you generate the output.

    You need to create different layouts for the different versions, each with the required build expression for that output.

    See www.grainge.org for RoboHelp and Authoring tips

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
    EileenPalsson
    EileenPalsson
    Inspiring
    January 8, 2010

    Isn't this what Properties -> Exclude From Search is for in RH8?

    If so, it's not working -- at least in my project.

    If not, its actual intended use escapes me.

    Enlightenment would be appreciated.

    Correction: Never mind, I found the info in a separate thread: http://forums.adobe.com/message/2354655#2354655

    Namely, this functionality works for WebHelp but not CHM. (Why didn't Adobe say so in their help?)

    Peter Grainge
    Community Expert
    Peter GraingeCommunity Expert
    Community Expert
    January 8, 2010

    Peter,

    Actually, I didn't ask a question. I pointed out that the functionality doesn't work (even though I neglected to mention that it doesn't work in CHM files, because I didn't understand that at the time) OR that it is not completely documented. The latter is the case here.

    I thought one of the advantages of AIR Help is that users can point out errors in the documentation and tips to each other, and that writers can get feedback and correct errors & emissions that users find. Adobe already knows about this issue, so why is the Help not augmented to state that the "Exclude From Search" setting currently only works in WebHelp searches?

    I appreciate the RH tour on your site, but I can't go take a new tour every time I have a question about RH functionality. It should be covered in the Help.

    It is interesting that you and Rick are in disagreement about whether this functionality can be implemented for CHM files.

    Thanks

    Eileen


    I stand corrected but nonetheless I read the comment as something that needed to be raised with Technical Support or via these forums and I see another moderator rejected the comment for the same reason.

    Rick and I are not in disagreement as far as the fact that the MS compiler cannot handle the Exclude from Search option. Rick is saying that there is another way of doing that which I had overlooked, http://bit.ly/7bYDkx

    I didn't mean to imply you should look at everything on my site first. I made reference to the tour in the hope that a look at it sometime might help with a future problem.

    I agree the help should specifically state this method is not available with CHMs and, as I said, if you comment to that effect I will approve it so that it gets to the authors.

    See www.grainge.org for RoboHelp and Authoring tips

    Follow me @petergrainge

    Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.
    RoboWizard
    RoboWizard
    Inspiring
    April 22, 2009

    Hi there

    Indeed just because a topic is not in the TOC it is not excluded from search.

    To exclude from search you need to use Conditional Build Tags.

    Think of the TOC as you would a simple web page with links to other pages. Just because the link isn't there does not mean the page cannot be found.

    Cheers... Rick

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