Glossary hotpsots for merged projects
Hi all,
Has anyone done glossary hotspots for merged projects?
If so what is the official way of doing this please?
My intention at present is to have a single glossary residing in the master project for simplicity of maintentnance but I'd be interested to hear what others have tried etc.
Thanks
I'd say so. It makes it easier knowing that all the glossary items go in the same place which also means you can ensure there is no duplication between projects. You didn't really want the links anyway did you
The RoboColum(n)
@robocolumn
Colum McAndrew
Similar Messages
-
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. -
Glossary does not appear in merged project
Hi,
I am using RHX5 to produce help in HTML chm format. I have 14
separate projects which are merged into a master project, due to a
bug in RH in which the table of contents does not display correctly
I use HTML Help Workshop to compile the master project.
One of the 14 projects has glossary entries and so far I have
been unable to make the glossary entries appear in the master
project when it is compiled in HTML Help Workshop.
I have registered the hhactivex.dll.
I checked the glossary checkbox in the windows setup in both
the individual project and the master and I added a glossary entry
to the master project.
When I compile the project using RH then all the glossary
entries appear but the table of contents is messed up.
When I compile the project using HTML Help Workshop then only
the single glossary entry from the master project appears.
Anyone have any idea how to solve this problem?
TIA
MorvenHi Morven. When you say your TOC is messed up are you
referring to the problem where the merged projects appear as a book
within a book? If so,
click
here for a method to get around it and use RH to compile your
output. If this is not the problem to which you refer, I'll crawl
back under my stone. -
I have successfully merged two projects in order to add new photos for my book. The library available to the book which has 26 completed pages accesses only the original project library. Has anyone else had this problem ? It is frustrating to see the photos I want in the merged project file, but to have only the original photos when I started the book available in the book library.
That will work, but it is the long way 'round.
As Frank noted, Book Albums are just specialized Albums. Albums can show any Image in your Library, regardless of where the Album is located on the Library Inspector, and regardless of which Project contains the Image. You can put your Albums anywhere (in a Folder called "Books" for example). You can put Images from anywhere in your Library in any Album.
The easy way 'round:
- Make a new Book Album
- Select Images you may want to put in your Book. Flag them.
- Select some more. Flag them.
- Go to the "Flagged" container (listed near the top of the Library Inspector), select all, and drag-and-drop them to your Book Album.
- Repeat as needed, or just drag-and-drop directly into the Book Album.
Note that you can remove any Image from any Album (including Books) by selecting and hitting the "{Delete}" key. This _does not remove the Image from the Project that contains it, or from the Library.
Note, too, that once the Images are in your Book Album, you then put them in the Book you are creating for publication. The Book Album contains the superset of Images with which you populate the Book itself. The Book Album also holds the Book.
A good (imho ) introduction to the parts of Aperture can be found in this short guide I wrote.
The User Manual is helpful. Here is
the chapter on making Books.
From that chapter, here is
the section detailing how to create and populate a Book Album. -
Merged Project for RoboHelp 10 - TOC does not display
I created a merged project.
I created a master/parent project.
I added the children rreferences in the parent TOC using the new merged button.
I published the parent project.
I published all the children (in the parent merged project folder).
I generated the parent project again for webhelp, then click view results.
The parent project displays with the TOC (children), BUT as soon as I click Allow Blocked content, the TOC disappears (first topic is blank).
I have created all projects files locally. The children (when viewed independency) work fine.
I have deleted and started over 3 times with the same issue. I contacted Adobe Support, but they could not help.
Any idea o what might be the issue or how to resolve this problem.
Thanks!
KimFirst of all try moving the project so that the path is shorter. Create a folder like C:\RhMerge.
Second, I notice your path has spaces showing in the browser. Browser addresses substitute %20 so I am not sure how you have managed that. However the demo does not have spaces unless you have buried it somewhere that does.
Also please try Firefox as well.
Post back if still not resolved or to tell us what fixed it.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge -
I inherited a merged help system created using RH 8 that has 40 merged projects, about 3,000 total topics, with several of the merged projects containing about 5 topics. Since I will be the only technical writer maintaining the project, I would prefer to re-combine the projects into one project. Is there an easy way to do this? Thanks!
There's nothing difficult about it, apart from the ***** ache.
You have to import all the topics into one project, fix all the links, rework the TOC, index and glossary etc. Getting the idea?
It seems odd to create a project with just five topics unless there is a very good reason. Are you sure you are familiar enough with what you have inherited to be entirely sure your predecessor didn't have some reason.
3,000 topics in one project should be OK but try to avoid too many in any one folder. If you also have lots of images then test things as you go. I have had more than 3,000 topics in a project but I have also seen people have issues with a smaller number but a high number of images (into four figures).
Perhaps do it in stages still having a merge but with fewer projects, see how that goes for a while and then amalgamate more.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge -
I have a merged project that I use the same images in several topics in different projects. I use the resource manager but each time these images are being copied into each project. My merged project is getting so large it is taking forever to download. I hope I'm just missing a step to eliminate the redundant usage of these images.
I'm concerned since the complete merged projects have increased in size on a steady basis. For example, January 2014 project size was 288mb and I just published again today and it has increased to 353mb. There are so many images replicated over and over in each merged project. We are getting complainants from our customers on the size of our online documentation. I was hoping for a easy solution and thought this might be the best way.
-
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 CareHi 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 -
Is it possible to split the topics in one help project into
two toc (hhc) files? I have a master project that merges about 53
chm files. Some of the slave projects are rather large and over the
years have had several types of information added to them. The
information in the projects are related to each other, but they
need to be organized separately in the master TOC. Splitting the
projects themselves is not a good solution. I would like to have
multiple hhc files for the projects so that the topics can easily
be inserted in their logical place in the master TOC.Hi,
I am TW working jointly with another TW on a huge multifirm
project for a same client. He is well versed in RH, while I am a
beginner (with using RH) not with TW. He and I each produce large
parts of what will be merged into a single huge context sensitive
.chm file. Having experimented a bit with possibilities such as the
ones you are exploring, I thought we could use it for our project.
But the other TW felt we would have problems down the road.
Just to confirm what John says. But then, I also am not
adding anything positive by way of solution. Hope somebody else
reacts to these two successive negative answers, and comes up with
help for you.
Daniel Garneau, CTM, CL
Technical Writer, Canada -
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). -
How can I include merged projects in the printed documentation?
I have a master project with several merged projects. This works splendid with online documentation, but when I am asked to provide a printed version, it seems I have to create separate documents for each merged project.
Is there any setting or fix that enables print also of merged projects and topics when I create printed documentation?
Pretty please with sugar on top :-)Hm - there is a contract with the customer, saying that he wants documentation both as word and pdf, and as we now aim at only writing online documentation, these tasks create extra work, as we are delivering updates each month
But yes - two beasts, where only chm is actually needed we think.
-Tone
Date: Tue, 3 May 2011 06:53:04 -0600
From: [email protected]
To: [email protected]
Subject: How can I include merged projects in the printed documentation?
Hi there
I'm a bit curious as to the reasoning behind your "persuation process for using chm-files only".
CHM files and printed documentation are two entirely different beasts.
Cheers... Rick
| http://www.robowizard.com/pc.gif | Helpful and Handy Links
http://www.Adobe.com/cfusion/mmform/index.cfm?name=wishform&product=38
http://www.gooberguides.com/ProductPages/RoboHelp/RoboHelp82Day.htm
http://www.ShowMeSolutions.biz
http://sorcererstone.wordpress.com/
http://www.gooberguides.com |
> -
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 -
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 -
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.
Maybe you are looking for
-
How to show "ALL" Values by default in Page Drop-Down Lists in Pivot Tables
Hi Everyone, Iam stuck with 1 problem please can any 1 help me if u know the solution. Here is my problem: How to show "ALL" Values by default in Page Drop-Down Lists in Oracle BI Pivot Tables? For example, if you place Region in the pages area, a Re
-
Do I need to embed QT movies in my iWeb site if I am using another web host
I am going to be posting my iWeb site to another web hosting service (bluehost.com). Does anybody know if I will need to embed the QuickTime movies I have on my site. Do I need to purchase QuickTime Pro to accomplish this task? How difficult is embed
-
Moving iTunes playlists, ratings and play counts to a new computer
Hi everyone, I got a new MacBook and had set up and used iTunes on it for the last 6 months. I am just now getting around to moving my old (40GB) iTunes library over from my old computer. I figured out how to move the music files and I successfully i
-
When I'm placing entities in a subview for a new ER-Diagram, all the relations are shown as expected. When I do not want to show all relations, I can mark one and delete it. The question about "Remove Object" or "Remove View" I'm answering with "Remo
-
Playlists no longer sync, replaced by red circle. How do I sync my music?
Iphone 5, ios 7.0.5, playlists not able to sync, replaced by red download icon.