Merged webhelp project problem

Dear Sir,
my problem is with merged Webhelp project. the links to
external topics are not active in the master project, although
these links work fine in the HTML help output.
thanks.

quote:
Originally posted by:
Peter Grainge
What Ahlam may not be doing is allowing for the fact that
cross project links have to be created one way for webhelp and
another way for HTML help. The way to do that if both outputs are
required is using conditional tags.
Actually, my project was generated as HTML help project from
the begining but for some reasons I need to convert it to webhelp,
what I did is that I generated the whole project as webhelp. I did
not know that creating links in webhelp is different from HTML
help, if it is so, could you please tell me how.

Similar Messages

Merging Webhelp Projects

When merging two webhelp projects (in version 7), the
subtopic is opening in a new window and the indexes are not merged.
I looked it up in the help and there is a note at the bottom that
says: "Merging WebHelp/FlashHelp projects with a pure HTML master
project or Section 508 compliant WebHelp/FlashHelp causes the
subprojects to be available only from the TOC. Subprojects will
appear as a book in the TOC. Sub-project TOC books will open the
subproject in a new browser window." That is exactly what I don't
want to happen! I was able to do it in other versions easily. What
other options do I have? All the options on the Navigation Pane
Preferred Format tab includes PureHTML. Any advice will be
great!

There's a complete tutorial on my site.

Need guidance on upgrading RH5 Merged WebHelp project to RH8

I just upgraded from RH5 to RH8 to use with a new product my company is developing. I have quite a large merged help project that I have been editing and reorganizing. I have a version published and in use but I have an updated version about 75% finished. I would like to do in RH8. Is there anything I need to watch for or recommended method to upgrading each child and then the parent? Any help would be sincerely appreciated.

Hi there
There are two patches.
Help > Updates...?
Cheers... Rick
Helpful and Handy Links
RoboHelp Wish Form/Bug Reporting Form
Begin learning RoboHelp HTML 7 or 8 moments from now - $24.95!
Adobe Certified RoboHelp HTML Training
SorcererStone Blog
RoboHelp eBooks

Opening merged WebHelp projects

I currently have a project that I just converted to WebHelp (stand-alone, not merged). In addition, I have another projected that I converted; this is used as a "merged" project and is merged into one mentioned previously.
When I am in the stand-alone project and attempt to click a link to open a topic in the merged project, I am getting a second TOC. My question...is there a way to prevent a second TOC from appearing and just have the merged project topic appear in the frame like those from the "original" project?
Please see attached screen shot for a better idea of what I am referring to.
Thanks in advance for the assistance!

It must be because of the way you are linking to the target topic.
From another project it needs to be something like [path]index.htm#[path]targettopic.htm.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Calling CSH in Merged webhelp

This is more of a re-phrase than a new post: I've created a
merged webhelp project (using Peter Grainge's excellent guidelines)
and have two questions:
1) Can someone point me to the spot in the RH help that
discusses how to call webhelp using Map IDs from an application?
2) My merged webhelp project has a parent and several
children. Each of these still has its own .h file, right? How does
that affect the Map ID lookup? (If I regenerate a child project,
its .h file will be updated...do I need to copy that up, merge them
together, or what?)
Thanks,
-Greg

Just wanted to give a better description of my problem
(thanks in advance):
The source folders for my merged project have this structure:
\rh_projects
..\parent
..\projects
....\child1
....\child2
....\child3
I load each project and create Map IDs for CSH. We need to
use Map IDs, I can't use the URL technique Peter Grainge describes.
I make sure that each child project's map IDs start with a
different base number (e.g., child 1 starts with 1000, child2
starts with 2000). If I load and save each project, I get a .h file
in the main project and for *each* child project:
\rh_projects
..\parent
...BSSCDefault.h
..\projects
....\child1
.....BSSCDefault.h
....\child2
.....BSSCDefault.h
....\child3
.....BSSCDefault.h
The .h files look something like this (not real names, but
you get the idea):
For \parent:
<empty file>
For \child1:
#define child_1_topic_1 1000
#define child_1_topic_2 1001
For \child2:
#define child_2_topic_1 2000
#define child_2_topic_2 2001
For \child3:
#define child_3_topic_1 3000
#define child_3_topic_2 3001
When I generate and publish, I get the following directory
structure:
\rh_generate
..\mergedProjects
....\child1
....\child2
....\child3
..\whdata
..\whgdata
..\whxdata
(Same structure when you publish.)
If you try to test the output with the CSH Test tool at this
point, you won't be able to, because you're prompted for a .h file.
Generating does *not* copy any of the .h files to the output
folder...you have to do this manually. Well, I want to use the .h
files anyway, so that's OK. Question is, which files do I copy, and
where?
Since I was careful to keep the IDs unique in each project, I
decided to merge them into a single file and put it at the
\mergedProjects level:
\rh_generate
..\mergedProjects
...BSSCDefault.h
....\child1
....\child2
....\child3
..\whdata
..\whgdata
..\whxdata
This merged .h file looks like this:
#define child_1_topic_1 1000
#define child_1_topic_2 1001
#define child_2_topic_1 2000
#define child_2_topic_2 2001
#define child_3_topic_1 3000
#define child_3_topic_2 3001
I then fired up the CSH Test tool, selected the merged .h
file, and it *almost* works. Choosing any map ID shows the correct
topic, but not in the three-pane window. Instead, I see only the
topic with the "Show" link in the upper left corner. I want the
correct topic to appear in the three-pane window.
Any ideas?
-Greg

