Rdoc, el generador de documentación de Ruby

Rdoc es el generador de documentación de Ruby por defecto. Es muy útil para generar la documentación de librerías que luego has de reutilizar.

Básicamente parsea recursivamente todos los archivos .rb, .rbw y .c del subdirectorio actual, en busca de comentarios encima de la definición de cada función y al inicio del fichero. Con todos estos datos crea archivos HTML en un subdirectorio llamado "doc". Un ejemplo del resultado es: api.rubyonrails.com

Para ejecutarlo hay que llamar a:
rdoc

Unos flags útiles son:
  • --main [PATH a un fichero], hará que el fichero apuntado sea el que aparezca como inicio en la documentación generada.

  • --all, incluye también métodos privados en la documentación (por defecto solo incluye los públicos).

  • --op [PATH a un directorio], utiliza este directorio para guardar la documentación en lugar de "doc".

  • --inline-source, incluye el código fuente de cada método en la documentación.


Reglas básicas de marcado:
  • = cabecera de nivel 1

  • == cabecera de nivel 2

  • * o - crea un elemento de una lista

  • # crea un elemento de una lista numerada

  • Con las palabras se puede hacer: _italica_, *negrita* y +codigo+


Más información:

Etiquetas:

Posted by Spejman at 8:20 p. m. | 0 comments | links to this post read on

Inteligencia Artificial y Ruby on Rails: Mejora la publicidad de tu web

Mas vale tarde que nunca... este post debería haberlo escrito hace unos 2 meses, pero estos han sido frenéticos, mucho trabajo. Uno de los proyectos que me ha tenido más ocupado estos meses es verycocinar.com que en los próximos días verá la luz, la verdad es que está teniendo críticas muy positivas lo que me anima a continuar trabajando.

Bueno, aquí dejo las transparencias de la sesión: http://www.slideshare.net/spejman/inteligencia-artificial-y-ruby-on-rails-mejora-la-publicidad-de-tu-web

Y aquí el vídeo con la ponencia grabada:
http://2007.conferenciarails.org/videos/02_Rails_Hispana_2007_Sala2_Inteligencia_Artificial.wmv

Espero que sean de utilidad!

Etiquetas: , , ,

Posted by Spejman at 9:30 p. m. | 2 comments | links to this post read on
Recommend Me


XING
View Sergio Espeja's profile on LinkedIn













Enlaces