Skip navigation
Currently Being Moderated

How do I set up audiences with topics?

Dec 10, 2012 5:17 AM

Tags: #condition

I want to create my help so that there is a drop-down choice for each job role, and when the person clicks on their role in the drop-down, just the help relevant to them displays.

 

I'm very confused by the terminology and options.  I created a conditional build tag for each role.  I have my TOC with books and topics within them.  I tried using right-click on the topic --> Apply Conditional Build Tag to try to restrict that topic to the audiences I specified.  When I did that, the topic displayed for all audiences.  I also tried going into the Topic List and using Properties --> Topic-Level Tags to select audiences that way.  It still displayed the topic for all audiences. 

 

I'm generating using WebHelp, and I see in the WebHelp menu there are Content Categories.  I have each of my roles set up there, and I see that there is a Conditional Build Expression field, and I'm not sure if I'm supposed to be doing something with that.

 

I know there must be a simple way to do this, but I'm just not understanding the Help file.

 

Thanks so much!

 
Replies
  • Currently Being Moderated
    Dec 10, 2012 5:26 AM   in reply to zeppmelissa

    Take a look at the sample projects, Employee Care and Salesbuilder. There is some guidance there along with examples already set up.

     

    Click Open on the RoboHelp Starter page and then click Samples in the ribbon on the left.

     


    See www.grainge.org for RoboHelp and Authoring tips

     

     

    @petergrainge

     
    |
    Mark as:
  • Currently Being Moderated
    Dec 10, 2012 6:02 AM   in reply to zeppmelissa

    That is not where I said to look for them. They are part of RoboHelp,  not part of my site. 

     
    |
    Mark as:
  • Currently Being Moderated
    Dec 10, 2012 6:02 AM   in reply to zeppmelissa

    Not Peter’s page – your local RH install – it’s called the Starter page & usually appears when you launch RH from a shortcut (i.e. not when opening a project’s .xpj file)

     
    |
    Mark as:
  • RoboColum(n)
    5,356 posts
    Oct 8, 2004
    Currently Being Moderated
    Dec 11, 2012 5:04 AM   in reply to zeppmelissa

    This sounds like you are using RH10. Is that correct? If you generate the WebHelp Location Based single source layout you will see what we are talking about. Content Categories are sometimes described as "Conditional Build Tags on steroids". As this suggests you tag your output as you would if you just wanted to exclude some output. In each of the Content Categories you specify a conditional build tag expression - again as you would inside the single source layout. So if you have 13 roles you would have 12 tags excluded.

     

    If you go down this line make your tags as short as possible. There used to be an issue with the conditional build tag expression going over 255 characters in length. I am not sure if this is still an issue in RH10. Either way it makes sense to keep your tags short for ease of use.

     
    |
    Mark as:
  • Currently Being Moderated
    Dec 11, 2012 12:30 PM   in reply to zeppmelissa

    There are numerous ways of setting up the content and TOC for each role. You can do it from one TOC and use tagging or you can use multiple TOCs but most likely you will need both. The output will contain a webhelp for each role so be aware of the size implications. Also check the outputs for topics that you didn't intend to be in a particular one.

     

    The fact that you have chosen to only allow topics in a TOC does not mean they are the only ones in that category. Say you did not want Topic 110 in an output but Topic 109 has a link to it, Topic 110 will be included and findable in a search. Look at what is in each category via Windows Explorer.

     

    You will likely need a combination of TOCs and tagging to achieve your objective. The Location layout is the one to study, the skinned one is for use with a script that creates skinned CHMs from a webhelp output. I'm not sure how you are concluding tagging was not used when you go on to say the layout had AND NOT statements. That is the build expression that is using the tags.

     

    There is another thread running on this area at the moment.

     

    You can achieve what you want but you need to check it very carefully before you demo it.

     


    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