From: Mojca M. <moj...@gm...> - 2011-02-28 15:37:26
|
2011/2/28 Bastian Märkisch wrote: > >> Did you ever notice any link that would return you multiple hits? I >> somehow have a feeling that gnuplot would not even generate a link in >> such cases (or that something weird would happen). > > There are a few. Most of them because we currently put both '?' and '=' > entries in gnuplot.doc into the index. > > Try: > > awk "/^=|^?/ {key=substr(\$0,2); if (a[key]==1) print \"duplicate:\", key; > a[key]=1;} " gnuplot.doc | wc -l > > It gives 45 duplicates for =|?, 0 for '?' only, and 18 for '=' only. So in a > strict sense ('?' only) there are really non duplicate interactive help > entries. But I wanted to make use of the additional index entries. And why > shouldn't we? Thanks a lot for explanation. >> Out of curiosity: why is "image" not a link (not even in other >> documents, not just in chm)? > > 'image' is a interactive help entry. Which topics miss the link? I'm sorry. I now see that it is completely confusing. 1.) In HTML document (created with the command you pointed me to), I get 2.14 image The `image`, _rgbimage_, and _rgbalpha_ plotting styles all /.../ That is: image is in ugly `quotation marks` instead of being a link or at least a bold keyword. 2.22 rgbimage See `image`. which is entirely useless since `image` should be a link here (but that is HTML, not your CHM file). 2.) In PDF: 37 Image The {\bf image}, {\bf rgbimage}, and {\bf rgbalpha} plotting styles all /.../ where it would be handy to have hyperlinks to rgbimage and rgbalpha. 45 Rgbimage See image (p. _49_). which is perfectly ok (includes hyperlink; hyperlinks are marked with "_"). 3.) In CHM it is image The <b>image</b>, _rgbimage_ and _rgbalpha_ plotting styles all /.../ but I have noticed later that you consistently don't provide any self-links anywhere, so that may be the clue of why I thought the link was missing. The rgbimage example links to image as expected (I'm curious to know if it will still link if I try to compile the file with hardlinks). > So in fact, it would be rather unlikely that the average gnuplot user has a > program to view CHM files already installed? Yes. But it is even more unlikely that he would come to the perverse idea to download the zip for windows for stealing help from there. > Anyway, there's now a compile time option for hard links, just define > HTML_HARDLINKS. Great, thanks a lot. I will try to figure out how to compile gnuplot on windows despite some of very bad experiences from the past. >>>> (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.) >>>> > > 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 would like to suggest to switch to TikZ for graphics in the manual, but that is lower on priority list.) 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. 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.) >>>> 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. > > You got a point there. Now included. Thanks a lot. Mojca |