Archiving Documents Using Conditional Build Tag

I'm looking for suggestions to resolve a problem I've encountered this week.
Using information from a post by Rick Stone, I was able to create a CBT (Exclude_from_Search) that, when applied to a topic, removes that topic from the published Search results. This work fine on a small Project that I tested it out on. I'm now trying to apply this same technique to a large Project, only to continuously get booted out of RoboHelp completely.
Any thoughts or suggestions on another way to keep archived documents in RoboHelp but out of the published intranet findings?

Hi again
So RoboHelp closes down when you attempt to apply the tag? Or when you attempt to generate output using an expression that would exclude the tag?
Also, one of your posts said "see attached", but nothing was there to see. Were you trying to upload a screen capture? If so, use the Camera icon.
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

Similar Messages

Can I use conditional build tags in CSS files?

I am using RoboHelp X5.0.2 and building CHM files.
I use conditional build tags to output different Help files
for the different products we have that all have similarities.
In the past I have setup the CSS file to show headers, links
etc in the color scheme we use to keep the look and feel of our
branding. One of the new products uses a different branding color
scheme.
I was wondering if there is a way I can use conditional build
tags in the CSS file so that when I build one type of help it uses
header in one color and when I build another help it uses a
different header color. Does anyone know how to do this? If it is
not possible in my current version, is it possible in the latest
version of Robohelp?

[WORKAROUND ALERT IN X502]
For .chm output, you could:
1. In the Topics pane, select all the topics (click on one
topic and press Ctrl+A).
2. Right click in the highlighted area and select Properties.
3. In the Appearance tab, select the different style sheet.
4. Click Save.
5. Generate the .chm file.
6. (optional) Repeat steps 1-4 to revert to previous style
sheet setting.
Good luck,
Leon

RoboHelp 6 crashes-Robo 5 project when using conditional build tags

Hi there
I had no build tags in my project, and it was an R5 project.
I just upgrated to R6. I need to use the tags & when I put a
build tag or two in the project on the topic level and compile it
and it crashes. Based on a prior thread (related to merged cells in
tables) I removed any merged cells I had in my tables and I was
able to replace them with table captions. I also tried to place the
build tag only on the folder level and only on the TOC level both
crashed. Unfortunately it still crashes when I compile it without
the merged cells in a table. I did create a brand new project and
test and I was in fact able to compile it.
My project was "somewhat lost" meaning I renamed it and then
compiled it and it didn't fully compile. Two folders showed up in
the compiled project, however all the folders were in the project
folder when I looked via explorer. I found the CHM file from prior
to renaming it and I decompiled it from that CHM file and
recompiled it with the hhp builder tool.
Any thoughts? PS. I am only a year using this product, so
please keep that in mind :)
Thank you Rebecca

Hi Peter
Thank you for the suggestion. I created a new project, new
folders, imported the files a few at a time & compiled it each
time (with one build tag in it) and found that only two files made
it crash. On the one file, I removed the tables (which had no
merged cells) from the project and it worked. The other file was
removed completly and I will re-do that page.
I then opened my current project (with all links &
pictures etc TOC working) and imported the changed file and removed
the other file and wala....I have a useable project.
The project was on our own software so unfortunately I would
not be able to share it.
Being a relativley new (1.5 yrs) user, I find running into
bugs are brutal....Thanks for all your help.

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

The extra space created due to Conditional Build Tags

Hello,
I am authoring a online help file, for a web application. As different content is needed for the 4 different roles of the user, I have used Single Sourcing option and made use of conditional build tags for the content that is not common among the different roles. I even have images which are difffernt for the differnt roles. I have used conditional build tags for these too. The problem is that, extra space appears in place of the images which are not applicable to build I am publishing. Is there any workaround other than modifying the HTML files to remove the extra space added?
Regards,
Deepti Korwar

hi Deepti,
I have seen this issue on multi-level lists (in RH9) when using soft returns (Shift-Enter) within the lists.
An extra space is added before images marked with CBTs. But this only caused problems in print.
Are you seeing this space on all outputs or just print?
Can you paste a code snippet from one of the offending list?
Perhaps you can get round this by opening up the HTML tab and carefully examining and perhaps moving the CBTs.
e.g. <?rh-cbt_start condition="xyz" ?><img src="xyz" > <?rh-cbt_end ?></p><?rh-list_end ?>
Will be helpful to see the code.
thanks
Craig

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

Conditional build tags with numbered lists

Hi, I am using conditional build tags to create a separate
version of our product help file for a cut down version of the
software. In our help instructions we use numbered tasks for
explaining how to complete a process.
Where some steps aren't required for the cut down version,
the numbering does not auto-update accordingly - is there a way to
resolve this?
Thanks
Richard.