Merged Webhelp - TOC doesn't display

Hello all,
I have generated a merged webhelp project as per the instructions at:
http://www.wvanweelden.eu/blog/2013/02/28/adobe-robohelp-creating-merged-webhelp
The output help file is quite large. I can run it without issues on my PC. However, when I copy it to a server, it does load, the TOC pane appears empty until I click around a few times in the help. Is there any way to fix this?
Thanks!

First off, make sure that the optimization in your layout is set to web
site.
Now for some more info: Which version of RoboHelp are you using?
Last, make sure to look at
http://www.grainge.org/pages/authoring/merging_webhelp/merged_help.htm,
the bible for merged help.
Kind regards,
Willam

Safari browser issue when calling Merged Webhelp

Hi All,
I am using Robohelp 8.0. I am creating a merged Webhelp project and calling the help as context sensitive from the web application using the Topic ID.
What Happens:
Calling webhelp with parent_csh.htm#<productID> work fine in Firefox, IE browsers.
When I try to call the topic in Safari browser on Mac OS, it opens the topic section correctly as shown below:
when I click the Show link on the top of the page to view the TOC, it gives me a page cannot be displayed error as shown in screenshot below:
NOTE: It still works well in Firefox on the same Mac computer.
What is not working:
* Error occurs when the show link is clicked in help page in Safari 5.0 browser.
* Same error reported even when I include "withnavpane=true" in the parent_csh.htm#<topic id> to show the TOC.
Questions:
* Is Robohelp 8.0 is compatible with Safari browsers in Mac?
* Is there a way to show the TOC of the webhelp in Safari?
* Why Safari interprets the '#' to %23 and why the link does not work in Safari alone even it works in Firefox on the same machine?
Let me know your thoughts and awaiting a resolution from sharp heads of Robohelp.
Thanks & Regards,
Pan_Sel

From the Safari menu bar, select
Safari ▹ Preferences... ▹ Privacy ▹ Remove All Website Data
and confirm. Test.

Linking between projects in merged WebHelp

I have a merged WebHelp (created using RoboHelp 10) that has several child projects. I now need to have the same topic in two child projects and I want to prevent duplicate maintenance.
I tried making the topic a snippet and adding the snippet to the Resource Manager; however, when the snippet is updated in project A, the snippet in project B doesn't reflect the updates. The only other alternative I could think of is linking the topic from project A to project B.
So that leads me to my question - how can you update project A so that when the user clicks a topic, it automatically displays the topic from project B (but without leaving the frame of project A)? Is there a better method to accomplish this?
Thank you in advance for your help, I GREATLY appreciate it!
Nikki

Weird. I just exported a Snippet from Project 1 to Resource Manager and then dragged it into Project 2 where I made a change. That put the red icon on RM until I hit sync. I then when back to Project 1 and, as you say, the snippet was not updated in the project or showing that it was out of sync. Here's the weird bit. I then added the snippet from RM to another topic and it came with the amendment and updated the first snippet. Weird bit 2 is it seems to be working OK now although it was a quick test really needing a few more attempts.
Might be worth you pursuing this to see if you can get it working.
Otherwise the topic in Project B could be a Redirect to the one in Project A. That would only be practical if you always supply all the projects in the merge.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Linking 2 WebHelp Projects

