Zoom Search with Merged Projects

I have read the instructions on www.grainge.org, but I don't
seem to be getting results from any of my merged projects. I think
the problem is the directory structure of my merged projects. Can
someone confirm?
My structure is:
Master SDK (placeholder folder)
----Main SDK (where my Main xpj file is and the TOC links to
the merged projects)
----Merged_Flash (folder where I put my merged projects in)
--------MergedProjects (where the Main SDK compiles its
output)
--------------Child Project 1 compiled output
--------------Child Project 2 compiled output
--------------Child Project 3 compiled output
Child Project 1 (xpj)
Child Project 2 (xpj)
Child Project 3 (xpj)

OK. I obviously need to take this step-by-step. I have a question about step 2 in Stage 2.
Stage 2
Now we need to change the way the search of all topics is configured and then set up the searches of the child projects.
In the published help for Child 1 you created a folder called search_files. Under that create two folders, all and child1. Delete any earlier search files.
Open the ZoomSearch configuration file that was created earlier and change the output folder so that it now goes to search_files/all in the published folder structure. Change the relative path (add ../).
I created the "all" and "child1" folders in teh published help for child1. (The published help for child1 is in the MergedProjects folder...NOT in the "/generate" folder at the top level of the project, per the Merged WebHelp demo.)
Proceeding to step 2....
It says to modify the ZoomSearch configuration file just created earlier, which is the one for the entire Parent project. This configuration file (that I confirmed to be correct in the zip file I sent) has the following relationship for Start directory and Output directory:
Start directory
c:\workspaces\SDKI_Int\SDK\generate
Output directory
c:\workspaces\SDKI_Int\SDK\generate\search_files
Here is where I am confused....
Step 2 nows says to change the Output directory so that is goese to "search_files\all" in the published folder structure. I am confused because there is no "c:\workspaces\SDKI_Int\SDK\generate\search_files\all" in the publilshed directory --- the "all" directory was greated in the child1 project. (And if I do so, ZoomSearch rightly gives me an error stating that the Output directory doesn't exist.)
So, am I supposed to create an entirely new ZoomSearch configuration file that has nothing to do with the previously created configuration file, but instead has the following configuration that relates to the new chld1 project structure?
Start directory
c:\workspaces\SDKI_Int\SDK\MergedProjects\child1\search_files
Output directory
c:\workspaces\SDKI_Int\SDK\MergedProjects\child1\search_files\all

Similar Messages

Search and index functions don't work with merged projects

Until this morning, the search and index functions in my RoboHelp project worked okay; I have one Main project into which I have merged more than three dozen sub-projects. About an hour ago, I created a new sub-project and merged it into the Main project; now, it's as if the topics in my merged projects don't exist.
Any suggestions?
thanks,
Lon

So when you open the merge you see all the content, it is just the search and index not working. This must be merged CHMs as you are talking about a Favourites tab so maybe your other comment is relevant. My understanding of merged CHMs is that you do not want spaces in file names, that could be the problem.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Map ID with merged projects

Hello,
I'm working on merged projects for made one CHM for a
software.
I manage to merge the several chm, but now I've got a another
problem with the topics ID I use to call help in the application.
I create a file Map-ID for all my .chm, but I don't know how
to use it from my principal .chm.
- Do I must create only one file Map-ID for all the .chm ?
- Do I must use all the Map-ID of all the ;chm and call them
from my principal .chm ?
If somebody can help me for that.
Thanks a lot.

vlavergne,
This area of HTML Help deployment is a little tricky. You can
either channel all the context help calls through the master help
file, as described here:
http://helpware.net/htmlhelp/how_to_merge.htm#ContextHelpIDs
http://helpware.net/htmlhelp/how_to_merge_ctx2.htm
or you can pass the calls directly to the slaves -- but you
would modify their window definitions so that they open with
exactly the same navigation pane as the master file. For guidelines
on how to do this, see the section headed "Step 3 - Slave Windows
Definitions" in the first of the two pages above.
Here's an earlier thread that may provide useful information:
http://www.macromedia.com/cfusion/webforums/forum/messageview.cfm?catid=449&threadid=10585 87
Are you using the HTML Help API or .NET HelpProvider
components to display context-sensitive help?
Pete

Print document with merged project

I´m using RoboHelp 7.
I have a main project which merges to other projects. When I
print documentation to a Word file I'd like the merged projects to
automatically integrate in the main document, i.e. I'd like to
print one doc file that integrates both the main project and the
merged projects. Thanks in advance.

Can't be done garcia3000 as there is nowhere for a RH project
to know where the master word file is located. The best you can do
is create all the word files and cut/paste the content into the
master project's word file.

RH9 - problem with ID mapping and HTMLHelp merged projects

I have a merged project with a couple of baggage files (.chm), some .h files.
When the application opens the merged project file, it cannot find the topic ID.
                          hwnd = HtmlHelp (
                                      hWnd,
                                      help_name,
                                      HH_HELP_CONTEXT,
                                      (DWORD_PTR)help_id );
A zero handle is returned. When we were using RH5 (from where we moved the project), everything worked fine.
All mapping IDs are yellow with a lock on them, FWIW.
Any help appreciated.
Christoph

Astrid,
Sorry to go off-topic on your post...but I have a question in relation to how you deploy your login module. Do you deploy the login module with your application ? I've developed a login module that I would like to deploy by itself, I currently deploy it with the calculator example and it works fine like this, but I need to deploy it by itself. Any tips you can give would be greatly appreciated.
I've tried to use the deploytool and deploy the module as a library...but I get a "cannot load a login module" in the logs when authenticating a user.

RH8 - Publishing Merged Projects with AIR Browserbased Help

Hello,
i have one master project with 5 subprojects. When i make an Output with Adobe Air "Browserbased Help" is the preview ok, all tables of Content from all projects are included.
When i publish it to our webserver i first got a grey screen with an loading error.
I discovered that the link in the start site to the included file ac_oetags.js is incorrect because of upper and lower case writing. When i change the link, the site appeared correctly - but unfortunately only with the table of content of the main project.
Is it possible to merge Projects with Browserbased Help?
Has anybody an idea what went wrong?
Thanks for your support!
Steffan

In the Start Page field you define where you want to generate the help.
If you click the Server settings you define where you want to publish.
When you publish the parent it goes to \\servername\myrobohelp and it creates a folder called mergedProjects and subfolders for each child.
When you publish the children, your Server setting must point to those subfolders.
Does that clarify? If not, please add some screenshot using the camera icon so that the images are in the post as above.
See www.grainge.org for RoboHelp and Authoring tips
Follow me @petergrainge

Not new; merged projects with separate TOC and indices

As it turns out, I have three projects that will need to be
created:
Folder (1) for Admin users:
Administration
User Management
Users (General Contents)
Folder (2) for Approver/PM users:
User Management
Users (General Contents)
Folder (3) for Regular users:
Users (General Contents)
I'm unsure whether, in RH6, I will be able to generate
separate TOC and indices. Can someone tell me whether there's a
best approach in order to enable this functionality?
Regards,
Sharon

OK. Of course, nothing could be that easy, now can it? lol. I
have managed to create the structure as Peter has defined it, and
for the most part, things are looking good. I do, of course, still
have a few questions I'd like to ask before I proceed:
1. When Peter suggests I put the [Parent (No Content)] into
each of the three folders for the administrators to use on the
server, what exactly does the Parent content entail?
2. I'd like to understand better the difference between the
default topic and the start page, and how it works structurally. I
started by generating each of the child folders with the start page
(example: Intro.htm), but realized that using index.htm was
important not only for the parent, but for each of the child
projects that I set up. I just don't understand WHY it works that
way.
3. I set up Books in the TOC and used the Merged Help under
each book which, of course, when generated, display books within
books. Can I just move the projects and delete the Books
altogether? This may be obvious, but I want to make sure I'm not
undoing something I'm unaware of undoing (if that makes any sense
at all).
4. The server will be a Linux box; I have checked off the Use
Lowercase checkbox when generating all. Is there anything else I
should be doing to keep problems to a minimum?
5. Last but not least (if you've made it this far), I'd like
to know if it is any easier for the administrator, or myself, in
the long run, to be using RoboHelp 8. Because this looks like it
will be an ongoing project for at least five years, I want to make
sure I am working in the smartest way I can.
Thank you, to those who respond. I know I am asking for a lot
of information, because this is my first merged project. Any
assistance you can provide would be greatly appreciated.
Regards,
Sharon

Merging Projects in RoboHelp 8

I've never merged projects before so this is probably user
error, but when I follow the steps from the Adobe help system for
merging projects in RoboHelp 8, generate the project, and then view
it my merged project is not present. This is what I did:
(1) Created a generic project (documentation that we reuse in
all help systems)
(2) Created the client project (documentation that's specific
to this client's help system)
(3) From the Client Project in the TOC pod, I clicked the New
Merged Project icon
(4) This is a WebHelp Pro project so I selected the
FlashHelp/WebHelp/Adobe AIR tab
(5) I browsed for the generic project (located in a seperate
folder)
(6) I clicked OK
(7) The generic project name showed up in the TOC
(8) I generated the project like normal
(9) I clicked View Results and the only stuff that's there is
just the stuff from the client project. Nothing from the generic
project is available.
Everything that I read says that merged project doesn't show
up until the project is published. I guess with the way we do work
I don't understand the difference between generating and
publishing. What happens is that I generate the project, zip the
WebHelp Pro folder, email it to a developer or put it in a shared
drive depending on the client and then the developer attached the
files to the system. To call the correct screen, I have to include
a HTM for every single screen (wfm) in the application. The
application calls the screen name with the same HTM name which
displays a screen help page for that particular screen and then the
user can use the navigation (TOC or search or links) to find the
help topics they're looking for. I doubt this is the "best" way to
do this, but I'm working with developers on a 12 hour time
difference and this is how they requested the files. Point being --
there is no "publishing" step according to my understanding of
publishing. I know there is a server somewhere because the actually
application we build is on a server, but I don't know the technical
aspects about how my HTM files I create get onto that server and
display online.
Can anyone help me?

Actually, I had generated all the child project previously,
but what I did wrong is that I didn't create a folder for the
child. It looks like in the table of contents, you actually have to
include a separate folder for the mergedProject to go into. I just
called it the same thing that I called the child project. For
example "Global Features." You can't just have the mergedProject go
into the table of contents without it being in a folder (normally).
That said, I did find a way to get it in there before I found this
solution. I did all the steps that Peter Grainge had suggested,
then I copied and pasted the !SSL folder from where the child
project was saved into the mergedProject folder of the parent
project. That's basically what RoboHelp does anyway, but doing it
manually allows for you not to have to create a folder in the table
of contents -- just provides a different navigation to the same
thing.

Merged projects - topic-level tag problems in sub-projects

I am working on an extensive help file in RoboHelp HTML. It
consists of a master project and 15 sub-projects. Each of the sub
projects have topic-level conditional tagging, and when each
sub-project is compiled, the topic-level tagging works and the CHM
is correct in regards to what topics are included and excluded.
However, when I compile the master project, it seems that RoboHelp
disregards ALL topic-level tagging in the sub-projects. So, the CHM
for configuration A includes all sub-project topics for
configurations A, B, C, and D. The topics are in the TOC and they
appear as search results. We are not using an index, but binary
index is checked in the project settings.
The same four configurations in the sub-projects are also in
the master project, but the conditional tag expressions aren't
word-for-word identical. Should they be?
Note that the content-level tagging within the sub-projects
DOES work when the master project is compiled. For some reason, the
problem is isolated to the topic-level tagging.

I think I'm the one causing the problem - I don't think I
read your initial post carefully enough. Sorry...
I can't figure out how this is happening. When you merge
.chms, you have already compiled the 'slave' projects. The link
from the master TOC points to a slave .chm - which you say is
working correctly when opened on its own.
Since the slaves and masters are compiled independently,
there shouldn't be any interaction between the master and slave
build expressions - and if there is one, it should be excluding
more topics, not including more topics!
The typical problems people have with merged .chms seem to be
TOC issues (does the master TOC show up, or just the slave
project's TOC?) and path issues (the master can't find the slaves).
However, I did see one or two posts on this forum where the master
was pointing to old copies of the slave .chm - could you have a
"complete" .chm lurking about?
BTW, according to RH help, binary indexes are fine in merged
HTMLhelp. Binary TOCs are not. I don't think you have this problem,
because the symptoms are different, but you could take a look - the
setting is in the HTMLHelp Generate wizard. Click the [Advanced]
button on the first wizard page and look on the TOC tab to make
sure Binary TOC is not checked.
You might also do a quick search on the General
Info/HTMLHelp/RH for HTML forums for "merged .chm" - you might
recognize a symptom in someone's post that I didn't catch.
Good luck,
Elisa

Can't link to projects in merge projects - RH8

I generated my merged file in RH8. However, I can't link between the merged projects.
I accesss the parent project and then click the link and successfully access the child1 project. Then I click the link in child 1 to go back to the parent and it doesn't work. I get the message that Explorer cannot display the web page.
All my files are on my C drive and I checked the links and they look ok.
Also, when I allow blocked content, I get two bars at the top of the window with the Contents, Index and Search instead of the usual one.
Any help is appreciated.
Thank you.

Let's say you have a project that is located in the directory c:\Source\Project directory. Inside the project you have two folders called (FolderA and FolderB) with topic1 and topic2 in folder A and topic3 and topic4 in folder B. If you link from topic1 to topic 3, the link path added by RH is "foldera/topic3.htm". This is a relative path to a topic inside the project. If the project folder is moved, the link will still work provided none of the overall project folder/file structure is changed.
The generated output - although it is by default output to the !SSL!\Webhelp folder - is not inside the project. You can link to it but if it or the project source files are moved, it run the risk of broken links. If all you are doing is trying to link to another topic in the same help project, use the approcah I have outlined above.
Read the RoboColum(n) for mutterings on RoboHelp, Technical Communication Suite and technical communication.

Zoom Search + Highlight, Exclude Bookmarks

Hi,
I've used Zoom Search for about 2 years with few Homesite HTML projects and am now incorporating Zoom Search into a Robohelp project. So far, so good.
I've followed Peter's suggestions, tweaked for my needs. Again, so far, so goo. I added the highlighting option (jump to match and highlight search words). It works as expected, but I'm having an issue that it's highlighting bookmarks, when the search terms matches a word in the bookmark. This isn't ideal, and it causes a big issue when the matched search word is in the bookmark and at the bottom of the page. The "jump" in this case stops at the top of the page because the bookmark is the first occurrence of the word. Technically, this is correct, but from a user's perspective, it's not so great.
To exclude portions of the page from being indexed by Zoom one uses the  and  tags, which works as expected with RoboHelp. My issue is that the bookmark code does not appear in the html file, so I can't even exclude it. Any suggestions?
I was going to post this in Zoom's forum, but I have a feeling they'll tell me to ck in with Robohelp.
thanks in advance........
--j

Is there a way to edit the original post?
I run the Zoom indexer on the published files.
I looked at the published .htm file and I found something, I think, related to breadcrumbs, but I have no idea how I could configure Zoom to skip it, other than add the ZOOMSTOP/RESTART comments to this file....which will be an impossible task given the # of files and the time required.
here are the lines in my published .htm file:

Searching for a Project status = CLSD and open purchase orders?

Hi,
I am searching for a project status (Project Builder CJ20N) which allowed my to set a CLSD or a simillar status for settlement with open purchase orders.
This staus should allowed to process with open orders BUT not allowed to add new orders after setting this status.
Have somebody any idee? Or it is impossible?
Tahnk you in advanced for your Help.
Regards Baldy

Hi TV-kid,
while I was waiting for an answer I got to the same conclusion, so what you offers me is quite tempting actually.
I got a look to your website and it seems convincing. Still though, your case studies are in other business area, It's only a mater of good knowledge of File Maker.
I did download the test-drive last version of File Maker plus their samll Business Solution. I did read most of the documentation and the learning process would be too long to construct ourself a good crossed-data base.
I'd like to get in contact with you to look for a possible colaboration. to get private, I'd liketo do it through your contact link in your website .
To whom shall I write?
Thanks
Cheers
Cheers

How do I save Icon templates with the Project files?

My project files are stored in a folder, say, "My Documents\LabVIEW\My Project", and this folder, in turn, is saved under (Sub)Version Control. I'd like to include a sub-folder called "Icon Templates" that could contain the icon templates I'm using in this project, but they seem to be "forced" into "My Documents\LabVIEW Data\Icon Templates" (almost the same, but the "owning folder" is different).
Is there any way to change, preferably on a Project-by-Project basis, the default location for Icon Editor templates? I tried to figure this out, and saw that one could change where "3rd Party" templates were stored, but that didn't seem to do anything (maybe because I don't understand the concept of a "3rd Party"?).
An important (to me!) reason to accomplish this is that I want to commit my new icons when I commit the rest of the Project, and have them appear when I checkout the project on another machine (or do an update from the Repository).
Suggestions welcomed ...
Bob Schor

Well, I thought of this as well. I did change Default Data Documents (which seems to be where Icon Editor expects to find its Templates file) to My Documents\LabVIEW (instead of LabVIEW Data), and that worked (sort of). But that still doesn't solve my problem. I have multiple projects -- My Docs\LabVIEW\Project 1, say, and My Docs\LabVIEW\Project 2, and want to have a specific set of icon templates for each stored, say, as Project 1\Icon Templates and Project 2\Icon Templates.
My problem is two-fold. First, there is a setting in Icon Editors, Tools, that seems to be designed to let you designate where your "special" templates are located, which I've set to, for example, My Docs\LabVIEW\Project 1\Icon Templates. However, when using the Icon editor, these templates never appear! It's as though it's still "locked" into the "3rd Party" sub-folder of the parent Icon Templates folder. Second, even if this worked (which it doesn't), is there a way to "embed" this setting as part of Project so that the settings "stay with the Project" (and can thereby be customized)? One important reason to do this is to simplify organizing Projects and folders on disk -- I keep them "together" (use the same structure for both, so a Project is contained, on disk, inside a single set of nested folders), which greatly simplifies and facilitates using Version Control to manage development.
Thanks for the reference. I didn't know about all of the symbolic names. It does appear that they are only used in the VI Search Path entry, correct?
Bob Schor

