Estructura de páginas

A lo largo de MDN existen estructuras de documentos que se utilizan para proporcionar una presentación coherente de la información en los artículos de MDN. Esta página enumera artículos que describen estas estructuras para que pueda modificar el contenido de la página de manera adecuada para los documentos que escribe, edita o traduce.

Banners y avisos

Se agregan banners a algunas páginas, en particular a la referencia de la API, para resaltar factores importantes que afectarán la forma en que se usa el contenido descrito. Por ejemplo, los banners se usan para resaltar cuándo una interfaz, un método o una propiedad en particular están obsoletos y no deben usarse en el código de producción.

Ejemplos de código

En MDN, encontrarás numerosos ejemplos de código insertados en las páginas para demostrar el uso de las características de la plataforma web. Este artículo discute los diferentes mecanismos disponibles para agregar ejemplos de código a las páginas, junto con cuáles debes usar y cuándo.

Ejemplos ejecutables

MDN puede convertir ejemplos de código de los artículos a ejemplos ejecutables que el lector puede ver en acción. Estos ejemplos ejecutables pueden contener HTML, CSS, y JavaScript en cualquier combinación. Ten en cuenta que los ejemplos "ejecutables" no son interactivos; sin embargo, aseguran que el output coincida exactamente con el código de ejemplo, porque es generado por este.

Enlaces rápidos

MDN admite la adición de enlaces rápidos a las páginas; estos son cuadros que contienen una lista potencialmente jerárquica de enlaces a otras páginas en MDN o a páginas fuera del sitio. Este artículo describe cómo crear enlaces rápidos.

Tablas de compatibilidad y repositorio de datos de compatibilidad con navegadores (BCD)

MDN tiene un formato estándar para tablas que ilustran la compatibilidad de tecnologías compartidas en todos los navegadores, como DOM, HTML, CSS, JavaScript, SVG, etc. Para que estos datos estén disponibles en varios proyectos mediante programación, se crea un paquete de Node.js desde el repositorio browser-compat-data y se publica en npm.

Tablas de especificaciones

Cada página de referencia en MDN debe proporcionar información sobre la especificación o especificaciones en las que se definió esa API o tecnología. Este artículo muestra el aspecto de estas tablas y explica cómo agregarlas.

Utilizando macros

La plataforma Yari en la que se ejecuta MDN, proporciona un sistema de macros, KumaScript que permite automatizar ciertas tareas. Este artículo proporciona información sobre cómo invocar las macros de MDN dentro de los artículos.