Sharing a Help Project in RH10

Hi All,
Two of us at our office are doing documentation in RH. We are currently using RH9, and - since I have had HORRIBLE experiences with RH and networks in the past - she is literally working off of a completely separate project, and I then import her topic pages and images when she's done with them. Obviously, this is very tedious.
I have read that RH10 has made changes that make networking better. Can anyone tell me if this is true? Would we both be able to open the same project at the same time?
Is there any other advice anyone can offer? (By the way, we do of course have separate licenses of the Tech Comm Suite.)
Thanks in advance!
Chris

Hi Chris.
The point of a source control application is to prevent two or more users editing the same file. As you can imagine this could have serious reprocussions. Having said that most source control applications have a merge facility that allows you to merge together two versions of the same file. Again this can be problematic and has to be undertaken with great care.
I think your current approach is a good solution. Importing topics takes no time at all and as long as one of you is responsible for adding TOC entries, Index keywords, CBTs, etc. it should work well. I should add that whilst RH10 has the ability to run a project on a network, I'll still be nervous of doing so.

Similar Messages

Could you help me creating a multilingual project in RH10 (using Trados for translations).

Hi,
I used to create a multilingual project in RH8 few years ago but can't read the files anymore. Could you give me advice so that I could rebuilt a multilingual project quickly. The procedure in the online help is too short and I fail when following it.
Thanks in advance.
BR
Sandrine

Hi Thank you for your reply.
In fact I wanted to use my former project just to see how I managed it. But it is "damaged" when I want ti open it after the RH update. Now I have RH10 and not RH8 anymore.
I need help on creating a multilingual project with RH10.
In the RH Help document, the procedure is :
Apply French language project settings by selecting French Language.
2 Open an English topic, create a topic for the French language, and translate the content, including the topic title from
English to French. (Do not translate topic filenames.)
3 Create French tables of contents, indexes, and glossaries.
4 Create a conditional build tag, such as FrenchContent.
5 Apply the FrenchContent conditional build tag to French content and topics.
6 Generate output for the French language.
When I create topics with same names, I have a Error message "The file already exists". May be it will work in different folders.
I'll try and let you know.
Thanks for helping.

Can you fix your help project (via coding) after importing a topic from an output file by mistake?

Yes - I admit it - I imported html topic files from an output folder of another RH project into the help project I am currently working on (the source files were lost and I needed to bring over a lot of legacy content in a hurry). However, I completely forget that the RH output html file contains unique Java scripting that is used to render the topic properly in a browser, but that same Java Script causes havoc when you open it up in as a source file in another RH Project. Needless to say, it has caused numerous weird things when I went to publish and view my files (but, surprisingly, you don’t really see or notice them in the RH Design WYSIWYG view or preview mode).
The bad news is that it took about 2 weeks for me to notice the issue (the help output is viewed on a special console running Linux with a QT browser that I only view occasionally). The good news is that is that I figured out what the problem was (that took some hours) and I can restore my help project back to a time before I did the "naughty deed".
I am now at a crossroads - do I:
Try to re-enter all of my content from the last two weeks? (Actually, to avoid repeating the same mistake twice, I will need to re-enter the text manually and NOT cut and paste from the RH output files!)
Or locate and find the offending HTML coding in my topic files (if that is even possible)? Has anybody documented what the RH output file JavaScript code injects into your files, and what files they affect?

OK - here is the documentation of this weird issue (hopefully, you can read the htlm code in the screen images):
1. In this topic, I cut and pasted some text into the table you see at the bottom of the screen. I had to reapply the “TableBody” style to this text. After doing this, I moved my cursor to the “Keyboard" text on top. Notice that it is displaying the "TABLEBODY" style, although visually, it is displaying the correct style on screen (“Heading 1”).
2.     In HTML view, notice the addition of the class= “TableBody”> code for this “Keyboard” text.
3.   I then reselected Heading 1 for this “Keyboard” text.
4.   Notice that the class= “TableBody”> code is now removed for this “Keyboard” text and has just the proper <h1> tagged assigned.

Cannot get simple merged HTML Help project going with context sensitive help