Urgent - HTML help merged projects - displaying in the same window

Hi All,
Following some recent windows updates I'm experiencing all sorts of problems. My most urgent problems is as follows:
First off this is all in RH8 and yes I have upgraded to 8.0.2 and project is set to re-build cpd each time.
So I have a merges project as follows:
Parent project
child project 1
chils project 2 etc
when I compile an html help project with TOC, and single source window settings on default if I click on a child project it is diaplyued in a separate window. If I then select a different project in the parent project TOC this is also displayed in a different window but the window still has the caption of the previously opened file.
What I need as the end result is for my HTML help project output to al display in the same window whether I click on a parent project item, or a child project item.
Please can somebody advise mne how to do this as I am VERY close to a deadline and as usual it seems RH8 has let me down again.....
Thanks
Author Care

Hi there
Methinks Colum needs more coffee, because the options he cited have nothing to do with other windows. They have to do with whether the displayed topic synchronizes with the TOC and whether the TOC entry is highlighted.
I'm thinking it has to do with creating a "Global" window. You change the names of the windows so they include Global.
The link below has more:
Click here to view
Cheers... Rick
Helpful and Handy Links
Captivate Wish Form/Bug Reporting Form
Adobe Certified Captivate Training
SorcerStone Blog
Captivate eBooks

