Progetto:BridgeCards
L'estensione BridgeCards fornisce tre tag parser per rappresentare in modo strutturato mani di bridge, smazzate complete e sequenze di licita. I tag producono output HTML formattato con simboli dei semi e tabelle di asta. L'estensione è indispensabile per garantire dati di qualità nel wiki: ogni mano, smazzata o licita deve essere codificata con questi tag, mai come testo libero.
Tag <hand> — Singola mano
Il tag <hand> mostra una singola mano con i quattro semi, il calcolo automatico degli HCP (A=4, R=3, D=2, F=1) e, opzionalmente, l'etichetta di posizione.
Formato compatto
I quattro semi sono separati da un punto, nell'ordine picche.cuori.quadri.fiori:
<hand>AKQ72.J32.A9.K65</hand>
Le carte vuote si indicano con un trattino o lasciando vuota la posizione:
<hand>AKQJ.-.AKQ.AKQJ</hand>
Formato per riga
Ogni seme su una riga separata con il prefisso del seme (lettera inglese o nome italiano):
<hand> S: AKQ72 H: J32 D: A9 C: K65 </hand>
I prefissi accettati sono:
| Prefisso inglese | Nome italiano | Seme |
|---|---|---|
S |
Picche | ♠ |
H |
Cuori | ♥ |
D |
Quadri | ♦ |
C |
Fiori | ♣ |
Sono accettati anche i nomi italiani completi come prefisso: Picche:, Cuori:, Quadri:, Fiori:.
Parametri opzionali
| Parametro | Valori | Default | Descrizione |
|---|---|---|---|
position |
N, E, S, W | (nessuno) | Mostra l'etichetta di posizione sopra la mano |
hcp |
true, false | true | Mostra o nasconde il conteggio HCP |
Esempi con parametri:
<hand position="N">AKQ72.J32.A9.K65</hand> <hand position="S" hcp="false">98643.Q754.T8.32</hand>
Calcolo HCP
Gli HCP vengono calcolati automaticamente: Asso=4, Re=3, Donna=2, Fante=1. Il totale è mostrato accanto alla posizione (o da solo se la posizione non è specificata).
Carte valide
Le carte sono: A K Q J T 9 8 7 6 5 4 3 2. Il 10 può essere scritto T o 10 (viene convertito automaticamente in T). Le carte duplicate nella stessa mano vengono ignorate. Una mano valida ha al massimo 13 carte in totale.
Esempio completo
Tag <deal> — Smazzata completa
Il tag <deal> mostra una smazzata a quattro mani nel classico diagramma a croce (Nord, Est, Sud, Ovest). Supporta due formati di input e può includere una sequenza di licita.
Formato PBN
Il formato PBN (Portable Bridge Notation) esprime le quattro mani su una sola riga. La lettera iniziale indica la posizione di partenza, seguita da due punti e dalle quattro mani separate da spazi. L'ordine delle mani segue il giro orario a partire dalla posizione indicata.
<deal>N:AKQ72.J32.A9.K65 J54.AKQ8.432.AQ3 T983.9876.KQJ.J9 6.T54.T8765.T874</deal>
Nel formato PBN ogni mano è in formato compatto (picche.cuori.quadri.fiori).
Formato esplicito per posizione
Ogni mano su una riga con il prefisso di posizione:
<deal> N: AKQ72.J32.A9.K65 E: J54.AKQ8.432.AQ3 S: T983.9876.KQJ.J9 W: 6.T54.T8765.T874 </deal>
Le singole mani nel formato esplicito possono usare il formato compatto (punti) o il formato per riga con prefisso seme.
Parametri opzionali
| Parametro | Valori | Default | Descrizione |
|---|---|---|---|
dealer |
N, E, S, W | (nessuno) | Posizione del dichiarante; la mano viene marcata con "D" |
vul |
NONE, NS, EW, ALL | (nessuno) | Vulnerabilità; le mani vulnerabili vengono evidenziate |
board |
numero | (nessuno) | Numero della smazzata, mostrato nell'intestazione |
hcp |
true, false | true | Mostra o nasconde gli HCP per ogni mano |
I valori italiani accettati per la vulnerabilità: NESSUNO (= NONE), EO (= EW), TUTTI (= ALL).
Esempio con parametri:
<deal dealer="N" vul="NS" board="1"> N: AKQ72.J32.A9.K65 E: J54.AKQ8.432.AQ3 S: T983.9876.KQJ.J9 W: 6.T54.T8765.T874 </deal>
Licita integrata nel tag deal
È possibile includere una sequenza di licita direttamente nel tag <deal>, separandola dalle mani con una riga di tre trattini (---):
<deal dealer="N" vul="NS"> N: AKQ72.J32.A9.K65 E: J54.AKQ8.432.AQ3 S: T983.9876.KQJ.J9 W: 6.T54.T8765.T874 --- 1S P 2S P 4S P P P </deal>
La licita viene mostrata in una tabella sotto il diagramma della smazzata.
Esempio completo
Tag <bidding> — Sequenza di licita
Il tag <bidding> mostra una sequenza di asta in una tabella con le quattro colonne N-E-S-W (o dal dichiarante specificato).
Notazione delle dichiarazioni
| Simbolo | Significato |
|---|---|
1C 2C ... 7C |
Dichiarazione a ♣ (Fiori) |
1D 2D ... 7D |
Dichiarazione a ♦ (Quadri) |
1H 2H ... 7H |
Dichiarazione a ♥ (Cuori) |
1S 2S ... 7S |
Dichiarazione a ♠ (Picche) |
1NT o 1SA |
Dichiarazione a Senza Atout |
P o Passo |
Passo |
X o Contro |
Contro |
XX o Surcontro |
Surcontro |
Le dichiarazioni sono separate da spazi, virgole o punti e virgola. I trattini usati come separatori visivi (-) vengono interpretati come Passo; per separare visivamente le dichiarazioni usare uno spazio.
Parametro dealer
| Parametro | Valori | Default | Descrizione |
|---|---|---|---|
dealer |
N, E, S, W | N | Posizione del primo dichiarante; determina l'allineamento nella tabella |
Alert
Si può segnalare un alert in due modi:
- Aggiungendo
!dopo la dichiarazione:2C! - Aggiungendo un testo di alert tra parentesi:
2C(mano forte)— il testo appare come tooltip
Separatori accettati
Il parser divide la sequenza di input usando spazi, virgole e punti e virgola. Si possono scrivere le dichiarazioni su più righe. Il trattino - è un alias per Passo.
Esempio: sequenza semplice
<bidding>1S P 2S P 4S P P P</bidding>
Esempio: sequenza con dealer specificato
<bidding dealer="E">P 1NT P 3NT P P P</bidding>
Esempio: sequenza con alert e SA
<bidding dealer="S"> 1SA 2C!(Stayman) 2H P 4H P P P </bidding>
Esempio: termini italiani
<bidding>1C Passo 1H Passo 1SA Passo 3NT Passo Passo Passo</bidding>
Regole importanti
MAI usare template wiki dentro i tag BridgeCards
I tag <hand>, <deal> e <bidding> sono tag parser: il loro contenuto viene passato direttamente al parser PHP dell'estensione prima che MediaWiki espanda i template. I template wiki come {{cuori}} o {{picche}} non vengono mai espansi all'interno dei tag e causano un errore di parsing.
| SBAGLIATO | CORRETTO |
|---|---|
<bidding>1{{cuori}} - 2{{fiori}}</bidding> |
<bidding>1H 2C</bidding>
|
<hand>{{picche}}: AKQ</hand> |
<hand>S: AKQ</hand>
|
Fuori dai tag BridgeCards (nel testo normale della pagina), si usano invece i template {{picche}}, {{cuori}}, {{quadri}}, {{fiori}} per i simboli colorati dei semi.
Il trattino è Passo
Nel tag <bidding>, il carattere - è un alias per Passo. Non usarlo come separatore estetico tra le dichiarazioni: 1H - 2C viene interpretato come "1H, Passo, 2C". Usare invece gli spazi come separatori.
Carte duplicate e mani incomplete
Il parser accetta mani con meno di 13 carte (utile per esempi parziali). Le carte duplicate nella stessa mano vengono ignorate. Una smazzata completa deve avere 52 carte uniche; il parser rifiuta le smazzate con carte duplicate tra le mani.
Esempi combinati
Mano con commento di licita
La mano di Nord in un esempio di apertura 1♠:
Sequenza di sviluppo:
Smazzata completa con licita
Riferimenti
- Codice sorgente:
extensions/BridgeCards/ - Segnalazione errori e richieste: pagina di discussione di questo progetto
- Per approfondire il formato PBN: PBN Standard (esterno)