Hi, it occurred to me it may be of interest to share how I work on the docs, and maybe hear how other do it as well.
I basically tried a few ways: a) from Eclipse use an old plugin called Afae (http://robrohan.com/2005/07/01/afae-an-all-purpose-editor-for-eclipse/) which I hand modified to do syntax highlight on rst files. The editor is nice in that it has word wrapping, very much necessary to wrok on the long lines of rst files (at least the GeoServer ones). And then configure an external tool build launcher to re-run sphinx on the command line, and a firefox to preview the contents. Dev cycle is: edit a bit, keyboard shortcut to run sphinx, ctrl-tab to see firefox, refresh, check, go back. Not bad, but the hand modifications to afae are long to make, made it on one machine and was too lazy to replicate on my notebook b) install JEdit along with the "Project View", "Spell Check" and "Console" plugin. Once the project is setup edit a file, run the sphinx build on the console, tab to firefox, refresh, back. Clunky in a number of ways though, the project plugin is not really great, but hey, sort of works c) all the way down to command line with vim, which also syntax highlights rst. Needs some obscure command to turn on word wrapping, save, ctrl-z to go to command line, build, firefox, "fg" to get vim back and continue. Don't like it but it's a possibility. d) gedit can word wrap and syntax highlight rst too, and also do spell checing. But file management is poor, could not get it to work in an acceptable way. In all cases having the extension as .txt in geoTools is a nuisance, all editors require us to do something explicit, and often well hidden, to get proper syntax highlighting. Recently I also stumbled into this promising french eclipse plugin: http://www.coderxpress.net/blog/2011/05/rest-editor-1-0-4/ It looks really promising, but still lacks word wrapping for the moment, the author might be adding it in the next version. Oh well, the quest for the ideal rst editor system is still open for me, but hope the above can be a help for others trying to do editing with rst Cheers Andrea -- ------------------------------------------------------- Ing. Andrea Aime GeoSolutions S.A.S. Tech lead Via Poggio alle Viti 1187 55054 Massarosa (LU) Italy phone: +39 0584 962313 fax: +39 0584 962313 http://www.geo-solutions.it http://geo-solutions.blogspot.com/ http://www.youtube.com/user/GeoSolutionsIT http://www.linkedin.com/in/andreaaime http://twitter.com/geowolf ------------------------------------------------------- ------------------------------------------------------------------------------ Achieve unprecedented app performance and reliability What every C/C++ and Fortran developer should know. Learn how Intel has extended the reach of its next-generation tools to help boost performance applications - inlcuding clusters. http://p.sf.net/sfu/intel-dev2devmay _______________________________________________ Geotools-devel mailing list Geotools-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/geotools-devel
