Problem With Framless' "In This Topic" Section on ONE Topic

[Zachary24897071nluu]

Hello,

Normally, the "In This Topic" section of the Frameless output has links to the H1, H2, H3, and H4 styles, and links to them as such, without using bookmarks. See an example of the filepath/webpage URL that pops up for a normal topic when clicked in the "In This Topic" section.

 

Now, see below an example of the page that is failing. I believe it is throwing Error 403 Forbiddens to our customers because it is using bookmarks (and incomplete ones, at that) to try and call the section of the page.

 

 

 

How do I fix this?

[Peter Grainge]

In This Topic uses headings within the topic. You are showing a path to another topic. Look in the code of the topic with the problem. That should show something wrong.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Peter,

These two headers pictured ARE in this same topic, that's the problem. It is calling something incorrectly.

Where would I even begin to look in the code? I don't even know where that is located in terms of filepaths on the machine.

How do I prevent this sort of degradation? I haven't touched this topic in months. How did it manage this on its own?

[Zachary24897071nluu]

I also totally deleted the topic, deleted any references to it in the Table of Context, in the Context-Sensitive Help Map File, and any other topics that link to it.

Then, when I re-typed everything from scratch, changed the image that I used, and took out all of the special characters from the headers, the same issue persisted on the brand new topic!

[Peter Grainge]

If you import that topic into a new project, does it have the same issue?

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Yes

[Peter Grainge]

See the Contact page on my site and me the test project as instructed there. I will look tomorrow morning.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Sent it your way, take your time!

[Peter Grainge]

You have only sent the rhpj file. I need the whole test project. Zip the folder.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Apologies, I have zipped it. I also sent you over the problem project if you need to take a look through.

Thanks,

[Peter Grainge]

Please look at the test project. I am not seeing In This Topic in it.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

I can't even open my test file anymore, it says it didn't load properly this time. The import of the topic is all jacked up, are you able to open the other Project? Same file is in there to inspect.

[Zachary24897071nluu]

The import obviously is failing, because the author view and output of this file is totally wrong in the test file.

Look at this:

[Peter Grainge]

So why tell me you had tested this and the same problem occurred? This is not the same problem.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Peter Grainge]

I'll look in the morning.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Peter Grainge]

Let's correct a few things.

You say your customers are getting a 403 error when they click the links in In This Topic. That makes no sense to me as a 403 means they are not authorised to see the target but they are already viewing the topic so patently they are authorised. For what it is worth no one has ever reported a 403 from In This Topic.

I don't know which of the output presets you are using so I created a fresh one. Using that and your Orange template I get this, the same as the test project you sent. In This Topic does not appear, never mind error.

The reason nothing appears is that the "headings" in the topic are not formatted as heading styles but as paragraphs with inline styling. In This Topic relies on heading styles. 

Example

<p><strong><a id="trans_id_gl_account_code_setup"></a>Trans ID</strong><br />

Change that to 

<h2><a id="trans_id_gl_account_code_setup"></a>Trans ID</h2>

and that will work.

You can't have a line break at the end as the following line will also be styled heading 2.

In short, the problem of In This Topic not showing is you have applied inline styling rather than proper styles.

The 403 error, as I said, makes no sense. It feels like there is something wrong with the installation of the help wherever your users are viewing it.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Ah I sent you the "fixed" version where I removed the headers. This is not helpful to you.

But if the 403 is some sort of issue where the hosting is the problem I will speak to my hosting team.

[Peter Grainge]

First you need to know what triggers the 403. I don't believe it is the In This Topic, rather a bad link from another topic.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Well the two lines of text that were originally set as H2, that then show up in the "In This Topic" section, were what were causing the 403, I sent the wrong file to you, where I "fixed" the issue by making them in-line text. There are only 2 incoming links to this page. Both work, I ran the broken link report.

You can see that they were changing into half-bookmarks when output. (In the images I originally supplied).

I can send the broken file if you want, but since no one has EVER had this problem before, apparently, I'll just talk to the folks in the office who know what the deal is with our hosting site.

I really do think it is a RH breakdown though, why are none of the other 380 topics broken?

[Peter Grainge]

Is the failure you first reported perhaps when they use a link to the bookmark from another topic and not related to the In This Topic issue?

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Peter Grainge]

Personally I would fix In This Topic in GL Account Setup and generate a fresh output and test it works locally. Then I would test locally any topics with link to the bookmarks in that topic. Then put that output in a new folder on your server and check it still works.

In your testing check the code in the topics with the links to GL Account Setup and make sure the bookmark part of the link is the same as the bookmark.

Assuming it does, maybe trash the troublesome output and replace it with this working one. 

I don't believe RoboHelp is the issue here as if it were, then others would be having this problem. Also note In This Topic relies on heading styles and not bookmarks.

________________________________________________________

My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.

[Zachary24897071nluu]

Peter,

The problem I am having is because I don't know how to fix the "In This Topic" section of the GL Account Code Setup.

When generated the links work locally - because there is no network to forbid me from. However, as you can see from the images I posted, it still does "create" these half bookmarks for when the links in "In This Topic" are clicked. So in essence, it is still creating the same error, it just doesn't throw a 403 because it is local. The images I provided were from my local machine, but they do the same thing in a web browser, and in the web browser it breaks and throws a 403.

I did not link to any BOOKMARKS in this topic!!! The 2 incoming links link to the topic as a whole. There are no bookmarks here except the internal ones I plan on linking an image map to.

I feel you are not understanding the issue here, as you can see in the top images ROBOHELP is CREATING those bookmarks. I did not type those half words! It took them from the headers, and created a half-bookmark (starting with the hashtag, as pictured) and ruins the links.

Please stop telling me what "In This Topic" refers to, I understand it only does H2-H4, I can change that setting as well.

If it is not RoboHelp, why is the problem beginning in RoboHelp, and present on a local machine and a network where the site is stored?

[Jeff_Coatsworth]

Hang on - if the output works locally, but not on your webserver, then the issue lies on the webserver, not in the output files. Did you ensure that all files were cleared off the webserver & re-uploaded? Are there permission issues on the webserver? Did you clear your cache(s) on the browser(s)?

[Zachary24897071nluu]

Read closer. The issue persists locally and on the network.

The issue that throws the 403 occurs locally, but because there is no 403 to throw locally.

[Zachary24897071nluu]

The images I provided in my original post are from my local machine output of the file, and they match the network output.