Sorry I was talking rubbish. If this can be deleted please go
ahead.

Conditional Build Tags...weird behavior?

If I apply a conditional build tag to a topic from the TOC
tab, the topic gets included in the output even if I have specified
that tag to be excluded.
However, if I apply the same conditional build tag to a topic
from the Project tab, then the topic gets excluded (as expected)
from the output because I have specified that tag to be excluded.
Is this inconsistency in behavior by design? I looked at the
RoboHelp Help, and it appears there is nothing wrong with adding
conditional build tags to topics from the TOC tab.
Can someone shed light on this? I am using Adobe RoboHelp
HTML 6, Build 099.
Thanks,
K
P.S.: It appears RoboHelp is completely ignoring the
conditional build tags that I am adding to topics from the TOC tab.
If I see these tagged topics from the Project tab or the Topics
tab, there is no color shading for these topics. The color shading
for the topics shows only if I tag the topics from the Project Tab
or the Topics tab.

Here's a copy-paste from the RH Help...It didn't explain
things the way you did. :-(
Applying conditional build tags to Table of Contents
Use conditional build tags to design and create multiple
versions of your project from a single set of source files. After
creating the conditional build tag, you can apply it to both books
and pages in the TOC for maximum control over the final results.
From the TOC view, you can apply conditional build tags to Topics
also. When you generate a project, you can define conditional build
expressions to include or exclude the book or page in the TOC, from
the output.
Show Me
Use this procedure to apply conditional build tags to books
and pages in the TOC. When you exclude such a tag from your output,
the book or page in the TOC, is not included in the output.
To apply a conditional build tag to a book or page in the
TOC:
Option 1:
Create the conditional build tag.
Click the TOC tab to view the Topic list.
Select a book or page to which you want to apply a
conditional build tag.
Right-click and select Apply Conditional Build Tag, and
choose the Tag you want to apply. The tag is applied to the
selected book or page.
When you generate the project, you can define conditional
build expressions to include or exclude the tagged books or pages
in the TOC, from the output. (A TOC to which a tag has not been
applied, will be included in the output.)
Option 2:
Create the conditional build tag.
Click the TOC tab to view the Topic list.
Select the book or page to which you want to apply a
conditional build tag.
From the Format menu, select Apply Conditional Build Tag, and
then choose a tag. The conditional build tag is applied to the
selected book or page in the TOC.
When you generate the project, you can define conditional
build expressions to include or exclude tagged books or pages in
the TOC, from the output. (A TOC to which a tag has not been
applied, will be included in the output.)
To apply multiple tags:
From the Format menu, select Apply Conditional Build Tag, and
choose New/Multiple. The Conditional Build Tag dialog box appears.
Click Check All to apply all the tags, or select specific
tags to apply to the book or page in the TOC.
Click OK.
If your project is under version control, these steps may
include more options. Click here for more information.
Tips:
You can also apply conditional build tags to topics, topic
content, folders, and Index.
To verify the tags applied to topics, topic areas, TOC, and
Index, or rename a tag, or change the color of a tag, click the
Project tab, expand the Conditional Build Tags folder, and
double-click the tag. You can make the desired changes in the
Conditional Build Tag Properties dialog box.
Ensure that you remove textual references to the excluded
book or page, such as text links, which refer to the tagged book or
page in the TOC. (Hotspots are not active for excluded topics.)
If you generate Printed Documentation, TOC with Conditional
Build tags are not excluded from printing.

Conditional Build Tags Break Links

Hi all,
I have a solid, 3-years old, RHX5 project that works fine.
Delivering a part of it using
conditional build tags, I found out that some of links are
broken.
The topics configuration looks like this:
Parent topic - with a link to several
child topics
(many) Child topic(s) - each with a
link to the parent topic
Now, using conditional build tags, all of the topics go to
the main deliverable and are marked accordingly.
Some of the topics go to the secondary deliverable. This
includes the parent topic and some of the child topics.
So, the parent topic is marked with both tags, and the links
that point at topics that doesn't belong to the secondary
deliverable are tagged accordingly. This part works fine.
The links that belong to both deliverables are tagged with
both tags. Some of them - not all - are broken.
In these cases, a child topic exists in the deliverable, but
the link from the parent topic is broken.
I have deleted all links and written them anew. This did not
solve the problem.
Where elese should I look into?
Thanks in advance (please help the poor writer regain his
weekend :-)
Avi

quote:
Originally posted by:
Peter Grainge
It sounds like topics that belong to both versions, like the
parent, have both tags. I am wondering why they have any tag as you
only need a tag on a topic that you might want to exclude.
Hi Peter,
Until this project, I had two tags, when each topic belongs
to either tag A or tag B, and no topic belongs to both. (the reason
to this configuration was to keep everything on the same source,
when topics could move from tag A to tag B.)
Now, in the current project, I have a new tag, C. Topic may
belong to:
Tag A only
Tag B only
Tag A + C
Tag B + C
Tag C only - there are very few such topics (maybe 5 or so).
These topics are not problematic.
The problem of the broken links always occur among topics of
the type "tag A + C".
How do I proceed from here?

Conditional Build Tags for Framesets Using RH6

I am using RoboHelp 6. I have conditional build tags on some
topics within a folder and also on certain entire folders and these
are working nicely. In addition, however, I really would like to
add conditional build tags to two framesets in order to separate
this information so that each frameset is seen only by the
appropriate groups (just as it is in the regular topics/folders). I
am reluctant to even try to do so because if this is something that
RH6 doesn't allow I don't want to do something that will corrupt my
project. If adding conditional build tags is possible, then I need
to know where I add them: 1) to the frameset, or 2) to each of the
two topics that make up the frameset, or 3) a combination of the
frameset and the two topics.

