2008/12/3 Hannes Magnusson <[EMAIL PROTECTED]>:
> On Wed, Dec 3, 2008 at 10:03, Álvaro G. Vicario <[EMAIL PROTECTED]> wrote:
>> 2008/12/3 Hannes Magnusson <[EMAIL PROTECTED]>:
>>> On Wed, Dec 3, 2008 at 09:21, Xuefer <[EMAIL PROTECTED]> wrote:
>>>> http://www.php.net/download-docs.php
>>>> either traditional or extended html help file (chm) is 1 year lag
>>>> behind, can soneone pls update it? thx
>>>
>>> The extended CHM will probably be dropped in the next days.
>>> We are working on the normal CHM files (in all languages) and it will
>>> hopefully be online before next Friday (and rebuilt on weekly basis
>>> after that).
>>
>> I understand it's hard to maintain the two separate versions of the
>
> The underlying problem is that noone understands how the CHM works,
> and noone cares enough to tell me exactly what this "extended chm"
> file is exactly and how we can create it :(
>
> -Hannes
>

A CHM file is essentially a compressed website with the CHM reader
providing indexing and searching capabilities. The CHM reader is, to a
point, IE. Anything IE can do then a CHM can do (ok, don't go over
board on this, it is only a help file).

The Extended CHM had additional javascript code to allow the user
notes to be integrated at runtime (2 CHMs, Manual and User Notes). The
old style build process for the ExCHM converted the usernotes into
separate HTML files per manual page.

The ExCHM also supported skinning by using different JS/CSS files
controlled by a small windows GUI application.

The process of getting the user notes into the main page involved some
rather nifty javascript which essentially grabbed the notes HTML and
dropped it into a container (though in hindsight, maybe an iframe
would have been a better option here). The CHM indexing and searching
could search both the usernotes and the main manual.

As a consequence, the main document was adjusted at runtime to
accommodate the usernotes. This had an unfortunate side effect of
losing any highlights added by the CHM reader.

Richard.

-- 
-----
Richard Quadling
Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
"Standing on the shoulders of some very clever giants!"

Reply via email to