Lpala: Creazione manuale dell'estensione BridgeCards per gli editor del wiki

2026-03-12T11:24:30Z

Creazione manuale dell'estensione BridgeCards per gli editor del wiki

Nuova pagina

{{Articolo}}
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 <code><hand></code> — Singola mano ==

Il tag <code><hand></code> 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''':

<pre>
<hand>AKQ72.J32.A9.K65</hand>
</pre>

Le carte vuote si indicano con un trattino o lasciando vuota la posizione:

<pre>
<hand>AKQJ.-.AKQ.AKQJ</hand>
</pre>

=== Formato per riga ===

Ogni seme su una riga separata con il prefisso del seme (lettera inglese o nome italiano):

<pre>
<hand>
S: AKQ72
H: J32
D: A9
C: K65
</hand>
</pre>

I prefissi accettati sono:

{| class="wikitable"
! Prefisso inglese !! Nome italiano !! Seme
|-
| <code>S</code> || Picche || {{picche}}
|-
| <code>H</code> || Cuori || {{cuori}}
|-
| <code>D</code> || Quadri || {{quadri}}
|-
| <code>C</code> || Fiori || {{fiori}}
|}

Sono accettati anche i nomi italiani completi come prefisso: <code>Picche:</code>, <code>Cuori:</code>, <code>Quadri:</code>, <code>Fiori:</code>.

=== Parametri opzionali ===

{| class="wikitable"
! Parametro !! Valori !! Default !! Descrizione
|-
| <code>position</code> || N, E, S, W || (nessuno) || Mostra l'etichetta di posizione sopra la mano
|-
| <code>hcp</code> || true, false || true || Mostra o nasconde il conteggio HCP
|}

Esempi con parametri:

<pre>
<hand position="N">AKQ72.J32.A9.K65</hand>

<hand position="S" hcp="false">98643.Q754.T8.32</hand>
</pre>

=== 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: <code>A K Q J T 9 8 7 6 5 4 3 2</code>. Il 10 può essere scritto <code>T</code> o <code>10</code> (viene convertito automaticamente in <code>T</code>). Le carte duplicate nella stessa mano vengono ignorate. Una mano valida ha al massimo 13 carte in totale.

=== Esempio completo ===

<hand position="N">AKQ72.J32.A9.K65</hand>

== Tag <code><deal></code> — Smazzata completa ==

Il tag <code><deal></code> 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.

<pre>
<deal>N:AKQ72.J32.A9.K65 J54.AKQ8.432.AQ3 T983.9876.KQJ.J9 6.T54.T8765.T874</deal>
</pre>

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:

<pre>
<deal>
N: AKQ72.J32.A9.K65
E: J54.AKQ8.432.AQ3
S: T983.9876.KQJ.J9
W: 6.T54.T8765.T874
</deal>
</pre>

Le singole mani nel formato esplicito possono usare il formato compatto (punti) o il formato per riga con prefisso seme.

=== Parametri opzionali ===

{| class="wikitable"
! Parametro !! Valori !! Default !! Descrizione
|-
| <code>dealer</code> || N, E, S, W || (nessuno) || Posizione del dichiarante; la mano viene marcata con "D"
|-
| <code>vul</code> || NONE, NS, EW, ALL || (nessuno) || Vulnerabilità; le mani vulnerabili vengono evidenziate
|-
| <code>board</code> || numero || (nessuno) || Numero della smazzata, mostrato nell'intestazione
|-
| <code>hcp</code> || true, false || true || Mostra o nasconde gli HCP per ogni mano
|}

I valori italiani accettati per la vulnerabilità: <code>NESSUNO</code> (= NONE), <code>EO</code> (= EW), <code>TUTTI</code> (= ALL).

Esempio con parametri:

<pre>
<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>
</pre>

=== Licita integrata nel tag deal ===

È possibile includere una sequenza di licita direttamente nel tag <code><deal></code>, separandola dalle mani con una riga di tre trattini (<code>---</code>):

<pre>
<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>
</pre>

La licita viene mostrata in una tabella sotto il diagramma della smazzata.

=== Esempio completo ===

<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
---
1S P 2S P
4S P P P
</deal>

== Tag <code><bidding></code> — Sequenza di licita ==

Il tag <code><bidding></code> mostra una sequenza di asta in una tabella con le quattro colonne N-E-S-W (o dal dichiarante specificato).

=== Notazione delle dichiarazioni ===

{| class="wikitable"
! Simbolo !! Significato
|-
| <code>1C 2C ... 7C</code> || Dichiarazione a {{fiori}} (Fiori)
|-
| <code>1D 2D ... 7D</code> || Dichiarazione a {{quadri}} (Quadri)
|-
| <code>1H 2H ... 7H</code> || Dichiarazione a {{cuori}} (Cuori)
|-
| <code>1S 2S ... 7S</code> || Dichiarazione a {{picche}} (Picche)
|-
| <code>1NT</code> o <code>1SA</code> || Dichiarazione a Senza Atout
|-
| <code>P</code> o <code>Passo</code> || Passo
|-
| <code>X</code> o <code>Contro</code> || Contro
|-
| <code>XX</code> o <code>Surcontro</code> || Surcontro
|}

Le dichiarazioni sono separate da spazi, virgole o punti e virgola. I trattini usati come separatori visivi (<code>-</code>) vengono interpretati come Passo; per separare visivamente le dichiarazioni usare uno spazio.

=== Parametro dealer ===

{| class="wikitable"
! Parametro !! Valori !! Default !! Descrizione
|-
| <code>dealer</code> || N, E, S, W || N || Posizione del primo dichiarante; determina l'allineamento nella tabella
|}

=== Alert ===

Si può segnalare un alert in due modi:

* Aggiungendo <code>!</code> dopo la dichiarazione: <code>2C!</code>
* Aggiungendo un testo di alert tra parentesi: <code>2C(mano forte)</code> — 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 <code>-</code> è un alias per Passo.

=== Esempio: sequenza semplice ===

<pre>
<bidding>1S P 2S P 4S P P P</bidding>
</pre>

<bidding>1S P 2S P 4S P P P</bidding>

=== Esempio: sequenza con dealer specificato ===

<pre>
<bidding dealer="E">P 1NT P 3NT P P P</bidding>
</pre>

<bidding dealer="E">P 1NT P 3NT P P P</bidding>

=== Esempio: sequenza con alert e SA ===

<pre>
<bidding dealer="S">
1SA 2C!(Stayman) 2H P
4H P P P
</bidding>
</pre>

<bidding dealer="S">
1SA 2C!(Stayman) 2H P
4H P P P
</bidding>

=== Esempio: termini italiani ===

<pre>
<bidding>1C Passo 1H Passo 1SA Passo 3NT Passo Passo Passo</bidding>
</pre>

<bidding>1C Passo 1H Passo 1SA Passo 3NT Passo Passo Passo</bidding>

== Regole importanti ==

=== MAI usare template wiki dentro i tag BridgeCards ===

I tag <code><hand></code>, <code><deal></code> e <code><bidding></code> sono tag parser: il loro contenuto viene passato direttamente al parser PHP dell'estensione '''prima''' che MediaWiki espanda i template. I template wiki come <code><nowiki>{{cuori}}</nowiki></code> o <code><nowiki>{{picche}}</nowiki></code> non vengono mai espansi all'interno dei tag e causano un errore di parsing.

{| class="wikitable"
! style="color:red" | SBAGLIATO !! style="color:green" | CORRETTO
|-
| <code><nowiki><bidding>1{{cuori}} - 2{{fiori}}</bidding></nowiki></code> || <code><nowiki><bidding>1H 2C</bidding></nowiki></code>
|-
| <code><nowiki><hand>{{picche}}: AKQ</hand></nowiki></code> || <code><nowiki><hand>S: AKQ</hand></nowiki></code>
|}

Fuori dai tag BridgeCards (nel testo normale della pagina), si usano invece i template <code><nowiki>{{picche}}</nowiki></code>, <code><nowiki>{{cuori}}</nowiki></code>, <code><nowiki>{{quadri}}</nowiki></code>, <code><nowiki>{{fiori}}</nowiki></code> per i simboli colorati dei semi.

=== Il trattino è Passo ===

Nel tag <code><bidding></code>, il carattere <code>-</code> è un alias per Passo. Non usarlo come separatore estetico tra le dichiarazioni: <code>1H - 2C</code> 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{{picche}}:

<hand position="N">AKQ72.J32.A9.K65</hand>

Sequenza di sviluppo:

<bidding dealer="N">1S P 2S P 4S P P P</bidding>

=== Smazzata completa con licita ===

<deal dealer="S" vul="EW" board="7">
N: KJ8.AQ9.KQ54.Q73
E: 752.KJT8.J97.T64
S: AQT94.7532.A.AK5
W: 63.64.T8632.J982
---
P P 1S P
2H P 3H P
4H P P P
</deal>

== Riferimenti ==

* Codice sorgente: <code>extensions/BridgeCards/</code>
* Segnalazione errori e richieste: pagina di discussione di questo progetto
* Per approfondire il formato PBN: [https://www.tistis.nl/pbn/ PBN Standard (esterno)]

[[Categoria:Progetto BridgePedia]]

Progetto:BridgeCards - Cronologia

Lpala: Creazione manuale dell'estensione BridgeCards per gli editor del wiki