Create a new project, import some topics from your existing
project and then attempt to do what you want. If it goes pear
shaped, no harm done.

Conditional build tags/expressions in the TOC

Hello all,
I've run into another issue with my conversion, this time with Conditional build tags and expressions.
All seems to be fine in my topics, but not in my TOC.
Some of my topic titles have words that have conditional text applied in the source FrameMaker document.
These topic titles also appear in the TOC that's automatically generated when I link my Frame book to Robohelp.
I set the conditional build expression in the Webhelp settings dialog and then Save and Generate.
These topic titles appear to pick up the correct conditional build expression in the topics themselves, but the TOC heading shows multiple conditions (including the condition I've set to "Exclude").
So, for example, if my topic title is
"Conventions in this documentonline help"
WHERE
document > should appear in PDF only
and
online help > should appear in Webhelp only
I can get the Webhelp topic to use the title "Conventions in this online help"
but the corresponding TOC heading looks like this:
"Conventions in this documentonline help"
Any ideas?
Thanks.
Sue

Conditional build tags are not imported to TOC from FrameMaker content. However, one can follow another approach to achieve this. One can manage the Conditional build expression in FrameMaker itself and import the filterted content in RoboHelp. Inorder to achieve this, set the conditional build expression in FrameMaker. Turn on the setting in RoboHelp to "Apply FrameMaker Conditional Text Build Expression". [File->Project Settings->Import->Edit(FrameMaker Settings)->Other Settings]
This way RoboHelp will import only the filtered content with Conditional Build Tags resolved as per the expression applied in FrameMaker.
Mayank

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.

Conditional Build Tags not present in HTML Help

I have opened a RoboHELP for Word project in RoboHELP HTML.
My conditional build tags are NOT transferred into the HTML
documents. I have entered the names of my build tags in the file
rhbuildtag.apj, so they are visible in the Conditional Build Tags
virtual folder (cf
http://www.adobe.com/go/97220fe6).
However, the conditional tags do not appear in the converted
documents. The version I use is X5.0.2. Is there any other solution
than applying all my build tags anew?
J. van Meggelen / Quadrant Software

Welcome to the forum.
Look in the meta tag section of your htm files to see if the
is any reference to build tags. Do a multi file search on <meta
name="build tags"
I think that will confirm that tag information is lost during
the conversion and I believe this has been posted before. Change
your search history period in your profile and poke around.
Sorry but I think it is the long hard slog.

Conditional Build Tags lost converting from X5

When I did a trial conversion of an existing RH Office X5 project to RH8 it lost all of the Conditional Build Tags. As the X5 project was made up of 29 Word documents with many tags it would be a big job to go through all of the topics and redo the work. The company for which I work supplies multiple software products using common forms and the wording for each product is different, therefore when I compile help for each product the Conditional Build Tags are very important. Is there any way that the tags could be retained when converting to RH8.

Thanks for the suggestion.
I have created all of the Conditional Build Tags and when I look at the
properties it lists the Topics that they are used in. Howver, when I look at
the properties of the individual topics the check boxes are all clear for
all Conditional Build Tags.
I have also noticed that none of the Content level conditionality has been
preserved during the upgrade. This is a major problem as it would take a
long time to go through all of the documents and re-apply the tags to text
and graphics. If I do upgrade is this something that I would have to do
manually?
I have upgraded to 8.0.2
Regards
Tony Champ

Archiving Documents Using Conditional Build Tag

Similar Messages

Maybe you are looking for