Merged Projects Not Appearing in WebHelp TOC

Following the instructions on the Grainge site, I created a
merged project with the following folder structure:'
BAM\parent --->parent project location
BAM\Child\Project1 --->child location
BAM\Child\Project2 --->child location
BAM\Child\Project3 --->child location
I added the metatag redirecting the first topic in the parent
project to the default topic in Project1.
When I generated the output:
I got a nested set of navigation frames along with the error
msg from IE saying it blocked the content from running ActiveX.
The correct TOC books, one for each project, did display in
the outer navigation frame. However, once I clicked to allow the
content to run, the TOC would disappear. When I went to IE Tools,
Options and selected to allow ActiveX to run from My Computer, the
error message stopped appearing, but the TOC disappeared entirely.
I did get the extra set of nav frames to disappear by
clearing the nav option in Project1 when I generated it.
Thanks for any tips.

Hello. I have been sailing along working on my merged
projects, but then I decided to change the name of one of
them--twice. The first time I changed the name it continued to work
fine. But this morning I changed the name again and now the child
project no longer appears in the merged TOC.
**This is the first merged project in the parent project's
TOC. However, it still doesn't appear even if I move it farther
down in the list.
**The redirect from the parent project's default topic to the
child project's default topic works fine.
**The child project's TOC works fine when I generate it
independently.
**I changed the Title of the project and the name of the
project. I regenerated the parent project to get the new folder
name and generated the child project into that new folder name.
Perhaps I did all of these things in the incorrect order? At first
I didn't change the folder name, but then later I did. And I
deleted the old output folder...
**The new project is being pointed to in the parent project's
cshdat_robohelp.htm file (though interestingly there is no order to
the list of child projects in that location).

Zoom Search with Merged Projects

Similar Messages

Maybe you are looking for