Glossary Markers FM9 to RH7

I hope I'm posting this in the correct place!
I am learning FM9 Structured and slowly building new templates/EDD for our large existing company user documentation.  The plan is to use RH to publish it to html, pdf, etc.
I'm trying to figure out how the glossary markers work in FM9 and how to set them up properly to be imported into RH.  No one in the FM discussion groups seems to be able to help me.  My main confusion is that I can't figure out how to mark something within FM itself.  The way I'm understanding the documentation it goes like this:
I put my cursor on the term I want to mark (for example: name)
I open the Marker pod, and select Add New.
The documentation says that what I type in the Marker Text window becomes what I think of as the term name and the paragraph that the marker is in becomes the definition.
I click New Marker and voila!
However, no matter what I try, when I create a List of Markers (glossary), all I get is whatever is in the Marker Text window and the page number. There is no Term - Definition.
There's one other thing I don't understand - but maybe this will answer itself if I could get the above to work?  My understanding of a glossary is one definition that can be linked to from many places throughout the documentation.  For example: I define Name the first time it is used, and then I can put a "name" marker anywhere else and have a pop-up or link to the name definition.  If the definition has to be in the text at every point that you insert a marker - then what would be the point?
I feel like I'm going around and around in the documentation and I apparently have some kind of mental block, because it's just not making sense.  I would REALLY appreciate it if someone could explain to me either what the process is or what I'm mis-understanding about what the process actually does.  I've tried to include the relevant info, but if you need anything else from me -please don't hesitate to ask!

Technical Communication Suite allows you to mark Glossary terms and definitions in FrameMaker source content, import them in RoboHelp and finally publish them to various ouput formats generated through RoboHelp.
If you are using TCS 2 or TCS 3, here are the steps to achieve it.
Marking Glossary Term and Defintion in FrameMaker
======================================
1. Place the cursor at the beginning of the paragraph in FM document which is to be marked as Glossary definition
2. Open the marker Pod (Special->Marker)
3. Select the Marker Type as "Glossary"
4. Add the Glosary term as Marker Text
5. Save the FM document
Please note that generating "List of Makers" creates a list of marker text with each term linked to paragarph it points to.
Importing FM content to RoboHelp and publishing it
=====================================
1. Create a RoboHelp project
2. Link/Import the FM document to RoboHelp project
3. Mark "Convert Glossary" option in Import Wizard or Linked document properties(Edit->Properties) dialog
4. Finally update/import the content.
5. The generated glossary(term-definition pairs) can be viewed in Glossary pod by opening the glossary from Project Manager Pod
6. If you wish to link glossary terms instances with the glossary definition within the content, you may like to use Glossary Hotspot Wizard (Tools->Glossary hotspot wizard).
7. Finally, the content can be published to various formats from Single Source Layouts pod by choosing the appropriate glossary in the SSL dialog.
I hope this helpful. Please let me know in case you need any further elaboration of any step.
Mayank

