RH 11: Conditional Build tags applied: Content still showing up in search

Hello. I am generating WebHelp using conditional build tags using RH 11.
I have marked books in the TOC with a CBT of Not in 6.1.
I generated help and excluded content marked with the CBT Not in 6.1.
When the Web Help is generated, the books marked with the CBT do not display in the TOC. However, if I do a search, topics that are under the books and therefore should not be included in the output have search results returned.
Is there a scenario in which topics that have been excluded from the generated help would still show up in search?
Your help is greatly appreciated.
Jenny

Hi Jenny
Indeed there are a few reasons this may happen.
First, simply excluding a topic or a book in the TOC simply makes sure that the TOC doesn't have a link pointing to the topic. Normally, I'll just tag the topic itself and ignore tagging the TOC. If a topic has been excluded, it won't appear in the TOC.
In the WebHelp SSL recipe, click to expand the Content Categories section and look at the settings on the right. You might try ensuring the following option is enabled. It's named Exclude Unreferenced Topics from Output. As long as nothing else is linking to the topic, ensuring it is removed from the TOC *SHOULD* cause it to no longer be included.
Cheers... Rick

Similar Messages

Conditional build tags applied to topic but it still displays in my TOC?

I have applied topic level conditional build tags to topics.
The corresponding books are still being displayed in my TOC. I
checked the 4 topics and the condition is applied at the topic
level. What am I missing here?

Hi Renee
If I recall correctly, you were also using Conditional
tagging on almost everything in the TOC too.
It's worth noting that:
1. Sometimes the tagging will conflict and you won't get the
results you were expecting
2. Any topic inside a book should disappear if you are
tagging at topic level. But the book will remain if at least one
topic linked to a page inside the book wasn't excluded and remains.
Cheers... Rick

Apply Conditional Build Tags to Index Keywords?

My client has a bespoke module for a specific customer in
their software. There is a common Help Topic with conditional build
tags applied to content, so that one Layout is for the standard
product, and the Help excludes all mention of the bespoke material,
and the other layout includes text on the bespoke module. This
works well, except for the Index Keywords for the bespoke stuff,
which still appear in the Index for the standard Help Guide.
Any ideas anyone? How do I tag index keywords so they are
excluded from a defined Layout?

Thanks Peter, So that's what they're for!
(I don't know if you ever used ForeHelp, but the Index tags
were inserted immediately next to their tagged text, so that they
were automatically included within the boundaries of the
Conditional Build Tags. This also had the benefit that when
exporting to Word, the Index at the back gave reference to the
actual page number, not the page number of the beginning of the
topic. Quite useful; I was thinking along those lines...)
Regards

Conditional build tags with character styles and ignored text

RoboHelp HTML v8.0.2.208
Windows XP Professional Version 2002 Service Pack 3 with 2 GB of RAM
Output: WebHelp and HTML Help
I have recently moved my projects from RH HTML X5 to RH HTML 8 and this is when the following problem appeared. I use lots of conditional build tags within the help projects. Some of these tags are for my own use for reference and I combine these with character styles containing a coloured background (highlight) so that they show up in the WebHelp or HTML Help output (e.g. text to identify the software version that the field/feature/text was added, reminders to check details, insertion of bug ID numbers, design document names, etc.). These areas of text are stripped out of the final build for customers by using a conditional build expression.
What I have noticed is that if a paragraph contains text with a conditional build tag applied AND that tagged text has a character style applied AND an unknown word within the conditional build tag is ignored (with the HTML tag <?rh-ignored text="word_to_be_ignored" ?>), saving the topic, closing it, then re-opening it shows that the conditional build text has stretched to the next conditional build tag, or to the end of the topic if there aren’t any other conditional build tags. This also happens by switching from Design View to HTML View. Note that this doesn’t happen if Ignore All is applied to the unknown word.
This doesn’t just apply to projects converted from RH X5. I created a new test project in RH8 and the same behaviour was observed. Similar behaviour occurred very occasionally in RH X5 but that seemed to be down to HTML tags being nested incorrectly.
The largest project contains around 1200 topics and with many hundreds of conditional build text areas this now causes a problem. I’ll probably have to locate every ignored word in an area of conditional text within each project, set it to Ignore All and then manually remove and re-apply the conditional build tags, unless someone can come up with something clever. Can anyone else replicate this and should it be logged as a bug?

