Do I need Robohelp with FrameMaker 2017 to generate CSH

New Here ,
May 11, 2017 May 11, 2017

Copy link to clipboard

Copied

Hello! I searched this forum for a while, so sorry if this has been asked before. If I'm using FrameMaker 2017, do I need Robohelp to generate Context Sensitive Help (CSH)?

Thanks,

TOPICS
FAQ

Views

976

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
May 12, 2017 May 12, 2017

Copy link to clipboard

Copied

No, but the interface is much easier to work with (IMHO) in RH than it is inside FM.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
May 12, 2017 May 12, 2017

Copy link to clipboard

Copied

(teasing Jeff in this first part)
No, but you'll find that the Fm>Rh setup has challenges, and the direct Fm publishing has challenges as well.

A personal choice, to be sure; I choose the Fm route over the Fm>Rh route.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Beginner ,
May 31, 2017 May 31, 2017

Copy link to clipboard

Copied

Hi Matt,

my team just switched to FM 2017 and we would like to generate CSH using Framemaker (not Rh). Could you let me know how you handle the help map file? As far as I have understood, you need to manually adjust this file everytime you generate the output, right? Is there any other way? This just doesn't seem feasible...

Thanks and BR

V.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Jun 02, 2017 Jun 02, 2017

Copy link to clipboard

Copied

Unless you're adding CSH markers, you shouldn't have to touch the map file. But as with Rh, if you need to add new markers or adjust IDs, you need to adjust the .h file. The difference is whether you do this in a text editor (easy enough) or in Rh's UI (even easier).

Jeff's right, in that the .h interface makes it easy to do this in Rh, but then again, there's a lot of overhead in managing and setup of integration, not to mention a heavy processing load each time you update Fm content in Rh.

Bottom line: You need to travel down each road to see which is the more rational choice.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Community Beginner ,
Jul 07, 2017 Jul 07, 2017

Copy link to clipboard

Copied

Thanks for your reply. We have found a different approach and it seems to be working. Here's the link, if you're interested in generating CSH with FM2017: Context-sensitive help in FM 2017 - map file and code

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Feb 15, 2019 Feb 15, 2019

Copy link to clipboard

Copied

Yes, the thread you found describes the process I outlined above...create the TopicAlias markers, manually create the .h file and store with your source Fm docs, then publish. The extra details Dieter provides are very illuminating.

One user was concerned about having to adjust the .h file for each new publish. There's no need for that. The only time you modify the .h file is when you modify or add to your TopicAlias markers. The same is true for Fm>Rh, or for a full Rh workflow.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Engaged ,
Feb 17, 2019 Feb 17, 2019

Copy link to clipboard

Copied

I would like to add that I have been working on this, and submitted a HTML 5 context sensitive help file based on Frame 2017 only to R&D, and it works really well.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Engaged ,
Feb 17, 2019 Feb 17, 2019

Copy link to clipboard

Copied

The code that worked in the end for the programmer to call the CSH was

index.html?rhmapid=<code>

when she used the CSH_topicname

and not the number from the .h file

If you need the full instructions that we used for the whole procedure, i can copy them from here, but they were taken from the Frame Help files, and from posts here.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Feb 18, 2019 Feb 18, 2019

Copy link to clipboard

Copied

My only concern in using the CSH_# is that if you introduce/delete a  marker, your mapping may increment/decrement, which might throw off the numbering of markers after the new/deleted marker.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Engaged ,
Feb 18, 2019 Feb 18, 2019

Copy link to clipboard

Copied

My understanding of how this works, is that there is an h file, and after the initial compilation by the system, it does not change unless the user edits it.

So the numbers will not change after the first compilation

The h file must be in the folder where the source Frame is.

The way we got it to work was to use the markers and not the number, we did try to use the numbers but could not get it to work.

So I do not see why this should create a problem.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Community Professional ,
Feb 24, 2019 Feb 24, 2019

Copy link to clipboard

Copied

I suppose if using the CSH_XX markers is working, then that's great.

I just implemented CSH for a client last week and had great success creating Map IDs (via TopicAlias Markers) and then using the map numbers specified in the .h file.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Contributor ,
Feb 17, 2019 Feb 17, 2019

Copy link to clipboard

Copied

Unless you have a really complicated output requirement, the built in publishing system with FM should be just fine. If you need to tweak all the details of the output, then maybe RH would be a good compliment. We have found that using the CSH system without adding RoboHelp to the mix works just fine.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Contributor ,
May 14, 2019 May 14, 2019

Copy link to clipboard

Copied

FrameMaker's subset of RoboHelp functionality does not include the ability to generate a map file (a basic feature of help authoring tools). While it's technically possible to create and maintain the map file manually in a text editor, I would strongly recommend getting the Technical Communication Suite and linking the FrameMaker source to RoboHelp to generate help.

Linking (rather than importing) FrameMaker source is not covered in Adobe's documentation, so I created this sample project and doc:

http://lauriston.com/fm10_link_to_rh9.zip

The correct way to write help calls is documented here (which is referenced in Using FrameMaker):

https://help.adobe.com/en_US/robohelp/2017/robohtml/#t=book%2Frob_createhelp_ch%2FInformation_for_de...

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Adobe Employee ,
May 14, 2019 May 14, 2019

Copy link to clipboard

Copied

With next release of FM, the plan is to continue to improve HTML and other output types and work is underway on  a new publishing engine.

thanks

Amitoj Singh

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines
Engaged ,
May 14, 2019 May 14, 2019

Copy link to clipboard

Copied

LATEST

From answers in this thread it seems each method has advantages and disadvantages.

My version of Frame actually generates the map file.

Of course there are also considerations of budget, the size of the source Frame and the number of projects you have to manage.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
community guidelines