Difference between revisions of "Cómo Generar Documentación en JavaScript"

From Wiki de Caballero
Jump to navigation Jump to search
Line 31: Line 31:
</li>
</li>
<li>
<li>
En vez de ejecutar cada vez estos comandos es mejor ponerlos en algún archivo que lo haga automáticamente. Esto se puede hacer en diferentes partes, por ejemplo en ~/.profile, pero una mejor forma puede ser guardarlo en el archivo jsdoc (mencionado en el paso 4 de la instalaciónd e JSDoc), se agrega el código al principio del archivo.
En vez de ejecutar cada vez estos comandos es mejor ponerlos en algún archivo que lo haga automáticamente. Esto se puede hacer en diferentes partes, por ejemplo en ~/.profile, pero una mejor forma puede ser guardarlo en el archivo jsdoc (mencionado en el [[Cómo documentar JavaScript#Instalación|paso 4 de la instalación de JSDoc]]), se agrega el código al principio del archivo.
</li>
</li>
</ol>
</ol>


====Uso====
====Uso====
 
El uso es el mismo que el de JSDoc pero se usan ubicaciones de DocStrap, con las variables que se crearon en el punto anterior, se usa de la siguiente manera:
<syntaxhighlight lang="bash">
jsdoc js.js -t $JSDOC_DOCSTRAP_TEMPLATE_DIR -c $JSDOC_DOCSTRAP_CONFIG -d /directorio/donde/se/guarda/documentacion/
</syntaxhighlight>


===Referencias===
===Referencias===
* http://usejsdoc.org/, cómo usar JSDoc.
* http://usejsdoc.org/, cómo usar JSDoc.

Revision as of 23:10, 25 May 2014

JSDoc

Una forma de documentar JavaScript es usar JSDoc para generar la documentación en html. Este software hace uso de una sintaxis similar a JavaDoc. A continuación los pasos para instalarlo y usarlo fácilmente.

Instalación

  1. Crear directorio para mantener todo lo relacionado con JSDoc en /opt/local/etc/jsdoc (directorio sugerido).
  2. Descargar JSDoc de https://github.com/jsdoc3/jsdoc/archive/master.zip.
  3. Descomprimir en el directorio creado en el primer paso.
  4. Agregar el ejecutable de JSDoc al PATH. Para esto se puede crear un link del ejecutable, por ejemplo corriendo el siguiente comando: 
    sudo ln -s /opt/local/etc/jsdoc/jsdoc-3.2.2/jsdoc /usr/local/bin/jsdoc

Uso

El uso básico es sencillo, se llama JSDoc y se le pasa el parámetro de donde se quiere generar la documentación. 

jsdoc js.js -d /directorio/donde/se/guarda/documentacion/

Para saber más sobre el uso ejecutar jsdoc --help.

DocStrap

Instalación

  1. Descargar DocStrap de https://github.com/terryweiss/docstrap/archive/master.zip.
  2. Descomprimir DocStrap en el directorio del primer paso.
  3. Para el uso de DocStrap se usan algunos parámetros como su ubicación, en vez de escribir cada vez los directorios se usan variables para hacerlo más fácil. Para crear estas variables se hace con los siguientes comandos: 
    export JSDOC_DOCSTRAP_DIR=/opt/local/etc/jsdoc/docstrap-master
export JSDOC_DOCSTRAP_TEMPLATE_DIR=$JSDOC_DOCSTRAP_DIR/template/
export JSDOC_DOCSTRAP_CONFIG=$JSDOC_DOCSTRAP_TEMPLATE_DIR/jsdoc.conf.json
  4. En vez de ejecutar cada vez estos comandos es mejor ponerlos en algún archivo que lo haga automáticamente. Esto se puede hacer en diferentes partes, por ejemplo en ~/.profile, pero una mejor forma puede ser guardarlo en el archivo jsdoc (mencionado en el paso 4 de la instalación de JSDoc), se agrega el código al principio del archivo.

Uso

El uso es el mismo que el de JSDoc pero se usan ubicaciones de DocStrap, con las variables que se crearon en el punto anterior, se usa de la siguiente manera: 

jsdoc js.js -t $JSDOC_DOCSTRAP_TEMPLATE_DIR -c $JSDOC_DOCSTRAP_CONFIG -d /directorio/donde/se/guarda/documentacion/

Referencias

Retrieved from "http://wiki.caballero.co/index.php?title=Cómo_Generar_Documentación_en_JavaScript&oldid=327"