Table of Contents
Per fare in modo che i tuoi contributi vengano aggiunti al progetto principale (detto anche upstream) e diventino visibili sul sito, devi inviare una Pull Request, in sigla PR.
Inviare un Pull Request (PR) dal proprio branch
Appena aggiunte modifiche al tuo fork, solitamente dentro un nuovo ramo, in Gitea comparirà un avviso e un pulsante utili per inviare la richiesta di Pull Request verso l'upstream.
Premi il pulsante Nuova Pull Request
.
Nella schermata successiva, due menù a tendina ti permettono di scegliere verso quale ramo seguire il branch e quale ramo usare come fonte. Di norma a sinistra si trova il ramo main del repository del sito ed, a destra, il ramo appena creato da te per il contributo. Nella parte in basso puoi controllare tutti i tuoi nuovi contributi ed, eventualmente, confrontare le versioni dei file a cui hai apportato modifiche.
Per confermare e procedere clicca il pulsante Nuova Pull Request
.
Compila la PR con un titolo (1), eventualmente usanto il prefisso WIP se trattasi di un work in progress, ed un commento (2). Opzionalmente consenti le modifiche (3) e/o aggiungi la PR ad un progetto (4).
Conferma cliccando il pulsante Crea Pull Request
.
Concludere la Pull Request
Accedi ora al repository principale e verifica che una PR è stata ricevuta.
L'aggiunta delle modifiche proposte non è automatica ma richiede una successiva autorizzazione, in base alle regole scelte dall'amministratore del repository.
Il presente richiede che almeno un altro utente accetti le modifiche. Se non l'hai già fatto, seleziona l'opzione se vuoi che i maintainer possano apportare piccole modifiche.
Controlla se ricevi commenti o proposte di modifiche. Finchè la PR non viene accettata è possibile aggiungere o apportare modifiche. Ogni modifica genererà un commit, che troverai nella parte bassa della PR.
Se le modifiche richiedono tempo attiva la modalità WIP (work in progress), per evitare che qualcuno chiuda la tua PR per sbaglio.
Quando tutto è aggiornato e qualcuno ha approvato le modifiche, vedrai una spunta verde e il pulsante Crea commit mescolato
(o Create squash commit
) ti permetterà di inviare tutto all'upstream.
Se preferisci, appena inviata la PR e anche prima di ricevere l'approvazione di qualcuno, puoi subito richiedere il commit finale, che però resterà in stand-by e verrà eseguito automaticamente solo in seguito all'approvazione di un maintainer.
Tutti i tuoi commit verranno uniti in uno solo (opzione squash
) e da quel momento il branch main sarà aggiornato e conterrà le modifiche da te proposte.
Come contribuire usando Gitea
Comandi hugo e struttura del sito
- Contribuire dal BROWSER
- Contribuire da LOCALE
- I'm a lazy boy
- Cartella content e permalink
- Front matter
- Note sull'utilizzo di media
- Inviare una PR
- Aggiungere warning in homepage
Comandi GIT
Guide online