On Mon, Oct 25, 2010 at 1:57 AM, 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
Hi Tom this is an excellent news! Thanks for your effort Nowadays I am also trying to assemble some material about this excellent library for a GIS/Python talk I will give here at the local FOSS4G day. Your compressed file seems missing the .rst files (and the html build), are you aware of that? I would love to see your work thanks P -- Paolo Corti GIS specialist and web developer web: http://www.paolocorti.net twitter: @paolo_corti _______________________________________________ Community mailing list [email protected] http://lists.gispython.org/mailman/listinfo/community