Hi Daggins,
Thanks - that is good info to have. But as we all agree, that does take away from the point of single-sourcing.
You aren't misunderstsanding exactly... I am doing all my conditional tagging in FM and it works like a charm in terms of the PDFs that I generate from FM, and even the conditionally tagged text in RH shows/hides correctly. The issue is I am also importing my index and TOC from FM... and even if I have an entire file in FM tagged as conditional (all the text is tagged as conditional, I don't know if you can tag a file as conditional), the file name as a heading it still appears in the RH TOC. There is no text... but in my view it shouldn't appear in the TOC either (it looks like just a broken link when I generate my online help) - this is not ideal.

Conditional Build Tags Bug

I have several problems with RoboHelp9. I am using Windows7 and 64bit. This is the one causing the most trouble.
Conditional build tags apply themselves unwanted and unassigned.
The deletion of conditional build tags at the topic properties tag (right side window) does not work.
I have to repeatedly go back and forth to the dialog and keep selecting and deleting.
Some of the conditional build tags go clear, most don't.
I go into the topic directly in the wysiwyg view and manually try to select and delete them, and they delete only with difficulty.
After running through a long topic and using every method available to clear conditional build tags, I saved the project, then went in to manually apply cbtags, of which I am only using two.
After applying them, and switching to the html window to adjust image sizes manually (because thru the wysiwyg interface the process takes too long), I find that the conditional build tag I applied to several tables and texts at the top of my topic have now applied themselves unasked to a number of the texts and even tables which I had cleared of all cbtags.
I have just about had it with this program.
This is only one of the many problems and bugs I have found and been trying to work around.
I suppose that the solution to my problem is to not use conditional build tags at all, but I am working with about five years' worth of legacy technical documents that have all been upgraded to RH9 and as I am looking at them to make the standard revisions, I am noticing this phenomenon of wrongly applied cbtags in other projects.
I would rate this as a bug of very high and critical importance.
Has anyone seen this under the consitions stated? (RH9, upgraded RH7 projects, Windows7, 64bit).

Sorry, I should have said see the Announcements.
http://forums.adobe.com/community/robohelp/robohelp_general_discussion
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Conditional Build Tags + Image Map + Popup Doesn't Work

For RH build X.5.0.2, I have images in some topics and a
conditional build tag is applied to those images. The images have
image maps drawn on them and those image maps launch popup topics.
Everything worked fine until I added the conditional build tag
--even though I'm not applying the conditional build tag when I
compile. Now when I click an image map, on an image that has a
conditional build tag applied (though not compiled) nothing
happens.
Can anyone help?

Did you apply the conditional tag before, or after you
inserted the image maps? Are there different results for the two
approaches?
Harvey

How to apply conditional build tags to the topic title that is displayed in Search tab of CHM?

