Bloques Code y HTML

Objetivo: presentar un ejemplo de código y entender el único bloque que puede romper una página.
Tiempo: 3 minutos
Necesita: una página y algo que mostrar

1. Seleccione Add Block y elija Code.
2. Rellene Title y use Filename / Language Label para la etiqueta pequeña sobre el ejemplo: un nombre de archivo se lee mejor que el nombre de un lenguaje.
3. Pegue el ejemplo en Code y ajuste Syntax Language.
4. Seleccione Save New Block.
5. Para marcado que ningún bloque puede expresar, seleccione Add Block y elija HTML (Trusted).
6. Pegue su marcado en Trusted HTML y seleccione Save New Block.

El bloque se llama HTML (Trusted) porque el CMS deja de comprobar en ese punto. Lo que pega es lo que se renderiza.

Eso significa que una etiqueta sin cerrar puede romper la disposición de toda la página, que un código de seguimiento pegado se ejecuta en cada visita, y que un embebido de un sitio que no controla puede cambiar más adelante lo que le sirve. Nada de eso se adapta cuando cambia el diseño del sitio.

Antes de recurrir a él, compruebe: ¿existe un bloque real para esto (vídeo, audio, descarga, galería, tabla y formulario de contacto existen todos)? ¿El proveedor del embebido es alguien que le gustaría seguir viendo en su marcado dentro de un año? ¿Preferiría un desarrollador añadir un tipo de bloque propio? Úselo cuando la respuesta a las tres sea no, y mantenga el fragmento lo más pequeño posible.

• Code sirve para mostrar código a quien lee. Nunca ejecuta nada, y es el bloque correcto para cada fragmento de una documentación.
• Syntax Language solo afecta al resaltado. Dejarlo vacío renderiza el ejemplo como texto plano.
• La etiqueta de nombre de archivo es texto libre: publish.sh, composer.json o Terminal valen igual.
• Los ejemplos largos se desplazan en horizontal en vez de partirse, así que recorte el suyo a las líneas que importan.