Stap 3: GitHub instellen

Deze tekst is vertaald met AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik hier.

We raden je aan om een GitHub-repository te maken voor elk project waaraan je werkt: een thema, een plugin of een volledige site. Je kunt een gratis GitHub-account maken en daarna zoveel openbare of privé-repository’s instellen als je wilt. GitHub geeft je de flexibiliteit van versiebeheer en kan moeiteloos synchroniseren met je WordPress.com-productie- of staging-site.

Er zijn veel manieren om je code aan een GitHub-repository toe te voegen, bijvoorbeeld via de command line. We raden echter aan om GitHub Desktop te gebruiken, een gratis app die dient als GUI voor je commits en pull requests. Hiermee kun je naadloos werken met je lokale sitebestanden en GitHub-repository’s via een intuïtieve visuele interface.

De tutorials hieronder behandelen deze workflow.

Als je aan een nieuw thema werkt

Eerst moet je een lokale repository maken in je themamap:

1. Klik in GitHub Desktop op de knop “Create a New Repository on your Local Drive… (Een nieuwe repository op je lokale schijf maken…)” of ga naar File > New Repository (Bestand > Nieuwe repository).
2. Typ in het veld “Repository Name (Naam repository)” de naam van het thema dat je ontwikkelt. Deze moet overeenkomen met de naam van het thema in je map wp-content/themes/.
3. Selecteer in het veld “Local Path (Lokaal pad)” de map wp-content/themes/ in je Studio-site (het pad ziet er ongeveer zo uit: /Users/user_name/Studio/site_name/wp-content/themes).
4. Klik op “Create Repository (Repository maken)“.

Zodra je op de knop “Create Repository (Repository maken)” klikt, heb je een lokale repository gemaakt. Er worden twee verborgen bestanden toegevoegd aan je afzonderlijke themamap (.git en .gitattributes). 

Je kunt nu je thema binnen deze lokale repository maken.

Om je lokale repository naar GitHub te publiceren:

1. Ga naar GitHub Desktop en klik op de knop Publish repository (Repository publiceren) .
2. Als je nog niet bent ingelogd, wordt je gevraagd om in te loggen op je GitHub-account.
3. Geef je openbare repository een naam; je kunt elke naam kiezen, maar het is een goed idee om dezelfde naam te gebruiken als de themafolder. Je kunt ook met het beschikbare selectievakje kiezen of je je code openbaar of privé wilt maken. 
4. Klik op Publish Repository (Repository publiceren).

Na publicatie zou je je repository met je themacode op GitHub moeten kunnen zien.

Als je aan een nieuwe plugin werkt

Eerst moet je een lokale repository maken binnen je pluginfolder:

1. Klik in GitHub Desktop op de knop Create a New Repository on your Local Drive… (Een nieuwe repository op je lokale schijf maken…) of ga naar File (Bestand) > New Repository (Nieuwe repository).
2. Typ in het veld Repository Name (Repositorynaam) de naam van de plugin die je ontwikkelt. Deze moet overeenkomen met de naam van de plugin in je map wp-content/plugins/.
3. Selecteer in het veld Local Path (Lokaal pad) de map wp-content/plugins/ in je Studio-site (het pad ziet er ongeveer zo uit: /Users/user_name/Studio/site_name/wp-content/plugins).
4. Klik op Create Repository (Repository maken).

Zodra je op de knop Create Repository (Repository maken) klikt, heb je een lokale repository gemaakt. Er worden twee verborgen bestanden toegevoegd aan je afzonderlijke themafolder (.git en .gitattributes). 

Om je lokale repository naar GitHub te publiceren:

1. Ga naar GitHub Desktop en klik op de knop “Publish Repository (Repository publiceren)“.
2. Geef je openbare repository een naam; je kunt elke naam kiezen, maar het is een goed idee om dezelfde naam te gebruiken als de themamap. Je kunt ook met het beschikbare selectievakje kiezen of je je code openbaar of privé wilt maken.
3. Klik op “Publish Repository (Repository publiceren)“.

Na publicatie zou je je repository met je plugincode op GitHub moeten kunnen zien.

Als je alle wp-content-bestanden wilt synchroniseren

Als je niet aan een specifieke plugin of thema werkt en een volledige site onder versiebeheer wilt plaatsen, raden we aan om alleen bij te houden wat zich in de map wp-content bevindt. Hier worden al je aanpassingen opgeslagen die je site uniek maken. De meeste WordPress-corebestanden blijven meestal ongewijzigd en kunnen indien nodig opnieuw worden gedownload. Het bestand wp-config.php is een uitzondering, omdat het essentiële configuratiegegevens bevat, voornamelijk voor je databaseverbinding.

Eerst moet je een lokale repository maken in de map wp-content van je site:

1. Selecteer in WordPress Studio je site en klik op het tabblad Overzicht.
2. Open in het gedeelte “Openen in…“ de sitemap in je gekozen code-editor.
3. Maak een bestand met de naam .gitignore in de map wp-content.
4. Voeg de volgende map- en bestandsnamen toe aan dit nieuwe .gitignore-bestand om te voorkomen dat ze in je repository worden bijgehouden. Hiermee sluit je de plugins uit die Studio vereist, je SQLite-database en je uploads-map. Om deze reden worden je berichten, pagina’s en afbeeldingen van je lokale site niet naar je productiesite gecommit.

mu-plugins
database
db.php
uploads

4. Klik in GitHub Desktop op de knop “Create a New Repository on your Local Drive… (Een nieuwe repository op je lokale schijf maken…)” of ga naar File (Bestand) > New Repository (Nieuwe repository).
5. Typ in het veld “Repository Name (Naam repository)” wp-content, zodat dit overeenkomt met de naam van je map wp-content.
6. Selecteer in het veld “Local Path (Lokaal pad)” de map van je Studio-site (het pad ziet er ongeveer zo uit: /Users/user_name/Studio/site_name).
7. Klik op “Create Repository (Repository maken)“.

Zodra je op de knop “Create Repository (Repository aanmaken)” klikt, heb je een lokale repository aangemaakt. Er worden twee verborgen bestanden toegevoegd aan je afzonderlijke themamap (.git en .gitattributes). 

Je lokale repository publiceren naar GitHub:

1. Ga naar GitHub Desktop en klik op de knop “Publish Repository (Repository publiceren)“.
2. Geef je openbare repository een naam; je kunt elke gewenste naam kiezen. Je kunt ook met het beschikbare selectievakje kiezen of je code openbaar of privé moet zijn. 
3. Klik op “Publish Repository (Repository publiceren)“.