Come Aggiungere Screenshot e Animazioni alle Pull Request di GitHub

Gli programmatori di GitHub spesso aggiungono screenshot o GIF animate alle loro pull request nel repository. Queste tecniche sono sicuramente più accattivanti che far leggere a qualcuno diverse righe di testo semplice. Aggiungere screenshot statici è utile se si desidera inserire modifiche visive o fotografie inline. Per dimostrare flussi di processo e movimento del cursore del mouse, è possibile utilizzare video MP4 e animazioni GIF. Il seguente tutorial ti mostra come aggiungere screenshot e animazioni MP4/GIF nelle pull request di GitHub.

Indice dei Contenuti

• 1. Aggiungi un Nuovo Repository e Branch
• 2. Crea Screenshot per GitHub
• 3. Crea Video e Animazioni GIF per GitHub
• 4. Aggiungi Screenshot o Animazioni alle Pull Request di GitHub
• 5. Visualizza Screenshot e Immagini GIF su una Pagina GitHub
• Domande Frequenti

Leggi anche: La Guida per Principianti a Git

1. Aggiungi un Nuovo Repository e Branch

Anche se non hai mai usato GitHub prima, puoi seguire i passaggi qui sotto per iniziare come sviluppatore. Attualmente, hai solo bisogno di un’email per la creazione dell’account GitHub. Questo rende molto più facile iniziare con GitHub rispetto a prima.

1. Dopo aver effettuato l’accesso al tuo profilo GitHub, fai clic sul segno “+” in alto a destra per creare un nuovo repository.

1. Dai al repository un nome a tua scelta e scegli di mantenerlo pubblico o privato. Ricorda di controllare l’opzione “Inizializza questo repository insieme alla verifica di un README”.

1. Puoi scegliere di rilasciare il tuo codice sotto forma di licenza Apache 2.0, licenza pubblica generale GNU, licenza MIT, Eclipse, licenza pubblica Mozilla, ecc. Scegli “nessuna” se non vuoi che altri possano utilizzare liberamente il codice.
2. Fai clic su “Crea repository” per confermare l’aggiunta del tuo repository sotto il branch principale del tuo profilo.

1. Nella fase successiva, aggiungi un branch al tuo repository utilizzando il menu a discesa mostrato qui sotto. Qui, il branch “Guten-tag-1” è stato aggiunto al repository “Guten-tag”, che è a sua volta un branch del repository principale “Hola-World.”

1. Lo scopo di un branch in GitHub è aiutare lo sviluppatore a lavorare su funzionalità e correzioni di bug separatamente dal branch di produzione principale. Aggiungere un numero seriale come 1, 2, 3, ecc., è un modo più semplice per memorizzare il livello del branch.

2. Crea Screenshot per GitHub

Per aggiungere screenshot in GitHub, hai bisogno di un buon software di cattura dello schermo. In Windows 11, lo Strumento di Cattura è un’app Microsoft meglio adatta a questo scopo. Se hai problemi con esso, segui la nostra guida alla risoluzione dei problemi.

Windows 10, tuttavia, utilizza un’app “Cattura e Bozza” che funziona molto similmente allo Strumento di Cattura di Windows 11 ma con meno funzioni. Ha un timer di 3 o 10 secondi per il ritardo nella cattura dello schermo.

Leggi anche: Strumento di Cattura di Windows 11 Non Funziona: 12 Possibili Soluzioni

3. Crea Video e Animazioni GIF per GitHub

Per aggiungere video o GIF per GitHub, hai bisogno di un buon strumento di cattura video. In passato, non potevi caricare un MP4 in GitHub, ma questo è cambiato.

In Windows 11 e Windows 10, puoi utilizzare un’app del Microsoft Store chiamata Registratore dello schermo & Registrazione dello schermo. Il Microsoft Store è la fonte più sicura per scaricare software di registrazione dello schermo, poiché ogni app è progettata per funzionare bene con Windows. Per scoprire come registrare il tuo schermo gratuitamente su un Mac, segui questa guida.

1. Avvia l’app di registrazione dello schermo e scegli una modalità di cattura: “Intero”, “Area”, “Camera” o “Solo Audio.” Premi “Inizia” quando sei pronto per iniziare a registrare sul tuo schermo.

1. La cosa positiva di questo software è che puoi scegliere di creare un GIF direttamente selezionando la modalità GIF.

1. In alternativa, puoi facilmente convertire un MP4 in GIF utilizzando Ezgif o qualsiasi altro strumento online. Prima, aggiungi il video MP4 utilizzando il link di caricamento.

