Re: How to build new html help on mac?

[Ethan M. <merritt@u.washington.edu>]

On Monday, February 28, 2011, Mojca Miklavec wrote:

> > Ethan asked this already: PDF really is cross-platform. What don't you use
> > that?
> 
> 1.) It lacks figures. (Well, there is an option to create PDF with
> figures. But it works a bit bad. I can send screenshots, but I don't
> know how to fix the problem in LaTeX. LaTeX is very user unfriendly
> when it comes to creating floating text around figures. 

I find this kind of ironic.  I thought you were the LaTeX guru, 
sending me complex instructions about re-installing everything in
sight that I can't ever seem to get working.  But now you're having
trouble with something that works out of the box for me.

So - what's wrong with the document produced by your system using
the current "make pdffigures" target?  How is it different from
the pre-prepared one in the distribution?


> I would like
> to suggest to switch to TikZ for graphics in the manual, but that is
> lower on priority list.)

How would TikZ help at all?  I could switch the script to use TikZ
rather than pdfcairo, but the figures still need to get included
into the document.
 
> 2.) chm is really handy with its one-page-per-topic structure, it
> resizes nicely (rewraps text) when I resize the window, it has a very
> very very user-friendly user interface, better search etc.

Better search than PDF?  Maybe you need to switch PDF viewers.
 
> 3.) In reality (in slightly longer run) I want to figure out how to
> create native help for mac. And that one has no way to compare to PDF
> in any way. (I want help window to pop up when I type "help
> something", just like it does on windows.)

Are you saying that you want an option to compile gnuplot such that
"help foo" triggers an external viewer rather than invoking the
internal help system?   That sound possible, but it has little to
do with PDF vs HTML vs CHM.