You probably know this already, but there's a little bit of info here: http://groups.google.com/group/sphinx-dev/browse_thread/thread/ffd99304f4f9903d/85775bdf8db17c1a?lnk=gst&q=editor#85775bdf8db17c1a
Lee On 5/15/2011 6:56 AM, Andrea Aime wrote: > 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 > ------------------------------------------------------------------------------ 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
