github Tutoriel
Démarrer avec github
Recherche…
Remarques
Cette section fournit une vue d'ensemble de ce qu'est github et pourquoi un développeur peut vouloir l'utiliser.
Il devrait également mentionner tous les grands sujets dans github, et établir un lien avec les sujets connexes. La documentation de github étant nouvelle, vous devrez peut-être créer des versions initiales de ces rubriques connexes.
Installation ou configuration
GitHub est une énorme collection de dépôts Git. En d'autres termes, vous pouvez considérer GitHub comme un ensemble de projets!
Créer un compte
- Visitez la page principale de GitHub ici
- Choisissez un nom d'utilisateur, entrez votre adresse e-mail, puis choisissez un mot de passe sécurisé et vous êtes prêt à partir!
Outils utiles
Pour les débutants Git / GitHub, comprendre comment fonctionne le contrôle de version peut être déroutant au début. Il existe une version graphique de GitHub que vous pouvez télécharger et utiliser. GitHub Desktop est juste cet outil.
Créer votre premier référentiel
Vous pouvez considérer un référentiel comme un projet. Vous pouvez créer un référentiel en ligne ou hors ligne. Suivez les étapes ci-dessous:
En ligne
- Connectez-vous d'abord et accédez à votre profil.
- Accédez à l'onglet "Référentiels" en haut de la page.
- Appuyez sur le bouton vert "Nouveau" et vous êtes prêt à gronder!
Hors ligne
- Téléchargez et installez git (choisissez le système d'exploitation que vous utilisez)
- Après le téléchargement et l'installation, vous pouvez utiliser l'outil de ligne de commande ou télécharger un client d'interface graphique.
- Après l'installation, créez un compte sur github
- En haut à droite, cliquez sur + et choisissez soit de créer un nouveau référentiel, soit d'importer un existant.
- Si vous en choisissez un nouveau, entrez le nom du référentiel et choisissez de le rendre public ou privé.
- Cliquez sur: Créer un référentiel
NB Les dépôts privés ne sont pas disponibles pour les utilisateurs gratuits.
Fichier README
Si votre projet ne contient pas README.md, GitHub peut analyser README.rdoc pour afficher les détails. S'il a les deux, il utilisera README.md, ignorant silencieusement rdoc.
Un fichier README peut inclure-
Titre du projet
Décrivez brièvement votre projet. Vous pouvez également fournir le lien vers le site Web du projet, les badges, la communauté et les informations de contact (par exemple, email, site social).
Télécharger
Lien exécutable (exécutable ou minifié ou fichier d'installation). Il peut également y avoir des liens vers les versions précédentes.
Installation
Comment votre travail peut être utilisé. Cela peut inclure les conditions préalables, les paramètres, les bibliothèques tierces, l'utilisation, les mises en garde, etc.
Manifestation
Il peut s'agir d'un échantillon de code, d'un fichier gif, d'un lien vidéo ou même de captures d'écran.
Auteurs
Noms d'auteur, coordonnées, etc.
Remerciements
Liste de personnes ou de communautés aidées et inspirées tout au long du projet
Contribuant
Instructions pour contribuer (c.-à-d. Ajouter une fonctionnalité, signaler un bogue, soumettre un correctif) au projet. Peut également inclure un lien de documentation.
Licence
Donnez une courte introduction sur votre licence. Vous pouvez également donner un lien vers le site de licence.
Fichier de licence
GitHub vous aide à ajouter rapidement une licence à votre référentiel, comme alternative à l'ajout de votre propre fichier texte / démarque.
Dans votre référentiel, cliquez sur "Créer un nouveau fichier"
Sur la page suivante:
- Tapez
LICENSE.mdouLICENSE.txtcomme nom de fichier du nouveau fichier. - Le Voulez-vous utiliser un nouveau modèle? la boîte de dialogue apparaîtra.
- Tapez
Choisissez votre licence préférée.
La licence que vous pouviez voir dans les détails du référentiel:
De Q & A - Comment ajouter une licence à un projet Github existant
GitHub Flavored Markdown
GitHub étend la syntaxe de Markdown pour fournir de nouvelles fonctionnalités utiles.
Entête
# Header1
## Header2
### Header3
#### Header4
##### Header5
###### Header6
H1
===
H2
---
Accentuation
*Italic1* _Italic2_
**Bold1** __Bold2__
***Bold_Italic***
~~Strikethrough~~
Ligne horizontale
---
***
___
liste
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
Table
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
Code
inline code- `int i=0`
block code-
``` C
for(int i=0; i<10; i++){
printf("Hallow World! \n");
}
```
Citation
> Stay hungry; stay foolish.
>> Quality is better than quantity.
>>> Life is not fair; get used to it.
Lien
https://github.com
[GitHub](https://github.com)
[GitHub](https://github.com "github website")
[GitHub][1]
[1]: https://github.com
Image
Listes de tâches
- [x] completed item
- [ ] incomplete item
Emoji
:octocat: :+1: :book: :ghost: :bulb: :imp:
Pour tous les emojies GitHub visitent - Emoji Cheat Sheet .
Références SHA
Toute référence à un hash SHA1 d'un commit sera convertie en un lien vers le commit lui-même sur GitHub:
e7909ea4fbb162db3f7f543d43c30684a3fb745f
Références sur les demandes de tirage et les problèmes
Toute référence à une demande d'extraction ou à un problème sera automatiquement liée à cette requête ou à ce problème d'extraction.
Cela peut être fait en mettant un # devant le numéro de la question / demande de tirage.