Introduction
Waymark publie des guides de promenade compacts. Le lien vers le guide complet de l'édition Harbour Loop encore prise en charge est toujours défectueux. Une nouvelle présentation Explorer est en développement, et votre répertoire de travail principal contient à la fois du travail préparé dans l'index et un brouillon supplémentaire non préparé. Une note privée doit aussi rester privée.
Vous utiliserez d'abord un téléchargement de démarrage rapide fonctionnel pour établir le résultat normal. Vous ouvrirez ensuite la branche de maintenance existante dans un worktree lié à côté de votre travail inachevé, réparerez son petit paramètre de lien et vérifierez le téléchargement utilisable de l'ancienne édition sans modifier le brouillon d'origine.
Les prérequis sont les bases de la navigation dans le terminal, des commits, des branches et de la lecture simple de log/diff. Aucune programmation de site web, aucun compte hébergé ni serveur Git n'est nécessaire. Utilisez les onglets préparés Workspace et Release Desk. Ce sont de véritables worktrees Git et un aperçu HTTP sur une seule machine de formation. L'aperçu lit les commits des branches nommées, et non les fichiers non enregistrés dans un commit ; ce n'est pas un déploiement en production. Les itinéraires, les identités et les textes des guides sont fictifs. La durée de 35 minutes est une estimation de l'auteur.
Inspecter la version et ouvrir son worktree
Dans cette étape, établissez le téléchargement normal, observez le lien défectueux et comprenez précisément quel travail inachevé doit rester intact.
Ouvrez Release Desk. Dans la vue d'ensemble à deux cartes, cliquez sur Open supported release. La page doit afficher Harbour Loop, Waymark Pocket Edition 1.0, 3.2 km et North Pier. Cette édition compacte est toujours prise en charge ; son identité et le contenu de son guide ne sont pas remplacés par Explorer.
Cliquez sur Download quick start. Ouvrez quick-start.txt depuis la liste des téléchargements de votre navigateur. Il doit identifier Harbour Loop, vous demander de vous retrouver à North Pier et mentionner de l'eau et des chaussures confortables. Ce téléchargement fonctionnel établit le résultat normal.
Cliquez sur Download full guide. Une page 404 indiquant Guide not found est attendue. La version sélectionnée ne possède aucun fichier à ce lien ; cela diffère d'une impossibilité de se connecter au site. Cliquez sur Back to release sur la page d'erreur. Vous inspecterez le lien versionné et le réparerez plus tard.
Cliquez sur All releases sur la page de la version prise en charge, puis sur Open development preview. La page affiche Waymark Explorer Edition 2.0, Harbour Loop, 3.2 km et North Pier, avec l'identité et le format de la nouvelle édition. Ces changements de présentation ne sont pas approuvés ; ils ne constituent pas des exigences pour l'édition prise en charge. Utilisez All releases pour revenir.
Passez à Workspace et entrez dans le répertoire de travail d'origine :
cd /home/labex/project/release-desk/editor
cd change uniquement le répertoire de ce terminal. Si vous saisissez mal un chemin, utilisez pwd pour afficher votre emplacement et ls pour lister ce répertoire, puis répétez la commande cd complète ci-dessus. Les erreurs de navigation courantes ne nécessitent pas de réinitialiser la VM.
Définissez une identité d'auteur uniquement pour ce dépôt. --local évite de modifier les paramètres globaux ; les guillemets maintiennent ensemble un nom contenant des espaces. Ces valeurs fictives sont des exemples que vous pouvez remplacer. La configuration propre au dépôt est partagée par ses worktrees liés, contrairement à leurs index séparés :
git config --local user.name "Guide Editor"
git config --local user.email "guides@example.com"
Inspectez l'état. --short affiche une liste compacte ; branch --show-current affiche la branche extraite :
git status --short
git branch --show-current
Vous devez obtenir MM preview.txt, ?? private-note.txt et la branche main. Dans l'état abrégé à deux colonnes, le premier M signifie une modification préparée et le second M une modification supplémentaire du fichier de travail. ?? signifie un fichier non suivi.
Lisez les deux modifications distinctes. --no-pager affiche directement la sortie au lieu d'ouvrir un visualiseur défilant. --cached compare l'index, la zone de préparation de Git, au commit courant. Sans cette option, diff compare les fichiers de travail à l'index. -- sépare les options du chemin de fichier qui suit :
git --no-pager diff --cached -- preview.txt
git --no-pager diff -- preview.txt
L'ajout préparé est Plan: add dusk photographs.. L'ajout supplémentaire non préparé est Draft: try the violet cover.. Les deux versions doivent survivre séparément ; les enregistrer dans un commit, les supprimer ou les réduire à un seul état n'est pas la tâche de maintenance.
Lisez la note privée sans la modifier. cat affiche le fichier :
cat private-note.txt
Conservez Do not publish supplier prices. comme note non suivie. Un état qui semble propre parce que ce travail a été supprimé n'est pas une réussite. Donnez maintenant à la maintenance son propre répertoire et son propre index.
Ouvrir un worktree de maintenance séparé
Dans cette étape, ouvrez la branche prise en charge existante à côté du travail inachevé de main. Vous reconnaîtrez aussi un refus sans conséquence lorsqu'une branche est déjà utilisée.
Restez dans Workspace, dans /home/labex/project/release-desk/editor. Listez les branches locales :
git --no-pager branch
main est la branche courante et release/1.0 existe déjà. Un worktree lié est un autre répertoire de travail rattaché au même dépôt. Il partage les commits et les références de branche, tout en conservant sa propre branche extraite, son propre HEAD et son propre index. Sa création ne met pas de côté et ne supprime pas le brouillon du répertoire principal.
Observez d'abord un cas protégé. La commande suivante doit échouer avec main is already checked out et un code non nul. Exécutez-la seule. .. désigne le répertoire parent : le répertoire demandé serait donc à côté de editor :
git worktree add ../busy-preview main
Git refuse d'ouvrir une seconde fois la branche déjà extraite. N'ajoutez pas d'option de forçage. Inspectez l'entrée existante :
git worktree list
Elle identifie editor sur main. Aucun reset correctif n'est nécessaire. Ouvrez maintenant explicitement la branche de maintenance distincte et existante :
git worktree add ../supported-v1 release/1.0
Ici, ../supported-v1 est le nouveau répertoire de travail et release/1.0 est la branche existante à ouvrir. Omettre la branche pourrait créer une nouvelle branche à partir d'un mauvais point de départ : conservez donc les deux arguments.
Listez les deux véritables worktrees et entrez dans celui de maintenance :
git worktree list
cd ../supported-v1
git branch --show-current
git status --short
Vous devez obtenir release/1.0 et aucune sortie de fichier modifié. Cet index propre est séparé du travail inachevé de main. L'entrée .git d'un worktree lié est normalement un petit fichier pointant vers les métadonnées partagées du dépôt ; ce n'est pas un clone indépendant.
Lisez son identité de version prise en charge et son paramètre de téléchargement :
cat release.txt
cat full-guide.path
ls downloads
L'identité reste Pocket Edition 1.0. Le paramètre de lien est /downloads/harbour-guid-v1.txt, mais le véritable fichier du guide complet est harbour-guide-v1.txt : il manque un e dans le lien. Conservez les fichiers ordinaires, leur format et tout le contenu sans rapport. Le point de contrôle évalue la relation native de worktree lié et la préservation de main, et non la simple existence d'un dossier.
Réparer le lien et conserver le brouillon
Dans cette étape, corrigez un lien versionné, enregistrez un commit de maintenance, testez l'ancien guide complet et confirmez que le travail préparé et non préparé d'origine reste séparé.
Restez dans Workspace, dans /home/labex/project/release-desk/supported-v1. Le fichier de paramètre contient un chemin de site web absolu et un saut de ligne. printf affiche une valeur selon un format : %s signifie du texte et \n ajoute le saut de ligne. Les apostrophes préservent ce format. > remplace uniquement le fichier nommé par la valeur affichée. Utilisez-le uniquement pour ce petit fichier de paramètre :
printf '%s\n' '/downloads/harbour-guide-v1.txt' > full-guide.path
Examinez la correction d'une ligne avant de la préparer :
git --no-pager diff -- full-guide.path
Seul le passage de harbour-guid-v1.txt à harbour-guide-v1.txt doit apparaître. Préparez ce fichier et inspectez le patch préparé :
git add full-guide.path
git --no-pager diff --cached -- full-guide.path
add écrit le fichier de ce worktree dans l'index de ce worktree. Il ne prépare pas le brouillon de main. Enregistrez la correction ; -m fournit directement un message pertinent, les guillemets conservant ses espaces :
git commit -m "Repair the supported Harbour guide link"
Examinez l'historique de maintenance. --oneline affiche une ligne courte par commit et --decorate affiche les étiquettes de branche et de tag :
git --no-pager log --oneline --decorate
git status --short
Il doit y avoir une correction directement au-dessus du commit pris en charge d'origine, aucun commit de refonte Explorer et un worktree de maintenance propre. Le tag préparé supported-start marque la pointe de maintenance d'origine ; gardez-le inchangé. Un commit fait avancer cette branche prise en charge, que lit son aperçu local. Aucun envoi distant ni déploiement hébergé ne fait partie de ce scénario.
Passez à Release Desk. Cliquez sur Release Desk dans l'en-tête pour revenir à la vue d'ensemble, puis sur Open supported release. Vérifiez Pocket Edition 1.0, Harbour Loop, 3.2 km et North Pier.
Repérez Pocket Edition 1.0 à gauche et les deux liens de téléchargement à droite ; sur un écran étroit, le panneau de téléchargement se trouve sous les détails de la version.
Cliquez sur Download full guide et ouvrez le véritable téléchargement harbour-guide-v1.txt depuis la liste des téléchargements du navigateur. Il doit inclure le départ de North Pier, les trois indications numérotées passant par Clock Steps, l'ancien hangar à bateaux et Anchor Square, la distance de 3.2 km et le rappel final concernant les sentiers et les déchets. Une réponse 200 ou un nom de fichier seul ne prouverait pas que le contenu est complet.
Cliquez de nouveau sur Download quick start et confirmez que la courte liste de préparation d'origine fonctionne toujours. Depuis All releases, ouvrez l'aperçu de développement et confirmez qu'Explorer Edition 2.0 est inchangée. Revenez avec All releases.
Passez à Workspace et revenez au répertoire d'origine :
cd /home/labex/project/release-desk/editor
git branch --show-current
git status --short
git --no-pager diff --cached -- preview.txt
git --no-pager diff -- preview.txt
cat private-note.txt
Vous devez obtenir main, les états d'origine MM preview.txt et ?? private-note.txt, la même phrase préparée du plan photo, la même phrase distincte non préparée de la couverture violette et la note privée inchangée. Le point de contrôle vérifie la branche corrigée et les véritables téléchargements avec ces faits préservés. Laissez le worktree lié disponible ; sa suppression ne fait pas partie du livrable.
Résumé
Vous avez ouvert une branche de maintenance existante dans un véritable worktree lié, reconnu le refus protégeant une branche déjà utilisée et réparé un téléchargement pris en charge sans perturber le travail préparé et non préparé d'origine. L'ancienne édition, les deux téléchargements utiles et la note privée sont restés intacts.
L'atelier guidé suivant, initialisé indépendamment, réutilise une correction isolée existante du développement au lieu de la modifier à nouveau. Il ajoute cherry-pick en conservant les mêmes décisions de branche et de préservation du brouillon.
