Blocchi Code e HTML

Obiettivo: presentare un esempio di codice e capire l'unico blocco che può rompere una pagina.
Tempo: 3 minuti
Serve: una pagina e qualcosa da mostrare

1. Selezionate Add Block, poi Code.
2. Compilate Title e usate Filename / Language Label per la piccola etichetta sopra l'esempio: un nome di file si legge meglio del nome di un linguaggio.
3. Incollate l'esempio in Code e impostate Syntax Language.
4. Selezionate Save New Block.
5. Per markup che nessun blocco può esprimere, selezionate Add Block e scegliete HTML (Trusted).
6. Incollate il markup in Trusted HTML e selezionate Save New Block.

Il blocco si chiama HTML (Trusted) perché a quel punto il CMS smette di controllare. Quello che incollate è quello che viene renderizzato.

Significa che un tag non chiuso può rompere l'impaginazione dell'intera pagina, che un codice di tracciamento incollato gira a ogni visita e che un embed da un sito che non controllate può cambiare in seguito ciò che vi serve. Nulla di tutto questo si adatta quando cambia il design del sito.

Prima di ricorrervi verificate: esiste un blocco vero per questo (video, audio, download, galleria, tabella e modulo di contatto ci sono tutti)? Il fornitore dell'embed è uno che vi farebbe piacere ritrovare nel vostro markup fra un anno? Uno sviluppatore preferirebbe aggiungere un tipo di blocco vero e proprio? Usatelo quando la risposta a tutte e tre è no, e tenete lo snippet il più piccolo possibile.

• Code serve a mostrare del codice a chi legge. Non esegue mai nulla ed è il blocco giusto per ogni frammento in una documentazione.
• Syntax Language influisce solo sull'evidenziazione. Lasciandolo vuoto l'esempio viene reso come testo semplice.
• L'etichetta del nome file è testo libero: publish.sh, composer.json o Terminal vanno bene tutti.
• Gli esempi lunghi scorrono in orizzontale invece di andare a capo: tagliate il vostro alle righe che contano.