[pyar] Amigos de Sphinx

[Wil Alvarez]

El 12 de julio de 2013 13:54, Elvio Rogelio Toccalino <
elviotoccalino en gmail.com> escribió:

> Uh! yo siempre edite manopla, asi que me supo a la consulta :)
>
>
> El 12 de julio de 2013 14:46, Andres Riancho <andres.riancho en gmail.com>escribió:
>
> Estimados,
>>
>>     Estoy escribiendo la documentacion para un proyecto, y por primera
>> vez tengo tiempo para dedicarle a hacerla BIEN :) Por eso estoy usando
>> Sphinx, lo que queria consultar era que otras herramientas (mas alla
>> de un RST editor) recomiendan para usar en un proyecto de
>> documentacion.
>>
>>     Gracias!
>>
>> Saludos,
>> --
>> Andrés Riancho
>> Project Leader at w3af - http://w3af.org/
>> Web Application Attack and Audit Framework
>> Twitter: @w3af
>> GPG: 0x93C344F3
>> _______________________________________________
>> pyar mailing list pyar en python.org.ar
>> http://listas.python.org.ar/listinfo/pyar
>>
>> PyAr - Python Argentina - Sitio web: http://www.python.org.ar/
>>
>> La lista de PyAr esta Hosteada en USLA - Usuarios de Software Libre de
>> Argentina - http://www.usla.org.ar
>>
>
>
> _______________________________________________
> pyar mailing list pyar en python.org.ar
> http://listas.python.org.ar/listinfo/pyar
>
> PyAr - Python Argentina - Sitio web: http://www.python.org.ar/
>
> La lista de PyAr esta Hosteada en USLA - Usuarios de Software Libre de
> Argentina - http://www.usla.org.ar
>

Estuve revisando varias y hasta ahora Sphinx me parece la mejor. Tiene
bastante documentación y es sencilla, todo se resume a comentar bien tu
código.

Si quieres ejemplos de cómo hacerlo puedes darle un ojo al código del core
de libturpial [1] y puedes seguir las instrucciones en [2] para generar la
documentación y ver el resultado.

Saludos

[1]
https://github.com/Turpial/libturpial/blob/development/libturpial/api/core.py
[2] https://github.com/Turpial/libturpial/blob/development/README.rst

-- 
“Yo construyo Soberanía, uso Software Libre”
Wil Alvarez
Linux Counter #415026
http://damncorner.blogspot.com
------------ próxima parte ------------
Se ha borrado un adjunto en formato HTML...
URL: <http://listas.python.org.ar/pipermail/pyar/attachments/20130715/2c343f3e/attachment.html>