Subdirectories not found

[Gloops]

Hello everybody,

The number of messages I find here does not encourage to be too precise,
can anybody answer about Html Help Workshop not recognising the
subdirectories of the main project folder, on the local C: drive ?

[Rainer H. Rauschenberg]

I would like to help you, but we didn't use subfolders.

What exactly do you mean by "not recognising the subdirectories"?

[Gloops]

Hello,

Thank you for your answer.

Guess what : since this afternoon, it works.

I was sure I tested all the possible syntaxes, but the page for the user
in the help browser always showed navigation cancelled.

Some points to take care of :
- each page has to be added to the project with the "add/remove topic
files" button
- at this condition, the <A> tag can refer to the page with or without
its path from the root of the HTML or from the root of the disk.

For instance, in the project file :

[FILES]
MainPage.html
Page1.html
Page2.html
img\Projet.bmp
Sujet\Sujet.htm

in the main page :
<p><A href="Sujet/Sujet.htm">Sujet</A></p>


and in page1 :
<p><img src="img/Projet.bmp" /></p>


I have to admit I have no idea why it did not work yesterday (I mean
while asking the question).

[Gloops]

Le 09/12/2015 00:26, Gloops a écrit :
> Le 08/12/2015 12:37, Rainer H. Rauschenberg a écrit :
>> On 2015-12-07, Gloops <glo...@zailes.invalid.org> wrote:
>>
>>> The number of messages I find here does not encourage to be too precise,
>>> can anybody answer about Html Help Workshop not recognising the
>>> subdirectories of the main project folder, on the local C: drive ?
>>
>> I would like to help you, but we didn't use subfolders.
>>
>> What exactly do you mean by "not recognising the subdirectories"?
>>
>
> Hello,
>
> Thank you for your answer.
>
> Guess what : since this afternoon, it works.
>
> I was sure I tested all the possible syntaxes, but the page for the user
> in the help browser always showed navigation cancelled.
>
> Some points to take care of :
> - each page has to be added to the project with the "add/remove topic
> files" button
> - at this condition, the <A> tag can refer to the page with or without
> its path from the root of the HTML or from the root of the disk.
>
> For instance, in the project file :
>
> [FILES]

> Sujet\Sujet.htm
>
> in the main page :
> <p><A href="Sujet/Sujet.htm">Sujet</A></p>
>
>
> and in page1 :
> <p><img src="img/Projet.bmp" /></p>

Some focus has to be brought to the syntax. It is a temptation to get
the path to a page from the address bar of the Windows explorer. The
help syntax can tolerate that if you double the backslashes, but the
path will be recognized two or three times and then not, or recognized
after compilation but not with the preview button you have in HTML Help
Workshop, or reverse.

So the declarations, in the project, are done by pressing a button and
choosing the file in a dialog box, and that issues paths with one
backslash between two path elements, but for the paths in the <A> tags,
you have to respect the same syntax as in web sites : relative paths
with one front slash between two path elements.

That is what is done in the example above.
To go back to the root, two points by level.

In Sujet/Sujet.html :

<P><A href="../MainPage.html">Main page</A></P>

And it is much easier to use BlueGriffon to type the help pages than to
type the whole HTML code in text mode in HTML Help Workshop.

There is something special if you want to open a pop-up window. Pay
attention, this point is not covered in the documentation by the pop-up
keyword, which is about creating a tooltip, but by "Related topics".

So you click on the "HTML Help ActiveX Control" button, you keep the
Related Topics choice and give a unique name, let us suppose you want a
button with text on it, and then you are invited, after pressing on Add,
to give a title, and a path next to the "File/URL" label.

This path must be given including the path to the compiled help file,
followed by two semi-columns, and the path to the page from the root of
the help system, as given above.

Example :
<PARAM name="Item1"
value="ZeTitle;C:\\Sites\\Help1\\Help1.chm::Page1.html">

ZeTitle is the title you seized in the dialog box, it seems it is for
internal reference, or maybe for the toc (I could not obtain an
automatic toc).

Then you can give the name of a window, that you defined before.

Pay attention : if you have a syntax error in your path, the compiler
can tell you that the window name you gave does not exist. Not always.

[Gloops]

Le 10/12/2015 20:28, Gloops a écrit :
> This path must be given including the path to the compiled help file,
> followed by two semi-columns

I meant two colons, it definitely was a good idea to give an example.