Similar Messages

  • Auto generate glossary entries

    TCS 2
    FM 9.0.3
    RH 8.0.2
    My Framemaker book includes a glossary file with terms and descriptions using devoted para tyles. Is there nay way to map these to styles in Rh to autogenerate as Glossary entries int he webhelp template based ont he style.
    Alternatively, how can i make set these to behave as popups when the term is selected or when links to a term are selected?
    TIA
    Rob

    I'm not sure i follow you on both those points.
    I have assigned glossary markers to all the Glossary terms in FM. These are also unique FM styles. What do i do in RH. To what do i map these?
    The second part about saving as separate HTML files, i can set pagination for GlossTerms but what then must i do ?

  • RH7: Corrupted Special Characters in TOC, Glossary, Favorites, etc.

    When I generate a .chm from a Japanese, Polish, Russian or
    Chinese RoboHelp 7 HTML Help, the special characters are corrupted
    on the .chm file’s Contents, Search, Favorites, and Glossary
    tabs as well in the HTML Help window's title bar.
    For instance the Russian topic title
    “Использование
    приложения”
    is shown approximately as
    “Éñïîëücîâàíèå
    ïdéëîæåíèèÿ”
    on the TOC tab, making it useless for navigation purposes.
    The fonts were initially also corrupted on the TOC inside the
    RH7 project itself until I added charset=UTF-8 info in the
    head/meta of the hhc files. However, there's still no joy when I
    generate HTML Help output.
    I found a reference to someone with a similar problem with a
    RH7 Web help project where the solution was to add UTF-8 BOM to the
    very beginning of the files. Have tried adding UTF-8 BOM to the hhc
    or xpj files, using both Notepad and Dreamweaver, but with no
    result. Someone also recommended the installation of the required
    language packs – I tried, but again without improvement.
    Have you experienced something similar and found a solution,
    please share your knowledge with me.

    I'm no expert in this area but I am beginning to acquire some
    knowledge of the problems in this area.
    First question is, I believe, are you using a unicode font?
    It might be worth trying something such as Arial Unicode.
    I believe the BOM stuff is relevant only to webhelp.
    If changing the font does not work. Please contact me direct
    via my website.

  • Problem with index markers and importing MS Word 2007 files

    This was ugly in that it wasn't caught until after a book had been typeset and the index was being finalized. I'm now having to go back and manually insert a zillion index markers. Not fun.
    This was my first project since migrating from FM 7.1 to FM9.0.3.
    Source documents are Microsoft Word 2007. Am working in Microsoft Windows 7 64-bit.
    When the Word files were imported into FrameMaker, only SOME of the index markers were imported. The difference between those that were imported and those that weren't was seemingly random.
    I did some testing and found the problem and a solution.
    Looking at the source Word .docx file, and displaying hidden text shows two types of index markers:
    1. { XE "word to be indexed"}
    2. {xe "word to be indexed"}
    Note the difference in case and the extra space after the opening brace in #1. Markers of type 1 were imported fine. Markers of type 2 were stripped by the import process.
    The solution:
    Backsave the Word file to Word 2003 format (.doc) before importing into FrameMaker.
    I backsaved to Word 2003 and imported using both the "Microsoft Word" and "Microsoft Word 2007" filters and both filters imported correctly. It's only when trying to import a Word 2007 .docx file directly that things run amok.
    Grr...

    Thank you for posting your solution, Dan. It's cold comfort, but I've also ran into this issue in the past, almost certainly well before Word2003 though, probably as far back as Word2000 or earlier.
    In your testing, did you try saving as RTF to see if the markers were homogenized, by any chance? In my simple testing just now, Word itself recognized the index field correctly no matter whether I changed the field to "xe" or "XE", but FM's import of the .docx file format wouldn't recognize "xe", only "XE". But importing an RTF file handled both upper- and lower-case entries.
    Ah, yes, that's it -- saving the Word2007 file as RTF (with 2 fields, one caps, one lower-case) changed cap field to lower-case when the RTF is opened in Word again, so saving as RTF does homogenize the fields to lower-case. Is it possible that your file(s) were changed to or saved as RTF at any point in their life-cycle? I believe some older versions of Word were actually RTF under the hood, too -- if you do Save As in Word2007 you can scroll through the File Type entries and see "Word 97-2002 & 6.0/95 - RTF (*.doc)"  I believe some doc management systems change binaries to RTF too, or conversely some apps create RTF but they name the files as doc.
    So Word itself recognizes either lower- or upper-case, and FM's RTF import handles both, but not the .docx import.
    Sheila

  • Glossary Not Appearing in Windows 7 64 Bit

    I have RH7 installed on XP. All is OK when I view the CHM file in XP.  When I view the CHM file in W7 64 Bit, the glossary does not appear.
    Do I need to install RH7 under W7 64 bit to get the glossary to work under W7 64 bit?  If that is true, one issue is I have Office 2010 which RH7 doesn't support and I'm not in a position to upgrade to RH10.
    Is there any way to keep RH7 installed on XP and generate the CHM file that shows the glossary under W7 64 bit?
    Thank you.
    Shawn

    IIRC you’ll have to register the 64 bit dll for CHM viewing – search the forums; this issue has come up before

  • Need to Delete Glossary & Add Search

    Hi All,
    After converting my RH7 project to RH8, RH added a Glossary tab (which is empty, by design because we don't use them) and removed the Search tab. I am trying to remove the Glossary tab, but the Delete option is greyed out. I deleted the .glo file from the project folder and reopened the project, but all that did was give the Glossary file a red X. I have searched this forum, but no one else seems to have this problem.
    Can anyone help me permanently delete the Glossary from my project?
    I also can't find how to add back the Search tab. Can anyone help me with that, too?
    (If these are simple tasks, I apologize in advance. I've onlly been using RH for a few months.
    Thank you for your help!!

    Hi again
    Thanks for the info.
    For CHM files you need to edit the Window definition. Click View > Pods > Project Set Up. Expand the Windows pseudo-folder. Double-click the CHM window definition. (The WebHelp definition will have a small globe in the center of the icon)
    Ensure the Glossary check box is cleared in the lower left area of the dialog.
    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

  • How to create FrameMaker glossary entries which convert properly to RoboHelp HTML 8?

    I have been having a challenging time creating FrameMaker 9 glossary
    entries which convert properly into RoboHelp HTML 8. Here is the process I'm doing, and perhaps someone call tell me what I'm doing wrong.
    1.) In the FrameMaker document, I highlight a word or phrase which serves as the "glossary term" to be defined.
    2.) I open the Marker dialog box, select the Glossary option, then enter the "glossary definition" for the highlighted "glossary term." I commit the entry.
    3.) In the FrameMaker Book file, I create a new "Index of Markers" (IOM) of "Glossary" type. Upon generation of the IOM, my FrameMaker output is much like a standard index: There are letter delimiters ("A," "B," C," etc.), and under each is the "glossary definition," then a page number where the "glossary term" is.
    4.) Now I go to RoboHelp HTML 8 and update the document there. The glossary displays such that the "glossary term" is the entire paragraph in which the marker had been placed in the FrameMaker source file. The "glossary definition" is displayed properly (the text I placed into the Marker dialog box.
    So, how am I to create auto-generating glossaries? This implies that I need to create a manual glossary whereby the "glossary term" is in a paragraph by itself (much like a printed glossary would look). Furthermore, I would need to add this manual glossary as a file in the FrameMaker Book file for RoboHelp 8 to detect and pull the entries.
    Surely this isn't as how it was designed. I suspect I'm doing something wrong in how I create glossary entries or create the file in the FrameMaker Book file.
    Could someone offer some assistance?
    Thank you very much in advance!
    Most sincerely,
    Sammy Spencer

    It's because you're doing your markers backwards. The text inside your Glossary marker should be the term. The paragraph your marker is inside is the definition.
    I should say, rather, that Robohelp does it backwards, because when I think of glossary terms and definitions, I think there should be a way to highlight a word and provide the definition in the hidden marker, not hide the term inside the marker.
    I am still figuring out how to make a glossary in my Framemaker file that will work with my Robohelp file, and not have Robohelp generate a separate content file for the glossary file. I think I'll get it, though. Eventually.

  • X-refs and index markers in absolute paths don't work

    A problem has arisen that did not exist before:
    If I have added files to a book using an absolute path, all X-refs and index markers in those files then don't work. The index *generates* without trouble, but if I then try to Alt-click an item in the index that refers back to a file with an absolute path I get the error "Cannot find the file named X. Make sure the file exists." This also means, of course, that the corresponding hyperlinks in a generated PDF file also don't work.
    X-refs and index markers in files added using *relative* paths work okay.
    What is wrong?
    (I use FM9 / Windows 7.)
    Regards,
    Knut Högvall

    Hi Michael,
    Yes, I use 9.0p255.
    No, the files don't have to be on different volumes. They can even be in the same folder (not that they are, but they *could* be; they are in fact in separate folders, but on the same volume). What matters is how I select the file in the File dialog box when I add the file to the book. To get an absolute link, I first click the Network button, select the top volume, and then navigate down to the file. The absolute path is displayed in the book window as \\<volume>\folder\file.fm" while a relative path is indicated by "..\..\file.fm".
    If I add a file using an absolute path it doesn't work; if I add the exact same file using a relative path, it works.
    How do I check the hypertext content in the index?
    Regards,
    - Knut

  • Is there 1 Glossary file with all terms & def's?

    I have created a complete glossary list in RH7 for my
    project. One of my teammates would like to use the same glossary
    terms because the RH project he is working on is very similar to
    mine. Is there a way to grab a copy of the glossary terms and
    definitions from my project? I am assuming there is a file, but
    don't know the name and location.
    Any help is MUCH appreciated!!! :)
    Natalie

    Hi Natalie
    As Peter said, if you want to do this "behind the scenes",
    copy the .GLO from your PC to your teammate's PC.
    OR... you can also view the right-click the Glossary editor
    in RoboHelp and choose to Import a glossary. You would then browse
    to the desired Glossary file and pull it in.
    Cheers... Rick

  • $$PlaceHolder$$ in  RH7 HTML output

    Help!. We have recently upgraded from RH6 to RH7 (as part of
    Adobe Tech Comm Suite). Opening a RH6 project with RH7 all seems OK
    (topics, template, TOC, etc.) until I try closing and/or saving a
    topic. At this point -even if I've made no changes to the topic nor
    to the template- I am noticed that changes have been made to the
    header and footer and I am prompted to "apply the modification" to
    either "all the topics created from the template" or "only to the
    current topic". No matter what option I choose, every time I work
    with the same topic/s I have to repeat the whole process. Then,
    when I generate the HTML output, the text "$$PlaceHolder$$" appears
    instead of the header and footer. All the other features (Topic
    contents, TOC, Glossary, Browse sequences) are displayed properly.
    Note that header and footer look OK in Preview mode!
    About configurations: I have unistalled RH 6 before
    installing RH7; RH7 is version 7.01.001; my OS is Windows XP Pro
    (2002 with SP2).
    I don't know what to do other than going back to RH6. Please
    help!

    We have the same issue... the auto-update Date field in the
    footer causes the template warning message in RH 7. We have never
    had this problem before (all the way back to RoboHelp 9 and X5).
    Colum, you wrote:
    quote:
    A template is just standard text that can be applied to a
    topic.
    Well, that's partly true. A template is used to enforce
    headers, footers, and styles. Standard text, not included in a
    header and footer is only good once--if the template's body
    changes, that doesn't get pushed to topics (unless the standard
    text is included in a snippet); header and footer changes are
    pushed. So, I guess my point is that the templates are used to
    enforce a "corporate look". If you alter that look or delete
    standard text/variables, then you should be prompted with the
    warning. I'd imagine that for many authors, these warnings come as
    a surprise in RH 7. The content of the template really hasn't
    changed, just the value of a variable.

  • RH7 Trial HTML View

    This discussion started with
    this
    thread. I am using the RH7 trial on a Windows XP SP2 machine
    and looking at a project with Japanese text in the topics. The
    project language is now set to Japanese. In Design view, the
    characters display properly, but in HTML view, all I get are
    squares. The encoding is utf-8, which must be RH7's default, so I
    would think it would work. If I open a topic in Notepad, the
    characters are showing up correctly.
    I am also getting squares in the TOC, glossary, and index
    panes. I was hoping when I heard about double-byte support that
    double-byte characters would render correctly throughout the
    interface in RH7, so I'm hoping this is something I can somehow
    change. Thanks for any help,
    Ben

    I am pretty certain that my computer does not have language
    packs installed. I looked into those some time ago as a way to have
    menus, etc. displayed on my machine in other languages, but we went
    with a different method.
    I followed Akshay's steps 1-3 but checked only the East Asian
    checkbox. My machine installed some files and asked to restart.
    When it booted back up and I opened my Japanese project in RH7, the
    Japanese characters show up in the TOC, glossary, and index
    pallettes and in HTML view with Courier New as my code font. In
    HTML view, the Japanese text doesn't all seem to display between
    tags and slides around a bit when I highlight it, but it looks like
    this is the closest I'll get and it should make things easier.
    Unless it would help with this strange behavior in HTML view,
    it looks like installing the language packs using the Windows XP
    SP2 CD is not necessary, which I was hoping because I would have to
    go through our tech support reps (who issue our workstations and
    manage the configuration) to get one. Thanks very much for the
    help!
    --Ben

  • RH8 deletes the glossary file (.GLO)

    Simple issue: I converted an RH7 WebHelp project to RH8. The glossary file became a zero-byte door stop.
    I close RH8, copy over a backup GLO file, open the project in RH8, make changes to the Glossary and can edit at will, close and open the project and the Glossary is still there...but, when I complile/publish the project, RH8 wipes out the GLO file.
    This also occurs if I use the Glossary Hotspot Wizard: I end up with a zero-byte file.
    (An ancillary issue is that the Glossary "Toolbar Button" does not show as an option in the WebHelp layout Properties page, and it is properly defined in the skin I am using).
    Any hints/help would be thoroughly appreciated...
    Here's something else I just discovered: any action that results in saving the GLO file zero-bytes the thing.

    Bear with me on this: I refined the issue to anything that causes RH8 to explicitly save the .GLO file.
    If a populated Glossary is available in the RH8 interface and no changes are made to the Glossary in RH8, then everything compiles and works fine. Any change to the Glossary in the RH8 interface, however, results in a zero-byte file when RH8 saves the change. I discovered I could use an external editor (e.g., UltraEdit) to make and save changes without getting RH8 all fluttered.
    Issue resolved, but there's an underlying problem -- likely a bug.

  • Glossary Updates

    Ok, maybe I'm just too tired from lack of sleep last night or
    maybe I just dreamed this a while ago, or maybe it's just wishful
    thinking, but I swear when I downloaded the trail version of RH7
    that after I imported a glossary I could drag and drop terms in to
    the topic. Then if I modified the term in the glossary pod it would
    automatically update that term in all the topics.
    My client has since purchased the Technical Communications
    suite, but now this feature doesn't seem to work. Is anyone else
    having this issue or was this just something I dreamed up one night
    and it never really existed? Call me crazy, but I swear that I did
    this in the trail version.
    I think.

    Welcome to our community, kfrdk
    The Glossary Hotspot Wizard works in a very similar fashion
    to the Smart Index Wizard. Both are a bit like shooting a gun. It's
    something you simply run from time to time to make sure all is
    updated.
    As you have seen, changing a definition in the Glossary
    editor area will not automatically update the definitions in all
    the topics. To do that, you need to run the Glossary Hotspot Wizard
    again after you make changes. Then you will have the opportunity to
    update all the expanding hotspots to include the new definition.
    Cheers... Rick

  • Glossary Not Appearing

    I have RH7 (all lastest patches). Creating Microsoft HTML Help. Using W7, 64Bit
    When I create and view the Help, I see the glossary. When I run the CHM file directory, I see the glossary tab, but there are no entries.
    All other tabs seems to be OK. I have deleted the GLO file, recreated a new glossary, and just typed in test names. Same results.
    Any ideas?
    Shawn

    Hi there
    In addition to Leon's fine advice, I think I'd take it a step further.
    In addition to the Glossary, define at least a single browse sequence and ensure the window definition has enabled the Browse Sequences.
    Here's why I'm suggesting this. The HHActiveX.dll file is what governs both the Glossary Tab behavior as well as the Browse Sequence bar that gets added into the CHM window. Many years ago when I first became involved with RoboHelp and learned about the HHActiveX.dll file we would see that when it wasn't properly registered on an end user's PC, one of the symptoms would be that the Glossary Tab would appear, but there would be the characteristic blank area on the tab.
    So if you are expecting to see the Glossary populate and you are wondering why it isn't, it's most likely the direct result of the HHActiveX.dll not working properly. And if you have a Browse Sequence to boot, that will tend to confirm my theory.
    So you can klick and fight and scream at the issue all day/week/month/year long, but my gut says that until Adobe addresses the underlying issue with the dll, you aren't going to see the entries populate.
    Cheers... Rick
    Helpful and Handy Links
    RoboHelp Wish Form/Bug Reporting Form
    Begin learning RoboHelp HTML 7 or 8 moments from now - $24.95!
    Adobe Certified RoboHelp HTML Training
    SorcererStone Blog
    RoboHelp eBooks

  • RoboHelp RH8 crashes when using RH7 environment file

    I am just trying the RoboHelp 8 trial.
    I created a new blank project.
    I loaded an environment file that I use regularly in RH7 (attached as "authorgraphic_env2.txt" - just change the extension to .rhs). The environment appears, but all the tabs (the bits that stick out) are missing until I open a topic.
    If I click on the Index or Glossary tab, after 5 seconds the tab disappears, and 15 seconds later, RH8 crashes, followed by the "shall I report this to Miscroft?" prompt. This has happened 4 times in a row. Repeatable fault.
    Error signature is:
    AppName: robohtml.exe AppVer: 8.0.0.203 ModName: toolkitpro1042vc80u.dll
    ModVer: 10.4.2.0 Offset: 001b2b92
    Any ideas, anyone?
    (BTW, this system does not allow me to upload environment files with .rhs extension. This is daft! Please pass on...)
    Message was edited by: Philip Tory

    Any ideas, anyone?
    Report to Adobe as a bug?
    Click here to visit the Wish Form/Bug Reporting Form
    Cheers... Rick
    Begin learning RoboHelp HTML 7 within the day - $24.95!
    Click here for Adobe Authorized Captivate and RoboHelp HTML Training
    Click here for the SorcerStone Blog
    Click here for RoboHelp and Captivate eBooks

Maybe you are looking for