1. Otterrai una stima approssimativa della dimensione del file GIF, larghezza e lunghezza. Puoi cambiare il frame rate del tuo file GIF per renderlo più lento per istruzioni facili.

Leggi anche: Come Registrare il Tuo Schermo su un Mac Gratuitamente

4. Aggiungi Screenshot o Animazioni alle Pull Request di GitHub

Una volta creati i tuoi screenshot o video, puoi facilmente aggiungerli alle pull request di GitHub.

1. Per aggiungere screenshot o video/animazioni a GitHub, torna al branch che hai creato in precedenza e naviga su “Pull requests.” In alternativa, raggiungilo direttamente facendo clic sul branch.

1. Per aggiungere un nuovo file, come MP4 o GIF, seleziona “Carica file” nel branch in cui desideri che il file sia disponibile.

1. Una volta in modalità editor, puoi allegare l’immagine dello screenshot e i file MP4/GIF dall’opzione “scegli i tuoi file”. Se stai effettuando un commit per la prima volta nel repository del branch di GitHub, fai clic su “commit changes.” Se no, scegli di “aggiornare il commento.”

1. Aspetta qualche secondo affinché il file screenshot o animazione venga aggiunto al tuo branch del repository.

1. Lo screenshot/video/animazione creato è stato aggiunto con successo al branch di GitHub e, a sua volta, al repository.

1. GitHub riguarda la collaborazione con altri sviluppatori. Se piacciono le tue modifiche proposte, possono unirle nel loro repository. Questo avviene automaticamente se riesci a vedere un’opzione “In grado di unire”.

1. Una volta completata l’unione, i video/screenshot appariranno come “commits” nel repository principale.

Leggi anche: Come Cancellare la Cache di Git

5. Visualizza Screenshot e Immagini GIF su una Pagina GitHub

Invece di caricare screenshot e file GIF separatamente all’interno del repository della pull request, puoi anche renderli visibili sulla pagina di GitHub.

1. Il trucco è fare clic sul file “ReadMe.md” visibile su qualsiasi branch. Una volta aperto, fai clic su un’icona chiamata “Visualizza il blob sorgente.” Questo branch può essere modificato per visualizzare immagini, screenshot, GIF e altro.

1. Facendo clic sull’icona “modifica file” si arriverà a una schermata di codifica dove puoi aggiungere il codice per lo screenshot o GIF animata. È facile visualizzare un’immagine aggiungendo ! e racchiudendo il testo alternativo in [ ], quindi incorporando il link per l’immagine tra parentesi ().

Se non vuoi codificare, c’è un modo più semplice per aggiungere uno screenshot/GIF direttamente alla pagina del repository.

1. Fai clic su “modifica file” nella pagina Readme.md, che porterà a una nuova finestra in cui puoi allegare lo screenshot/GIF da visualizzare sulla pagina del branch.

1. Prima di confermare le modifiche al tuo branch di GitHub, puoi facilmente visualizzare in anteprima l’immagine, lo screenshot o il GIF.

Leggi anche: Come Installare Git e Git Bash in Windows

Domande Frequenti

Come posso allineare o ridimensionare un’immagine o uno screenshot in GitHub?

Per allineare un’immagine o uno screenshot sulla tua pagina GitHub, fai clic su “modifica questo” nel file ReadMe.md, quindi carica l’immagine o lo screenshot e aggiungi il seguente codice:

Modifica il codice a seconda che tu voglia l’immagine allineata a sinistra, a destra o al centro. Per ridimensionare l’immagine, modifica le dimensioni di larghezza e altezza.

C’è un limite di dimensione per i file GIF e video su GitHub?

Sì. La dimensione massima del file è di 50 MB per singoli file GIF o MP4. Utilizzando una funzione nascosta di GitHub chiamata “GitHub Blocks”, puoi aumentare questo limite a 100 MB per ciascun file. I repository di GitHub (il tuo branch principale) dovrebbero rimanere inferiori a 5 GB.

Se hai bisogno di caricare un’immagine o un video con una dimensione di file superiore, utilizza un programma di GitHub chiamato GitHub Large File Storage (LFS), che ha un limite massimo di 2 GB per file per utenti Free/Pro.

Come posso condividere immagini su GitHub?

GitHub attualmente non ha alcuna funzionalità per condividere direttamente immagini utilizzando chat e strumenti correlati, come screenshot o GIF. Tuttavia, puoi creare “problemi” in una pagina GitHub e inviarli per la loro revisione. Questi problemi possono includere le immagini. Per notificare una persona su GitHub, usa @ prima del loro nome utente.

Crediti immagine: Groot e Octocat su Unsplash Tutti gli screenshot sono stati presi dall’autore.