Parish Archive

Diagrammi

Diagrammi di flusso, sequenze, linee del tempo, mappe mentali, Kroki, PlantUML e draw.io

I diagrammi si scrivono come testo e il wiki li disegna. Cambia il testo e il disegno lo segue. La maggior parte dei diagrammi qui usa Mermaid: vedi mermaid.js.org per ogni tipo.

Diagramma di flusso

Per una decisione o una procedura. --> disegna una freccia, {...} una domanda, |Sì| un'etichetta sulla freccia.

flowchart TD
  A[Inizio dell'incontro] --> B{Piove?}
  B -->|Sì| C[Giochi nel salone]
  B -->|No| D[Giochi in cortile]
  C --> E[Preghiera finale]
  D --> E
::block-diagram{caption="Piove?" align="center"}
```mermaid
flowchart TD
  A[Inizio dell'incontro] --> B{Piove?}
  B -->|Sì| C[Giochi nel salone]
  B -->|No| D[Giochi in cortile]
  C --> E[Preghiera finale]
  D --> E
```
::
[block-diagram, caption="Piove?", align="center"]
====
[source,mermaid]
----
flowchart TD
  A[Inizio dell'incontro] --> B{Piove?}
  B -->|Sì| C[Giochi nel salone]
  B -->|No| D[Giochi in cortile]
  C --> E[Preghiera finale]
  D --> E
----
====
<block-diagram caption="Piove?" align="center">
<pre><code class="language-mermaid">flowchart TD
  A[Inizio dell'incontro] --> B{Piove?}
  B -->|Sì| C[Giochi nel salone]
  B -->|No| D[Giochi in cortile]
  C --> E[Preghiera finale]
  D --> E</code></pre>
</block-diagram>

Linea del tempo di un progetto

Un diagramma di Gantt mostra gli incontri di un progetto nel corso delle settimane.

gantt
  dateFormat YYYY-MM-DD
  title Cammino di Quaresima
  section Preparazione
  Programmare gli incontri :done, 2026-02-02, 7d
  Preparare il materiale   :2026-02-09, 7d
  section Incontri
  Incontri da 1 a 5        :2026-02-21, 35d
  Festa di Pasqua          :milestone, 2026-04-05, 0d
::block-diagram{caption="Cammino di Quaresima"}
```mermaid
gantt
  dateFormat YYYY-MM-DD
  title Cammino di Quaresima
  section Preparazione
  Programmare gli incontri :done, 2026-02-02, 7d
  Preparare il materiale   :2026-02-09, 7d
  section Incontri
  Incontri da 1 a 5        :2026-02-21, 35d
  Festa di Pasqua          :milestone, 2026-04-05, 0d
```
::
[block-diagram, caption="Cammino di Quaresima"]
====
[source,mermaid]
----
gantt
  dateFormat YYYY-MM-DD
  title Cammino di Quaresima
  section Preparazione
  Programmare gli incontri :done, 2026-02-02, 7d
  Preparare il materiale   :2026-02-09, 7d
  section Incontri
  Incontri da 1 a 5        :2026-02-21, 35d
  Festa di Pasqua          :milestone, 2026-04-05, 0d
----
====

Mappa mentale

Per raccogliere idee attorno a un tema.

mindmap
  root((Campo estivo))
    Giochi
      Caccia al tesoro
      Giochi d'acqua
    Preghiera
      Preghiera del mattino
      Messa la domenica
    Gite
      Camminata in montagna
::block-diagram{align="center"}
```mermaid
mindmap
  root((Campo estivo))
    Giochi
      Caccia al tesoro
      Giochi d'acqua
    Preghiera
      Preghiera del mattino
      Messa la domenica
    Gite
      Camminata in montagna
```
::
[block-diagram, align="center"]
====
[source,mermaid]
----
mindmap
  root((Campo estivo))
    Giochi
      Caccia al tesoro
      Giochi d'acqua
    Preghiera
      Preghiera del mattino
      Messa la domenica
    Gite
      Camminata in montagna
----
====

Sequenza

Chi fa cosa, in ordine.

sequenceDiagram
  participant G as Genitore
  participant S as Segreteria
  participant C as Catechista
  G->>S: Consegna il modulo firmato
  S->>C: Conferma l'iscrizione
  C-->>G: Manda il calendario
::block-diagram
```mermaid
sequenceDiagram
  participant G as Genitore
  participant S as Segreteria
  participant C as Catechista
  G->>S: Consegna il modulo firmato
  S->>C: Conferma l'iscrizione
  C-->>G: Manda il calendario
```
::
[block-diagram]
====
[source,mermaid]
----
sequenceDiagram
  participant G as Genitore
  participant S as Segreteria
  participant C as Catechista
  G->>S: Consegna il modulo firmato
  S->>C: Conferma l'iscrizione
  C-->>G: Manda il calendario
----
====

Kroki e PlantUML

Questi due disegnano il diagramma su un server esterno (kroki.io e plantuml.com), quindi il testo del diagramma viene mandato lì. Non metterci mai nomi di bambini.

Kroki disegna Graphviz, D2, BPMN e una ventina di altri linguaggi: scegli il linguaggio con type.

digraph G {
  rankdir=LR
  Oratorio -> Piccoli
  Oratorio -> Medi
  Oratorio -> Adolescenti
}
::block-kroki{type="graphviz" caption="I gruppi dell'oratorio"}
```kroki
digraph G {
  rankdir=LR
  Oratorio -> Piccoli
  Oratorio -> Medi
  Oratorio -> Adolescenti
}
```
::
[block-kroki, type="graphviz", caption="I gruppi dell'oratorio"]
====
[source,kroki]
----
digraph G {
  rankdir=LR
  Oratorio -> Piccoli
  Oratorio -> Medi
  Oratorio -> Adolescenti
}
----
====

PlantUML disegna sequenze, attività, mappe mentali e altro.

@startuml
Genitore -> Segreteria : modulo firmato
Segreteria --> Genitore : ricevuta
@enduml
::block-plantuml{caption="Iscrizione"}
```plantuml
@startuml
Genitore -> Segreteria : modulo firmato
Segreteria --> Genitore : ricevuta
@enduml
```
::
[block-plantuml, caption="Iscrizione"]
====
[source,plantuml]
----
@startuml
Genitore -> Segreteria : modulo firmato
Segreteria --> Genitore : ricevuta
@enduml
----
====

draw.io

Un diagramma disegnato a mano su una tela, per esempio la pianta del salone parrocchiale. Inseriscilo con il pulsante blocchi dell'editor e scegli Draw.io: l'editor apre lo strumento di disegno e conserva il disegno dentro la pagina. Usa il sito diagrams.net, a meno che l'amministratore non configuri un server proprio.