Referencia de HTML 5.1

Jorge Maldonado Ventura 56bd49b27d Agrega nota sobre actualización a la nueva versión 6 months ago
imagenes 6034f2cd7e Cambia ejemplo de código del atributo global contextmenu 2 years ago
.gitignore 9b2925bdb3 Añade .gitignore que ignora el directorio _build 3 years ago
Makefile 66b7cb2d46 empezando con Sphinx 3 years ago
README.markdown 56bd49b27d Agrega nota sobre actualización a la nueva versión 6 months ago
agrupando-contenido.rst 3af401c8da Corrección de faltas de ortografía 2 years ago
atributos-globales.rst 6034f2cd7e Cambia ejemplo de código del atributo global contextmenu 2 years ago
conf.py d7ddc5c2c3 Publica versión 1.0 2 years ago
contenido-incrustado.rst b6dbbfd7cb Estes es el archivo que tiene la versión revisada de contenidos_incrustados , revisa esta y añadela 2 years ago
datos-tabulados.rst 6b19e36a98 Realiza correcciones en datos-tabulados.rst 2 years ago
edicion.rst 16bdf6b488 Completa sección 6: Edición 2 years ago
elemento-raiz.rst 8b1a34dff0 Correción de elemento Html 2 years ago
elementos-interactivos.rst ceb3b10112 Termina sección elementos interactivos 2 years ago
formularios.rst 5441aa4e1c Corrige error en el segundo código de ejemplo del elemento select 2 years ago
index.rst 34d26febe5 Añade sección de datos tabulados al índice 2 years ago
metadatos.rst 11dd947b31 Añade codificación de caracteres al ejemplo del elemento style de metadatos.rst 2 years ago
scripting.rst deb889ee87 Correción ejemplo de código del elemento noscript 2 years ago
secciones.rst 738fc9a63c Cambia el ejemplo de <aside> 2 years ago
texto-nivel-semantico.rst e3c46e5b65 Corrección de encabezado 2 years ago

README.markdown

¿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.