github Tutorial
Iniziare con github
Ricerca…
Osservazioni
Questa sezione fornisce una panoramica su cosa sia GitHub e perché uno sviluppatore potrebbe volerlo utilizzare.
Dovrebbe anche menzionare qualsiasi argomento di grandi dimensioni all'interno di github e collegarsi agli argomenti correlati. Poiché la Documentazione per github è nuova, potrebbe essere necessario creare versioni iniziali di tali argomenti correlati.
Installazione o configurazione
GitHub è una vasta collezione di repository Git. In altre parole, puoi pensare a GitHub come a una collezione di molti progetti!
Creare un account
- Visita la pagina principale di GitHub qui
- Scegli un nome utente, inserisci il tuo indirizzo email e scegli una password sicura e sei pronto per partire!
Strumenti utili
Per i principianti di Git / GitHub, capire come funziona il controllo della versione potrebbe essere inizialmente fonte di confusione. Esiste una versione GUI di GitHub che è possibile scaricare e utilizzare. GitHub Desktop è proprio questo strumento.
Creare il tuo primo deposito
Puoi pensare a un repository come a un progetto. È possibile creare un repository online o offline. Segui i passaggi seguenti:
in linea
- Primo login e vai al tuo profilo.
- Passare alla scheda "Archivi" nella parte superiore della pagina
- Premi il pulsante verde "Nuovo" e sei pronto per il rombo!
disconnesso
- Scarica e installa git (scegli il sistema operativo in esecuzione)
- Dopo il download e l'installazione, è possibile utilizzare lo strumento della riga di comando oppure è possibile scaricare un client della GUI.
- Dopo l'installazione, crea un account su github
- In alto a destra, fai clic su + e scegli di creare un nuovo repository o di importarne uno esistente.
- Se ne selezioni uno nuovo, inserisci il nome del repository e scegli se renderlo pubblico o privato.
- Fare clic: Crea repository
NB I repository privati non sono disponibili per gli utenti gratuiti.
File README
Se il tuo progetto non ha README.md, GitHub può analizzare README.rdoc per visualizzare i dettagli. Se ha entrambi, utilizzerà README.md, ignorando silenziosamente rdoc.
Un file README può includere-
titolo del progetto
Descrivi brevemente il tuo progetto. È inoltre possibile fornire il link del sito Web del progetto, i badge, la comunità e le informazioni di contatto (ad es. Email, sito social).
Scaricare
Link eseguibile (file eseguibile o minisito o file di installazione). Ci possono essere collegamenti anche alle versioni precedenti.
Installazione
Come può essere usato il tuo lavoro. Può includere i prerequisiti, le impostazioni, le librerie di terze parti, l'uso, le precauzioni, ecc.
Dimostrazione
Può includere esempio di codice, file GIF, collegamento video o anche schermate.
autori
Nomi degli autori, informazioni di contatto, ecc.
Ringraziamenti
Elenco di persone o comunità aiutato e ispirato durante il progetto
contribuire
Istruzioni per contribuire (es. Aggiungere funzionalità, segnalare bug, inviare patch) al progetto. Può includere anche un link alla documentazione.
Licenza
Fai una breve introduzione sulla tua licenza. Puoi anche dare un link al sito della licenza.
File LICENZA
GitHub ti aiuta a aggiungere rapidamente una licenza al tuo repository, come alternativa per aggiungere il tuo file text / markdown.
Nel tuo repository, fai clic su "Crea nuovo file"
Nella pagina successiva:
- Digitare
LICENSE.md
oLICENSE.txt
come nome file del nuovo file. - Vuoi usare un nuovo modello? apparirà la finestra di dialogo.
- Digitare
Scegli la tua licenza preferita.
La licenza che potresti vedere nei dettagli del repository:
Da Q & A - Come aggiungere la licenza a un progetto Github esistente
GitHub Flavored Markdown
GitHub espande la sintassi di Markdown per fornire nuove utili funzionalità.
Intestazione
# Header1
## Header2
### Header3
#### Header4
##### Header5
###### Header6
H1
===
H2
---
enfasi
*Italic1* _Italic2_
**Bold1** __Bold2__
***Bold_Italic***
~~Strikethrough~~
Linea orizzontale
---
***
___
Elenco
unordered list:
* item-1
* sub-item-1
* sub-item-2
- item-2
- sub-item-3
- sub-item-4
+ item-3
+ sub-item-5
+ sub-item-6
ordered list:
1. item-1
1. sub-item-1
2. sub-item-2
2. item-2
1. sub-item-3
2. sub-item-4
3. item-3
tavolo
Table Header-1 | Table Header-2 | Table Header-3
:--- | :---: | ---:
Table Data-1 | Table Data-2 | Table Data-3
TD-4 | Td-5 | TD-6
Table Data-7 | Table Data-8 | Table Data-9
Codice
inline code- `int i=0`
block code-
``` C
for(int i=0; i<10; i++){
printf("Hallow World! \n");
}
```
Citazione
> Stay hungry; stay foolish.
>> Quality is better than quantity.
>>> Life is not fair; get used to it.
collegamento
https://github.com
[GitHub](https://github.com)
[GitHub](https://github.com "github website")
[GitHub][1]
[1]: https://github.com
Immagine
![GitHub Logo](https://assets-cdn.github.com/images/icons/emoji/octocat.png "GitHub")
Elenchi di attività
- [x] completed item
- [ ] incomplete item
emoji
:octocat: :+1: :book: :ghost: :bulb: :imp:
Per tutte le emoji di GitHub visitate- Emoji Cheat Sheet .
Riferimenti SHA
Qualsiasi riferimento a un hash SHA1 di un commit verrà convertito in un link al commit stesso su GitHub:
e7909ea4fbb162db3f7f543d43c30684a3fb745f
Richiama referenze di richieste e problemi
Qualsiasi riferimento a una richiesta di pull o un problema verrà automaticamente collegato a tale richiesta o problema.
Questo può essere fatto mettendo un #
di fronte al numero di problema / Pull Request.