Layout del documento

Layout del documento

Il layout del documento è un modello a due colonne per le pagine di documentazione — descrizione a sinistra, codice a destra — che si riduce a una sola colonna su mobile.

Struttura

Usa .doc come wrapper esterno e .doc-section per ogni riga. Ogni sezione ha una colonna .doc-section--description e una colonna .doc-section--code.

Sezione base

Una sezione tipica abbina un blocco di descrizione a un frammento di codice.

Contenuto demo
<div class="doc">
  <div class="doc-section">
    <div class="doc-section--description">
      <h3>Title</h3>
      <p>Description</p>
    </div>
    <div class="doc-section--code">
      <!-- code snippet -->
    </div>
  </div>
</div>

Con un blocco di codice

Usa il parziale code-block all'interno di .doc-section--code per esempi con evidenziazione della sintassi.

Contenuto demo
{{ include('@Bundle/partials/code-block.html.twig', {
  lang: 'bash',
  code: 'curl https://api.example.com/resource'
}) }}