Skip to main content
Participating Frequently
October 19, 2010
Question

Webhelp output files picking wrong slash for filepaths

  • October 19, 2010
  • 3 replies
  • 2268 views

I use RoboHelp 7.0.2 to generate WebHelp.

We are newly adding support for Linux.

To support the usage of slash (in filepaths) in Linux supported browsers, I changed all '\' to '/' in multiple source files as well in the CSS file.

When I view the WebHelp on a Linux browser, I see link breaks.

Upon analysis, I found out that the files in whdata, whgdata & whxdata are still using '\', which is the cause of the link breaks.

As a temporary solution for a Beta release, I manually (using a search & replace tool) changed '\' to '/' in files that are present in whdata, whgdata & whxdata.

Every time I generate the Webhelp, the problem will reoccur.

How do I resolve this?

Thanks,

PT

This topic has been closed for replies.

3 replies

Inspiring
October 20, 2010

This bothered me all night...

I need to construct a new project from scratch and use the functions that are causing you this problem. I do recall that X5 did create a similar or same problem and I had to make the same manual correction as you. The test project I used was from that version and I likely had made the correction (years ago) - I'm missing something. I haven't found my notes from then (six years ago) and the old forum threads were wiped by Adobe (I do recall posting a thread about this).

I'll work on it later today.

Regards,

GEWB

Inspiring
October 19, 2010

Hello PT and Peter -

I ran a few tests to see what  happens when opening an RH generated WebHelp project in Mandriva Linux  2010.1 using Firefox 3.6.10 as my default browser. Here is my set up,  sequence and finding.

RH7 WebHelp running on Windows XP Professional.

> I converted an RH X5 WebHelp project to RH7 WebHelp.

> Project has over 500 topics, heavy with images and DHTML drop text.

> I use "index.htm" as the default project page (not the default opening topic).

> I generated to project twice, once without Java, once with Java.

> Copied all generated folders and files to a flash drive.

Linux: Mandriva 2010.1

Browsers in Linux: Firefox and Chromium

Procedure: open flash drive in Dolphin window explorer, navigate to generated project default file (index.htm), select and open in desired browser.

RH7 (no Java applet) gen settings

Conditional Build Expression: none
Additional Options: W3C Compliant Topics

Toolbars: Content, Index, Search, Glossary
(enable) Show Navigation Pane
(enable) Add Breadcrumbs

(enable) Browse Sequence
(enable) Enable Highlights
(enable) Sync TOC

No Java Applet: DHTML > Pure HTML

Optimize Speed: Web Site

(enable) Republish all

Firefox in Linux result: no problems, full functionality

Chromium in Linux: would not open any (local) generated project

RH7 (with Java applet) gen settings

Conditional Build Expression: none
Additional Options: W3C Compliant Topics

Toolbars: Content, Index, Search, Glossary
(enable) Show Navigation Pane
(enable) Add Breadcrumbs

(enable) Browse Sequence
(enable) Enable Highlights
(enable) Sync TOC

Java Applet: DHTML > Java Applet > Pure HTML

Optimize Speed: Web Site

(enable) Republish all

Firefox in Linux result: no problems, full functionality

Chromium in Linux: would not open any (local) generated project

RH9 Beta - B171

I also tested RH9 beta build 171 WebHelp as configured above for no Java: Firefox in Linux had no problems, full functionality.

Question for PT: how are you setting up your Linux to  open the default project page? Are you opening the GENERATED project  default page or trying to open the project source files? Why are you  replacing the foreward-backward slash?

If you are uploading to a Linux server, just copy the entire  generated project folders/files as-is and point your browser to the  default opening page file you named during generation.

Regards,

GEWB

panchameeAuthor
Participating Frequently
October 20, 2010

Hi GEWB,

Here are some more details--

Generate Webhelp output setup:

Use lowercase filenames (recomm. for UNIX)

Toolbar buttons: Content, Index, Search

Navigation: Add breadcrumbs links

Additional options: Enable Highlight Search results, Synchronize TOC automatically

Navigation Pane preferred format: DHTML > Java Applet > Pure HTML

Optimize speed for: Web site

Q: how are you setting up your Linux to open the default project page?

A: I use Linux only to launch the webehelp output.

Q: Are you opening the GENERATED project default page or trying to open the project source files?

A: I am trying to open the generated project default page. I copy the Webhelp folder to a Linux machine and launch the index.html page to see the output.

Q: Why are you replacing the foreward-backward slash?

A: In Linux '\' is not supported for hyperlinks/filepaths. Therefore I changed the backward slashes to forward slashes.

The scenario:

When the project files have filepath such as ../../doc/xyz/,

  • when I view in Windows (IE)- I can access the link
  • when I view in Linux (FF)- I see broken link with error message somewhat like "cannot find ..\..\doc\xyz\". (Note the changed usage of slash)

This indicates that the generated files changes the forward slash to backward.

Inspiring
October 20, 2010

How do the file paths look in your generated help files, as raw HTML in Notepad for example?

- ToC files (whtdata0.htm etc.)

- any topic files that have links

Peter Grainge
Community Expert
Community Expert
October 19, 2010

I have asked a Linux user to look at this and he has kindly offered to run some tests later.


See www.grainge.org for RoboHelp and Authoring tips

@petergrainge

Use the menu (bottom right) to mark the Best Answer or Highlight particularly useful replies. Found the answer elsewhere? Share it here.