I have 2 separate (not merged) WebHelp Pro projects that I
need to link together. I'm using customized toolbar buttons for
each project; a button on Project A calls project B and vice versa.
I need the buttons to load the called help system in the parent
window, not in a new popup, or within the topic frame.
I've tried the following button configurations from the Skin
Editor:
Using the Link command and Browsing to the other parent
topic. This actually reloads WRONG parent toolbar (the one that's
already open) within the topic pane.
I've also noticed that making a simple hyperlink to
http://www.adobe.com opens the
Adobe website in topic frame; I would need mine to load as the
parent.
Using the onClick javascript:
parent.frames[1].location='C:\HelpProjectB\indexB.html'
This gives a "The page cannot be displayed." error. The
toolbar is still there for some reason.
*this script borrowed from Rick Stone's Skinny on Skins.
Using the onClick javascript:
parent.location='C:\HelpProjectB\indexB.html'
This gives a "The page cannot be displayed." error.
*this script borrowed from Rick Stone's Skinny on Skins.
The projects still on my hard-drive for testing, and I
suppose trying to call a file in this manner may be the problem.
I'm fairly proficient at RoboHelp, but I am scripting neophyte. I
am using RH6.
Any advice would be much appreciated. Thanks in
advance!

Nevermind! I figured it out.
The Skin Editor's Link option is for linking a single file
(PDF, etc). The file will displayed in the topic frame and the file
will be added to the main directory.
The parent.location javascript is what I needed, but I had to
change the slashes from \ to / .
I know there is some reason for this, I can't remember what
it is though.

Missing TOC Book in Merged WebHelp

It's late on a Friday, and I'm brain dead. I am using a merged WebHelp structure (based on Peter Grainge's model with parent project only having one topic and using redirect to first child project) for my company's disaster recovery plan (separate department plans plus a master company plan). I recently added a new department plan. When I generate the merged help, the new department plan (Marketing) appears in the TOC but another one that should be there (Underwriting) is not showing up. Does this have to do with the length of the TOC? Seems like I recall having a problem with long TOC's before (in another job and project) but not sure if that's the issue or not.
Any guidance on where to troubleshoot would be appreciated. Thanks!

Unfortunately, I do have the same problem in Firefox. Just to clarify, I'm not viewing the merged plan in SharePoint; I am generating and viewing it locally on my C: drive. Copying to SharePoint is the last thing I do, so I haven't even gotten to that point yet, and when I do it, I delete all files on the server and copy all files again to it.
I tried regenerating AND publishing all of the plans to my C: drive (separate locations with same folder structure). I can either get the Marketing plan to show up or the Underwriting plan but not both at the same time.
Here is screen shot of the parent file TOC. They are all there. What am I missing? Have you encountered this issue before on the forum? I tried searching but couldn't find a situation that exactly matched mine. The Marketing plan only has 18 topics in it with 6 folders in the project file. The Underwriting plan has 33 topics in it with 6 folders in project file.
However, the IT plan, which comes before those two, has 226 topics and 7 folders, some of which have multiple levels of sub-folders going 3 or 4 levels down. I can send you screen shots of the structure, if you like. It's the most complicated one of the bunch. I've got to get this resolved as I am supposed to publish 1Q updates this week. And of course, I can't merge any additional department plans until I can determine where the problem lies.
Thanks in advance for your help!

TOC doesn't synchronize in merged HTMLHelp project

This issue had been discussed several times. Peter Grainge offered a solution for WebHelp projects. Though I'm still looking for a solution on HTML Help projects with CHM output format.
Situation:
As the help file growed tremendously over time we'd like to split our MS HTML Help project in several sources resulting in a couple of *.chm files. Those refer to modules of our application suite. We successfully generated the help files and merged them using one clasping 'parent help file' based on the merge functionality of the TOC (table of contents) dialog. We use RH 7 in a Windows XP environment, language is German.
Problem
When the application calls a specific help topic from a child help file that had been meregd into a parent help file, then the TOC (left pane) doesn't synchronise / synchronize with the content of the right pane.
Example
Calling a specific topic from Visual Basic .NET code:
Help.ShowHelp(Me, "C:\DEVELOP\myApp\help\myAppHelp.chm", "Basics.chm::/CommonDialogs/Print_Dialog.htm")
As expected myAppHelp opens, in the right pane the correct topic "Print_Dialog" is presented, but the TOC on the left pane is not being expanded to this level. Expanding the TOC manually shows that all topics from the child help files are available.
Further information
1. We ensured to tick the related option "Auto-synchronize TOC" from the window dialog and the "Always show Selection" option of the advanced options for the project properties. Things work well, when calling a topic from the parent help file (TOC synchronises perfectly) or when the child help file is being accessed directly from the application.
2. Based on the release notes for RH8 ...
Merged project enhancements Merged project enhancements introduce the concept of a child project referring to a master TOC. Child projects automatically synchronize with the merged TOC, and you can see the merged TOC in the child projects.
... I asked someone to import my sources in RH8 and generate all output. It still doesn't work.
Any hints on existing or up-coming solutions are highly appreciated. Kind regards,
Pinkepunk

In Project Manager you should see Table of Contents listed. From what you say, instead of setting up the default TOC, you elected to create a new one. That will be confirmed by you seeing two entries under Table of Contents.
Then probably what happened is instead of setting the wizard to use the new TOC, you left it with the default so you generated using the default instead of the TOC you had created.
Double click the Primary Layout and change the TOC used in the first page to your new one and it should be OK.
If you double click a TOC in Project Manager, you should see it open in a pod.
See www.grainge.org for RoboHelp and Authoring tips

Issue with Mark of the Web, PDFs, and merged WebHelp

I'm sure this has come up before, but I can't locate the definitive answer.
I am using RH8 and have a merged WebHelp system containing a parent projects and 10 or so child projects. Previously, when I generated the WebHelp projects, I selected the Mark of the Web check box for the parent and all the children. Everything seemed to work fine.
Now, I've been asked to create a new child project with links to a large number of PDF files. After reviewing the documents on this forum, I realized I needed to (1) unselect Mark of the Web to see the PDFs in the generated output and (2) change my IE settings to Allow Active Content to Run from Files on PC. Unfortunately, while I can now see PDFs just fine, my merged help is no longer working correctly--the link from the parent topic to a project generated w/o Mark of the Web no longer works. That is:
If Mark of Web selected:
     PDFs don't work
     merged help does
If Mark of Web not selected:
     PDFs work
     merged help does not
How can I make everything work?
Thanks.

Are you testing locally?
Have you tried after publishing to the server? If not do so as that will likely make the difference.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Need to disable script or ActiveX control in WebHelp project

Two of our WebHelp projects display the following two
messages prior to loading the first page:
1) "To help protect your security, Internet Explorer has
restricted this file form showing active content that could access
your computer. Click here for options."
2) "It seems javascript is disabled in your browser, please
enable it abd reload again, or click here to view without
javascript."
I don't know my way around well enough in RoboHelp to solve
these problems. I've read that you can disable the ActiveX issue
through options in the Windows Control Panel, but that is not a
valid resolution for these customers, as that will pose security
vulnerabilities. Not sure either about how to enable javascript, as
indicated in the second message.
Obviously there is something in these WebHelp projects that
cause these messages to display. I want to address the issues at
the project level - not the OS level. Is there a way to search a
WebHelp project foe embedded ActiveX controls and java scripts that
may cause these messages, and then figure out a way to change this
behavior?
I am using RoboHelp HTML, version 5.0.2, build 801, and
generating the primary layout as WebHelp. I've played with the
Preferrred Format options when I generate the project, but nothing
has solved the problem yet.
Any suggestions? Help! This novice is stumped.

