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