[OSGeo-Discuss] Help authoring tools

[Jorge Gaspar Sanz Salinas]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

El 01/06/10 19:00, Daniel Ames escribió:
> Do any of you have a preferred open source help authoring tool? We're
> looking for something to document our projects on web pages - something
> better than wiki - and also to download and install with software. Must
> be cross platform, etc. I'd like to use whatever others are using in the
> OSGeo community for consistency... - Dan
> 

At gvSIG project we use Plone CMS and restructured text markup at
gvsig.org

I agree with others that sphinx is a nice environment to build but
well, we use our Plone instance for more things than documenting: we
have a contrib section[1], a huge group of people translating not only
the website (manuals, courses, etc) but also the gvSIG GUI (Desktop
and Mobile) using a new plone plugin we promoted[2], working groups
management, our events[3], etc. etc.

rst is a nice markup and I use it everyday with gnome text editor
(gedit). There are some plugins to help editing rst, do fast previews,
etc.

Anyway I would recommend also to follow the other people
recommendation about using sphinx, our plone instance requires to have
a very skilled people and sphinx is more easy to deploy and maintain.

Cheers

[1] https://gvsig.org/plugins/downloads
[2] http://forge.osor.eu/projects/gvsig-i18n/
[3] https://gvsig.org/web/home/community/events
- -- 
Jorge Gaspar Sanz Salinas
Ingeniero en Geodesia y Cartografía
http://es.osgeo.org
http://jorgesanz.net
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJMBgWbAAoJEAOYD75lvHdBFGEIAI74vFA+dqd72GeA6+r8uKuT
CXRPOklFQTy6Wn/KsR6kNuWILbm1K7hzKiV4giEcyrahZZKLElPqq47DF6/uo0rS
uL4blK8fU7S13ak5anGtCytTYefgHth9TQMYomzp59rEmbmT7d4CXbi86PWKxpRI
kkvYjJwgRDo3stEMcTAB1Dq2i8iFQswg4i5FoT4su27mPv+zNKvxMNzSNFXBBLeg
JGZqZosRlILFse0Rshr8eMX9OsdwXHn6NXqbzBFzue3ClNQ6C3gH6rjD9XKF0hFD
6+N+yLwGJZmwZMjFWBy13SQ9lCQRNbid82DHUWhrydSOLSkNhSP45UextGgAnGM=
=AwhV
-----END PGP SIGNATURE-----