RoboHelp 8 HTML/TOC Levels/Topic Names

Hi,
I'm a new user to Robohelp HTML 8.
I have several HTML files (created in Homesite 5.5) that I have imported into Robohelp.  Headings are defined as <h1> <h2> and <h3>.
I have two issues (so far) relating to TOCs that I have been unable to solve.
1.  The name that displays in the TOC listing is the name of the link and not the name of the topic. For example, in <h1><a name="ovr">Overview</a></h1>, the TOC displays "ovr" when I want it to display "Overview".
2.  Robohelp doesn't seem to recognize the differences between <h1>, <h2> and <h3>.  All headings are at the same level.  I have been unable to locate a screen or setting I can use to configure the TOC. Is there one?
I realize that the files I am importing need a lot of tweaking for RoboHelp.  They were used differently, and right now, I'm just  trying to determine the scope of my nightmare :-)
Thanks for your help!

The code looks like the remnants of a hyperlink, just the name part with no link.
Unless you know something about it, the code does nothing so remove it. You can remove those topics from the TOC and add them back in or just rename them in the TOC editor.
See www.grainge.org for RoboHelp and Authoring tips
@petergrainge

Similar Messages

  • Importing MS Word into RoboHelp HTML / TOC Creation/ CHM output?

    Hello,
    I am a newbie to RoboHelp 8 and am trying out the Adobe Technical Communication Suite 2.5, and have a Windows 7 (64 Bit) OS.
    At the moment, I have a single 40 page word document (MS Word 2010) that I would like to bring into RoboHelp 8.
    With that said, I create a blank project, and then import the document.  But, when I try to generate and view a help file, I am not seeing the table of contents.  I have even done the AUTO TOC and verify that the links correspond to sections and sub-sections etc. - but still no TOC.
    In addition, for some reason it brought in each of my figures twice, so that I have two figure 1s, two figure twos and so on.
    Finally, it gave me an error message and was complaining about WidgetMax:
    "Compilation failed while compiling http:\www.widgetmax.com."
    I am not sure what that is about either.
    Okay, one more question.  Is there an easy way to break up all the sections/sub-sections into unique topics before or during inport into RoboHTML?  It seems that RH 8 really needs to have multiple topics versus one long topic, containing what was formerly a MS Word document.  What is the best approach to making that happen?
    Overall, I am looking for a nice automated system, whereby I can take developer created documents (from protected MS Word templates) and bring them into RoboHelp HTML (version 8).  Hopefully, I will not have to break apart the entire MS Word document first, before bringing it into RH 8.
    Thanks for taking the time to answer the questions from a newbie.
    -J

    Hi there
    My own guess is that you created a project using one of the supplied templates. Specifically, the Application Help template. This template already has a CHM window defined that contains a link to the WidgetMax.com site. When a link to a web site is defined in a CHM window, the compiler will squawk about it because it cannot resolve the link to a local HTML page. So you may safely ignore the message.
    As for importing the Word content, you have some decisions to make. How do you want to edit the content after you get it into RoboHelp?
    After you import you will abandon Word and make any changes to the documentation only using RoboHelp HTML.
    You will continue to maintain the Word document using Microsoft Word and you will want to update RoboHelp HTML to reflect the changes
    Depending on the avenue you wish to take, you will have different options for splitting the Word content into individual topics. Once we know which option you wish to use we can offer more guidance.
    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 HTML 5.02 - Topics in index do not synchronize

    I have Robohelp HTML 5.02 - when I select a help button from
    the program the top navigation window synchronizes but the Topics
    within the Index window do not. I tried the solution suggested in
    online help but I must have a previous version of Robohelp HTML
    because I don't see the synchonize button or the window tab in the
    Projects tab - Single source layout - Microsoft HTML help -
    properties - Advanced - TOC Styles tab. The navigation window at
    the top works fine.
    Any help would be greatly appreciated..
    Thanks - Kern

    Can anyone suggest how to troubleshoot this problem? This Help project has a few hundred topics and compiled perfectly in RH X5.1. It seems strange that the entries in the Index pane within RoboHelp HTML 8 look fine yet they are not in the right order in the .chm.
    Suggestions would be greatly appreciated.
    Thanks,
    Cherie Lorenzo

  • Robohelp HTML 8 - Generating files with apostrophe in file name

    Before I start, I have read this thread
    http://forums.adobe.com/message/1062904#1062904 and several others, yet I still have questions.
    Previously I used Robohelp 5x, which worked perfectly.  Our user manuals are in MS Word and each have several topics that have apostrophes in the topic name (that are necessary in the topic).  Robohelp 5x would import the Word Document without issue and create HTML files that automatically replaced the apostrophe with an underscore.  All references (Index, TOC, etc) to those files also automatically changed to underscore.
    Fast Forward to Robohelp 8.0.2 (yes, I have the update).  Even if I go into the options and make sure "Use Underscores in file names" is selected - it no longer replaces the apostrophe with an underscore (though it does replace the spaces with underscores).
    Locally, when I generate the online help (WebHelp) and put it on our local webserver - it works just fine.  Even with the apostrophes in the file names and references.
    However, when the WebHelp files are hosted at our server hosting facility, any links within the Webhelp to files with an apostrophe result in a 404 error.  I have searched and searched to see if there is some kind of server setting to allow these special characters to be recognized in the file name but have not had any luck.
    Per the link at the beginning of this post, the issue in that thread was resolved by changing the file name of the HTML files.  I attempted to change the file name of the HTML files that RoboHelp created.  However as far as I can tell there is no way to do this within RoboHelp 8.  If I attempt to do it outside of RoboHelp 8, I need to import all of the "new" HTML files and all references (Table of Contents, Index, etc) now show broken links and need to be re-linked to this new topic.  This is not an option.  I have 12 user manuals that are updated on a regular basis and the renaming\relinking process would take forever.
    Any help would be greatly appreciated.
    Thanks,
    -Noob

    I was able to log into the server hosting facility and look at the html files themeslves.
    It appears that at some point (between when I created them locally and now) all of the apostrophes in the file names were changed to "Æ".  This blew my mind.  And sure enough if I plug in the URL and replace the apostrophe with "Æ" the page shows up just fine.
    From what I've been reading it looks like that may be related to the conversion from MS Word and "Smart Quotes".  I'm looking into that now, but any help would still be great.
    Thanks,
    -noob

  • RoboHelp HTML 10 is taking one of my topic files and copying it multiple times.

    I am using RoboHelp HTML 10 to update a reference project with about 1,500 topics in it. Today, I created a new topic with several internal bookmark links. I have edited this topic file several times and saved it without any problems but late today, when I wanted to save the file and close the project, RH gave me an error message about the file name being too long and the TOC reference was too long. This error message repeated over and over so I used Task Manager to kill RH and I rebooted my PC.  When I got RH running again, I discovered 40 copies of the topic file listed in the Project Manager window.  Each file name is a unique creation made up of the original topic file name and one or more of the internal links. Here is a sample of the names:
    Ultimate_Data_Display.htm (topic file with several bookmarks)
    Ultimate_Data_Display.htm#View_Data (no .htm suffix - when I open one of these files using NotePad, the file contains an exact copy of the original html code)
    Ultimate_Data_Display.htm#View_Data#Detailed_View
    Ultimate_Data_Display.htm#View_Data#Detailed_View#Summary_View
    The file names get longer and longer until the 260-? character limit is reached.
    RH appears to be parsing the topic file, pulling out the bookmark code, concatenating various bits together and then saving copies of the original file under these new names. Perhaps this is occuring because of some interaction between RH and the version control system we are using.  However, I don't know what version control system we have. I have a "source folder" on my local desktop and RH is doing some type of checking in and checking out of all the files that I work on.
    Any suggestions on how to stop this problem would be great, as I have several new topic files to create over the next few work-days.

    This is a new one on me.
    Have you tried deleting the CPD file and then working on the project?
    Where is the project located?
    Does your working environment have a backup tool running all the time, such as Memeo?
    See www.grainge.org for RoboHelp and Authoring tips
    @petergrainge

  • RH8 RoboHelp HTML published as web help TOC format

    Is there any way to manually tweak the TOC formatting in a published set of sub docs that were generated from the root books of a RoboHelp HTML project?
    Original project had Install Guide, Admin Guide, etc. which are now published separately. Problems: all files for all books are in each published help system. Browse sequences contain all topics. TOC format got 'lost' so tab names rather than icons are used for ...TOC, Index, Glossary, etc. even though Icons are in the projects. Individual projects open with one book, which must be expanded. No colors in TOC, and uses a different (and noticeably larger) font from the topic.
    Since this one-off was done to an unknown version of the content, I'd be better off mucking with the cshdat and wh files than the content of the topics.

    ...just now revisiting the project that precipitated the original request. I have additional info and a request:
    The separate help documents had been published without resetting the browse sequence. As it is today, (because browse sequences were not updated), many hyperlinks jump out of the published books and over to an earlier build that has a single TOC (same IIS server, but completely different path).
    I learned that a RH HTML project can have multiple TOCs. So, my new question: is it possible for three TOCs to keep thier own browse sequences and access one common set of published HTM topics?  How would that be engineered? I don't quite know how to manage hyperlinks that reference topics in one of the other books. I don't want to inherit the wrong browse sequences.
    The alternative is to generate help from the 4 different TOCs into 4 different folders, which is a lot of replication.  Like Siamese twins, there's a lot of cross sharing built into the original project, so in most cases, the "see also" relationships would give each separately published book 100% access to all the topics, but from a limited TOC.

  • Topic headings not showing in Firefox, with RoboHelp HTML version 8 WebHelp

    1. I have just upgraded a customer's Help project to RH8, with a WebHelp layout.
    The finished WebHelp Guide works fine in Internet Explorer 8.
    But Firefox 3.0.1.5 (latest update) does not show topic headings (style Heading 1) where they are automatically linked to the Topic Properties > Topic Title.; i.e. the topic heading is a Field {Title}, using rh-variable_start name="title" etc. Firefox only shows the topic heading if the heading exists as text in the WYSIWYG field.
    I checked a backup copy of the compiled WebHelp that I had generated using RoboHelp HTML version 7, and this works OK - all topic headings that are fields display OK in Firefox.
    2. Also, some images (.gif format) do not display in Firefox that is generated by RH8.
    Any ideas, anyone?
    Philip

    Hi,
    Note: All I post here are my findings. I didn't test all DHTML effects and I'm not a javascript guru, so I may be wrong.
    As far as I can find, this behaviour is defenitly a bug, although  it's not related to headings, CBT's or images. This is what I found:
    Whenever you have multiple DHTML-effects that kick in on load, Firefox only displays the one that is defined first in the topic. In the bottom of the topic, you'll find a script like this:
    <script type="text/javascript" language="JavaScript1.2">//<![CDATA[
        if( typeof( InitEffects ) != 'function' ) InitEffects = new Function();
        InitEffects('img1','x-on-pageload: fadein();');
        InitEffects('h11','x-on-pageload: fadein();');
        InitEffects('h111','');
    //]]></script>
    In this case, the image with id img1 is loaded first and displayed correct. All subsequent effects (heading with id h11) is not displayed. Putting the heading in front of the image will show the image, while the image is not displayed.
    I suspect that the effects are not correctly parsed into
    if ((gbBsNS6)&&(srcObj.addEventListener))
            srcObj.addEventListener( noOn.toLowerCase(), new Function("event", newHandler ),false);
    on line 2994 and 2995. Changing or deleting line 2995 effectively removes kills on load effects (ie not showing anything with an on load effect) as expected.
    If you also use DHTML effects and find the same behaviour as Philip, please post a bug report.
    Greet,
    Willam

  • How do I create a Search window in a RoboHelp HTML 8 topic pane?

    I am working in RoboHelp HTML version 8 that is published as WebHelp. The system I am developing for has a search window as part of a skin that is available above the topic windows and is not always easily accessible. Can you create a search window to appear in individual help panes like they do in Microsoft Office Word 2007's Help? (to do this, can you use skins within each Help topic pane?)  Or can a link or a button be created within a help topic pane to bring up a search window as a popup? If so, can you give me high level steps to doing these tasks?  thanks.

    Hi,
    Although you can open RoboHelps search pane in a popup, the search function will not function. I guess the easiest is to use another tool for your search, one that you customize into what you need. On Peter's site, he uses a progam called zoomsearch, which you can also use for RoboHelp projects. See http://www.grainge.org/pages/authoring/zoomsearch/zoomsearch.htm
    Greet,
    Willam

  • Linking to .hlp topics from RoboHelp HTML 6

    We have a comprehensive help file for our CADD systems built
    in RoboHelp 6 for Word that has been compiled to WinHelp 2000
    (.hlp) format. We now want to link to specific topic from a project
    being built in RoboHelp HTML 6. This is easy to do in RoboHelp 6
    for Word but I cannot find out how to do this in the HTML version.
    Any help is greatly appreciated, and please dumb down the
    responses, I will be appreciative not offended.
    Thanks,
    Kelly

    Hi Kelly and welcome to our community
    Whether you may do this will depend on whether you are
    creating WebHelp or a Compiled .CHM output. I don't believe it will
    work with WebHelp. If you are creating a compiled .CHM, first off
    make sure your primary layout is configured for Microsoft HTML
    Help. If it isn't, you won't see the option I'm about to point you
    to.
    Once you cross that hurdle, click inside a topic and choose
    Insert > HTML Help Controls > WinHelp Topic...
    Hopefully that helps some... Rick

  • RoboHelp HTML X5: Merged help not displaying ToC

    Hi All:
    Hoping someone can help me here.
    I have been generating merged help for some time now w/o problems. But got this problem today after compiling a particular project after a 15-month gap. When I compiled the parent/master project, the ToC displayed the child projects and the Information Bar displayed the following message:
    "To help protect your security, Internet Explorer has restricted this  file from showing active content that could access your computer. Click  here for options..."
    I ignored the message and clicked the child projects to check if they displayed correctly. Each child project opened new instance of IE - this has not happened before. The last time I complied this parent project, everything worked fine and child projects opened within the same browser instance.
    Secondly, when I right-clicked the Information Bar message and chose to Allow Blocked Content, the ToC disappeared.
    Just in case this is relevant, my employer replaced all our PCs last month and all software had to be reinstalled.
    Could this be because of the new version of IE? (My old machine may have had an older version.) Or the fact that I have not installed the updates to Robohelp X5? (I keep getting the message that the Macromedia server is down.) I have not activated the product yet either.
    Would appreciate any advice/clues.
    Thanks in advance
    Sophie

    Hi there
    Usually you can prevent that message from appearing by enabling Mark Of The Web (MOTW) in the WebHelp generation options. The unfortunate part about that is you stated X5 and X5 didn't offer that option. So the next best thing you can do is to configure IE so it doesn't present the Yellow Information Bar. You do this by opening the Internet Options for IE. Click the Advanced tab and scroll to the Security section. Place a check mark in the option "Allow active content to run in files on My Computer".
    Note that this only affects your own computer. If you are planning on having your end users copy the WebHelp files to their local C drives, you will have to instruct them to perform the same steps. But if you are uploading your content to a Web Server, they should not encounter this issue.
    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

  • RoboHelp HTML 9 Webhelp Layouts include all (unnecessary) project files

    I am currently using RoboHelp HTML 9 on Windows 7 Pro. I have administrative rights on the computer.
    My current project contains over 30 different webhelp layouts with 30 different TOCs that are all based on the different functions in a web-based application for a client. The project also includes over 30 different print layouts based on the same TOCs. I use build conditions to specify what I want to appear in the webhelp and print layouts. My project is organized into basically three main folders that represent Tasks, References and Concepts (as close to DITA as I can get this client). Each of these main folders has a subfolder named after a function and it contains the topics and screen captures that relate to that specific function task, function reference or function concept.
    I created each webhelp layout in the SSL pod based on the specific TOC that was created for the function. In the WebHelp settings, I specified the TOC in the Content section along with enabling the "exclude unreferenced topics from output" and "exclude unreferenced baggage files from the output" options. In the Navigation section, I selected the appropriate skin that I customized along with enabling Contents and Search options with adding the About box.
    With these settings my problem is that ever single webhelp layout includes all of the files in the three main folders, even when they are not referenced in the TOC. This has caused my outputs to explode in size because of the unnecessary folders filled with files (topics and graphics). How can I compile the webhelp layouts so they only output the files referenced in the TOCs and not every single file in the the three main project folders?
    Any suggestions will be greatly appreciated because my client is not local and I have to send these files to them over the internet.
    Thanks in Advance!

    "Exclude unreferenced topics from output" starts by excluding topics that are not in the TOC etc. However if a topic in the TOC has a link to a topic that is not in the TOC, the linked topic will also be included to avoid a broken link. It also daisy chains so that if the second topic has further links, that too gets included.
    The idea behind this option was that people wanted TOC only outputs but Adobe chose to implement it in this way. I can see why but I take the view that if that results in broken links, that is the author's responsibility. If you agree, then please follow this link and ask for true TOC based authoring.
    http://www.Adobe.com/cfusion/mmform/index.cfm?name=wishform&product=38
    Meantime you will, as Amebr points out, need to create build tags and expressions. There is a page on my site that covers that.
    See www.grainge.org for RoboHelp and Authoring tips
    @petergrainge

  • Frames in RoboHelp html

    Is there a way to control the length of the frame opening
    upon launching RoboHelp from RoboHelp html? I have some longer
    topics and I'd like the topic to show up in it's entirety.

    I don't follow what you are asking.
    Control the "length" as in the verticle dimension? Which
    frame in particular - the TOC frame, tool bar frame or the topic
    frame?
    What do you mean by "longer topics...to show up in its
    entirety"? You have a long TOC topic name that you want to see or
    you have a long topic name (<title>) that you want to see in
    the topic frame? This to me relates to "width" of a frame rather
    than "length" of a frame. Are you asking two separate questions?
    Regards,
    GEWB

  • Using a topic name marker in TCS2

    Hi everyone,
    I'm trying to set up FM to RH converstion for the first time since TCS1. I have TCS2 with FM 9.0p255 and RH 8.0.2.208.
    In my project, I'm attempting to use a topic name marker to specify the HTML filename and topic title in RH when I convert my FM files. It appeared to be working well but some in some linked topics, the topic title would be the filename rather than the title I'd specified in the FM marker. After some investigation, it seems that adding cross-references to a topic in FM breaks the topic title portion of the feature. Add the internal cross-reference in FM, update in RH, topic title = topic filename (though they are both specified in the marker). Remove the cross-reference in FM, update RH, and the filename and topic title are as expected.
    Has anyone else seen this issue and may know what I'm doing wrong or have found a workaround?
    I want to be able to create my TOC separately in RH rather than using the FM version. Not being able to control the topic titles is a big enough deal for me that I may have to abandon the project if I can't fix it.
    Thanks for any help,
    Glynnis

    In case anyone else has this problem, I eventually called Adobe tech support. My issue has been identified as a bug in both TCS2 and TCS3. With any luck, they'll fix it in an update.
    Glynnis

  • RoboHelp HTML 9.0.2.271 crashes when opening .htm files

    Hello. I'm using RoboHelp HTML 9.0.2.271. When opening a certain RH project (I have three that I access regularly), the project opens fine, but when I try to open any of the topic files, RH hangs/crashes. I can perform any other tasks in the project (generating, publishing, updating the browse sequence, etc.), but I can't open any .htm files. In trying to fix this problem, I have:
    Updated from 9.0 to first 9.0.1 then 9.0.2
    Renamed the .cpd file
    Imported one of the topics in the crashing project to a project that isn't crashing
    Updating and renaming the .cpd file didn't work and importing the topic into a healthy project allowed the topic to open (so the topic doesn't seem corrupt).

    Also using 9.0.2.271, I had exactly the same problem: open project, double-click a topic in the Topic List pane... crash.
    However, immediately after opening the project I had Windows 7's blue 'busy' doughnut symbol constantly flashing under the mouse pointer. This is described (for RH8) in Peter Grainge's description on his excellent website (RoboHelp > Opening RoboHelp Projects). The same topic mentions the .hhp file, so I checked the contents of mine...
    At the very end, in the [MERGE FILES] section, it listed two other .chm files; one which was supposed to be there, and one which was not (Dummy.chm). I had merged Dummy.chm only during the early testing stages of my project, and had long since removed all references to it from my project. I have no idea why it was still listed in the .hhp file.
    I deleted the reference to Dummy.chm from the .hhp file and regenerated the project... and Dummy.chm reappeared in the .hhp file!  After deep-searching my project files using NotePad++, one remaining reference to Dummy.chm was also listed in the .xpj file:
      <file>
       <name>Dummy.chm</name>
       <comments></comments>
      </file>
    So I manually removed those lines and saved the .xpj using NotePad++, reopened the project using RoboHelp, and regenerated. The rogue reference to Dummy.chm is now gone. I have opened, saved, and closed the project several times and it now seems to be reliable.
    Probable cause of bug: I had recently performed a cleanup of my project folder and deleted Dummy.chm, but unknown to me I suspect RoboHelp was still looking for it when opening the project, hence the permanent 'busy' doughnut and the crash when trying to do anything else, like opening a topic.

  • RoboHelp HTML Version 10 - Navigation panel not displaying in published project

    We are generating a WebHelp project in RoboHelp HTML Version 10 and the navigation panel (TOC, Search, etc.) is no longer visible in the index file (viewed locally) and it's only visible by clicking "Show" when viewed in a web server. This issue is occurring with Internet Explorer 11 and Google Chrome Version 39.0.2171.99 m. I also tried to view the index files of previously generated projects and am experiencing the same issue (this did not occur before). Is this a known issue? It appears that there a few other discussions posted recently experiencing similar issues. Any help would be greatly appreciated.
    Thanks,
    Nikki

    Hi there
    Sorry, but I'm a bit confused. What you are describing sounds like perfectly normal behavior.
    Can you share a link where this is happening? Not so we can click it, but so we can see what the link looks like.
    If you want a topic to open with the surrounding navigation (TOC, Index, Search, Glossary) you need to click the Show link, then look at what's in the Address bar. Copy that link and you should have what you need.
    Cheers... Rick

Maybe you are looking for