I have built a very simple project in RH9 from scratch, consisting of a main project and a sub-project now after I have modified our large project in changing every hyphens from file and directory names over a couple of days now only to see that context help still doesn't work.
The map IDs are not visible in the main project. To test it in the example, invoke the CSH-Test (context sensitive help test) from the Toolbox, enter !SSL!\Microsoft_HTML_Help\main.chm in the Offline field and a number 57 in the ID field. In our large project I'm getting nothing (no window pops up). In this example I'm getting this mystical error box, saying HH_HELP_CONTEXT called without a [MAP] section.
Christoph

Hi William,
thanks having a look at my problem. I read in another thread today a description which comes close to the problem I'm facing.
Maybe I formed the mini sample not exactly as our problem is situated. (thus the doubled map ids you were claiming).
I will try to explain again: we have a couple of CHMs in separate single help projects. These go into their own TOCs, Index Glossar etc. like in sub1->Einzel. For the merged project we produce a chm that goes into the directory of the master (main) project, like in sub1->Primäres Layout.
Each Topic in the sub project (e.g. sub1->Erstes Thema) has a symbolic link address (e.g. "Linkadresse=det_org_angaben), which is mapped to the MAP ID via the .h file.
This all used to work that way in RH5.
Now it seems that this information between the map ID and the symbolic Linkaddress gets lost with the merge process.
I am not using the same ID (57) twice in my example. The MAP ID in the main project comes from the sub1 project (see the yellow locked MAP ID).
The simplest test is using the CSH-Test in the Toolbox giving the main.chm as the Helpfile to test and enter the 57 as a MAP ID.
The idea behind is to use one CHM later to have to open in the application. The other CHMs of the subprojects only need to be present in the application directory. Then you invoke HtmlHelp(with the MAPID),like I posted in this thread.
The method you are suggesting in mapping the ID to the topic in the main project will not work since the topic is in the CHM of the sub project.
I modified the sample project once again (somehow the baggage files were not showing) to come closer to the constellation we are using in the large project, though I'm getting the "HH_HELP_CONTEXT called without a [MAP] section" error (which does not occur in our large project).
Christoph

One of the folders of Robo Help Project Manager is listed twice in Windows Explorer.

Hello Everybody,
One of the folders of Robo Help Project Manager is listed twice in Windows Explorer. One has all the subfolders and topics of it and the other has all the subfolders but not the topics. How did I get into this kind of situation? Why do I have two folders? Can somebody please answer on this?
Since my RH project is attached to Visual Source Safe (VSS), the same structure is mirroring in VSS.

Hi there
After reviewing the image I see that what you might think are two of the same folder are two different folders similar in name.
One is named Advanced_Functionality. The other is named Advanced_Funtionality (note the missing C).
I'm assuming this is the folder you are referring to?
Cheers... Rick
Click here for Adobe Authorized Captivate and RoboHelp HTML Training
Click here for the SorcerStone Blog
Click here for RoboHelp and Captivate eBooks

Need HELP (Project Issue) : Having 3 individual VIs, datalogger.vi, start vi, amksms.vi done. (How to run the VIs in sequence order - datalogger start amksms combine into 1 VIs? )

Need HELP (Project Issue) : Having 3 individual VIs, datalogger.vi, start vi, amksms.vi done.
(How to run the VIs in sequence order - datalogger > start > amksms combine into 1 VIs? )

VIs in icon.
how would it able to run in the sequence order:
data first, follow by start and lastly amk sms.
Attachments:
dsa.jpg ‏10 KB

How do I import Eclipse Help project/pages?

I have an Eclipse Help project with about 100 html topic pages that I created in Eclipse and organized in various folders. However, the editor in Eclipse that I am using is not very advanced and it's quite tedious to manage the help project and cannot easily create other help formats. I want to try RoboHelp 8 as the authoring environment and have it output Eclipse Help (which I hear it can do).
However, I can't find a way to easily import my existing Eclipse Help pages and folder structure. Is there a way to do this without breaking anything (like images or css) or having to go to each page and do some fixing up?
Ideally, I would like some kind of two-way transfer so I can share the project with others on my team using Eclipse to edit the topics; but I realize that may be too much to ask for.

Peter, thank you for your reply.
I went ahead and re-created the folder structure and imported the topic pages into each folder. This part seems to work fine. However, I have a few issues:
1) When I double-click on the topic pages they open in Notepad rather than the built-in editor. If I right-click on a topic and choose Edit With Design View, that works, but is quite tedious to do for every page. I also notice that if I make a change to the page in design view and save it, from then on it opens in Design View.
I see that the files that open in Design View have the following markup added:
<meta name="generator" content="Adobe RoboHelp 8" />
Is there a way to have these .html pages always open in Design View by default, at least for this project?
2) I used the instructions here to create Eclipse Help: http://blogs.adobe.com/techcomm/2009/12/how_to_generate_eclipse_help_from_robohelp.html
When I bring up the pages in Eclipse, the ones that I edited using the Design View seem OK (so far), however the ones that were imported from original Eclipse Help format now show this error when I try to view them:
An error occured while processing the requested document:
org.xml.sax.SAXParseException: Content is not allowed in prolog.
at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
at org.eclipse.help.internal.dynamic.DocumentReader.read(DocumentReader.java:56)
at org.eclipse.help.internal.dynamic.XMLProcessor.process(XMLProcessor.java:49)
at org.eclipse.help.internal.xhtml.DynamicXHTMLProcessor.process(DynamicXHTMLProcessor.java: 66)
at org.eclipse.help.internal.webapp.servlet.DynamicXHTMLFilter$1.close(DynamicXHTMLFilter.ja va:81)
at java.io.FilterOutputStream.close(Unknown Source)
at org.eclipse.help.internal.webapp.servlet.FilterHTMLHeadAndBodyOutputStream.close(FilterHT MLHeadAndBodyOutputStream.java:311)
Any idea why I am getting this error? I am using the EclipseHelp.jsx that came with RoboHelp 8.0.0.203 (incidentally, the "latest" script file pointed to in the link above actually has an older copyright date so it would not seem that it's the latest). Would solving #1 solve this issue?
3) I set a default topic for my books, which works fine in Web Help. But when I try to view the book in Eclipse, it displays a Contents list instead of the default topic.
Any idea how to fix this?
Thanks in advance,
Dan

