Skip to main content
E
elisef94358195
Participating Frequently
September 28, 2015
Question

Single sourcing question

  • September 28, 2015
  • 1 reply
  • 464 views

Hello, I am not a Robohelp expert, but I’m working on 3rd party online help that they created with Robohelp. I’m editing and adding to it using the experience that I have.

My question is about single sourcing. I received two help projects from them: One is “global” help, which is one big project that contains all the help files. The user clicks the help icon and gets a TOC and all the help is searchable. The other project is “page level” help, which is context-sensitive help where each topic is directly linked to each application page in the UI. These are entirely separate help systems that contain very similar content, sometimes identical. However, they do not share any files. In fact, the names of files with similar or the same content have different file names.

As you might imagine, maintenance is a chore with having to make the same edits to two set of files. I would like to share files between the help systems (with the 3rd party approval). I am trying to keep everything in one project and  perhaps use condition tags to include/exclude topics. I’m not clear though on how to proceed. Should building the project with the separate conditions produce a project that only uses the files that are included?  I am using Robohelp HTML versions 11 on Windows 7.  Thanks.

This topic has been closed for replies.

1 reply

Captiv8r
Captiv8r
Braniac
September 28, 2015

Hi there

Indeed this is a perfect use of conditional build tags. I might suggest an experiment for you.

Make a backup copy of each project for our dear friend Justin. (Justin Case).

Now create a folder for the CSH topics.

Create another folder for the other topics.

Then import all of the CSH topics into the folder. Note that there may be other folders inside. If so, don't forget those!

Now move all the other topics into the other folder.

Now open the Conditional Build Tags pod and create a two tags. Perhaps call one "CSH" and the other "Basic).

From the Project Manager pod, right-click the CSH folder you created and apply the CSH build tag. (this is an easy way to tag all topics inside the folder)

Right-click the folder with the Basic content and apply the Basic tag.

Now, when you choose to build out the project, you edit the SSL recipe card and if it's WebHelp, expand the Content Categories area and choose the Category you are using and click where it says Define to the right of the Conditional Build Expression area.

Choose to exclude the unwanted tag. Click Save and Generate and you should be set.


Cheers... Rick


    E
    elisef94358195Author
    Participating Frequently
    September 28, 2015

    Thanks for your quick response, Rick. I will try out your suggested process.

    Elise

    E
    elisef94358195Author
    Participating Frequently
    September 29, 2015

    Hi Rick,

    I conditioned the files for both CSH and Basic, but when I generate either one, I end up with a blank screen for output! Any ideas where I'm going wrong?

    Thanks,

    Elise

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