Viste ad albero in Confluence

Una vista ad albero mostra una gerarchia di cartelle e file come un albero rientrato.

Ultimo aggiornamento

Quando usarlo

Usa una vista ad albero per mostrare la struttura di un repository o di una cartella di deployment in una pagina in stile README. Scrivi i nomi con il rientro e il diagramma disegna le linee dell’albero: è più facile da tenere corretto dei caratteri scritti a mano.

Esempio

Questo è il codice del modello Monorepo layout: l’albero delle cartelle di app, pacchetti e infrastruttura in un monorepo.

treeView-beta
  monorepo/
    apps/
      web/
        src/
        package.json
      api/
        src/
        package.json
    packages/
      ui/
        src/
        package.json
      config/
        tsconfig.base.json
        eslint.config.js
    infra/
      terraform/
        main.tf
        variables.tf
    package.json ## workspace root
    pnpm-workspace.yaml ## lists apps and packages

Vellnar Diagrams lo disegna così:

Cambia una riga e il diagramma cambia con lei. A nessuno serve il file originale del disegno, perché non esiste: il codice è il diagramma.

Aggiungerlo a una pagina di Confluence

  1. Modifica una pagina di Confluence e scrivi /mermaid dove vuoi il diagramma.
  2. Seleziona Mermaid diagram. Si apre l’editor con l’elenco dei modelli.
  3. Scegli un modello, oppure Start blank e incolla il codice qui sopra. L’anteprima segue ogni tasto.
  4. Scegli Save. Il diagramma compare nella pagina.

La documentazione spiega l’editor, le impostazioni e le esportazioni.

Modelli

Il pulsante Templates dell’editor ha un modello pronto per questo tipo:

  • Monorepo layout: L’albero delle cartelle di app, pacchetti e infrastruttura in un monorepo.

Sintassi

Il codice inizia con treeView-beta. La documentazione di Mermaid (in inglese) descrive ogni elemento della sintassi. Vellnar Diagrams lo disegna con Mermaid 12.3; se una riga ha un errore, l’editor segna la riga e tiene a schermo l’ultimo diagramma valido.

Altro

  • Mermaid in Confluence: come funzionano i diagrammi scritti come codice in una pagina, e tutti i tipi di diagramma.
  • Sicurezza: l’app non chiede nessun permesso e non manda nulla fuori da Atlassian.