Images in my FrameMaker 10-sourced Robohelp Web Help project are turning out as blank JPEGS appearing as blank spaces in the final output. How can I fix this?

I'm attempting to create online help sourced from a FrameMaker 10 book using Robohelp 9 and Web Help (primary layout).
The text is interspersed with numeorus small icons which, in the FrameMaker documents, are .bmp images inserted into anchored frames in the lines of text.
Most of these icons were imported by reference into the FrameMaker book's chapters. Some were copied from another FrameMaker book and pasted into the present book.
Many of these images are turning out blank in the finished Help project.
Robohelp seems to convert these images into JPEGS.
In the source FrameMaker book, the images which appear OK in the Help project have Object Properties including: Facets: FrameVector JPEG ... Referenced File: No File
The images which appear blank have different object properties there: Facets: DIB ... Referenced File: (address of the image's source file)
How can I fix this and make all of the images appear in the Online Help?

Sorry, Jeff. I missed the key word in your instructions. Well, I did the import and still no luck. I'm getting the exact same results with the same images. (In some cases, I'm even getting hidden conditional text from the FM document body showing up in the image's frame instead of the image! See below.) This is bizarre behavior, but it's not new with the import. It is happening both in the linked and imported WebHelp with the same exact images. (Just another piece to complicate the puzzle.) So we have some jpeg images that are blank, and a few that are glitchy. From what I can tell, the commonality, besides the fact that all these new images are in jpeg format instead of gif format, is that all the blank and glitchy images are in a text inset. I'm beginning to think maybe RH just doesn't support text insets at all.
Arnis, I'll have to ask my colleague how she created the images next week when she's back from vacation. I have no clue if there are any differences between the jpegs and why some are showing up correctly. What do you mean by "compression type or level?" Are you asking about the resolution (high, medium, low) she chose when saving the images, or which program she used to do the screen capture and editing? (We have Adobe Photoshop CS5 and FM 11).
My next step is to copy-paste all the content from the text insets into my FM document (in the book I am linking) and re-render to see if that solves the problem. It will make single-sourcing impossible because I'll have to copy-paste the new content and images my colleague creates into my document each time we do an update, but oh well.
Here is an example of a glitchy image in RH:
And here is what it looks like in FM:
So bizarre!

How achieve highest playback quality from shared iMovie HDV Project?

I have a Sony HDR-HC9 1080i HDV tape camcorder and I am able to play back HD video to either a Mac computer or to a Panasonic Full HD 1080p TV. Playback quality of unedited HD holiday video footage to TV using HDMI cable and to the computer via Firewire is superb. This excellent playback quality is also preserved in an edited iMovie Project in HDV format 57 minutes long and 48 GB in size which I made from the original 90 minutes holiday video footage.
The problems arose in trying to preserve this high quality when sharing the iMovie Project. Before I bought this HDV camcorder I had a Sony DV tape camcorder and I always used to make an archive tape from an edited DV Project by exporting the iMovie Project back to tape. However, when attempting to do the same with this latest HDV 48 GB Project the computer message informed me that it would take about 43 hours to do this. So that is out of the question!
Next I decided to make a Quicktime movie from the iMovie HDV Project using Full Quality compression via Apple Intermediate Codec (1440 x 1080). This took 12 hours to do! Computer viewing of the resultant 44 GB movie gave excellent image sharpness in still views, but for views of moving objects and also panned footage from the camera, closer viewing showed fine comb-outlining on most objects, but especially on narrow vertical objects. Is this what some of you call "jaggies" and is it an interlacing artifact? Whatever it is it was NOT in the iMovie Project but was introduced by the compression process Project->>Movie. Still worse was the jerky playback of the movie. The "IMovie Inspector" info confirmed that the movie had been made during the compression process at 25 frames per second whereas playback was in the range of only 3 to 10 fps! Previously made shorter Quicktime HD movies have not shown this jerky playback and played at 25 fps. Can anyone explain why this jerky playback occurred with the the longer 44GB movie?
Finally I made a DVD by dragging the uncompressed iMovie HD Project icon directly onto a DVD theme in iDVD and burning. The result was OK on both the computer and on TV but not great. Close viewing on the computer showed an effect which looked like a thin film of water rippling horizontally. This effect also showed in TV viewing of the DVD. Interestingly, this effect was almost eliminated when "Deinterlace" was UNCHECKED in the iDVD player viewing options.
My own conclusion is that the highest quality for archiving and playback is achieved by storing the large edited iMovie HDV PROJECT on an external hard drive and playing it back at full screen size on the Mac computer. In this way the iMovie editing functions such as the Timeline are hidden from view and cause no distraction when watching the superb HDV quality.
IS THERE A BETTER WAY?
Please comment and advise.
Vee Kay

I have a Sony HDR-HC9 1080i HDV tape camcorder and I am able to play back HD video to either a Mac computer or to a Panasonic Full HD 1080p TV. Playback quality of unedited HD holiday video footage to TV using HDMI cable and to the computer via Firewire is superb. This excellent playback quality is also preserved in an edited iMovie Project in HDV format 57 minutes long and 48 GB in size which I made from the original 90 minutes holiday video footage.
The problems arose in trying to preserve this high quality when sharing the iMovie Project. Before I bought this HDV camcorder I had a Sony DV tape camcorder and I always used to make an archive tape from an edited DV Project by exporting the iMovie Project back to tape. However, when attempting to do the same with this latest HDV 48 GB Project the computer message informed me that it would take about 43 hours to do this. So that is out of the question!
Next I decided to make a Quicktime movie from the iMovie HDV Project using Full Quality compression via Apple Intermediate Codec (1440 x 1080). This took 12 hours to do! Computer viewing of the resultant 44 GB movie gave excellent image sharpness in still views, but for views of moving objects and also panned footage from the camera, closer viewing showed fine comb-outlining on most objects, but especially on narrow vertical objects. Is this what some of you call "jaggies" and is it an interlacing artifact? Whatever it is it was NOT in the iMovie Project but was introduced by the compression process Project->>Movie. Still worse was the jerky playback of the movie. The "IMovie Inspector" info confirmed that the movie had been made during the compression process at 25 frames per second whereas playback was in the range of only 3 to 10 fps! Previously made shorter Quicktime HD movies have not shown this jerky playback and played at 25 fps. Can anyone explain why this jerky playback occurred with the the longer 44GB movie?
Finally I made a DVD by dragging the uncompressed iMovie HD Project icon directly onto a DVD theme in iDVD and burning. The result was OK on both the computer and on TV but not great. Close viewing on the computer showed an effect which looked like a thin film of water rippling horizontally. This effect also showed in TV viewing of the DVD. Interestingly, this effect was almost eliminated when "Deinterlace" was UNCHECKED in the iDVD player viewing options.
My own conclusion is that the highest quality for archiving and playback is achieved by storing the large edited iMovie HDV PROJECT on an external hard drive and playing it back at full screen size on the Mac computer. In this way the iMovie editing functions such as the Timeline are hidden from view and cause no distraction when watching the superb HDV quality.
IS THERE A BETTER WAY?
Please comment and advise.
Vee Kay

Sharing Date between Projects

I can copy slides and use the Library to share data. I can
also combine multiple projects into a chain of projects. Is it
possible to have a source of data that can be shared accross
multiple projects? For example, lets say I have one slide I want to
use across 30 projects. Right now I can create a slide and copy it
into 30 projects. I can also create a project with the one slide
and have all projects run the second project, but starting a new
movie (I think) won't allow the user to go back to the previous
movie.
Is it possible to link data so multiple projects can point to
one or multiple files with the one or multiple slides. So when I
update that one slide, it updates it in 30 locations. I don't have
to update 30 slides. Its kind of lik building common pieces and
sharing them so you don't have to duplicate the same work multiple
times.
Shawn

Yeah, what you are talking about used to be called dynamic
link libraries or just dynamic linking - might still be, for all I
know. No, Shawn, it's not possible in Captivate. Not the way you
want to use it - sorry.
You've been around long enough to know the drill -
click
here to go to the Wish List and enter a request for this
feature
. It's not a bad idea IMO. Good luck with the request...
.

Can RH let me insert a custom/personal icon for my published HTML Help project?

Just wondering if there's a setting inside of RH8 for setting
the icon in the browser URL bar?
(for example, there's a little red and white icon with barely visible "Adobe" in the browser address bar above...or facebook has the blue square with the white f in it). What if I have a fave icon; how do I associate it with my help project (rather than the blue e ...)
Thanks.

Hi there
These are known as "Favicons". Unfortunately there isn't anything RoboHelp will do to assist you with them. There has been some recent discussion about them that you will likely find useful. Try the link below.
Click here to view
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
SorcerStone Blog
RoboHelp eBooks

Not a recognized Help Project File

I need to address two problems which together have me 'dead
in the water'.
First, I am unable to open any RoboHelp HTML Project file.
Attempting to do so produces the following message: The file
"filename.xpj" is not a recognized Help Project file and cannot be
opened.
Second, every attempt to create a new Project produces the
following result: An Adobe RoboHelp 7 message box opens, explains
the RH7 has encountered a problem and needs to close - sorry for
the inconvenience. The 'more information' link identifies
utilities.dll as the module name - I tried registering the dll but
it has no entry point. Anyway, clicking OK crashes RH.
I've tried searching for the first condition but the forum's
search engine is down. Any help is appreciated.

This was a problem seen in an earlier version and the cause
was never really identified. However, some solutions were found and
these are in Snippets on my site.
Haven't heard of it for a while now though and certainly not
with RH7.

Import Web Help Projects

I have multiple Web Help Projects that I want to convert to
one HTML Project so that there is only one project to manage. I
don't want to link from a master project, I want it all embedded in
the one projectso that I end up with one .xpj Help file. It is easy
enough to import one but not the 5 that I have. I want all the map
files for each hpj project to be imported as well. Is there a
simple method for this? Thanks in advance.

Given the small number of topics, it would seem easier to
have one project provided you can get the layouts you need.
The problem is that the CPD for the all in one project has to
know about all the topics and to do that, you have to import them.
There aren't many and you can import all the topics in a folder in
one go so it shouldn't take that long.
Your cross project links will be broken so you'll have an
exercise on fixing that.
The map files can probably be manually merged in Notepad or
similar. Similarly with the TOC and Index files.
Take a copy of the project and run some tests. It will need
some tweaking. Only you can decide whether it is worth the effort.

Need help with a Context Sensitive Help project

Hey everyone,
I'm the RoboHelp administrator around here - I've done some
RoboHelp projects and created the procedures, stylesheets and
templates for our company's WebHelp, WinHelp 2000, and JavaHelp
projects, but now I'm sort of the consultant for the content
authoring team that creates the help systems. I think I need to
call in some help from the forum about a project I'm consulting on.
Here's the situation: A project team here thinks they want
field-level help to support a web-based application. I've told them
"That's fine, it's possible, just don't demand that the help author
create topics for EVERY field, even the obvious ones like "Name",
"Address", "Zip", etc, since there is very, very little value in
doing that." We already have a very old help system that is being
CONVERTED to WinHelp 2000 (from a "mocked-up" version of WinHelp)
that did just that - every field in every screen was a separate
topic, even if it wasn't useful. Every topic was essentially "This
information goes in this field". As a result, we abandoned creating
an Index, since we had about 27 entries for "Name", 13 for
"Address1", 15 for "Address2", etc.
Well, I just heard back yesterday that they totally ignored
my suggestion and they want to go ahead with the "all help for all
fields" idea. I still think I have a chance of convincing them to
choose context-sensitive topics wisely, if it can present my case
clearly and be persuasive. I just found John Daigle's article about
context sensitive help (
http://www.macromedia.com/devnet/robohelp/articles/context_help.html)
and I'm looking at it now (very well done, by the way - thanks
John!). It looks like, from first glance, that it might convince
that project team that "Whoa, this context-sensitive thing is more
than we bargained for", which is what I want them to think, since
they have very limited resources and a help author that is VERY new
to RoboHelp and WebHelp. I personally have never built a
context-sensitive help project with different windows, but I have
built several projects using conditional builds.
What does everyone think of this approach?
Thanks,
Jim

Here's a nice, convincing argument that I just thought of -
the only thing wrong with it is that I don't know if it's true or
not.
Does the end user's browser cache the .htm files for the help
topics that are grabbed from the server? If so, consolidating the
field definitions lessens the server traffic.
(Always get the server guys on your side - everywhere I've
worked, they wield a big stick!)
Also, I'm a big believer in functional help topics, but I
have compromised for some clients and included one-per-screen
conditional topics with the field labels. John, I wish I had known
about the map numbering trick back then - I would have loved to
give them F1 help.
Elisa

Sharing resource across projects in OSB11g

Hi,
We have some common resources like Service Account, Proxy Server, JNDI Provider, Custom Resources etc in our projects that should be shared across different projects. Among these resources like proxy server can be created only in Configuration projects and resources like service account can be created only in osb project.
I found that files created in configuration project can be used across the projects. Is there any way to share the resource across the configuration projects? i.e accesing Service account residing in confuguration project from another configuration project.
I tried with project references but did not get success. And i tried to do standards java mechanism creating jar of configuration project and adding this jar to another projects, seems to be this is not possible.
Please let me know the best way doing this? Is there anyway to share wsdls and xsds too?
Thanks
Siva

Hi Manoj,
Yes, i am referring to configuration project of OEPE. I am creating all resources in OEPE and the deploying the same to OSB. I have created different configuration projects for different systems we have, that will have all related projects. Because of this the need has come for sharing the resources across configuration projects in OEPE itself. I am able to reuse the resources across the projects within single configuration project.
When i deployed i am seeing only the projects in OSB, so able to share the same in sbconsole.
What's the general practice while using OEPE? single configuration projectfor all the projects in them?
Thanks
Siva

Sharing a Help Project in RH10

Similar Messages

Maybe you are looking for