Aggiungi un club o un evento

Board Game Clubs è gestito dalla community e ospitato su GitHub. Chiunque può aggiungere un club o un evento, o aggiornare una voce esistente.

Invia tramite il nostro modulo

Il modo più semplice per aggiungere il tuo club è il modulo su GitHub. Non servono competenze tecniche, basta compilare i dettagli, al resto pensiamo noi.

+ Aggiungi un club Modifica un club Aggiungi un evento

Preferisci una pull request?

Se hai dimestichezza con GitHub, puoi aggiungere un club direttamente. Espandi la sezione per la guida passo passo.

Aggiungere un club

1. Crea un nuovo file

Crea un nuovo file nella cartella _clubs/<paese>/ su GitHub, dove <paese> è il codice ISO 3166-1 alpha-2 in minuscolo (corrispondente a una delle cartelle esistenti in _clubs/). Nomina il file con lo schema nome-del-tuo-club.md (minuscolo, trattini al posto degli spazi). Per nomi con caratteri speciali usa l’equivalente ASCII: à→a, è→e, ò→o, ù→u ecc. (per es. circolo-gioco-milano.md).

2. Copia il modello

Incolla quanto segue nel tuo nuovo file e compila i dettagli. Imposta country in modo coerente con la cartella.

---
country: "IT"          # ISO 3166-1 alpha-2, maiuscolo, corrispondente alla cartella
name: "Nome del tuo club"
type: ["Board Games"]
days: ["Thursday"]
time: "19:00 - 22:00"
frequency: "Weekly"
location:
  name: "Sede"
  address: "Indirizzo completo, CAP, città"
  lat: 41.9000
  lng: 12.5000
cost: "Free"
age_restriction: ""
image: ""
website: ""
meetup: ""
facebook: ""
discord: ""
bgg: ""
description: >-
  Una breve descrizione del tuo club. Che giochi giocate?
  I nuovi arrivati sono i benvenuti? Altre informazioni utili.
---

Non impostare permalink. La pagina del club viene generata automaticamente in /clubs/<nome-file>/, con una copia sotto ogni prefisso di lingua (/it/clubs/..., /de/clubs/... ecc.).

3. Compila i campi

Campo	Descrizione
`country`	Codice ISO 3166-1 alpha-2, maiuscolo, corrispondente alla cartella
`name`	Nome completo del club
`type`	Array dei tipi, es. `["Board Games"]`. Opzioni: “Board Games”, “RPG”, “Wargames”, “TCG”, “BOTC”
`days`	Giorni di incontro (in inglese), es. `["Thursday"]` o `["Monday", "Friday"]`
`time`	Orario dell’incontro, es. “19:00 - 22:00”
`frequency`	“Weekly”, “Fortnightly”, “Monthly” o “Ad-hoc”
`location`	Sede, indirizzo completo con CAP, coordinate
`cost`	“Free” oppure un importo nella valuta locale, es. “€3”, “£2”, “CHF 5”, “kr 20”, “zł 10”, “€5 (primo incontro gratis)”
`age_restriction`	Limite di età, es. “18+”. Lascia vuoto se non c’è
`image`	URL o nome file in `assets/images/clubs/`
`website`	Link al sito del club
`meetup`	Link al gruppo Meetup
`facebook`	Link alla pagina o al gruppo Facebook
`discord`	Link di invito Discord
`bgg`	Link alla gilda o al gruppo BoardGameGeek
`description`	Testo libero. È supportato il Markdown semplice: righe vuote separano i paragrafi, righe che iniziano con `-` diventano elenchi. Vedi gli esempi sotto.

Formattare la descrizione

Il campo description viene reso come Markdown, quindi puoi usare paragrafi ed elenchi. Fai attenzione a mantenere l’indentazione di due spazi del block scalar YAML, altrimenti Jekyll si lamenta.

description: |
  Siamo un gruppo aperto e ci troviamo in centro a Milano.
  I nuovi arrivati sono i benvenuti, spieghiamo le regole.

  Una serata tipica:

  - Un eurogame medio per iniziare
  - Più tardi giochi di carte o party game leggeri
  - Pause e tempo per chiacchierare

La notazione >- del modello unisce le righe in un unico paragrafo, va bene per una breve descrizione. Passa a | (come sopra) se vuoi mantenere paragrafi ed elenchi.

4. Trovare le coordinate

Ecco come trovare latitudine e longitudine della tua sede:

Apri OpenStreetMap
Cerca l’indirizzo
Tasto destro sulla mappa → “Mostra indirizzo”
Le coordinate appaiono nell’URL (lat e lng)

5. Aggiungere un logo

Puoi aggiungere un logo o un’immagine per il tuo club:

Carica l’immagine in assets/images/clubs/ nel repository (PNG o JPG, idealmente quadrata e sotto i 200 KB)
Nel file del club, imposta il campo image sul nome del file, es. image: "logo-del-tuo-club.png"

In alternativa puoi usare un URL diretto a un’immagine ospitata altrove, es. image: "https://example.com/logo.png".

6. Apri una pull request

Esegui il commit del tuo file e apri una pull request. La esamineremo e la integreremo.

Il tuo paese non è nell’elenco?

Il menu dei paesi nell’intestazione del sito mostra tutti i paesi che copriamo al momento. Se il tuo club è altrove, apri un issue. Aggiungere un nuovo paese è una modifica piccola e siamo felici di farla.

Aggiornare una voce esistente

Trova il file del club nella cartella _clubs/ su GitHub, fai le tue modifiche e apri una pull request. Oppure apri direttamente una richiesta di modifica e lo aggiorneremo noi. Per gli eventi, apri una richiesta di modifica o modifica il file in _events/.

Le voci sono pubblicate sotto CC BY 4.0.