Re: [Epydoc-devel] chm files

[<jU...@ar...>]

Daniele Varrazzo schrieb:
> Jürgen Urner ha scritto:
>   
>> Hello,
>>
>> ...didn't know epydoc is under active developement again.
>>
>> I just would like to ask if someone is already working on on some
>>     
> mechanism to generate microsoft *.chm files from epydoc output.
>   
>> If not, maybe someone here is interested in joining forces to add this 
>>     
> feature
>   
>> to epydoc?
>>
>> Jürgen
>>
>>     
>
> Hello,
>
> i think .chm output would be a nice feature, and i think easy enough to
> put together.
>
> My experience is very limited, but it seems chm are just a bunch of html
> files together with an index, a ToC and a project file: Epydoc should 
> produce only a few files more than what the html writer already does.  The
> HTML generator already builds identifiers and terms indexes, so it's
> probably just a matter of reformatting them to get them right for the
> .chm: the informations required are already there.
>
> There is a open feature request for chm files (SF #938921) where Robin
> Dunn posted a script to generate support files to compile a CHM version of
> Python docs: if i had to start with a .chm writer i would start from
> there.
>
> I'd work for it after the 3.0 has been completed; any help you may give
> would be appreciated and would help us to quickly have chm support in the
> 3.1 alpha development line.
>
> Thank you very much,
>
>   

Yes, I thought of something like simply parsing over the html output
from epydoc, bringing the htmls into adequate form (removing frames ....).

I already have a some modules at hand. One to generate all the required
files for micros html workshop compiler (needs rework, ugly code!) and 
one for
parsing and bringing into shape html files. All not heavily tested, 
though working.

Think I could throw this together in a few weeks to a working alpha.
But the thing I can not do is test it on linux. AFAIK, Wine supports 
micros compiler
and it would be nice to support this.

And ....of course, I'd welcome any help or advice on implementation details.

Thanks for feedback, Jurgen