It's because you are viewing the help locally. Your users
will be viewing it from a server so they will not have this issue.
To fix it to help you work, see Snippet 19 on my site.

Show Merged TOC Option in Merged WebHelp

I am experimenting with merged WebHelp for my company's disaster recovery plans. There is a master company plan and then each department has its own dept plan. I have set up the merge using instructions from Peter's site. I'm running Robo 8.
When I generated the parent project, I did not select the "Show Merged TOC in Child Project" option, but all of the TOCs are still displaying in the merged output anyway. Is that how it's supposed to work? Eventually, I may want them to all display, but right now, I don't. I only want the TOC for the main child project to appear in the output. Is that possible?
See attached two screen shots.

Then you don't want that box ticked. The way it works is you generate all the outputs.
- If you open the start page of the parent, you will get all the TOCs showing as one.
- If you open the start page of a child, you will get just that child's TOC, unless you have ticked that check box when you will get the whole lot.
See www.grainge.org for RoboHelp and Authoring tips
Follow me @petergrainge

How to download a large merged webhelp RH 9.02 to local user's PCs

We have a large merged WebHelp using RH 9.02 on intranet site and want a way to have field reps download to local PCs. Before it got so large, the tech guys wrote a program to download and update the project to PCs but now it is just to large and timeconsuming for users. Any ideas? I have looked into the e-pub and Air formats but they don't seem to be a solution.
Thanks,
Gigi

Hi Gigi
I used to have large WebHelp's that presented content that also needed to be downloaded to Field Support Reps' PCs for when they traveled and were unable to reach the intranet.
What I did was to create a CHM version of the content and make it available via a link inside the WebHelp.
Another approach would involve using something like Microsoft SyncToy to copy the WebHelp files from the server to the local PC.
http://www.microsoft.com/download/en/details.aspx?id=15155
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

Merged webhelp project problem

Similar Messages

Maybe you are looking for