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

[Martin Pool]

On 17 Aug 2006, Alexander Belchenko <bialix at ukr.net> wrote:
> 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.

I think it's OK to require that people running this actually have
docutils installed.  On Linux it's easy enough to have the right version
corresponding to the Python version.

So +1 from me to merge that script with the 'except ImportError' block
removed.

> >(Hm, does the tarball include generated html documents?  If not, it
> >probably should.)
> 
> No. Release tarball contains only txt sources.

OK, it'd be nice to work out how to make setup.py do that.

-- 
Martin