Skip to main content
K
kmaddox1
Inspiring
June 29, 2010
Answered

adding links between two SSL outputs from the same project?

  • June 29, 2010
  • 1 reply
  • 1057 views

I suspect this question has a simple answer, but I want to confirm my approach before I get too far along. I am entering hyperlinks between projects in a merged help system and want to know if there are issues with linking to files in the Generated folder instead of to files in the Source folder.

Specifically, I followed Peter Grainge's very helpful instructions to create a merged help system with one parent and 12 children. Up until now, all the cross-project links have been between files in the Source folder, and they work great.

Now, I have generated two different WebHelp systems from one of my child projects (that is, the X User's Guide and the Z User's Guide). Since both projects use the same source files, I'm not sure how to format links between the two systems. What I'm seeing is that if I link from an "X" topic to a "Z" topic in the Source folder, the "Z" topics appear with the X conditional build tag applied, which is not what I want. It does work if I create links that go directly to files in the Generated folder for the Z User's Guide, but I'm not sure if there are issues in setting up the links that way. Before I commit myself to taking this approach, are there any gotchas for creating cross project links that go to the generated files? Or is there a better way to achieve my goal?

This topic has been closed for replies.
Correct answer Amebr

Just to clarify your setup.

Source

Parent project

---Child 1

---Child 2

---Child 3

---Child 4

Output

Parent project

---mergedHelp

------Child 1

------Child 2

------Child 3a

------Child 3b

------Child 4

Is this correct?

If so, it might be possible to handcraft the relative links.

The link between Child 3a and Child 3b should look something like this - working from the output location, but maintaining the general relativity ():

../Child 3b/myfile.htm

(I think it translates as 'up to mergedhelp', 'down to child 3b'. But you'll have to play around a little bit depending on your folder structure.)

I think it will show up as a broken link, or result in an annoying warning, but it should work. Or RH will "fix" it for you. I'm sure Peter will jump in with further information at some point.

Amber

1 reply

Captiv8r
Captiv8r
Legend
June 29, 2010

Hi Kathy

I suspect our dear friend Peter is about to retire for the evening seeing as how it's now 10:16 PM where he lives. So here's my own take on things unless he's awake and pops in.

Any time you create links in RoboHelp, the RoboHelp editor attempts to create them in a "relative" manner. When links are created this way, things just work when you begin copying all the files from your development PC to the server. So assuming you are working as I believe Peter recommends, you have all sibling projects at the same level. For the sake of argument and sheer simplicity, I'll make the assumption you are linking between topics at the project root level. In this case, the link would need to traverse up one folder level, then drop into the sibling folder and link to the desired topic:

Master Container

>> Child 1

>>>> Topic 1.htm

>> Child 2

>>>> Topic 1.htm

../ takes us up a folder level into Master Container. Child 2 is the new folder and Topic 1 is the topic. So our link looks like this:

../Child 2/Topic 1.htm

Now if you link to the topic in the output, you are probably going to create a link that looks like this in the end:

!SSL!/WebHelp/MergedProjects/Child 2/Topic 1.htm

That will likely fail miserably in the end.

I'm pretty sure Peter will agree that linking within source is the way to fly. Personally, I think you are seeing a red herring with the CBT things going on.

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

SorcererStone Blog

RoboHelp eBooks

K
kmaddox1Author
Inspiring
June 29, 2010

Hi Rick,

You are exactly right in how the two different links are appearing in the HTML. I was hoping there wouldn't be problems linking to topics in the generated output. I wouldn't ordinarily do that, but I'm not sure how to get around the CBT things I'm seeing when I create links between topics in the Source folder. My issue may be completely attributable to operator error/misunderstanding since I'm just coming up to speed with conditional build tags and variables. Here's what's happening:

I'm using one set of source files to generate two WebHelp systems (ABC User's Guide and the XYZ User's Guide). Both guides share most of the same files, and I've been able to control the few minor differences with my ABC and XYZ conditional build tags and user variables. So far, so good. The problem arises when I try to create links between the two help systems. For example, in my "Application Basics" topic (same file used for both outputs), I want to create two links:

  • A link that ABC users can click to access the XYZ User's Guide.
  • A link that XYZ users can click to access the ABC User's Guide

While I have no problem showing and hiding the links themselves when I generate the two help systems, it appears that the ABC conditional build tag is still being applied when the XYZ topic is displayed and vice versa. That is, users are not actually going to the other help system.

The only way I've figured out how to make this work is to link directly to the appropriate topic in the Generated output. But perhaps I'm missing something obvious?

A
Community Expert
AmebrCommunity ExpertCorrect answer
Community Expert
June 30, 2010

Just to clarify your setup.

Source

Parent project

---Child 1

---Child 2

---Child 3

---Child 4

Output

Parent project

---mergedHelp

------Child 1

------Child 2

------Child 3a

------Child 3b

------Child 4

Is this correct?

If so, it might be possible to handcraft the relative links.

The link between Child 3a and Child 3b should look something like this - working from the output location, but maintaining the general relativity ():

../Child 3b/myfile.htm

(I think it translates as 'up to mergedhelp', 'down to child 3b'. But you'll have to play around a little bit depending on your folder structure.)

I think it will show up as a broken link, or result in an annoying warning, but it should work. Or RH will "fix" it for you. I'm sure Peter will jump in with further information at some point.

Amber

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