Hi,
I just started to use NuHelp and I think it is very usefull for generating help documentation.
I had no problem with it until I tried to add an hyperlink in the source Word document.
The hyperlink should point to a document in my hard disk.
The Word hyperlink works correctly and also the html generated from NuHelp:
It seems the problem is the double dot for going up in the tree directory (href="../").
Even if I specify manually in Word the absolute path, Word will always use the relative path.
First attempt was to move the target file in a subdirectory where the main Words doc is stored. Anyhow in this way I have to duplicate target files. Second attempt was to create in a subdirectory the links to the target files and use those links in the main Word document. It works but, of course, if I move the chm file somewhere else then it will not work anylonger.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
If possible, email the complete word html file to info at opulos.com. In the mean time, an attempt will be made to reproduce the problm based on html snippet you provided.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Sorry for not replying before.
I'm attaching here a simple word document with one hyperlink to one text file in my PC.
Both files (doc and txt) are stored in my desktop (C:\Users\A.Renzi\Desktop).
The generated links point to the html pages itself !?
I'm attaching the generated pages as well.
Note: Test_raw.html works correctly, but not Test.chm
The correct way to define a hyperlink to an external file is to edit the hyperlink in Word, and change the hyperlink from "test.txt" to "\\test.txt". This causes MS-Word to ouput href="file:///\\test.txt" rather than href="..\..\..\..\..\..\test.txt".
Then make sure that test.txt is in the same folder as the .chm file.
However, a new version will be released that detects this case, and alerts the user. Also, an option to copy external files to the output folder (or to a user-specified subfolder relative to the output folder) seem like useful additions. It doesn't make sense to link to an external file that is not subfolder relative to the chm file because the file won't be found.
In the mean time, you can use the simple edit suggested above. Please report back if that solves your immediate needs.
Last edit: Opulos Inc. 2018-10-19
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Hi,
Thanks for the suggestion.
Anyhow, I'll try to explain my needs.
I have many, many products manuals that I need to access quickly in case of emergency situations (regarding customer telecommunication networks).
These manuals, guides and so on are stored in different folders of my PC but also on my company web server.
So, I need to create a .chm help file that has either some information or links to external documents.
I cannot link files that are stored only on the folder where the .chm files istored.
By the way, the html pages created by NuHelp are ok (i.e. the links work correctly).
Regards, Alessandro
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Your needs are understood. A new version will be released by next Friday that does a better job of resolving the href links. A message will be posted here when it is released.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Hi,
I just started to use NuHelp and I think it is very usefull for generating help documentation.
I had no problem with it until I tried to add an hyperlink in the source Word document.
The hyperlink should point to a document in my hard disk.
The Word hyperlink works correctly and also the html generated from NuHelp:
Call Flow
Anyhow when I click the link in the chm file I get following error:
Check whether Web Address //ieframe.dll/dnserrordiagoff.htm# is correct
Any idea on how to fix this problem ?
Thanks, Alessandro
Sorry, I forgot to add the html generated by NuHelp as code.
I try again
It seems the problem is the double dot for going up in the tree directory (href="../").
Even if I specify manually in Word the absolute path, Word will always use the relative path.
First attempt was to move the target file in a subdirectory where the main Words doc is stored. Anyhow in this way I have to duplicate target files. Second attempt was to create in a subdirectory the links to the target files and use those links in the main Word document. It works but, of course, if I move the chm file somewhere else then it will not work anylonger.
If possible, email the complete word html file to info at opulos.com. In the mean time, an attempt will be made to reproduce the problm based on html snippet you provided.
Sorry for not replying before.
I'm attaching here a simple word document with one hyperlink to one text file in my PC.
Both files (doc and txt) are stored in my desktop (C:\Users\A.Renzi\Desktop).
The generated links point to the html pages itself !?
I'm attaching the generated pages as well.
Note: Test_raw.html works correctly, but not Test.chm
Thanks for the sample file. Hopefully today a test will be done using the file, and a result of the findings will be posted here.
The correct way to define a hyperlink to an external file is to edit the hyperlink in Word, and change the hyperlink from "test.txt" to "\\test.txt". This causes MS-Word to ouput href="file:///\\test.txt" rather than href="..\..\..\..\..\..\test.txt".
Then make sure that test.txt is in the same folder as the .chm file.
However, a new version will be released that detects this case, and alerts the user. Also, an option to copy external files to the output folder (or to a user-specified subfolder relative to the output folder) seem like useful additions. It doesn't make sense to link to an external file that is not subfolder relative to the chm file because the file won't be found.
In the mean time, you can use the simple edit suggested above. Please report back if that solves your immediate needs.
Last edit: Opulos Inc. 2018-10-19
Hi,
Thanks for the suggestion.
Anyhow, I'll try to explain my needs.
I have many, many products manuals that I need to access quickly in case of emergency situations (regarding customer telecommunication networks).
These manuals, guides and so on are stored in different folders of my PC but also on my company web server.
So, I need to create a .chm help file that has either some information or links to external documents.
I cannot link files that are stored only on the folder where the .chm files istored.
By the way, the html pages created by NuHelp are ok (i.e. the links work correctly).
Regards, Alessandro
Your needs are understood. A new version will be released by next Friday that does a better job of resolving the href links. A message will be posted here when it is released.