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

[Alexander Belchenko]

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.

Here is third version of patch. I simply grab original rst2html.py from
docutils 0.4 tarball and put it in tools/. Other parts not changed.

--
Alexander

-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: make-htmldocs-rev3.patch
Url: https://lists.ubuntu.com/archives/bazaar/attachments/20060817/2e981335/attachment.diff