Thanks all. This activity can now be followed at http://trac.gispython.org/lab/ticket/241
..Tom > -----Original Message----- > From: [email protected] > [mailto:[email protected]] On Behalf Of > Dominic Lowe > Sent: Tuesday, 26 October 2010 05:15 > To: gispython.org community projects > Subject: Re: [Community] OWSLib proposal: sphinx documentation > > Yes, +1 from me too. I think this is a good idea. > > Dom > > On 25/10/10 17:47, Sean Gillies wrote: > > 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 > _______________________________________________ Community mailing list [email protected] http://lists.gispython.org/mailman/listinfo/community
