====== GitHub initialisatie======
[[github:github|{{ :github:icon.jpg?120|}}]]

===== context=====
dit document beschrijft hoe je met GitHub aan de slag gaat. 
===== netwerk vereisten =====
uitgaan verkeer op onderstaande poorten: 
  -80 en 443: toegang tot Git repository
  -22: SSH toegang tot je Git account om naar je remote repo te kunnen push/clone/syncen 
  -9418: Git protocol port om clone en fetch bewerkingen te kunnen doen naar publieke repo's

===== account  =====
  - ga naar [[https://github.com|GitHub]] en maak je account aan. 
  - kies voor **Free** account. Dit houdt ondermeer in dat je projecten steeds __publiek__ zullen zijn. 
  - open de bevestigingsmail die Github je toestuurt. 
  - maak nu je eerste **repository** aan
    - **Repository name**: kies een betekenisvolle naam voor je project
    - **Description**: geef een korte beschrijving van je project
    - kies: **Create repository**
===== repository toegang  =====
Er zijn verschillende manieren om toegang te krijgen op deze repository:
====web====
  -meld aan op je GitHub account en voila!
  - **create a new file**: opent een editor en je kan beginnen
  - **upload an existing file**: upload een bestaand bestand vanop je computer
====desktop====
  - open een repository en kies: **Setup in desktop** \\ dit brengt je naar download pagina van GitHub Desktop
  - installeer **GitHub Desktop**
  - open het programma en **meld aan** met je GitHub account. 
  - hier heb je een overzicht van je **repositories**
  - om die op je desktop beschikbaar te maken kan je die **clonen**.
    - standaard naar het pad: **Documents\GitHub\<naam repository>** \\ Alle bestanden in die directory zullen voortaan nu ook in de gaten gehouden worden. 

====SSH====
  -controleer dat [[linux:agent_forwarding|Agent Forwarding]] actief staat
  -meld aan op GitHub > **Settings** > **SSH and GPG keys** > **New SSH Key**
  -plak je public key in het tekstveld \\ Als je nu git commando's uitvoert op je remote repos zal je public key gebruikt wordt en hoef je dus geen gebruiker/wachtwoord in te geven. 

===== repository =====
==== remote ====
  - meld aan op je linux server en **cd** naar je repo.
  - controleer of je remote repository toegevoegd is: <code>git remote -v
origin  git@github.com:kveys/dokuwiki.git (fetch)
origin  git@github.com:kveys/dokuwiki.git (push)
</code>
  - indien niet:  <code>
git remote add origin git@github.com:kveys/<repo>.git
</code>
==== verwijderen====
  - open je repository > tabblad **Settings** > **Danger Zone** (helemaal onderaan): **Delete this repository**
  - geef de **naam** van de repository
  - kies: **I understand the consequences, delete this repository**

==== hernoemen====
  - open je repository > tabblad **Settings** > **Repository name
  - geef de nieuwe naam op
  - kies: **Rename**
===== meer info =====
voeg hier linken toe naar verdere uitleg
{{tag>github}}