Formato dei problemi

Ogni problema è rappresentato da un file Markdown:

Quanto fa 2 + 2?

- [ ] 2
- [ ] 3
- [x] 4
- [ ] 5

> La soluzione è 4.

Il file è composto da quattro parti:

• l'intestazione: viene generata automaticamente con il numero del problema, ad esempio Domanda 1, Domanda 2, ecc.;
• il testo: la descrizione di cosa chiede il problema;
• le risposte: la parte in cui l'utente sceglie la risposta corretta;
• la soluzione: la spiegazione di come si risolve il problema, mostrata dopo che la prova è finita.

TIP

Le risposte e la soluzione possono essere definite in qualsiasi parte del testo, ma è consigliato metterle alla fine del problema.

È anche possibile definire i problemi usando MDX (Markdown con l'aggiunta di JavaScript) che permette di definire, attraverso JavaScript, parti interattive del problema, ad esempio l'editor di codice a blocchi.

Testo del problema

Il testo è la parte principale del problema. Si può formattare in Markdown, la maggior parte delle funzionalità di Markdown sono supportate e alcune estensioni, tra cui:

• codice con syntax highlighting (anche per pseudocodice);
• immagini;
• tabelle;
• formule matematiche di LaTeX ($...$).

ATTENZIONE

Le seguenti funzionalità non sono supportate:

• citazioni (blockquotes): questa sintassi è usata per indicare la soluzione;
• separatore orizzontale (---): questa sintassi è usata per separare i sottoproblemi;
• TODO list: questa sintassi è usata per definire le risposte.

Risposte

Le risposte possono essere di tre tipi:

• risposta chiusa, definite tramite una TODO list in cui la risposta corretta è contrassegnata con una x:

  - [ ] risposta 1
  - [x] risposta 2
  - [ ] risposta 3
  - [ ] risposta 4

  TIP

  È possibile indicare più risposte corrette, ad esempio nel caso di refusi nei testi, tuttavia l'utente può selezionare solo una risposta.

• risposta aperta, definite con la sintassi ?>:

  ?> risposta

  WARNING

  Una risposta aperta può essere lunga al massimo 100 caratteri.

• codice a blocchi: l'utente può usare un editor integrato per implementare una soluzione usando la programmazione a blocchi.

Soluzione

La soluzione è definita da una citazione e può essere formattata a sua volta con Markdown:

> la
> **soluzione**
> al
> _problema_

Durante la gara la soluzione non è visibile all'utente. È possibile vedere la soluzione solo dopo aver finito la prova in modalità training.

Sottoproblemi

È possibile specificare più sottoproblemi nello stesso file separandoli attraverso tre trattini ---:

Sottoproblema 1 ...

- [x] Sì
- [ ] No

---

Sottoproblema 2 ...

- [ ] Sì
- [x] No

Ogni sottoproblema ha il suo testo, le sue risposte, la sua soluzione e un'intestazione generata automaticamente con il numero del problema e del sottoproblema, ad esempio Domanda 1.1, Domanda 1.2, ecc.