referencia-html

¿Qué es este repositorio?

Es una referencia de HTML. Contiene información sobre etiquetas y atributos útil para desarrolladores. Este proyecto toma como referencia la última versión de HTML (la HTML 5.1 a día de hoy). Cuando se publique una nueva versión de HTML, esta referencia deberá ser actualizada.

¿Cómo funciona?

Para generar los manuales utilizamos Sphinx, lo que nos permite generar documentación para distintos formatos.

¿Cómo genero la referencia a partir de este repositorio?

Para generar la documentación en formato HTML debes seguir los siguientes pasos:

1. Descarga el repositorio o clónalo usando Git (git clone https://notabug.org/jorgesumle/referencia-html).
2. Instala Python si no lo tienes instalado.
3. Instala Sphinx y el tema sphinx_rtd_theme. Puedes hacerlo con pip: pip install Sphinx sphinx_rtd_theme.
4. Ejecuta make html en la carpeta raíz del repositorio. Si usas Windows y no tienes el programa make, puedes ejecutar sphinx-build -b html . _build/html/.
5. La documentación estará disponible en el directorio _build/html/. Puedes abrir el archivo index.html que encontrarás en ese directorio con tu navegador favorito.

No obstante, puedes generar la documentación en cualquier otro formato ofrecido por Sphinx. Lee la documentación de Sphinx para descubrir cómo trabajar con otros formatos.

Actualizar la versión de HTML de la guía

Actualmente es necesario actualizar esta guía a la versión 5.2 de HTML.

Simplemente es necesario traducir y resumir la parte de la especificación oficial de las etiquetas, solo lo que está dirigido a desarrolladores porque la especificación también se dirige a quienes programan navegadores web. La mayoría de las etiquetas ya existen en esta guía y requerirán solo cambios menores con las novedades de la nueva versión de HTML. Actualmente es la sección 4 de la especificación de HTML 5.2 la que interesa.