I have the project in which 2 different words are used to reffer to one objects (this word/term depends on the customer). All other information related to functionality, steps, etc. are common. So:
In the help content (body of the files), I created 2 conditional build tags (CBT) for these terms.
In TOC, if topic title contains the term, I created 2 different topics reffered to the single topic file, but the title of the topic shows correct term (depends on CBT).
File names of this topics contain only term1.
The problem occurs when I generate CHM for CBT2 and search for the term1 (marked with CBT1) using the Search tab. All occurrencies where term1 presence in the file name, appear in the found results.
How can I resolve the issue?
These topics must be found by search (that's why "Exclude from search" option is not a decision).

Ahhh, you are correct. I believe it was Version 10 introduced that.
So here's what I'd suggest. Even though you are unable to use a variable in a Topic Title, it can still be used in other places such as the TOC, the Index and in the Topic content. So I'd still recommend that you declare and use a variable for those items. Just to simplify things.
As for any topics that have the term in the title, you could create two topics. One with the term one way and the other with the term the opposite way. Then use a Conditional Build Tag to exclude and remove the one that shouldn't be found.
This may cause you a bit of a maintenance issue by having the same topic content in more than one place. (one for each topic)
So to overcome that, you would be able to add the main body information to a topic and use an Inline Frame in the two topics that would then simply be shells with appropriate Topic Titles. Either that or declare a snippet and use the snippet in both topics. Put the main part in the snippet.
Cheers... Rick

Topic and content level conditional build tags

What is the difference between a topic level and a content
level conditional build tag? Why would you select one over the
other? How do you select one over the other.

First let me point out that the same conditional build tag
can be applied at either the topic level or the content level. It
sounds like you may be thinking that you have to create a tag as
for either the content or topic level.
Apply a tag at the topic level when you want the entire topic
excluded from a certain output. Do this by right-clicking on a
topic in your Project Manager, going to Apply Conditional Build
Tag, and selecting the tag.
Apply a tag at the content level (text, images) when you want
the topic to be included but want specific content to be excluded
from a certain output. Apply a tag at this level by selecting the
text and/or images that you want to apply the tag to,
right-clicking, going to Apply Conditional Build Tag, and picking
the tag.
Note that you wouldn't use a tag at the topic level on a
topic where you have used that same tag at the content level, and
vice versa.
Generally, the idea of build tags is to set an output to
exclude certain tags, but you can also set outputs to include tags
instead, which then excludes all other tags.
--Ben

Conditional Build Tags - Problems when generating content

Hi,
Just wanted to print 4 pages of a long help project so I added conditional build tags called 'ad-hoc' and created a Printed Doc SSL where ad-hoc was the conditional build value.
When I generate the document I am getting everything still though. Am I being particularly thick today?
I tried tagging everything 'online' and then adding the ad-hoc tag to the pages building the condition as 'online' AND 'ad-hoc' but then got nothing.
Help appreciated as ever.
Nick.
@Tompsk on Twitter.

I don't think the One Off Print tag is needed. If you apply Generic to all topics, then remove it from a few before generating online help with NOT GENERIC applied, you will get only the topics from which you removed the tag. No need to apply another one.
If you wanted to print, then forget tags, just have a print layout where you only select those topics you want in.
Print works the opposite way to online. Print you have to include, online you have to exclude.
See www.grainge.org for RoboHelp and Authoring tips
Follow me @petergrainge

Text coded with conditional build tags still showing up in TOC even if tag is "excluded"

I am using TCS2, Windows XP.
After creating a book in FM and coding with conditional build tags, I imported into RH. When I generate, I have the output tag set:
NOT NoOUtput AND NOT Internal AND NOT Print - I want to generate my External, Online Help webhelp. And it works like a charm. Except that:
In the TOC, I can still see headings for things that are "internal" - when I click on it, they don't go anywhere... but I don't want them to appear in the TOC!!
It seems to be excluded from the index and the search. I am sure I am just missing a step or something...
In looking through the forums I found this... http://forums.adobe.com/message/751847#751847 -- I don't know if it is still applicable since it seems to be referring to RH6 (which is a bit away from RH 8 that I am using)...
Any help is appreciated!
TIA,
Adriana

Hi Daggins,
Thanks - that is good info to have. But as we all agree, that does take away from the point of single-sourcing.
You aren't misunderstsanding exactly... I am doing all my conditional tagging in FM and it works like a charm in terms of the PDFs that I generate from FM, and even the conditionally tagged text in RH shows/hides correctly. The issue is I am also importing my index and TOC from FM... and even if I have an entire file in FM tagged as conditional (all the text is tagged as conditional, I don't know if you can tag a file as conditional), the file name as a heading it still appears in the RH TOC. There is no text... but in my view it shouldn't appear in the TOC either (it looks like just a broken link when I generate my online help) - this is not ideal.

Conditional Build Tags for Text Blocks Applied to Entire File

