Introducción
Waymark publica guías compactas de paseos. La edición de Harbour Loop que sigue recibiendo soporte todavía tiene un enlace defectuoso a la guía completa. Se está desarrollando un nuevo diseño Explorer y tu directorio de trabajo principal contiene tanto trabajo preparado como un borrador adicional sin preparar. Una nota privada también debe seguir siendo privada.
Primero usarás una descarga de inicio rápido que funciona para establecer un resultado normal. Después abrirás la rama de mantenimiento existente en un árbol de trabajo vinculado junto a tu trabajo sin terminar, repararás su pequeña configuración de enlace y verificarás una descarga útil de la edición antigua sin cambiar el borrador original.
Los requisitos previos son la navegación básica por la terminal, los commits, las ramas y la lectura sencilla de log/diff. No se requiere programar sitios web, una cuenta de un servicio alojado ni un servidor Git. Usa las pestañas preparadas Workspace y Release Desk. Se trata de árboles de trabajo Git reales y una vista previa HTTP en una única máquina de formación. La vista previa lee commits de ramas con nombre, no archivos sin guardar en commits; no es un despliegue en producción. Las rutas de los paseos, las identidades y los textos de las guías son sintéticos. La duración de 35 minutos es una estimación del autor.
Inspecciona la versión y abre su árbol de trabajo
En este paso, establecerás la descarga normal, observarás el enlace defectuoso y comprenderás exactamente qué trabajo sin terminar debe permanecer intacto.
Abre Release Desk. En la vista general de dos tarjetas, haz clic en Open supported release. La página debería mostrar Harbour Loop, Waymark Pocket Edition 1.0, 3.2 km y North Pier. Esta edición compacta sigue recibiendo soporte; Explorer no va a reemplazar su identidad ni el contenido de su guía.
Haz clic en Download quick start. Abre quick-start.txt desde la lista de descargas de tu navegador. Debería identificar Harbour Loop, indicar que el encuentro es en North Pier y mencionar agua y calzado cómodo. Esta descarga que funciona establece el resultado normal.
Haz clic en Download full guide. Se espera una página 404 que diga Guide not found. La versión seleccionada no tiene ningún archivo en ese enlace; esto es distinto de no poder conectarse al sitio. Haz clic en Back to release en la página de error. Más adelante inspeccionarás el enlace bajo control de versiones y lo repararás.
Haz clic en All releases en la página de la versión con soporte y después en Open development preview. La página muestra Waymark Explorer Edition 2.0, Harbour Loop, 3.2 km y North Pier, con la identidad y el formato de la nueva edición. Esos cambios de diseño no están aprobados y no son requisitos de la edición con soporte. Usa All releases para volver.
Cambia a Workspace y entra en el directorio de trabajo original:
cd /home/labex/project/release-desk/editor
cd cambia solo el directorio de esta terminal. Si escribes mal una ruta, usa pwd para mostrar dónde estás y ls para listar ese directorio; después repite el comando cd completo de arriba. Los errores habituales de navegación no requieren reiniciar la VM.
Configura una identidad de autor solo para este repositorio. --local evita cambiar la configuración global; las comillas mantienen unido un nombre que contiene espacios. Estos valores sintéticos son ejemplos que puedes reemplazar. Los árboles de trabajo vinculados de este repositorio comparten la configuración local del repositorio, a diferencia de sus índices separados:
git config --local user.name "Guide Editor"
git config --local user.email "guides@example.com"
Inspecciona el estado. --short muestra una lista compacta; branch --show-current muestra la rama extraída:
git status --short
git branch --show-current
Se esperan MM preview.txt, ?? private-note.txt y la rama main. En el estado abreviado de dos columnas, la primera M significa una modificación preparada y la segunda M una modificación adicional del archivo de trabajo. ?? significa un archivo sin seguimiento.
Lee los dos cambios distintos. --no-pager muestra la salida directamente en lugar de abrir un visor desplazable. --cached compara el índice, el área de preparación de Git, con el commit actual. Sin esa opción, diff compara los archivos de trabajo con el índice. -- separa las opciones de la ruta de archivo que sigue:
git --no-pager diff --cached -- preview.txt
git --no-pager diff -- preview.txt
La incorporación preparada es Plan: add dusk photographs.. La incorporación adicional sin preparar es Draft: try the violet cover.. Ambas versiones deben conservarse por separado; guardarlas en un commit, descartarlas o unificarlas no es la tarea de mantenimiento.
Lee la nota privada sin modificarla. cat muestra el archivo:
cat private-note.txt
Conserva Do not publish supplier prices. como nota sin seguimiento. Un estado aparentemente limpio obtenido eliminando este trabajo no es un resultado correcto. A continuación, da al mantenimiento su propio directorio e índice.
Abre un árbol de trabajo de mantenimiento separado
En este paso, abrirás la rama con soporte existente junto al trabajo sin terminar de main. También reconocerás un rechazo inocuo cuando una rama ya está en uso.
Permanece en Workspace, en /home/labex/project/release-desk/editor. Enumera las ramas locales:
git --no-pager branch
main es la actual y release/1.0 ya existe. Un árbol de trabajo vinculado, o linked worktree, es otro directorio de trabajo conectado al mismo repositorio. Comparte commits y referencias de ramas, pero mantiene su propia rama extraída, HEAD e índice. Crear uno no guarda temporalmente ni descarta el borrador del directorio principal.
Primero observa un caso protegido. Se espera que el siguiente comando falle con main is already checked out y un estado distinto de cero. Ejecútalo por separado. .. significa el directorio padre, así que el directorio solicitado estaría junto a editor:
git worktree add ../busy-preview main
Git se niega a abrir por segunda vez la rama que ya está extraída. No añadas una opción de forzado. Inspecciona la entrada existente:
git worktree list
Identifica editor en main. No hace falta ningún reset correctivo. Ahora abre explícitamente la rama de mantenimiento existente y separada:
git worktree add ../supported-v1 release/1.0
Aquí ../supported-v1 es el nuevo directorio de trabajo y release/1.0 es la rama existente que se abrirá. Omitir la rama podría crear una rama nueva desde un punto de partida incorrecto, así que conserva ambos argumentos.
Enumera los dos árboles de trabajo reales y entra en el de mantenimiento:
git worktree list
cd ../supported-v1
git branch --show-current
git status --short
Se espera release/1.0 y ninguna salida de archivos modificados. Este índice limpio está separado del trabajo sin terminar de main. La entrada .git de un árbol de trabajo vinculado suele ser un archivo pequeño que apunta a los metadatos compartidos del repositorio; no es un clon independiente.
Lee su identidad con soporte y su configuración de descarga:
cat release.txt
cat full-guide.path
ls downloads
La identidad sigue siendo Pocket Edition 1.0. La configuración del enlace es /downloads/harbour-guid-v1.txt, pero el archivo real de la guía completa es harbour-guide-v1.txt: al enlace le falta una e. Conserva los archivos normales, el formato y todo el contenido no relacionado. El punto de comprobación evalúa la relación vinculada nativa y la conservación de main, no simplemente la existencia de una carpeta.
Repara el enlace y conserva el borrador
En este paso, corregirás un enlace bajo control de versiones, registrarás un commit de mantenimiento, probarás la guía antigua completa y confirmarás que el trabajo original preparado y sin preparar sigue separado.
Permanece en Workspace, en /home/labex/project/release-desk/supported-v1. El archivo de configuración contiene una ruta absoluta del sitio web y un salto de línea. printf muestra un valor mediante un formato: %s significa texto y \n añade el salto de línea. Las comillas simples conservan ese formato. > reemplaza únicamente el archivo indicado con el valor mostrado. Úsalo solo para este pequeño archivo de configuración:
printf '%s\n' '/downloads/harbour-guide-v1.txt' > full-guide.path
Revisa la corrección de una línea antes de prepararla:
git --no-pager diff -- full-guide.path
Se espera únicamente que harbour-guid-v1.txt cambie a harbour-guide-v1.txt. Prepara ese archivo e inspecciona el parche preparado:
git add full-guide.path
git --no-pager diff --cached -- full-guide.path
add escribe el archivo de este árbol de trabajo en el índice de este árbol de trabajo. No prepara el borrador de main. Registra la corrección; -m proporciona directamente un mensaje con significado y las comillas conservan sus espacios:
git commit -m "Repair the supported Harbour guide link"
Revisa el historial de mantenimiento. --oneline muestra una línea breve por commit y --decorate muestra las etiquetas de ramas y tags:
git --no-pager log --oneline --decorate
git status --short
Debería haber una corrección directamente por encima del commit original con soporte, ningún commit del rediseño Explorer y un árbol de trabajo de mantenimiento limpio. La etiqueta preparada supported-start marca la punta original de mantenimiento; consérvala sin cambios. Un commit mueve esta rama con soporte, que es lo que lee su vista previa local. En este escenario no se realiza ningún push remoto ni despliegue alojado.
Cambia a Release Desk. Haz clic en Release Desk en la cabecera para volver a la vista general y después en Open supported release. Comprueba Pocket Edition 1.0, Harbour Loop, 3.2 km y North Pier.
Busca Pocket Edition 1.0 a la izquierda y los dos enlaces de descarga a la derecha; en una pantalla estrecha, el panel de descargas está debajo de los detalles de la versión.
Haz clic en Download full guide y abre la descarga real harbour-guide-v1.txt desde la lista de descargas del navegador. Debe incluir el inicio en North Pier, las tres indicaciones numeradas que pasan por Clock Steps, el antiguo cobertizo de barcos y Anchor Square, la distancia de 3.2 km y el recordatorio final sobre los caminos y la basura. Una respuesta 200 o un nombre de archivo por sí solos no demostrarían que el contenido está completo.
Haz clic otra vez en Download quick start y confirma que la lista breve original siga funcionando. Desde All releases, abre la vista previa de desarrollo y confirma que Explorer Edition 2.0 no haya cambiado. Vuelve con All releases.
Cambia a Workspace y vuelve al directorio original:
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
Se esperan main, los estados originales MM preview.txt y ?? private-note.txt, la misma frase preparada del plan fotográfico, la misma frase separada sin preparar de la cubierta violeta y la nota privada sin cambios. El punto de comprobación verifica la rama corregida y las descargas reales junto con estos datos conservados. Deja disponible el árbol de trabajo vinculado; eliminarlo no forma parte de la entrega.
Resumen
Abriste una rama de mantenimiento existente en un árbol de trabajo vinculado real, reconociste el rechazo protector por rama en uso y reparaste una descarga con soporte sin alterar el trabajo original preparado y sin preparar. La edición antigua, ambas descargas útiles y la nota privada permanecieron intactas.
El siguiente laboratorio guiado, inicializado de forma independiente, reutiliza una corrección aislada existente en desarrollo en lugar de volver a editarla. Añade cherry-pick y mantiene las mismas decisiones sobre la rama y la conservación del borrador.
