Sean: any update on this one? FYI this has been ticketed at http://trac.gispython.org/lab/ticket/241. Let me know if you need any help.
..Tom > -----Original Message----- > From: [email protected] > [mailto:[email protected]] On Behalf Of > Sean Gillies > Sent: Monday, 25 October 2010 12:48 > To: gispython.org community projects > Subject: Re: [Community] OWSLib proposal: sphinx documentation > > Tom, > > I'll be happy to write and manage the cron scripts. My > preference would be for minimal Sphinx, not too many add-ons. > > On Sun, Oct 24, 2010 at 5:57 PM, Kralidis,Tom [Ontario] > <[email protected]> wrote: > > > > All: I have been working on developing sphinx [1] docs for > OWSLib documentation. > > > > Initial efforts have been based on what's on > > http://trac.gispython.org/lab/wiki/OwsLib, as well as my > own documentation notes for CSW. > > > > I propose we add these to svn trunk, under a 'docs/' dir. Notes: > > > > - I used the MapServer approach to outputting multilingual > > documentation (you can see in docs/Makefile) > > - output documentation online would be at > http://gispython.org/owslib/docs/index.html with listing of > versions per release tag, i.e.: > > - http://gispython.org/owslib/docs/en/0.3.1/ > > - http://gispython.org/owslib/docs/en/x.y.z/ > > - svn trunk documentation would be at > http://gispython.org/owslib/docs/en/trunk/, and updated via > cron job, which would be: > > - cd owslib/trunk/docs/ && make html > > - cp -rp build/html/en/ <gispython.org/owslib/docs/en/trunk/> > > > > Way forward: > > - upon consensus, I will svn add to trunk > > - create http://gispython.org/owslib/docs/en/0.3.1 and > > http://gispython.org/owslib/docs/en/trunk/ > > - setup cron script to output (say hourly?) to > > http://gispython.org/owslib/docs/en/trunk/ > > > > I offer to help out any way I can. > > > > Thoughts? I think sphinx is a simple and powerful way to > develop and maintain documentation to output to many formats. > > > > ..Tom > > > > [1] http://sphinx.pocoo.org/ > _______________________________________________ > Community mailing list > [email protected] > http://lists.gispython.org/mailman/listinfo/community > _______________________________________________ Community mailing list [email protected] http://lists.gispython.org/mailman/listinfo/community
