kılavuz: dil dizinleri (en/tr/de/fr/ru) + dil değiştirici ve bölüm gezinmesi
- iki dilli tek dosyalar en/ ve tr/ altına ayrıldı - Almanca, Fransızca, Rusça çeviriler eklendi (10 bölüm) - kök README dil seçici oldu; her dilde kendi içindekiler sayfası - her bölüme dil değiştirici satırı + önceki/sonraki gezinme eklendi
This commit is contained in:
semih
@@ -0,0 +1,43 @@
|
||||
# 01 — Premiers pas
|
||||
|
||||
🌍 [English](../../en/01-getting-started/readme.md) · [Türkçe](../../tr/01-getting-started/readme.md) · [Deutsch](../../de/01-getting-started/readme.md) · **Français** · [Русский](../../ru/01-getting-started/readme.md)
|
||||
|
||||
KabaForge est l'endroit où vivent votre code, vos documents et l'historique de vos projets. Ce chapitre vous connecte et vous fait faire le tour.
|
||||
|
||||
## Se connecter
|
||||
|
||||
1. Ouvrez [forge.kabaforce.com](https://forge.kabaforce.com).
|
||||
2. Cliquez sur **Se connecter avec KabaForce ID**.
|
||||
3. Saisissez vos informations de compte KabaForce sur `id.kabaforce.com`.
|
||||
4. Vous revenez sur KabaForge, connecté.
|
||||
|
||||
KabaForge n'a pas de mot de passe distinct — votre KabaForce ID est le seul compte nécessaire. Si vous n'en avez pas encore, utilisez le lien **S'inscrire** sur la même page.
|
||||
|
||||
## Ce que vous voyez après la connexion
|
||||
|
||||
| Zone | À quoi ça sert |
|
||||
|------|----------------|
|
||||
| **Tableau de bord** (accueil) | Activité récente de vos dépôts |
|
||||
| **Explorer** | Dépôts publics de ce serveur |
|
||||
| **+** (en haut à droite) | Créer un dépôt ou une organisation |
|
||||
| **Avatar** (en haut à droite) | Profil, paramètres et déconnexion |
|
||||
|
||||
## Le vocabulaire que vous croiserez
|
||||
|
||||
- **Dépôt (repository, repo)** — un projet : ses fichiers et tout son historique.
|
||||
- **Commit** — une modification enregistrée, accompagnée d'un message qui la décrit.
|
||||
- **Branche** — une ligne de travail parallèle ; celle par défaut s'appelle en général `main`.
|
||||
- **Demande de fusion (pull request)** — une proposition de fusionner une branche dans une autre.
|
||||
|
||||
## Vos cinq premières minutes
|
||||
|
||||
1. Cliquez sur **+ → Nouveau dépôt**.
|
||||
2. Nommez-le `essai` (ou autre), cochez *Initialiser le dépôt*, cliquez sur **Créer**.
|
||||
3. Ouvrez-le et cliquez sur **Ajouter un fichier → Nouveau fichier**.
|
||||
4. Tapez `readme.md` comme nom, écrivez deux ou trois lignes, cliquez sur **Valider les modifications**.
|
||||
|
||||
Vous avez maintenant un dépôt avec une page d'accueil. Les chapitres suivants détaillent chacune de ces étapes.
|
||||
|
||||
---
|
||||
|
||||
📚 [Sommaire](../README.md) · [Suivant: 02 — Créer un dépôt](../02-create-repository/readme.md) ➡
|
||||
@@ -0,0 +1,41 @@
|
||||
# 02 — Créer un dépôt
|
||||
|
||||
🌍 [English](../../en/02-create-repository/readme.md) · [Türkçe](../../tr/02-create-repository/readme.md) · [Deutsch](../../de/02-create-repository/readme.md) · **Français** · [Русский](../../ru/02-create-repository/readme.md)
|
||||
|
||||
Un dépôt correspond à un projet. Créez-en un par projet, pas un par fichier.
|
||||
|
||||
## Étapes
|
||||
|
||||
1. Cliquez sur **+** en haut à droite → **Nouveau dépôt**.
|
||||
2. **Propriétaire** — vous-même, ou une organisation dont vous êtes membre.
|
||||
3. **Nom du dépôt** — en minuscules, sans espaces : `network-lab`, `web-site`, `guide`.
|
||||
4. **Description** — une ligne expliquant de quoi il s'agit. Elle apparaît dans les résultats de recherche.
|
||||
5. **Visibilité**
|
||||
- *Public* — toute personne pouvant atteindre le serveur peut lire.
|
||||
- *Privé* — seulement vous et les personnes que vous invitez.
|
||||
6. **Initialiser le dépôt** — cochez la case. Cela crée le premier commit avec un `README.md`, le dépôt est donc utilisable tout de suite.
|
||||
7. Cliquez sur **Créer le dépôt**.
|
||||
|
||||
## De bons noms
|
||||
|
||||
| Au lieu de | Préférez |
|
||||
|-----------|----------|
|
||||
| `Nouveau Projet (final)` | `nouveau-projet` |
|
||||
| `Devoir Réseau 1` | `network-lab-01` |
|
||||
| `test test 2` | `packet-tracer-tests` |
|
||||
|
||||
Les espaces et les parenthèses dans les noms compliquent le partage de liens et peuvent perturber les chemins relatifs à l'intérieur des documents. Minuscules, chiffres et tirets sont toujours sûrs.
|
||||
|
||||
## Après la création
|
||||
|
||||
- **Paramètres → Collaborateurs** — donner un accès en lecture ou en écriture à d'autres personnes.
|
||||
- **Paramètres → Branches** — protéger `main` pour que personne n'y commite directement.
|
||||
- **Ajouter un fichier** — commencer à remplir le dépôt (chapitre 03).
|
||||
|
||||
## Supprimer un dépôt
|
||||
|
||||
**Paramètres → Zone de danger → Supprimer ce dépôt.** Vous devez taper le nom du dépôt pour confirmer. C'est irréversible — l'historique disparaît avec lui.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 01 — Premiers pas](../01-getting-started/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 03 — Ajouter et modifier des fichiers](../03-add-and-edit-files/readme.md) ➡
|
||||
@@ -0,0 +1,52 @@
|
||||
# 03 — Ajouter et modifier des fichiers
|
||||
|
||||
🌍 [English](../../en/03-add-and-edit-files/readme.md) · [Türkçe](../../tr/03-add-and-edit-files/readme.md) · [Deutsch](../../de/03-add-and-edit-files/readme.md) · **Français** · [Русский](../../ru/03-add-and-edit-files/readme.md)
|
||||
|
||||
Tout ce chapitre se passe dans le navigateur. Rien à installer.
|
||||
|
||||
## Le menu « Ajouter un fichier »
|
||||
|
||||
Ouvrez un dépôt (ou un dossier qu'il contient) et cliquez sur **Ajouter un fichier** :
|
||||
|
||||
| Entrée | Sert à |
|
||||
|--------|--------|
|
||||
| **Nouveau fichier** | Écrire un fichier à la main — notes, code, `readme.md` |
|
||||
| **Nouveau répertoire** | Créer un dossier vide (chapitre 04) |
|
||||
| **Téléverser un fichier** | Apporter des fichiers de votre ordinateur — images, PDF, archives |
|
||||
| **Correctif (patch)** | Appliquer un diff tout prêt |
|
||||
|
||||
## Écrire un nouveau fichier
|
||||
|
||||
1. **Ajouter un fichier → Nouveau fichier**.
|
||||
2. Tapez le nom du fichier en haut, par exemple `notes.md`.
|
||||
Taper `docs/notes.md` crée en même temps le dossier `docs`.
|
||||
3. Écrivez le contenu dans l'éditeur.
|
||||
4. Remplissez le cadre de commit en bas :
|
||||
- **Résumé** — court, à l'impératif : *ajouter les notes d'installation*.
|
||||
- **Description** — détail facultatif.
|
||||
5. Choisissez **Commiter directement sur `main`**, ou *créer une nouvelle branche* si vous voulez une relecture d'abord (chapitre 09).
|
||||
6. Cliquez sur **Valider les modifications**.
|
||||
|
||||
## Téléverser des fichiers
|
||||
|
||||
1. **Ajouter un fichier → Téléverser un fichier**.
|
||||
2. Glissez les fichiers dedans, ou cliquez sur le cadre pour les choisir.
|
||||
3. Pour les placer dans un sous-dossier, tapez son nom dans le champ de chemin en haut.
|
||||
4. Cliquez sur **Valider les modifications**.
|
||||
|
||||
Les fichiers très volumineux (vidéo, images disque) relèvent d'un stockage de fichiers, pas d'un dépôt — l'historique conserve chaque version pour toujours.
|
||||
|
||||
## Modifier un fichier existant
|
||||
|
||||
1. Ouvrez le fichier.
|
||||
2. Cliquez sur l'icône crayon ✏️ en haut à droite.
|
||||
3. Modifiez le texte ; l'onglet **Aperçu des modifications** montre ce que vous avez changé.
|
||||
4. Commitez comme ci-dessus.
|
||||
|
||||
## Renommer et déplacer
|
||||
|
||||
L'écran de modification permet de changer le chemin : placez le curseur dans le champ du nom et tapez un nouveau chemin, par ex. `docs/notes.md`. Au commit, le fichier est déplacé — l'historique est préservé.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 02 — Créer un dépôt](../02-create-repository/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 04 — Créer des répertoires](../04-create-directory/readme.md) ➡
|
||||
@@ -0,0 +1,50 @@
|
||||
# 04 — Créer des répertoires
|
||||
|
||||
🌍 [English](../../en/04-create-directory/readme.md) · [Türkçe](../../tr/04-create-directory/readme.md) · [Deutsch](../../de/04-create-directory/readme.md) · **Français** · [Русский](../../ru/04-create-directory/readme.md)
|
||||
|
||||
## La méthode rapide
|
||||
|
||||
1. Ouvrez le dépôt, ou le dossier dans lequel vous voulez créer le nouveau dossier.
|
||||
2. **Ajouter un fichier → Nouveau répertoire**.
|
||||
3. Tapez le nom du dossier, par ex. `docs`.
|
||||
4. Cliquez sur **Valider les modifications**.
|
||||
|
||||
Au-dessus du champ du nom, le panneau indique où le dossier sera créé (`chemin/actuel/`) : vous savez toujours où vous êtes.
|
||||
|
||||
## Des dossiers imbriqués en une fois
|
||||
|
||||
Tapez un chemin plutôt qu'un simple nom :
|
||||
|
||||
```
|
||||
docs/images
|
||||
```
|
||||
|
||||
Cela crée `docs`, et `images` à l'intérieur, en un seul commit.
|
||||
|
||||
## Pourquoi un fichier `.gitkeep` apparaît
|
||||
|
||||
La gestion de versions suit des *fichiers*, pas des dossiers vides. Pour conserver un dossier encore vide, KabaForge y place un fichier vide nommé `.gitkeep`. Il n'a aucun effet sur votre projet — supprimez-le lorsque le dossier a un vrai contenu, ou laissez-le simplement.
|
||||
|
||||
## L'autre méthode : créer un dossier en créant un fichier
|
||||
|
||||
**Ajouter un fichier → Nouveau fichier**, puis tapez un chemin dans le champ du nom :
|
||||
|
||||
```
|
||||
rapports/2026/janvier.md
|
||||
```
|
||||
|
||||
Les dossiers et le fichier sont créés ensemble. Utilisez ceci quand vous connaissez déjà le premier fichier.
|
||||
|
||||
## Des règles de nommage qui évitent bien des ennuis
|
||||
|
||||
| À éviter | À utiliser |
|
||||
|----------|------------|
|
||||
| `Devoir Réseau (1)` | `network-lab-01` |
|
||||
| `Mes Notes` | `mes-notes` ou `notes` |
|
||||
| `images et pièces jointes` | `assets` |
|
||||
|
||||
Les noms de dossier avec des **espaces** ou des parenthèses compliquent le partage de liens, et les chemins d'images relatifs dans Markdown deviennent plus fragiles. Minuscules, chiffres et tirets sont toujours sûrs.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 03 — Ajouter et modifier des fichiers](../03-add-and-edit-files/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 05 — Supprimer fichiers et répertoires](../05-delete-files/readme.md) ➡
|
||||
@@ -0,0 +1,49 @@
|
||||
# 05 — Supprimer fichiers et répertoires
|
||||
|
||||
🌍 [English](../../en/05-delete-files/readme.md) · [Türkçe](../../tr/05-delete-files/readme.md) · [Deutsch](../../de/05-delete-files/readme.md) · **Français** · [Русский](../../ru/05-delete-files/readme.md)
|
||||
|
||||
Rien n'est jamais vraiment perdu : une suppression n'est qu'un commit de plus, et l'ancien contenu reste dans l'historique.
|
||||
|
||||
## Supprimer un fichier
|
||||
|
||||
1. Ouvrez le fichier.
|
||||
2. Cliquez sur le menu **…** en haut à droite de la vue du fichier.
|
||||
3. Choisissez **Supprimer ce fichier** (ou utilisez l'icône 🗑️ à côté du crayon d'édition).
|
||||
4. Écrivez un message de commit et cliquez sur **Valider les modifications**.
|
||||
|
||||
## Supprimer un dossier
|
||||
|
||||
1. Ouvrez le dossier.
|
||||
2. Cliquez sur le menu **…** à côté d'*Ajouter un fichier*.
|
||||
3. Choisissez **Supprimer ce répertoire**.
|
||||
4. Commitez.
|
||||
|
||||
Tout ce qui se trouve dans le dossier est retiré dans ce seul commit.
|
||||
|
||||
## Supprimer plusieurs fichiers d'un coup
|
||||
|
||||
Le navigateur supprime un chemin à la fois. Pour un grand ménage, travaillez depuis votre ordinateur (chapitre 10) :
|
||||
|
||||
```bash
|
||||
git rm -r ancien-dossier
|
||||
git commit -m "supprimer l'ancien dossier"
|
||||
git push
|
||||
```
|
||||
|
||||
## Récupérer un fichier supprimé
|
||||
|
||||
1. Ouvrez **Historique** sur le dossier qui le contenait, ou l'historique du dépôt.
|
||||
2. Trouvez le commit *précédant* la suppression.
|
||||
3. Ouvrez le fichier à ce commit et copiez le contenu, ou cliquez sur **Parcourir les sources à ce point** et recréez-le.
|
||||
|
||||
Tout ce qui a un jour été commité peut être récupéré. Ce que vous avez tapé dans l'éditeur sans jamais le commiter, non.
|
||||
|
||||
## Attention à
|
||||
|
||||
- **Supprimer le dossier au lieu du fichier** — vérifiez que le menu dit bien *fichier* quand vous visez un fichier.
|
||||
- **Les branches protégées** — si `main` est protégée, la suppression passe par une demande de fusion (chapitre 09).
|
||||
- **Les secrets** — supprimer un mot de passe d'un fichier ne le retire *pas* de l'historique. Changez le mot de passe lui-même.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 04 — Créer des répertoires](../04-create-directory/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 06 — Les bases de Markdown](../06-markdown-basics/readme.md) ➡
|
||||
@@ -0,0 +1,83 @@
|
||||
# 06 — Les bases de Markdown
|
||||
|
||||
🌍 [English](../../en/06-markdown-basics/readme.md) · [Türkçe](../../tr/06-markdown-basics/readme.md) · [Deutsch](../../de/06-markdown-basics/readme.md) · **Français** · [Русский](../../ru/06-markdown-basics/readme.md)
|
||||
|
||||
Markdown, c'est du texte brut avec quelques règles de ponctuation. Les fichiers terminés par `.md` sont rendus automatiquement, et un fichier nommé `readme.md` s'affiche sur la page de son dossier.
|
||||
|
||||
## Titres
|
||||
|
||||
```markdown
|
||||
# Titre
|
||||
## Section
|
||||
### Sous-section
|
||||
```
|
||||
|
||||
Laissez une ligne vide avant et après un titre.
|
||||
|
||||
## Texte
|
||||
|
||||
```markdown
|
||||
**gras** *italique* ~~barré~~ `code`
|
||||
```
|
||||
|
||||
Un simple retour à la ligne est ignoré. Pour commencer un nouveau paragraphe, laissez une ligne vide.
|
||||
|
||||
## Listes
|
||||
|
||||
```markdown
|
||||
- premier
|
||||
- deuxième
|
||||
- imbriqué (deux espaces)
|
||||
|
||||
1. étape un
|
||||
2. étape deux
|
||||
```
|
||||
|
||||
## Liens
|
||||
|
||||
```markdown
|
||||
[KabaForge](https://forge.kabaforce.com)
|
||||
[chapitre 04](../04-create-directory/readme.md)
|
||||
```
|
||||
|
||||
Pour les fichiers du même dépôt, écrivez de préférence des chemins relatifs — ils continuent de fonctionner sur toutes les branches.
|
||||
|
||||
## Code
|
||||
|
||||
Les blocs délimités conservent l'indentation et ajoutent la coloration. Écrivez le langage après les trois accents ouvrants :
|
||||
|
||||
~~~markdown
|
||||
```bash
|
||||
git status
|
||||
```
|
||||
~~~
|
||||
|
||||
## Tableaux
|
||||
|
||||
```markdown
|
||||
| Colonne | Signification |
|
||||
|---------|---------------|
|
||||
| `main` | branche par défaut |
|
||||
| `.md` | fichier Markdown |
|
||||
```
|
||||
|
||||
## Citations, filets, tâches
|
||||
|
||||
```markdown
|
||||
> Une note citée.
|
||||
|
||||
---
|
||||
|
||||
- [x] fait
|
||||
- [ ] pas encore fait
|
||||
```
|
||||
|
||||
## Conseils pratiques
|
||||
|
||||
- Prévisualisez avant de commiter : l'onglet **Aperçu** de l'éditeur affiche exactement ce que les autres verront.
|
||||
- Dans les documents longs, écrivez une phrase par ligne — les différences entre versions restent lisibles.
|
||||
- Les emoji fonctionnent directement : 📌 ✅ ⚠️
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 05 — Supprimer fichiers et répertoires](../05-delete-files/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 07 — Images et pièces jointes](../07-images-and-media/readme.md) ➡
|
||||
@@ -0,0 +1,71 @@
|
||||
# 07 — Images et pièces jointes
|
||||
|
||||
🌍 [English](../../en/07-images-and-media/readme.md) · [Türkçe](../../tr/07-images-and-media/readme.md) · [Deutsch](../../de/07-images-and-media/readme.md) · **Français** · [Русский](../../ru/07-images-and-media/readme.md)
|
||||
|
||||
## Mettre une image dans un document
|
||||
|
||||
1. Téléversez l'image à côté du document : ouvrez le dossier, **Ajouter un fichier → Téléverser un fichier**.
|
||||
2. Référencez-la depuis le fichier Markdown :
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
Le texte entre crochets est la description affichée si l'image ne peut pas se charger, et lue par les lecteurs d'écran. Écrivez une vraie description, pas « image ».
|
||||
|
||||
## Où ranger les images
|
||||
|
||||
Une organisation prévisible qui marche toujours :
|
||||
|
||||
```
|
||||
projet/
|
||||
readme.md
|
||||
assets/
|
||||
topologie.png
|
||||
baie.jpg
|
||||
```
|
||||
|
||||
et dans `readme.md` :
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
## Nommage — la seule règle à retenir
|
||||
|
||||
Utilisez des noms en minuscules et sans espaces pour les **dossiers** et les fichiers image :
|
||||
|
||||
| Fragile | Sûr |
|
||||
|---------|-----|
|
||||
| `Capture d'écran.PNG` | `capture-ecran.png` |
|
||||
| `1-) Notes Inter-VLAN/` | `01-inter-vlan/` |
|
||||
|
||||
Si un nom contient malgré tout des espaces, écrivez-les `%20` dans le lien :
|
||||
|
||||
```markdown
|
||||
|
||||
```
|
||||
|
||||
## Contrôler la taille
|
||||
|
||||
Markdown n'a pas d'option de taille : utilisez une simple balise HTML au besoin.
|
||||
|
||||
```markdown
|
||||
<img src="assets/topologie.png" alt="Topologie réseau" width="600">
|
||||
```
|
||||
|
||||
## Lier un fichier au lieu de l'afficher
|
||||
|
||||
Enlevez le point d'exclamation et vous obtenez un lien de téléchargement :
|
||||
|
||||
```markdown
|
||||
[Fichier Packet Tracer](main.pkt)
|
||||
```
|
||||
|
||||
## Pièces jointes dans les tickets
|
||||
|
||||
Pendant la rédaction d'un ticket ou d'un commentaire, glissez un fichier dans la zone de texte. Il est téléversé et le lien inséré pour vous. Utilisez ceci pour les captures d'écran et les journaux qui n'ont pas leur place dans le dépôt lui-même.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 06 — Les bases de Markdown](../06-markdown-basics/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 08 — Commits et historique](../08-commits-and-history/readme.md) ➡
|
||||
@@ -0,0 +1,46 @@
|
||||
# 08 — Commits et historique
|
||||
|
||||
🌍 [English](../../en/08-commits-and-history/readme.md) · [Türkçe](../../tr/08-commits-and-history/readme.md) · [Deutsch](../../de/08-commits-and-history/readme.md) · **Français** · [Русский](../../ru/08-commits-and-history/readme.md)
|
||||
|
||||
Un commit est une étape enregistrée : ce qui a changé, qui l'a changé, quand et pourquoi.
|
||||
|
||||
## Écrire un bon message
|
||||
|
||||
```
|
||||
ajouter les notes de configuration VLAN
|
||||
corriger l'adresse de passerelle erronée dans le readme
|
||||
supprimer la capture de paquets inutilisée
|
||||
```
|
||||
|
||||
- Une ligne, au présent, sans point final.
|
||||
- Dites *ce que fait* la modification, pas « mise à jour » ou « corrections diverses ».
|
||||
- Une explication plus longue ? Mettez-la dans le champ description sous le résumé.
|
||||
|
||||
## Bien commiter
|
||||
|
||||
- **Une idée par commit.** Deux changements sans rapport, ce sont deux commits.
|
||||
- **Commitez souvent.** Les petits pas sont faciles à relire et faciles à annuler.
|
||||
- **Ne commitez jamais de mots de passe, de clés ni de jetons.** Les retirer plus tard ne les retire pas de l'historique — il faut changer le secret lui-même.
|
||||
|
||||
## Lire l'historique
|
||||
|
||||
| Où | Ce que vous obtenez |
|
||||
|----|---------------------|
|
||||
| Bouton **Historique** sur un dossier ou un fichier | Tous les commits qui l'ont touché |
|
||||
| La page d'un commit | Le diff complet : rouge supprimé, vert ajouté |
|
||||
| **Blame** sur un fichier | Quel commit a modifié chaque ligne en dernier |
|
||||
| Onglet **Activité** | Graphe des contributions dans le temps |
|
||||
|
||||
## Annuler
|
||||
|
||||
- **Un commit était mauvais** → ouvrez-le, cliquez sur **Revert**. Cela crée un nouveau commit qui l'annule ; rien n'est effacé.
|
||||
- **Un fichier était mauvais** → ouvrez son historique, affichez la bonne version, recopiez le contenu et commitez.
|
||||
- **Un commit n'est pas encore poussé** (travail depuis votre ordinateur) → `git commit --amend` pour corriger le dernier avant de le partager.
|
||||
|
||||
## Comparer
|
||||
|
||||
Ajoutez `/compare/main...ma-branche` à l'URL du dépôt, ou utilisez le bouton **Comparer**, pour voir toutes les différences entre deux branches ou étiquettes.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 07 — Images et pièces jointes](../07-images-and-media/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 09 — Branches et demandes de fusion](../09-branches-and-pull-requests/readme.md) ➡
|
||||
@@ -0,0 +1,58 @@
|
||||
# 09 — Branches et demandes de fusion
|
||||
|
||||
🌍 [English](../../en/09-branches-and-pull-requests/readme.md) · [Türkçe](../../tr/09-branches-and-pull-requests/readme.md) · [Deutsch](../../de/09-branches-and-pull-requests/readme.md) · **Français** · [Русский](../../ru/09-branches-and-pull-requests/readme.md)
|
||||
|
||||
Une branche est une copie sûre du projet où vous pouvez travailler sans déranger `main`. Une demande de fusion (pull request) est la demande de ramener ce travail.
|
||||
|
||||
## Quand une branche est nécessaire
|
||||
|
||||
- La modification est assez grosse pour qu'un travail à moitié fait casse des choses.
|
||||
- Quelqu'un devrait la relire avant sa mise en ligne.
|
||||
- Vous voulez tester une idée et pouvoir la jeter.
|
||||
|
||||
Pour une faute de frappe dans un document, commiter directement sur `main` convient très bien.
|
||||
|
||||
## Créer une branche dans le navigateur
|
||||
|
||||
Au moment de commiter (chapitre 03), choisissez **Créer une nouvelle branche pour ce commit et ouvrir une demande de fusion**, nommez la branche, puis commitez. Les bons noms décrivent le travail :
|
||||
|
||||
```
|
||||
docs/notes-vlan
|
||||
fix/passerelle-erronee
|
||||
feature/export-rapport
|
||||
```
|
||||
|
||||
## Ouvrir une demande de fusion
|
||||
|
||||
1. Allez dans **Demandes de fusion → Nouvelle demande de fusion**.
|
||||
2. Choisissez la branche source (la vôtre) et la cible (`main`).
|
||||
3. Titre = ce que fait la modification. Description = pourquoi, plus ce que les relecteurs doivent vérifier.
|
||||
4. Cliquez sur **Créer la demande de fusion**.
|
||||
|
||||
## Relecture
|
||||
|
||||
- Les relecteurs commentent ligne par ligne depuis l'onglet **Fichiers modifiés**.
|
||||
- Poussez d'autres commits sur la même branche — la demande de fusion se met à jour toute seule.
|
||||
- Une fois approuvée, cliquez sur **Fusionner**, puis supprimez la branche.
|
||||
|
||||
## Conflits de fusion
|
||||
|
||||
Si `main` a modifié les mêmes lignes que vous, KabaForge vous demande de résoudre. Depuis votre ordinateur :
|
||||
|
||||
```bash
|
||||
git switch ma-branche
|
||||
git fetch origin
|
||||
git merge origin/main
|
||||
# ouvrez les fichiers marqués, gardez les bonnes lignes
|
||||
git add .
|
||||
git commit
|
||||
git push
|
||||
```
|
||||
|
||||
## Protéger `main`
|
||||
|
||||
**Paramètres → Branches → Ajouter une règle** : exiger une demande de fusion et des approbations avant que quoi que ce soit n'arrive sur `main`. Recommandé dès que plus d'une personne travaille dans le dépôt.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 08 — Commits et historique](../08-commits-and-history/readme.md) · 📚 [Sommaire](../README.md) · [Suivant: 10 — Travailler depuis votre ordinateur](../10-clone-and-tokens/readme.md) ➡
|
||||
@@ -0,0 +1,75 @@
|
||||
# 10 — Travailler depuis votre ordinateur
|
||||
|
||||
🌍 [English](../../en/10-clone-and-tokens/readme.md) · [Türkçe](../../tr/10-clone-and-tokens/readme.md) · [Deutsch](../../de/10-clone-and-tokens/readme.md) · **Français** · [Русский](../../ru/10-clone-and-tokens/readme.md)
|
||||
|
||||
Le navigateur suffit pour des documents. Pour le vrai travail — beaucoup de fichiers à la fois, ou exécuter le code — copiez le dépôt sur votre machine.
|
||||
|
||||
## Obtenir une copie
|
||||
|
||||
Cliquez sur le bouton **Cloner** de la page du dépôt et copiez l'adresse.
|
||||
|
||||
```bash
|
||||
git clone https://forge.kabaforce.com/proprietaire/projet.git
|
||||
cd projet
|
||||
```
|
||||
|
||||
## La boucle quotidienne
|
||||
|
||||
```bash
|
||||
git pull # récupérer ce que les autres ont changé
|
||||
# ... modifier les fichiers ...
|
||||
git status # qu'est-ce que j'ai changé ?
|
||||
git add . # préparer les modifications
|
||||
git commit -m "ajouter les notes d'installation"
|
||||
git push # les envoyer à KabaForge
|
||||
```
|
||||
|
||||
Si `git push` est refusé, c'est que quelqu'un a poussé avant vous : lancez `git pull`, résolvez ce qu'il signale, puis poussez de nouveau.
|
||||
|
||||
## S'authentifier en ligne de commande
|
||||
|
||||
Le mot de passe de votre KabaForce ID ne fonctionne pas en HTTPS. Créez plutôt un jeton :
|
||||
|
||||
1. **Avatar → Paramètres → Applications → Générer un nouveau jeton**.
|
||||
2. Donnez-lui un nom et seulement les permissions nécessaires (`repo` suffit en général).
|
||||
3. Copiez-le une fois — il ne sera plus jamais affiché.
|
||||
4. Quand git demande un mot de passe, collez le jeton.
|
||||
|
||||
Pour ne le saisir qu'une seule fois :
|
||||
|
||||
```bash
|
||||
git config --global credential.helper store
|
||||
```
|
||||
|
||||
## SSH plutôt que des jetons
|
||||
|
||||
1. Créez une clé si vous n'en avez pas : `ssh-keygen -t ed25519`
|
||||
2. Copiez `~/.ssh/id_ed25519.pub`.
|
||||
3. **Avatar → Paramètres → Clés SSH → Ajouter une clé**, collez-la.
|
||||
4. Clonez avec l'adresse SSH affichée sous **Cloner**.
|
||||
|
||||
Plus aucune demande de mot de passe ensuite.
|
||||
|
||||
## Compléments utiles
|
||||
|
||||
| Besoin | Commande |
|
||||
|--------|----------|
|
||||
| Voir l'historique | `git log --oneline --graph` |
|
||||
| Annuler les modifications locales d'un fichier | `git restore fichier.md` |
|
||||
| Changer de branche | `git switch nom-de-branche` |
|
||||
| Créer une branche | `git switch -c nouvelle-branche` |
|
||||
|
||||
## Automatisation
|
||||
|
||||
Les dépôts peuvent aussi être lus et écrits via l'API KabaForge avec le même jeton :
|
||||
|
||||
```bash
|
||||
curl -H "Authorization: token VOTRE_JETON" \
|
||||
https://forge.kabaforce.com/api/v1/repos/proprietaire/projet/contents
|
||||
```
|
||||
|
||||
Traitez les jetons comme des mots de passe : n'en mettez jamais un dans un fichier que vous commitez.
|
||||
|
||||
---
|
||||
|
||||
⬅ [Précédent: 09 — Branches et demandes de fusion](../09-branches-and-pull-requests/readme.md) · 📚 [Sommaire](../README.md)
|
||||
@@ -0,0 +1,38 @@
|
||||
# 📘 Guide KabaForge — Français
|
||||
|
||||
Des recettes courtes et pratiques pour utiliser KabaForge — aucune expérience préalable requise.
|
||||
|
||||
🌍 [English](../en/README.md) · [Türkçe](../tr/README.md) · [Deutsch](../de/README.md) · **Français** · [Русский](../ru/README.md)
|
||||
|
||||
---
|
||||
|
||||
## 📚 Chapitres
|
||||
|
||||
| # | Chapitre |
|
||||
|---|----------|
|
||||
| 01 | [Premiers pas](01-getting-started/readme.md) |
|
||||
| 02 | [Créer un dépôt](02-create-repository/readme.md) |
|
||||
| 03 | [Ajouter et modifier des fichiers](03-add-and-edit-files/readme.md) |
|
||||
| 04 | [Créer des répertoires](04-create-directory/readme.md) |
|
||||
| 05 | [Supprimer fichiers et répertoires](05-delete-files/readme.md) |
|
||||
| 06 | [Les bases de Markdown](06-markdown-basics/readme.md) |
|
||||
| 07 | [Images et pièces jointes](07-images-and-media/readme.md) |
|
||||
| 08 | [Commits et historique](08-commits-and-history/readme.md) |
|
||||
| 09 | [Branches et demandes de fusion](09-branches-and-pull-requests/readme.md) |
|
||||
| 10 | [Travailler depuis votre ordinateur](10-clone-and-tokens/readme.md) |
|
||||
|
||||
---
|
||||
|
||||
## 🚀 La version en 60 secondes
|
||||
|
||||
1. Connectez-vous sur [forge.kabaforce.com](https://forge.kabaforce.com) avec votre identifiant KabaForce.
|
||||
2. Cliquez sur **+ → Nouveau dépôt**, donnez-lui un nom, cochez *Initialiser le dépôt*.
|
||||
3. Ouvrez le dépôt, cliquez sur **Ajouter un fichier → Nouveau fichier**, écrivez quelque chose, cliquez sur **Valider les modifications**.
|
||||
4. Nommez un fichier `readme.md` : il s'affiche automatiquement sur la page du dossier.
|
||||
|
||||
---
|
||||
|
||||
## 💡 Comment lire ce guide
|
||||
|
||||
Les chapitres sont indépendants. Allez directement à celui dont vous avez besoin ;
|
||||
chacun tient sur une page et se lit en quelques minutes.
|
||||
Reference in New Issue
Block a user