Content-Level Build Tags

I'm converting a RoboHelp for Word project (.hpj), in which I
heavily employed conditional build tags at the topic and
content-level, to a RoboHelp HTML project (.xpj). Unfortuantly,
after the conversion my conditional build tags were missing (did
not appear in the Project folder of the .xpj).
I checked the knowledge base and found technical note
:9722oFeb6, and as the technical note instructed, I manually enter
the conditional build tag titles into the rhbuildtag.apj, but this
only resolved the issue at the topic level. I'm still missing the
content-level references. Any clue what I'm doing wrong?

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

Similar Messages

  • 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

  • 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 - 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

  • 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

  • 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 and Baggage Files

    Good afternoon
    I have a project where I need to produce two outputs - one
    for the internet and one for our intranet. I have applied
    conditional build tags to the topics that I don't want displayed on
    the internet however, the topics with baggage files attached still
    show up - I can't figure out how to apply a cbt to these files. Can
    someone help me please?
    Thanks

    HI Leapy.
    OK I think I have got to the reason why your CBTs are being
    included. If you have them at the topic level, they are exlcuded.
    If you have them at the topic contents level they are included. Do
    a right click on the CBT in the project tab and select the
    "Properties" popup menu item. You will probably find that the tags
    show up at content level. If you change these to be at topic level
    you should be OK.
    BTW if you are using merged webhelp there is a known problem
    with links failing. Peter Grainge has covered this, and the
    workaround, very well at his site. Click
    here
    for more details.

  • 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

  • Error in content level mapping

    Hi Gurus,
    I designed star schema in that when as a standard practice (for making report performance faster) . I searched threads in forum and everything as defined i have done still I am getting errors.
    1) I am setting content level agg. of fact for their based dimension then I am getting error in consistency check as
    '[39008] Logical dimension table Dim_xyz has a source Dim_xyz that does not join to any fact source.'
    , what i should do more for this ?
    2) If i define content level mapping in dimensions for its same column like date for time dimension then i get error message as
    '[nQSError: 14031] The content filter of a source for logical table: Dim_xyz references multiple dimensions.'
    3) Also as we know fact table contains only measures and foreign keys of dimensions so why do i get error in consistency check as '[89001] The Physical Table '"Fact_xyz"' has no keys defined.'
    I am fed of these stupid errors as why does not obi server understand that this is fact table. When I saw prebuilt rpd i did not find these types of error there.
    Thanks for your instant reply,
    Amol

    Hi,
    The scenario I am trying to test is a multi mapping scenario where I am trying to split one source message and create two target messages by using two different receiver interfaces, one for each message.
    I am on PI 7.1 and when I test message mapping and operation mapping using the payload from SXMB_MONI, it is successful. Whereas when I test the scenario end to end I am getting the following error messages:
    Operation Mapping
    Employee_Out_SI_To_Employee1_In_SI_AND_Employee2_In_SI_OM
    Name
    Employee_Out_SI_To_Employee1_In_SI_AND_Employee2_In_SI_OM
    Namespace
    http://accenture.com/1:N_multi-mapping
    Runtime error
    Split mapping created no messages
    Start tag ns0:Messages Add raw attribute xmlns:ns0="http://sap.com/xi/XI/SplitAndMerge" Start tag ns0:Message1 Close tag ns0:Message1 Start tag ns0:Message2 Close tag ns0:Message2 Close tag ns0:Messages
    Could someone please help
    Cheers,
    S

  • 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

  • Switching off conditional build tags

    I now have quite a few conditional build tags in my RH7 project and it's getting a bit difficult to see what's what in my topics as they are covered in coloured hash lines. Is it possible to switch off the view of individual tags? For various jobs I need to see certain ones but not others.
    Also, can I just check that I am using them right?
    Our software has web and windows versions so I have a 'Web' tag and a 'Win' tag for where the content differs and I create different outputs for each.
    Within the web version, we now have 2 different sets of customers who each need slightly different content and different names/logos etc. So I have created 'Customer X' and 'Customer Y' tags as well as 2 separate tables of contents. So in places, I have text which has 2 tags on it, 'Web' and 'Customer X' or 'Customer Y'.
    Does this sound ridiculous? Is there a better way?
    I know I could have used user defined variables for the company names but I would still need the cond build tags for the content so figured it would keep it simpler just to use tags.
    Helen

    Hi there
    Sorry, no way to turn off individual tags. You can turn off the shading if you like.
    Click View > Show > Conditional areas.
    You might also consider submitting a wish form to ask for this type of functionality to be added to a future version.
    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

  • In RH9, random conditional build tags appear within topic text

    I have assigned conditional build tags to text within a topic. After closing the topic and re-entering at a later time, other (additional) text now has the conditional build tag assigned as well. However, I did not assign the tags to those other sections of text.
    I do not have any trouble assigning a conditional build tag at the topic level. The issue only occurs when a tag has been assigned to text within a topic.

    There is another thread running on this. See http://forums.adobe.com/thread/58834?tstart=0
    I am locking this thread so that all replies go to the one above.
    See www.grainge.org for RoboHelp and Authoring tips
    @petergrainge

  • Do you know why the span style="color: Transparent;" build tag is set in topics as if by magic?

    Hello,
    We are using Robohelp 9 - 9.0.1.232
    It happens that some topics contain the <span style="color: Transparent;"> build tag.
    It seems that RH9 sets this tag by its own. We do not manage such tags.
    We come upon this while viewing one of our compiled CHM files. There was a big empty space inside a paragraph.
    We opened and found that the text was present. Using the HTML view, we discovered that the empty space in the CHM file corresponded to a paragraph included in the <span style="color: Transparent;"> build tag.
    For example, this morning, looking at a topic of another CHM file, we found When the tool runs,. The rest of the sentence was included in a <span style="color: Transparent;"> build tag.
    This is extremely annoying, as we do not know that this tag is set, until we discover it. We ar elikely to deliver doc with missing information without knowing it, until a customer complains.
    Has anyone encountered this or has an idea about this? How can we prevent RH9 from setting this tag?
    Thanks for your help

    Hi there
    First, let's get a bit clearer on our terminology, shall we?
    What you are seeing is not a "Build Tag". Sure, the Span indicates a tag and it's there when you build, but a "Build Tag" is a special tag inside RoboHelp that you apply to specific content that you wish to omit from the build using a counterpart known as a "Build Expression".
    A Build Tag in RoboHelp looks like this:
    <?rh-cbt_start condition="InProgress" ?>New model coming<?rh-cbt_end ?>
    What you are reporting is an inline styling element.
    Is this a project that began life in RoboHelp 9? Or was it created in an earlier version and was upgraded along the way? Does the same thing occur with a totally new topic you create?
    Cheers... Rick
    Helpful and Handy Links
    RoboHelp Wish Form/Bug Reporting Form
    Begin learning RoboHelp HTML 7, 8 or 9 within the day!
    Adobe Certified RoboHelp HTML Training
    SorcerStone Blog
    RoboHelp eBooks

  • 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.

  • 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

Maybe you are looking for