[RFC][PATCH] Produce HTML docs to upload on server

[Alexander Belchenko]

Martin Pool пишет:
> On 16 Aug 2006, Alexander Belchenko <bialix at ukr.net> wrote:
>> I do cross-platform rst2html launcher to use directly from Makefile.
>> Therefore Makefile almost not changed.
>>
>> To produce HTML docs to upload onto Canonical server use command:
>>
>> make htmldocs
> 
> The changes to the Makefile to make it run on Windows look good.  
> 
> I don't really understand why you try to run rst2html in a subprocess.
> If it's installed, won't the docutils package be necessarily installed
> too?  OK, maybe the package will be not on the current Python path, but
> for people who want to regenerate the documents it shouldn't be too much
> to ask them to install it.

My first thoughts was simply copy original rst2html.py launcher to
tools/ subdirectory and use it directly. But then I ask myself: 'what
will be if docutils installed on some linux machines on another python
interpreter version?' This complicated launcher try to import docutils
first and in the case of ImportError falling back to invoking rst2html
as regular executable.

> 
> (Hm, does the tarball include generated html documents?  If not, it
> probably should.)

No. Release tarball contains only txt sources.

--
Alexander