Pagination, topic naming, and context-sensitive Help

This question was posted in response to the following article: http://help.adobe.com/en_US/techcomsuite/tcs/using/WS1b49059a33f77726-31aee1b1342288940d-7 fd8.html

This TCS4 Help documentation is very vague on how to do most of the things it's talking about. For example: "Create separate HTML topics based on FrameMaker paragraph formats - You specify the heading styles in FrameMaker that should be used as the page break. For example, if the FrameMaker file contains ten topics, each with subtopics, tasks, and tables, you can have each topic convert into a separate HTML file. If each of these topic headings is at Heading 1 format, you can set each Heading 1 topic to be created as a separate HTML topic. On the other hand, if you set the pagination at Heading 2, separate HTML files are created for each Heading 2 topic" ... how do you actually do this? Can I do it within FrameMaker itself? Or do I do it somewhere within RoboHelp?

Similar Messages

  • Map.xml and context-sensitive help question

    We're changing the tools we use to generate JavaHelp from RoboHelp to WebWorks.
    RoboHelp's output always includes a file named map.xml. WebWorks doesn't include this file.
    My understanding is that map.xml is what applications use to find the correct context-sensitive topic. Is that right? Will the app be able to find context-sensitive files without it?
    Stan Stansbury

    There are a couple of posts about masterdata.xml that seem to indicate it's not a problem. See if either of these help.
    Context Sensitive Help Question
    MasterData.xml
    For the 'main portal page' bit - maybe the developer wants to know the Start Page of the project, rather than the Default Topic? I'm not very familiar with CSH and webhelp, so I'm uncertain of the details the developer needs, but I wouldn't think you'd have to change anything as long as they have all the necessary details.
    Amber

  • Glossary and context sensitive help

    Hi
    I was wondering if it is recommended to include the same terms and definitions used in context sensitive help and in the glossary or should I keep them seperate?  Also, when I printed the glossary in RoboHelp verison 8 for HTML, I only got the terms and not the related definitions?
    Thanks for advice
    Caryn

    Hi again
    When you do this, did you try changing the dialog as shown below?
    Cheers... Rick
    Begin learning RoboHelp HTML 7 within the day - $24.95!
    Click here for Adobe Certified Captivate and RoboHelp HTML Training
    Click here for the SorcerStone Blog
    Click here for RoboHelp and Captivate eBooks

  • Converted WinHelp to HTML Help and context-sensitive topics aren't working.

    Converted WinHelp to HTML Help and context-sensitive topics
    aren't working. Anyone run across this?

    I am a developer and we have big project that needs to be
    converted from winhelp to HTML help. I received only the .CHM help
    file from the help auther. I added the HTMLhelp.lib file and
    HTMLhelp.h file in to my project. I tried to change atleast one
    page of the dialog. I added on helpinfo function htmlhelp function
    call and hard coded the .chm file path and for the right click I as
    well did the same thing. But I am getting "No Help topic is
    associated with this item" upon F1 key and crash after the right
    click with wincore.cpp error.
    The code is as below.
    BOOL CCnvCfgGenNRecPage::OnHelpInfo(HELPINFO* pHelpInfo)
    // TODO: Add your message handler code here and/or call
    default
    if (pHelpInfo->iContextType == HELPINFO_WINDOW)
    int nCtrlId = pHelpInfo->iCtrlId;
    DWORD dwContextId = pHelpInfo->dwContextId;
    //THE NEW HTMLFUNCTION CALL
    ::HtmlHelp((HWND)pHelpInfo->hItemHandle,
    "D:\\vista_setup\\Patmob\\PatMob.chm",
    HH_TP_HELP_WM_HELP,
    (DWORD)&IDARRAY(nCtrlId, dwContextId)) ;
    THE OLD CODE
    ::WinHelp ((HWND)pHelpInfo->hItemHandle,
    AfxGetApp()->m_pszHelpFilePath,
    HELP_WM_HELP,
    // HELP_WM_HELP flag brings up pop-up help and expects an
    array
    // of DWORD pairs of the control ID and the context help ID
    (DWORD)&IDARRAY(nCtrlId, dwContextId));
    return TRUE;
    DO I NEED ANY OTHER FILE? Should I checked out the dialog h
    file and .hm file which compling the html related code?
    Regards,
    Kreena

  • Context-sensitive help - where is the CS topic folder in the output files?

    I have created a FlashHelpPro help file in RoboHelp 7 HTML. In the project setup pane, I have Map ID'd my context-sensitive topics and linked them to their respective pages. I generated the project, but there is no folder containing the context-sensitive topics in the output files. As a result, the developer suggested that I need to create a separate folder in the Project Manager that contains all the context-sentitive topics. Is this actually the next step, or can the developer find what he needs elsewhere in the files?
    I haven't seen anything about creating a separate folder in the Project Manager, which seems redundant as there is the 'Context-sensitive Help' folder already present in the Project Set-up. Do I need to create a separate folder, as suggested by the developer? If not, where can he find the context-sensitive files in the output? Thank you.

    Hi,
    What do you mean that the context sensitive topics are not in the output? RoboHelp generates your output and (in WebHelp, so the same should count for FlashHelp) puts the context sensitivity in cshdat_webhelp.htm. Your developer doesn't need to worry about this, he just has to get his call right.
    For information on calling the help, see http://www.grainge.org/pages/authoring/calling_webhelp/calling_webhelp.htm. It's for WebHelp but it should be the same for FlashHelp.
    If your developer only wants to know which mapid's he has to call, you best give them your map files (the .h files).
    Greet,
    Willam
    This e-mail is personal. For our full disclaimer, please visit www.centric.eu/disclaimer.

  • How to provide link for the topics of Webhelp in the Context Sensitive Help in RH10 ?

    I am using Robohelp 10 and currently working on Context Sensitive Help in which there is a need to create certain links for the topics that are present in Webhelp. My area of concern is that we can't use map id's since CS Help and Webhelp had already been created and it will be a mess for developers too since they had to relook their code. While generating output we don't give js files to our developers, we just give them folders and css file. Considering all these points,  is there any way to provide a link for a topic of Help in Context Sensitive Help? Anyone, Please Help !

    I'm not clear on what the question is. You seem to want CSH and to not use Map IDs. That leaves other methods to which Willam has already pointed you. Essentially it's Map IDs or URLs. So are you asking if there is a method that does not involve the developers? No as it is they who must create a link of some sort from a screen to a topic.
    You also say you don't give JS files, just folders and CSS. The Rh WebHelp output contains many files and folders and you have to give the whole output or the help will not work properly. Exactly what are you giving them?
    See www.grainge.org for RoboHelp and Authoring tips
    @petergrainge

  • RoboHelp 10 Context Sensitive Help Displays Full Help File, Not the One Topic

    I create WebHelp with RoboHelp V10 that contains context sensitive help to be displayed in a software application. When I click on any of the field names in the application, the entire Help file displays with TOC, Index, & Search, tabs but not the field level popup definition the Map ID is mapped to. I moved the RoboHelp V9 generated version files back to the server and the context sensitive help works correctly. Is there something different I need to deploy to the server to display the correct Map ID? I am using IE8 to test both conditions.
    The Map ID's the software application calls to the Map IDs have not changed between the versions of RoboHelp.

    Whilst the HHP is required to create CHMs, it can also be used to open damaged projects. Just be aware it will only be as good as the last time you generated some help and not just CHMs.
    See www.grainge.org for RoboHelp and Authoring tips
    @petergrainge

  • Error Opening 2nd Context-Sensitive Help Topic

    Hi All,
    We were having an issue that when opening a 2nd instance of the context-sensitive help (with the help already open), a blank window would appear and we would receive an "Access Denied" error related to the whcsh_home.htm file. I found the fix posted on Peter Grainge's site at http://www.grainge.org/pages/authoring/rh8/using_rh8.htm (thank you!), and this resolved the issue in IE7 and Firefox. However, our QA team is reporting that the issue still occurs in IE8.
    Can someone please confirm that this fix works for IE8 as well as IE7 and Firefox? I'm able to load a 2nd instance of the help in IE8 on my computer without an issue after implementing this fix, so I think this is an issue specific to the tester's machine, but wanted to post here for any additional information.
    Thanks in advance for any assistance.

    I'm just now running into this IE 8 issue with my Robo HTML 6 WebHelp project. It worked (and continues to work) perfectly in IE
    7, but not in IE 8. The fix didn't work for me. Any more info about (or fixes for) this one?
    thanks
    writer5010

  • Is there a way to open context-sensitive help in a new window with RH10?

    I'm linking my context sensitive help using the RoboHelp_CSH.js file to my web application.
    The correct topic opens when I click the help link, but it opens in a pop-up window. This causes problems in Firefox and Chrome (which block pop-ups by default).
    Is there anyway to force the context-sensitive help topics to open in a new window?
    I've tried adding
    <p><A HREF="javascript:RH_ShowHelp(0,'http:/myurl/index.htm', HH_HELP_CONTEXT, 100)" target="_blank">Help</A>
    which opens an empty tab in Firefox with no content in it. And it doesn't work in Chrome either.
    Has anyone else run into this? Any help is greatly appreciated.
    Thanks,
    Colleen

    Hi and welcome to the forums.
    Using the RoboHelp API, that is quite a bother. (Read: major pain)
    Fortunately, there is a simple solution:
    <a href="http://myurl/index.htm#<id=4>>newwnd=false" target="blank">Help<a/>
    This link does exactly the same, only opens the help in a new browser window.
    You may also be interested in my custom WebHelp API: http://www.wvanweelden.eu/blog/2012/08/03/custom-webhelp-apis
    Greet,
    Willam

  • 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

  • Context-sensitive help breaking in RoboHelp 8

    Peter - you're a lifesaver and I hope you're out there today . . . or somebody's out there who can help . . .
    I shouldn't have said that in my last post about something being the "wackiest" thing I'd ever seen in RoboHelp. Now we have a new problem that's much more serious.
    We have an aforementioned (in previous post) enormous RoboHelp 5 project, converted to RoboHelp 8 after much anguish, replacing hundreds of WYSIWYG graphics with true code etc. Map IDs were *not* touched.
    Now the context-sensitive help for our VB app is not working, even though the map IDs are still in place on both ends (dev and docs) and all the relevant .hh files were included in my compile. Some topics (within the same help file) appear when called from the app, some don't.
    A developer had a theory that in one case the topic ID was assigned (on their end) during design time, the other during run time. He's testing it now.
    If it doesn't work, I have no idea where to begin. Is anyone aware of any changes in RoboHelp 8 that would affect the way the .hlp links to VB?
    Thank you! - Sandy

    Hi all,
    I wanted to thank everyone who responded and post a follow-up to this, as well as a caution.
    I felt like the world's biggest *** when I found this out, but it turns out that in my .doc files for this particular .hlp file (our project includes multiple .hlps)  "Automatically Generate Map IDs" was turned on, and of course it should not have been. So the problem was on my end, not the software developers' end.
    However - part of the reason it took me so long to figure this out is that I know I never turned that setting on. The other writer on this project has been here longer than I have and never would have turned it on. And it's not like that command is easy to stumble upon and set off accidentally (For those of you who don't know, it's under File>>Project Settings in RoboHelp Explorer). I have to think that RoboHelp defaulted those settings in somehow, maybe during our conversion from 5 to 8.
    (Unless someone knows a way that you *can* just stumble on this setting and trigger it accidentally, maybe by inserting some random character in your .hpj . .  . if anyone does, I would love to know about it.)
    So, especially if you just changed versions of RoboHelp, I would encourage you to be proactive and, if you don't want "Automatically Generate Map IDs" turned on, double-check and make sure nothing is selected for Automatic Map ID Generation on the "Map Files" tab of the Project Settings dialog. After what happened to me this last time around, I'm probably going to check it every time I compile. - why not add another neurosis to the list?
    Thanks again - Sandy

  • Context-Sensitive Help Issues

    I have problem where context-sensitive help markers disappear
    from my .h files.
    I started with a .h file from my old WebWorks project. After
    a little reformatting, I was able to get the CSH Map IDs to load
    and map properly to my RH topics (I had to do the mapping manually
    even though the topic names were the same) . I was also able to add
    several new Map IDs to facilitate help in the latest version of our
    product. The final help was tested and worked properly.
    Now that it's time to update the help for another new release
    of our product, I am noticing that many, many of the Map IDs that
    were in my project before have now disappeared. Anybody have any
    idea what is happening here?
    I'm sick of struggling to get RH to play nice with these .h
    files. Manually remapping the Map IDs to the topics each time we
    release a new project is terribly dull work and time consuming.
    Is there any way to add the Map ID numbers to the CSH markers
    in FM so that RH can automatically map the IDs to the topics? I
    want to use the Map IDs we already have established with our
    development team; I don't want RH's automapping which starts at one
    and advances incrementally through all of your topics).

    I think you dint check the option "Project Map File" from drop down list in the dialog box for editing Map ids.  For this, in the main menu point to "Edit" tab, select "Map Id's". Edit Map Ids dialog box appears. Choose the option for Map File as "Project Map File" from the drop down list.

  • Context Sensitive Help in Different Formats

    I have a large help project in Robohelp HTML 8.  My project manager would like to have context sensitive help for many objects in our application.  I believe that context sensitive help cannot be used if you are generating a WebHelp format, but that it can be used for a Microsoft HTML format (chm file).  Is this correct?

    I thought you had CHM help working as CSH and were looking to go to WebHelp?
    Both outputs can be used to provide CSH.
    How the topics are called will be decided by your developer.
    See www.grainge.org for RoboHelp and Authoring tips

  • Context-Sensitive Help in RoboHelp 9

    Hi -- I recently upgraded from RoboHelp 5 to RoboHelp 9.  My first WebHelp project that I created using RoboHelp 9 is giving me problems with Context-Sensitive Help.  When a user clicks on a Help link that is supposed to bring him/her to a specific topic, the user is brought instead to the project's main screen with the TOC, Index, and Search. 
    Is there something specific that my Developers and I should be doing differently in RoboHelp 9 vs. RoboHelp 5?  Is the problem being caused because I made the jump from 5 to 9 without upgrading in between? 
    Any help that anyone can offer will be greatly appreciated. 
    Thank you.

    Maybe this link will help.
    http://www.wvanweelden.eu/robohelp/context_sensitivity_in_webhelp
    See www.grainge.org for RoboHelp and Authoring tips
    @petergrainge

  • Setting up context sensitive help for WebHelp in web application.

    Hi,
    I'm working on a help system for a web application. It will include context sensitive help triggered by an icon on the screen, and the Topic will open in an iframe with a set size. The developer has already set up the iframe that pops up when the icons are clicked. He is giving me the ID for the screens with the help icons as a fully qualified java file name. I'm not sure what the correct process would be in RoboHelp to map the ID's to the topics.
    1. Do I create a map file using the list of ID's the developer sends me? Would it be in this format:
    #define Topic_Name Java_File_Name
    2. Do I then add the ID to the appropriate help Topic using Project Setup pod Context-Sensitive Help folder?
    3. When I generate the layout I specify the map file I created above (.h extension)
    3. If the developer already set up the iFrame size, is it correct that I don't need to create a custom window to set up the size? Is there a way to set it so two panes open? (I believe using the method above one pane opens with link to navigation pane)
    Thanks in advance,
    Joanne

    Welcome to our community
    See if the link below helps.
    Click here to view
    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

Maybe you are looking for