RoboHelp 8.0.0.203. This post also deals with conditional build tags, but in this case the conditional build tags have been associated with sections of text and text blocks within a topic. The design was implemented originally in RH7 and the project has since been updated with RH8.
For example, you could have three blocks: Purpose, Procedure, Tips, and a Notes block. They are disabled by applying blocks Tag A, Tag B, Tag C, and Tag D respectively. If Tag A is applied to the Purpose, it is cross-hatched in the design window and does not appear upon generation.
The problem is that tags that are seemingly unrelated to blocks, such as Tag C and Tag D, are spontaneously applied to those blocks -- by the software. In fact, they would be spontaneously applied to all of the blocks and text in a some of the files (for no apparent reason), cross-hatching every element and every block of text in the file. When we unapply the tag and store the file, when we re-open the file, the tag is mysteriously re-applied to all the blocks -- again by the software.
Has anyone seen this type of problem in RH8?
Below is further detail about the problem
An example of how tags shold be applied involves a block involving three banners
<div class="banner">
     <?rh-udv_start name="Banner A" ?>BANNER A NAME<?rh-udv_end ?>
     <?rh-udv_start name="Banner B" ?>BANNER A NAME<?rh-udv_end ?>
     <?rh-udv_start name="Banner C" ?>BANNER A NAME<?rh-udv_end ?>
</div>
Under normal conditions, an associated tag would be applied to "unselect" two classifications, thus selecting the third by default. This is done by highlighting the associated banner, right-clicking and selected the "UnselectedBanner" tag, Below, banner C is selected by unselecting Banners A and B. T
<div class="banner">
     <?rh-cbt_start condition="UnselectedBanner"?>
     <?rh-udv_start name="Banner A" ?>BANNER A NAME<?rh-udv_end ?><?rh-cbt_end ?>
     <?rh-cbt_start condition="UnselectedBanner"?>
     <?rh-udv_start name="Banner B" ?>BANNER A NAME<?rh-cbt_end ?><?rh-udv_end ?>
     <?rh-udv_start name="Banner C" ?>BANNER A NAME<?rh-udv_end ?>
