Étape 3 : Configurer GitHub

Ce texte a été traduit à l’aide de l’IA. Si vous souhaitez consulter le texte original en anglais, cliquez ici.

Nous recommandons de créer un dépôt GitHub pour chaque projet sur lequel vous travaillez — un thème, une extension ou un site complet. Vous pouvez créer un compte GitHub gratuit, puis configurer autant de dépôts publics ou privés que vous le souhaitez. GitHub vous offre la flexibilité du contrôle de version et peut se synchroniser facilement avec votre site de production ou votre site de préproduction WordPress.com.

Il existe de nombreuses façons d’ajouter votre code à un dépôt GitHub, comme l’utilisation de la ligne de commande. Cependant, nous recommandons d’utiliser GitHub Desktop, une application gratuite qui sert d’interface graphique pour vos commits et pull requests. Elle vous permet d’interagir facilement avec les fichiers de votre site local et vos dépôts GitHub grâce à une interface visuelle intuitive.

Les tutoriels ci-dessous couvrent ce flux de travail.

Si vous travaillez sur un nouveau thème

Tout d’abord, vous devez créer un dépôt local dans le dossier de votre thème :

1. Dans GitHub Desktop, cliquez sur le bouton « Create a New Repository on your Local Drive… » ou accédez à File > New Repository.
2. Dans le champ « Repository Name », saisissez le nom du thème que vous développez. Il doit correspondre au nom du thème dans votre dossier wp-content/themes/.
3. Dans le champ « Local Path », sélectionnez le dossier wp-content/themes/ de votre site Studio (le chemin ressemblera à quelque chose comme : /Users/user_name/Studio/site_name/wp-content/themes).
4. Cliquez sur « Create Repository ».

Une fois que vous avez cliqué sur le bouton « Create Repository », vous aurez créé un dépôt local. Deux fichiers cachés seront ajoutés au dossier de votre thème (.git et .gitattributes). 

Vous pouvez maintenant créer votre thème dans ce dépôt local.

Pour publier votre dépôt local sur GitHub :

1. Accédez à GitHub Desktop et cliquez sur le bouton « Publish repository ».
2. Si ce n’est pas déjà fait, il vous sera demandé de vous connecter à votre compte GitHub.
3. Nommez votre dépôt public ; vous pouvez lui donner n’importe quel nom, mais il est recommandé de conserver le même nom que le dossier du thème. Vous pouvez également choisir si vous souhaitez que votre code soit public ou privé à l’aide de la case à cocher fournie. 
4. Cliquez sur « Publish Repository ».

Une fois publié, vous devriez pouvoir voir votre dépôt avec le code de votre thème sur GitHub.

Si vous travaillez sur une nouvelle extension

Tout d’abord, vous devrez créer un dépôt local dans le dossier de votre extension :

1. Dans GitHub Desktop, cliquez sur le bouton « Create a New Repository on your Local Drive… » ou accédez à File > New Repository.
2. Dans le champ « Repository Name », saisissez le nom de l’extension que vous développez. Il doit correspondre au nom de l’extension dans votre dossier wp-content/plugins/.
3. Dans le champ « Local Path », sélectionnez le dossier wp-content/plugins/ de votre site Studio (le chemin ressemblera à quelque chose comme : /Users/user_name/Studio/site_name/wp-content/plugins).
4. Cliquez sur « Create Repository ».

Une fois que vous aurez cliqué sur le bouton « Create Repository », vous aurez créé un dépôt local. Deux fichiers cachés seront ajoutés au dossier individuel de votre thème (.git et .gitattributes).

Pour publier votre dépôt local sur GitHub :

1. Accédez à GitHub Desktop et cliquez sur le bouton « Publish Repository ».
2. Nommez votre dépôt public ; vous pouvez lui donner n’importe quel nom, mais il est recommandé de conserver le même nom que le dossier du thème. Vous pouvez également choisir si vous souhaitez que votre code soit public ou privé à l’aide de la case à cocher fournie.
3. Cliquez sur « Publish Repository ».

Une fois publié, vous devriez pouvoir voir votre dépôt avec le code de votre extension sur GitHub.

Si vous souhaitez synchroniser tous les fichiers wp-content

Si vous ne travaillez pas sur une extension ou un thème spécifique et que vous souhaitez placer un site complet sous contrôle de version, nous recommandons de ne suivre que le contenu du dossier wp-content. C’est là que sont stockées toutes vos personnalisations qui rendent votre site unique. La majorité des fichiers du cœur de WordPress restent généralement inchangés et peuvent être retéléchargés si nécessaire. Le fichier wp-config.php constitue une exception, car il contient des détails de configuration essentiels, principalement pour votre connexion à la base de données.

Tout d’abord, vous devrez créer un dépôt local dans le dossier wp-content de votre site :

1. Dans WordPress Studio, sélectionnez votre site et cliquez sur l’onglet Vue d’ensemble.
2. Dans la section « Ouvrir dans… », ouvrez le dossier du site dans l’éditeur de code de votre choix.
3. Créez un fichier nommé .gitignore à l’intérieur du dossier wp-content.
4. Ajoutez les noms de dossiers et de fichiers suivants à ce nouveau fichier .gitignore pour éviter de les suivre dans votre dépôt. Cela exclura les extensions requises par Studio, votre base de données SQLite et votre dossier d’uploads. Pour cette raison, vos articles, pages et images de votre site local ne seront pas commités vers votre site de production.

mu-plugins
database
db.php
uploads

4. Dans GitHub Desktop, cliquez sur le bouton « Create a New Repository on your Local Drive… » ou accédez à File > New Repository.
5. Dans le champ « Repository Name », saisissez wp-content, pour correspondre au nom de votre dossier wp-content.
6. Dans le champ « Local Path », sélectionnez le dossier de votre site Studio (le chemin ressemblera à quelque chose comme : /Users/user_name/Studio/site_name).
7. Cliquez sur « Create Repository ».

Une fois que vous cliquez sur le bouton « Create Repository », vous aurez créé un dépôt local. Deux fichiers cachés seront ajoutés à votre dossier de thème individuel (.git et .gitattributes).

Pour publier votre dépôt local sur GitHub :

1. Accédez à GitHub Desktop et cliquez sur le bouton « Publish Repository ».
2. Nommez votre dépôt public ; vous pouvez lui donner n’importe quel nom. Vous pouvez également choisir si vous souhaitez que votre code soit public ou privé à l’aide de la case à cocher fournie. 
3. Cliquez sur « Publish Repository ».