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?
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?
--
Guillaume
http://blog.guillaume.lelarge.info
http://www.dalibo.com
