Menu
▾
▴
Re: How to build new html help on mac?
|
From: Mojca M. <moj...@gm...> - 2011-02-27 23:59:19
|
On Sun, Feb 27, 2011 at 22:14, Bastian Maerkisch wrote: > On 27.02.2011 00:30, Mojca Miklavec wrote: >> >> 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. > > The reason for this is probably that this app does not support the ActiveX > control which is used for linking. We use so-called K-links, aka a real > look-up in the index instead of hard links. This helps in case of ambiguous > references (multiply defined targets). 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). Out of curiosity: why is "image" not a link (not even in other documents, not just in chm)? > I realize that ActiveX is Windows technology, but so is CHM and this is a > standard control of the Windows HTML help workshop. > > Btw. how widespread is ArCHMock amongst Mac users? Google code claims 34.000 downloads since 2008 (but there are other sources that don't mention any number, like the official apple page http://www.apple.com/downloads/macosx/unix_open_source/archmock_vyacheslavzakovyrya.html) and there are other readers such as iChm (70.000 downloads since Oct. 2009 from Google Code). I would say that an average user doesn't have it until (s)he stumbles upon a document that doesn't come in any other format (and is eager enough to search for solutions to read it). I first did that when I received a book that only came in that format. chm is really exposed on windows since that is the default way to get any help. I'm not sure how many mac users would come to idea to download zip for windows, get chm from there and try to open it. On the other hand, I don't know how it is implemented on windows, but on mac searching in a chm document is very handy & natural. I would prefer hard links myself, but if it has many advantages on windows, it is better to make sure that windows users have a better experience. Out of curiosity: what is supposed to happen in terminal when somebody asks for > help multiple-times-defined-keyword ? How does it decide which one to show? I somehow think that it might be much better if links were not defined multiple times, but rather properly linked (with 'see also' etc.). >> (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. > > That is normal. There is not text or table of terminals there. I know. But there are subtopics. If you type > help set under linux you will get Subtopics available for set: angles arrow autoscale bars bmargin border boxwidth cbdata cbdtics cblabel cbmtics cbrange cbtics clabel clip cntrparam colorbox contour data datafile date_specifiers decimalsign dgrid3d dummy encoding fit fontpath format Press return for more: and that list was also present in the old help for windows (from what I can remember). > See gnuplot.pdf or even better gnuplot.doc. gnuplot.doc contains enough information. But I agree that it is not just straightforward to dig it out with C code ... > If you want this is an artifact of > the fact that we produce printed docs and online help from the same source. This particular problem can be solved with a few more tricks. (I need to figure out how the "online" help for gnuplot is generated.) Mojca |
