1+ for the conversion to rst but some side notes inline 2012/5/7 Jody Garnett <jody.garn...@gmail.com>: > Starting in on this today … > > 1) https://bitbucket.org/cdevienne/odt2sphinx > > This may be able to convert out walkthroughs and other assorted open office > docs. > > 2) http://johnmacfarlane.net/pandoc/ > > Looks like this converts Textile (like from a confluence export) to RST. > Would use this to start porting our admin guide. > > Notes: > - Going to mirror the geoserver setup with docs/en, docs/it etc… in case > people want to translate later? I think the OSGeo Live DVD has a better > example of how to do this in a single build.
I'm involved in the translation and documentation process in general for OSGeo Live. Everything is build with a Makefile. It creates symbolic links to the origin (en) rst file in the translation folder structure. Afterwards a standard sphinx command creates the html's (pdf's or whatever is possible). Because of a java project with maven build tools we should setup the doc build like geotools/geoserver did by using ant scripts... An other great pro is, that we don't need an other editor for the documentation and everybody can read it directly in the browser (at github). I'm wondering whether we can setup a project at www.transifex.net based on pot files (see also sphinx docs at http://sphinx.pocoo.org/latest/intl.html) What do you think? In the past I had positive experience with translation tools like transifex or sphinx. The great pro is to get people involved that are not programmers (git experiences, commit rights etc.) What's required? A facebook/twitter/google/linkedin account... So please lets evaluate pot scenario :) Cheers, Frank > -- > Jody Garnett > > > _______________________________________________ > User-friendly Desktop Internet GIS (uDig) > http://udig.refractions.net > http://lists.refractions.net/mailman/listinfo/udig-devel > _______________________________________________ User-friendly Desktop Internet GIS (uDig) http://udig.refractions.net http://lists.refractions.net/mailman/listinfo/udig-devel
