Skip navigation
creswriter
creswriter
Currently Being Moderated

Air Help topic navigation links broken

Feb 27, 2012 9:51 AM

Tags: #air_help

I've logged this as a bug, but was wondering if anyone else has run into this problem.

 

When generating the "Air Help and Browser Based Help" output format (and uploading the browser files to the web server and installing the AirHelp application), the navigation links that appear above the help window and below the search bar/navigation buttons are broken. The example below shows the uni-pane template, but the problem occurs with all templates.

 

Upon clicking the first or second topic link (in the red circled area), this displays "The page cannot be found" and the navigation links themselves disappear.

 

CDS.jpg

I noticed that the problem only exists when the topics in the Project Manager are organized into subfolders. If all the topics in the Project Manager reside in the top-level folder, the links navigate properly. Also, the links are only clickable when in online mode, not in local mode. I've been unable to either disable the navigation links entirely, or make them un-clickable in online mode.

 

I'm running RH9, Windows 7 (64-bit).

 

Any help would be appreciated.

1053 Views   15 Replies   Latest reply: creswriter, Mar 1, 2012 7:50 AM
 
Replies
  • Peter Grainge
    Currently Being Moderated
    1. Peter Grainge,
    Feb 27, 2012 12:07 PM   in reply to creswriter
    Report

    I am not sure what the problem is at this stage but I don't think it is a bug as no one else has hit the problem.

     

    Please open one of the sample projects and generate some AIR help from that to establish the links work there. That rules out a bug and tells us it is something in your project. What it is will still need to be determined but we will know we are looking in the right place.

     

    Probably the first thing I would do is apply another skin and not make any changes to the default.

     

    Post back how you get on. I'm going offline soon but will pick up your reply tomorrow if no one else has waded in.

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    2. creswriter,
    Feb 27, 2012 12:17 PM   in reply to Peter Grainge
    Report

    Thank you for the speedy reply.

     

    I did test this with the sample "salesbuilder" project and got the same results. I tried it with different skins and templates (i.e., multi-tab accordian) and got the same results. The only remedy has been to move the topics from their subfolders in the Project Manager to the top-level folder.

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    3. Peter Grainge,
    Feb 27, 2012 1:23 PM   in reply to creswriter
    Report

    Those projects are tested and known to work including the breadcrumbs and with the topics at many levels. Are your projects local when you are working on them?

     

    If they are, then look at the AIR pages on my site to see if you can pick up something.

     

    Post back. I can't think offhand what would cause this but will give it some time tomorrow.

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    4. creswriter,
    Feb 27, 2012 1:47 PM   in reply to Peter Grainge
    Report

    I did review the AIR pages on your site several times before posting. Perhaps it's a problem with our web server, since you say the sample projects are known to work. I was sure it was a bug.

     

    Our RH projects are stored in a Subversion repository, but I check them out and work on them locally, on my local machine. Some of my tests were done only locally and not saved in Subversion.

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    5. Peter Grainge,
    Feb 28, 2012 12:16 AM   in reply to creswriter
    Report

    I thought the problem occurred with both desktop and browser help. Are you saying it is only with the browser help?

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    6. Peter Grainge,
    Feb 28, 2012 12:27 AM   in reply to Peter Grainge
    Report

    Wondering just how the browser based AIR help was put onto the server. Could the developers have put the files up without respecting the folder structure?

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    7. creswriter,
    Feb 28, 2012 5:19 AM   in reply to Peter Grainge
    Report

    The problem occurs in Browser help. In desktop help, the breadcrumbs do not work as links at all, although they are visible.

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    8. creswriter,
    Feb 28, 2012 5:20 AM   in reply to Peter Grainge
    Report

    I upload the files myself to the server using FileZilla. I believe the folder structure remains intact but I will double-check that to make sure and post back, thank.

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    9. creswriter,
    Feb 28, 2012 6:20 AM   in reply to Peter Grainge
    Report

    I’ve just verified that the directory structure is exactly the same in both the BrowserBasedHelp folder and on the web server.

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    10. Peter Grainge,
    Feb 28, 2012 6:30 AM   in reply to creswriter
    Report

    Earlier on you generated from the SalesBuilder project. Did you just try BB AIR help or did you also try Desktop? If you did not create Desktop from that, please do so now and me the AIR file created.

     

    See the contact page on my site.

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    11. Peter Grainge,
    Feb 29, 2012 11:32 AM   in reply to Peter Grainge
    Report

    Meliset

     

    Just wondering if you got the new email thread I started?

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    12. creswriter,
    Feb 29, 2012 11:36 AM   in reply to Peter Grainge
    Report

    Peter, no. I don’t see a new thread.

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    13. Peter Grainge,
    Mar 1, 2012 7:31 AM   in reply to creswriter
    Report

    Just to update the thread, I believe I have found the solution to this and will post the answer once Meliset has confirmed it is working for her.

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • Peter Grainge
    Currently Being Moderated
    14. Peter Grainge,
    Mar 1, 2012 7:31 AM   in reply to Peter Grainge
    Report

    It seems the answer is not to generate browser based AIR help for the online element.

     

    I generated webhelp instead making sure the Show Navigational Links option was deselected. With that done the breadcrumbs all worked fine in both the online and offline help. The user opens the help and if a connection is available the help defaults to the online content in the view, which is local. Without a connection or when the user elects to go offline, they stay in the view but with the local content.

     

    See www.grainge.org for RoboHelp and Authoring tips

     

    @petergrainge

     
    |
    Mark as:
  • creswriter
    Currently Being Moderated
    15. creswriter,
    Mar 1, 2012 7:50 AM   in reply to Peter Grainge
    Report

    Yes, if webhelp is generated instead of browser-based AIR help, the breadcrumbs work properly.

     

    Thank you very much for finding a solution, Peter!

     
    |
    Mark as:
Actions

More Like This

  • Retrieving data ...

Bookmarked By (0)

Answers + Points = Status

  • 10 points awarded for Correct Answers
  • 5 points awarded for Helpful Answers
  • 10,000+ points
  • 1,001-10,000 points
  • 501-1,000 points
  • 5-500 points