Re: How to build new html help on mac?

[Mojca M. <moj...@gm...>]

2011/2/26 Tatsuro MATSUOKA wrote:
> Hello
>
> The example of wgnuplot.chm can be obtained in the gnuplot cvs version packages for windows.
> http://www.tatsuromatsuoka.com/gnuplot/Eng/winbin/

Thanks a lot.

However there seems to be something weird. (I'm using ArCHMock to read
the chm file. Maybe it is a problem/bug in that application, but I
didn't have a problem opening any other chm file with the same program
until now.)

Instead of hyperlinks I get big white squares saying "Missing Plug-in"
and then something that seems like a symlink, but clicking on it
doesn't do anything.

I can send a screenshot if needed, but it is probably reproducible on
any other mac. External hyperlinks are working, just the internal ones
are broken, but maybe only on macs.

(If that bug is fixed I might start using that chm file on mac for
gnuplot help before I manage to create native mac help ... it is much
more useful and easy to read & search than inline help, in particular
when reading larger portions of help.)

Just a question: is it a mac-specific thing or does it also happen on
windows that subtopics are missing? For example "Terminal types" has
no text at all and "complete list of terminals" doesn't list any
terminal either. It is true that they are there in "bookmarks", but it
would be very useful to have a list of subtopics with hyperlinks.

> Perhaps you know that the html help workshop working on windows is required to generate chm format
> help file.
> You can use it if you install windows in your Apple PC.
> (Windows can be installed in the Apple PC.)

Compiling gnuplot on windows is a nightmare (I managed to do it once,
but without any library included). I have windows installed, but I
don't want to touch it.

I was not interested in compiling the chm file, but in getting just
the html before it compiles into chm. I would like to use html files
to create help for Mac.

> Another possible way, you will try to use wine for Mac OS.
> http://wiki.winehq.org/MacOSX
>
> I do not know the html help workshop can be executed in the wine on MacOS.

I don't need or even want wine. All I was looking for were html files.
But now that you pointed me to a ready chm file, I'm considering using
it as my main source for gnuplot help, even on a mac, at least until I
figure out how to compile native osx help.

Mojca

PS: it is really nice to see graphical examples present in help. A
pitty there are not more of them.