On Sat, Jul 2, 2011 at 2:09 PM, Guillaume Lelarge
<guillaume@lelarge.info> wrote:
> On Thu, 2011-06-30 at 09:32 +0100, Dave Page wrote:
>> On Thu, Jun 30, 2011 at 9:08 AM, Guillaume Lelarge
>> <guillaume@lelarge.info> wrote:
>> >
>> > Could be the next thing I do. Last time we talked about it, I had done
>> > some work on sphynx. IIRC, I had two main things to do:
>> >
>> > * try to build on Windows, and Mac
>> > * change the build chain so that it buils automatically the manual
>> >
>> > Did I forgot something?
>>
>> No, I think that's it.
>>
>
> OK, I've done some work on this.
>
> Linux prep steps
>
> * install Python (with your distro package manager)
> * install the python easy_install module
> * install Sphinx (should be as easy as "easy_install -U Sphinx)
>
> Windows prop steps
>
> * download http://www.python.org/ftp/python/2.7.2/python-2.7.2.msi
> * install python-2.7.2.msi
> * download
>
http://pypi.python.org/packages/2.7/s/setuptools/setuptools-0.6c11.win32-py2.7.exe#md5=57e1e64f6b7c7f1d2eddfc9746bbaf20
> * install setuptools-0.6c11.win32-py2.7.exe
> * include C:\Python27\Scripts in %path%
> * in cmd, type "easy_install.exe -U Sphinx"
>
> Mac OS X prep steps
>
> I already had Python and the easy_install module, so I just had to
> install Sphinx with the usual command ("easy_install -U Sphinx")
>
> Windows Visual Studio project changes
>
> It should be quite simple. We simply need to change the Docs project so
> that it launches the "make html" command instead of the "builddocs.bat".
> We'll also have to add all the rst files in this project.
>
> Linux, and Mac OS X Makefile
>
> This should also be quite simple. We only need to change the Makefile so
> that it calls the Make in the docs directory.
>
> If it seems good enough for you, I'll update the rst filess with the new
> changes. I'll update the build system. And creates one big patch for all
> of this. OK?
OK.
> The remaining question is: what style do we want? do we keep the default
> theme? should we code one? any idea on what that should be?
If we code one, it should probably roughly follow the websites style.
Speaking of which, we'd need to figure out how we'd automate the
publishing of the docs on the website....
--
Dave Page
Blog: http://pgsnake.blogspot.com
Twitter: @pgsnake
EnterpriseDB UK: http://www.enterprisedb.com
The Enterprise PostgreSQL Company
