Template:Corso/Blocco: differenze tra le versioni
Altre azioni
m Mattia.sala ha spostato la pagina Template:Corso/Microbit/Blocco a Template:Corso/Blocco: generalizzazione nome, il gadget course tratta gia queste strutture come generiche |
aggiunta documentazione |
||
| Riga 1: | Riga 1: | ||
<span class="blk blk-{{{1}}}">{{{2}}}</span> | <noinclude> | ||
== Template:Corso/Blocco == | |||
Rappresenta un blocco "normale" (istruzione) di un editor a blocchi (MakeCode, Scratch...) dentro il testo di una lezione. Il gadget "course" (<code>MediaWiki:Gadget-course.js</code>) trasforma lo <code><nowiki><span></nowiki></code> generato in un vero SVG a forma di blocco (con la tacca di incastro), colorato in base alla categoria — non è solo testo colorato, è un disegno vettoriale generato al volo misurando il testo. | |||
Varianti sorelle, stessa sintassi, forma diversa: | |||
* '''[[Template:Corso/Blocco|Corso/Blocco]]''' — blocco normale (istruzione), forma rettangolare con tacca | |||
* '''[[Template:Corso/BloccoHat|Corso/BloccoHat]]''' — blocco "a cappello" (evento, es. <code>all'avvio</code>), forma arrotondata sopra | |||
* '''[[Template:Corso/BloccoBool|Corso/BloccoBool]]''' — blocco booleano (sì/no), forma a esagono | |||
* '''[[Template:Corso/BloccoVal|Corso/BloccoVal]]''' — blocco valore (lettura sensore/variabile), forma ovale | |||
'''Parametri (uguali per tutte e 4 le varianti):''' | |||
* <code>1</code> — categoria del blocco (determina il colore). Le categorie definite in <code>PALETTES.microbit</code> dentro <code>MediaWiki:Gadget-course.js</code> sono: <code>basic</code>, <code>input</code>, <code>music</code>, <code>led</code>, <code>radio</code>, <code>loops</code>, <code>logic</code>, <code>variables</code>, <code>math</code>, <code>game</code>, <code>pin</code>, <code>images</code>, <code>text</code>, <code>serial</code>, <code>control</code>, <code>functions</code>, <code>arrays</code>, <code>bluetooth</code>. | |||
'''🐛 Bug noto:''' [[Microbit/Riferimento/Blocchi]] usa le categorie <code>var</code> e <code>loop</code> (singolare), ma il gadget le chiama <code>variables</code> e <code>loops</code> — quei blocchi non trovano corrispondenza in <code>PALETTES</code> e finiscono col colore di default (<code>basic</code>) invece del loro colore corretto. Da correggere o nei contenuti (usare i nomi giusti) o nel gadget (aggiungere alias) — non ancora fatto, segnalalo se vuoi che lo sistemi. | |||
* <code>2</code> — testo del blocco, esattamente come appare nell'editor (in italiano) | |||
'''⚠️ Per un secondo corso (es. Scratch):''' il JS sceglie la palette guardando prima la categoria (<code>blk-<categoria></code>) dentro l'oggetto <code>PALETTES</code>; se in futuro le categorie di un nuovo corso hanno nomi diversi da quelle di MakeCode, va aggiunta una nuova voce a <code>PALETTES</code> nel gadget (es. <code>PALETTES.scratch = {...}</code>) — '''questa è una modifica al gadget, non al template''': va fatta da chi ha accesso in scrittura ai Gadget. | |||
'''Esempio:''' | |||
<pre> | |||
{{Corso/Blocco|1=basic|2=mostra stringa}} | |||
</pre> | |||
</noinclude><includeonly><span class="blk blk-{{{1}}}">{{{2}}}</span></includeonly> | |||
Versione delle 19:24, 3 ago 2026
Template:Corso/Blocco
Rappresenta un blocco "normale" (istruzione) di un editor a blocchi (MakeCode, Scratch...) dentro il testo di una lezione. Il gadget "course" (MediaWiki:Gadget-course.js) trasforma lo <span> generato in un vero SVG a forma di blocco (con la tacca di incastro), colorato in base alla categoria — non è solo testo colorato, è un disegno vettoriale generato al volo misurando il testo.
Varianti sorelle, stessa sintassi, forma diversa:
- Corso/Blocco — blocco normale (istruzione), forma rettangolare con tacca
- Corso/BloccoHat — blocco "a cappello" (evento, es.
all'avvio), forma arrotondata sopra - Corso/BloccoBool — blocco booleano (sì/no), forma a esagono
- Corso/BloccoVal — blocco valore (lettura sensore/variabile), forma ovale
Parametri (uguali per tutte e 4 le varianti):
1— categoria del blocco (determina il colore). Le categorie definite inPALETTES.microbitdentroMediaWiki:Gadget-course.jssono:basic,input,music,led,radio,loops,logic,variables,math,game,pin,images,text,serial,control,functions,arrays,bluetooth.
🐛 Bug noto: Microbit/Riferimento/Blocchi usa le categorie var e loop (singolare), ma il gadget le chiama variables e loops — quei blocchi non trovano corrispondenza in PALETTES e finiscono col colore di default (basic) invece del loro colore corretto. Da correggere o nei contenuti (usare i nomi giusti) o nel gadget (aggiungere alias) — non ancora fatto, segnalalo se vuoi che lo sistemi.
2— testo del blocco, esattamente come appare nell'editor (in italiano)
⚠️ Per un secondo corso (es. Scratch): il JS sceglie la palette guardando prima la categoria (blk-<categoria>) dentro l'oggetto PALETTES; se in futuro le categorie di un nuovo corso hanno nomi diversi da quelle di MakeCode, va aggiunta una nuova voce a PALETTES nel gadget (es. PALETTES.scratch = {...}) — questa è una modifica al gadget, non al template: va fatta da chi ha accesso in scrittura ai Gadget.
Esempio:
{{Corso/Blocco|1=basic|2=mostra stringa}}