</div>
The <?rh-cbt_start condition="UnselectedBanner"?> indicates that the section is de-selected.
Note, that the "<?rh-cbt_end ?><?rh-udv_end ?>" are in opposite order in the example (but that's how it appears in the file).
In the cases where this problme occurs, we the html riddled with "Tag D" and "Tag C" condition tags for all the elements.
<?rh-cbt_start condition="Tag C, Tag D"?><div .......     </div><?rh-cbt_end ?>
I cannot attach any files because these files are on a classified system.
Thank you much.

Hi Tammy
It will also be helpful if everyone that encounters the issue reports as a bug. It's like a voting system. The more reports of bugs that are seen, the more weight is given to the priority. This directly translates to the fix being posted sooner rather than later.
So even though the bug has been "reported", you and others should take a moment and report as well!
Cheers... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7 or 8 within the day - $24.95!
Adobe Certified RoboHelp HTML Training
SorcerStone Blog
RoboHelp eBooks

Apply Conditional Build tag to Browse Sequence

Hi Everyone-
I'm trying to control 6 conditional builds in one project. I
have 6 working indexes and TOCs using build tags. I was wondering
if there was a way to apply tags or somehow conditionalize the
browse sequences. I'm running RH7.
Thanks in advance!
Wendy

Hi Wendy:
It seems you are having the same problem that I did. I have
different User Guides however some of the Guides may have the same
procedure. I was trying to setup the search so only one of the
topics would return on the search and not 3 of them. I found
something that actually had to do with RoboHelp x3 but I applied it
to RoboHelp x5, where you need to do the following.
Create build TAG1 - this is for the ones you do not want
search to return.
Create build TAG2 - this is for the ones you do want the
search to return.
Apply the tags accordingly to each procedure accordingly.
Make copies of the following files in the WebHelp directorys
just incase:
Folder WHDATA:
whftdata0.htm
whwdata0.htm
Folder WHXDATA:
whftdata0.xml
whfwdata0.xml
Folder WHGDATA
whlstf0.htm
GENERATE PRIMARY LAYOUT (This should be set to Webhelp)
1. Define the Conditional Build Expressioin to exclude topics
that are not wanted in the search:
A. Click the Define button.
This wil bring up the Define Conditional Build Tag
Expression dialog.
B. Click the Advance button.
C. Click the Not button.
D. Select TAG1 from the drop-down list of Available
Conditional Build Tags.
E. Click the Add Tag button.
F. Click OK
G. Select your WebHelp Options, and then click Finish.
When you pull up your test or Dev site and perform a search
you should only come up with one topic. I just finished this and it
worked. Also, as a reminder I am working in x5 and not x7.
Good Luck,
Amy

RoboHelp applies Conditional Build Tags

Has anybody else had this problem?
It seems that RoboHelp (version 7) applied the Conditional
Build Tag on its own to various topics. Is there anything I can do
to prevent that in the future?

Salladep has now posted the same issue at http://forums.adobe.com/message/5177045
This is puzzling as it was a known issue in Rh8 until fixed and, as above, until these posts no one else has hit the problem with 8 or 9.
pmacbean has not replied so I don't know if what was suggested worked. Try what I have suggested above and let us know whether or not it works.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Quotes conditional build tag

I am using Office Word 2003 and Robohelp 7 for Word and I
need to apply conditional build tag to document contents.
I’m compiling the help for Microsoft HTML help but
opening the chm file I can still see the following text (in a small
font) at the place of the conditional text removed:
I tried to change the font/size/colour of text and marker but
it doesn’t help.
My text is in Italian language.
I tried to compile for WinHelp layout, but characters
‘’‘’‘’ are still there, in the
middle of my page.
Any idea?

See Build Expressions on my site.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Conditional Build Tags Bugs

Hello,
I have problems with Conditional Build Tags since I upgraded from RH7 to RH9 .
I am using the following software:
Windows XP Professional Version 2002 Service Pack 3.
Version control software (RoboSource Control 3.1) as we share projects between 3 authors
And I mainly work in wysywyg view.
When I open a project on my PC, the conditional build tags I've defined in a topic apply themselves unwanted and randomly.
The deletion of conditional build tags from the topic Properties > Advanced tab > Content-level tags > Remove button does not work properly. The selected tag is removed only for the paragraph pointed by the mouse cursor. When I navigate down in my document, this tag is still present on other paragraphs.
Sometimes, I must switch to the html view to remove the tags manually.
I noticed that a thread has seent on May 5, 2011, for which Peter Grainge gave a link to a TechNote with a fix. I tried to access this TechNote, unsuccessfully.
I also read that Adobe RoboHelp Service Release 9.0.1 is intended to fix the following: CBT gets applied randomly in topic content on switching between the HTML view and the Design view in certain scenarios.
However, my scenario is completely different as CBT gets applied randomly when OPENING the project in WYSYWYG.
Moreover, my administrator told me he has already downloaded this release.
With single sources, our team produces online helps for various versions and products. This situation is very uncomfortable for me, and my colleagues, as the produced documentation may contain bad information for a version or a product or may miss information. My work is not reliable.
Has anyone encountered this situation and found a solution?
Thanks for your help.

Hi Peter,
Thanks for your help.
Effectively, the patch was not installed.
I ran the update and did not need any passwords to do it. The About RoboHelp HTML now shows 9.0.1.232. However, the version of the PolarisProjectFile.dll still shows 9.0.0.228. Is this normal?
The IT administrator is sure to have downloaded this release. He thinks something got wrong during the downloading process and that it failed.
This release solved some of my problems:
I opened again the projects in which I identified that tags were messed up.
- For some, tags were still messed up. I had to fix them again manually. I checked them in and re-opened them. They were clean.
- For others, they re-opened with tags properly assigned (miraculously).
I do not understand these differences in behavior.
I do not feel confident when I open a project. We manage so many topics that it is impossible to identify those in which tags are messed up. How can I be sure that tags are correctly assigned? It is so an uncomfortable situation !
Moreover, I identified another problems yesterday.
I wanted to open a project that another member of the team upgraded to RH9 last week. RH9 proposed me to upgrade it.
A member of the team wanted to open a project that I upgraded on my PC. RH9 proposed her to upgrade it.
We removed these projects from our local directories and used the Open project from Version Control again. And it was OK.
This situation should not occur. What do you think?
The other members of the team have the patch 9.01.232 (and the same version of dll as me).
The IT thinks that these problems are linked with my user account.
Historically, Windows XP was installed in French on my PC whereas my colleagues were in English.
As I had so many problems after upgrading to RH9, my Windows XP is now in English.
However, I keep having problems (those mentioned in this discussion).
The solution proposed now is to change my machine for a new one.
Could this be really the final solution?
Do you have any opinion on this matter?
Thanks for your help.

RH 11: Conditional Build tags applied: Content still showing up in search

Similar Messages

Maybe you are looking for