🤝 Come Contribuire

Questa wiki rimane utile solo perché i membri dell'alleanza la tengono aggiornata. I tuoi aggiornamenti, nuove guide e screenshot aiutano tutti.

Come è realizzato il sito

La wiki è scritta in semplici file Markdown (lo stesso formato di queste pagine).

Uno strumento chiamato MkDocs (con il tema Material) trasforma questi file Markdown nel bel sito che vedi.

Tutti i file sorgente vivono in questo repository Git.

Quando le modifiche vengono accettate sul branch main, un sistema automatico (Forgejo Actions) costruisce il sito e lo pubblica su ffz.codeberg.page in un minuto o due. Non devi mai caricare manualmente file HTML.

Cos'è Git?

Git è un sistema che registra la storia completa di ogni modifica apportata ai file del progetto. Pensalo come la "cronologia delle versioni" dell'intera wiki (chi ha cambiato cosa, quando e perché).

Non hai bisogno di capire Git in profondità per contribuire.

Per lavori più grandi (soprattutto aggiungere o modificare foto, creare nuove pagine o ristrutturazioni importanti), clonare il repository e lavorare in locale ti dà il pieno controllo e un'esperienza molto migliore.

Il resto di questa guida spiega il percorso "Git completo". Per modifiche testuali semplici, puoi usare direttamente l'editor web su Codeberg (non serve clonare nulla).

Come ottenere materiale (foto, loghi, ecc.) dal repository

Tutte le immagini sono memorizzate nella cartella docs/assets/images/:

Ritratti degli eroi → docs/assets/images/hero/
Loghi e altre grafiche → docs/assets/images/logo/
Diagrammi (come i counter di fazione) → docs/assets/images/

Per visualizzare o scaricare immagini esistenti:

Vai al repository su Codeberg
Naviga in docs → assets → images
Clicca sull'immagine che ti serve
Clicca sul pulsante Raw — ti dà l'immagine diretta. Tasto destro → "Salva immagine con nome..."

Puoi anche clonare l'intero repository sul tuo computer (vedi la sezione "Lavorare con il repository completo") se vuoi tutti i file in locale.

Usare l'interfaccia web

Se hai (o crei) un account Codeberg gratuito, puoi contribuire con modifiche — inclusa l'aggiunta di nuove foto o screenshot — direttamente tramite il sito di Codeberg senza bisogno di clonare il repository o usare comandi Git sul computer. Questo è spesso il percorso più semplice per i contributori occasionali.

Accedi al tuo account Codeberg su https://codeberg.org.
Vai al repository: https://codeberg.org/FFz/pages
Naviga fino al file Markdown che vuoi modificare (o alla cartella in cui vuoi creare un nuovo file).
Clicca sul pulsante Edit (o "Edit file") per quel file. Si apre l'editor online di Codeberg con anteprima live.
Apporta le modifiche al testo nell'editor.
Per aggiungere una nuova foto o screenshot:
Nell'area di commit in basso nell'editor (o quando crei la PR), cerca l'opzione per caricare file o allegare nuovi file.
Carica la tua immagine (verrà posizionata nella posizione corretta rispetto alla modifica).
Scrivi un messaggio di commit chiaro che descriva la tua modifica.
Clicca Commit changes.
Se hai accesso in scrittura (ad es. fai parte del team di sviluppo), la modifica viene committata direttamente.
Altrimenti, Codeberg creerà automaticamente una Pull Request da un fork sul tuo account per la revisione.

Questo flusso web supporta il caricamento diretto di immagini ed è sufficiente per la maggior parte dei contributi (aggiornamenti testuali + nuovi visual).

Unirsi al team di sviluppo (per contributori regolari)

Se prevedi di contribuire frequentemente (aggiungendo molte guide, immagini o aiutando a mantenere la wiki), è molto più comodo diventare membro del team di sviluppo:

Crea un account gratuito su https://codeberg.org (se non ne hai uno).
Contatta un R5 (o R4) nell'alleanza — tramite mail in-game, chat dell'alleanza o Discord — e chiedi di essere aggiunto al team di sviluppo FFz su Codeberg.
Una volta approvato e aggiunto all'organizzazione:

Permessi che otterrai: - Accesso in scrittura diretta al repository (le modifiche possono essere committate senza passare per Pull Request). - Puoi modificare i file tramite l'interfaccia web e farli applicare direttamente (o push da clone locale senza fork). - Flusso di lavoro più veloce per lavori frequenti. - Se ti vengono dati diritti di maintainer, potrai anche revisionare e unire le Pull Request altrui.

Questo livello di accesso è riservato ai membri fidati e attivi dell'alleanza che aiutano regolarmente con la wiki. Non è richiesto per contributi occasionali — puoi sempre usare l'interfaccia web o il percorso Pull Request descritto sopra.

Lavorare con il repository completo (modo Git)

Per modifiche più complesse o quando preferisci lavorare in locale con i tuoi strumenti e anteprima:

Crea un account gratuito su https://codeberg.org (se non ne hai uno) e chiedi a un R5 di aggiungerti al team di sviluppo (vedi la sezione "Unirsi al team di sviluppo" per dettagli sui permessi).

Clona il repo:

git clone https://codeberg.org/FFz/pages.git
cd pages

Crea un nuovo branch per le tue modifiche:
```
git checkout -b my-new-guide
```
Modifica i file Markdown. Se aggiungi nuove immagini, posiziona i file nella sottocartella appropriata sotto docs/assets/images/ (vedi la sezione "Come ottenere materiale" sopra per la struttura delle cartelle, ad es. hero/ per i ritratti). Riferiscile in Markdown usando percorsi relativi (guarda file esistenti come la Galleria degli Eroi per esempi della sintassi relativa corretta).
Anteprima locale (fortemente consigliata):
```
pip install -r requirements.txt
mkdocs serve
```
Poi apri http://127.0.0.1:8000 nel tuo browser. Le modifiche appaiono in tempo reale.

Quando sei soddisfatto, commit e push:

git add .
git commit -m "Aggiunta nuova guida su X e foto eroe"
git push origin my-new-guide

Su Codeberg, apri una Pull Request dal tuo branch a main.

Un maintainer la revisionerà, suggerirà eventualmente piccole modifiche e la unirà. Il sito si aggiornerà automaticamente.

Linee guida

L'inglese (en/) è la lingua principale. Aggiornalo prima, poi possiamo tradurre nelle altre lingue.
Mantieni il tono amichevole e pratico delle pagine esistenti.
Aggiungi "Ultimo aggiornamento" in fondo alle nuove guide quando rilevante.
Per grandi cambiamenti strutturali, discuti prima con un R4 o R5.
Rispetta le emoji esistenti e lo stile di formattazione.

Non sei ancora sicuro?

Invia semplicemente il testo, la foto o l'idea tramite mail in-game o chat dell'alleanza a un officer. Gestiremo noi la parte tecnica se necessario.

Grazie — ogni piccolo miglioramento aiuta tutta l'alleanza a giocare meglio insieme.

Uniti sotto la Spada. ⚔️