Introdução
A Waymark publica guias compactos de caminhada. A edição de Harbour Loop que ainda recebe suporte tem um link quebrado para o guia completo. Um novo design Explorer está em desenvolvimento, e seu diretório de trabalho principal contém tanto trabalho preparado no índice quanto um rascunho adicional não preparado. Uma anotação particular também deve permanecer privada.
Primeiro, você usará um download de início rápido que funciona para estabelecer um resultado normal. Depois, abrirá a branch de manutenção existente em uma worktree vinculada ao lado do seu trabalho inacabado, corrigirá sua pequena configuração de link e verificará um download útil da edição antiga sem alterar o rascunho original.
Os pré-requisitos são navegação básica no terminal, commits, branches e leitura simples de log/diff. Não é necessário programar sites, ter uma conta hospedada nem configurar um servidor Git. Use as abas preparadas Workspace e Release Desk. São worktrees reais do Git e uma prévia HTTP em uma única máquina de treinamento. A prévia lê commits de branches nomeadas, não arquivos sem commit; não se trata de uma implantação em produção. Rotas, identidades e textos do guia são fictícios. A duração de 35 minutos é uma estimativa do autor.
Inspecione a Versão e Abra Sua Worktree
Nesta etapa, estabeleça o download normal, observe o link quebrado e compreenda exatamente qual trabalho inacabado deve permanecer intacto.
Abra Release Desk. Na visão geral com dois cartões, clique em Open supported release. A página deve mostrar Harbour Loop, Waymark Pocket Edition 1.0, 3.2 km e North Pier. Esta edição compacta ainda recebe suporte; sua identidade e o conteúdo do guia não serão substituídos pelo Explorer.
Clique em Download quick start. Abra quick-start.txt pela lista de Downloads do navegador. Ele deve identificar Harbour Loop, indicar o encontro em North Pier e mencionar água e calçados confortáveis. Esse download que funciona estabelece o resultado normal.
Clique em Download full guide. Espere uma página 404 dizendo Guide not found. A versão selecionada não tem um arquivo nesse link; isso é diferente de não conseguir se conectar ao site. Clique em Back to release na página de erro. Você inspecionará o link versionado e o corrigirá depois.
Clique em All releases na página da versão com suporte e depois em Open development preview. A página mostra Waymark Explorer Edition 2.0, Harbour Loop, 3.2 km e North Pier, com a identidade e o formato da nova edição. Essas mudanças de design não foram aprovadas e não são requisitos para a edição com suporte. Use All releases para voltar.
Mude para Workspace e entre no diretório de trabalho original:
cd /home/labex/project/release-desk/editor
cd altera apenas o diretório deste terminal. Se digitar um caminho incorretamente, use pwd para exibir onde está e ls para listar esse diretório; depois, repita o cd completo acima. Erros comuns de navegação não exigem restaurar a VM ao estado inicial.
Configure uma identidade de autor apenas para este repositório. --local evita alterar configurações globais; as aspas mantêm um nome com espaços como um único valor. Estes valores fictícios são exemplos que você pode substituir. A configuração local ao repositório é compartilhada por suas worktrees vinculadas, ao contrário dos índices separados delas:
git config --local user.name "Guide Editor"
git config --local user.email "guides@example.com"
Inspecione o estado. --short exibe uma lista compacta; branch --show-current exibe a branch em uso na cópia de trabalho:
git status --short
git branch --show-current
Espere MM preview.txt, ?? private-note.txt e a branch main. No status curto de duas colunas, o primeiro M significa uma modificação preparada e o segundo M significa uma modificação adicional no arquivo de trabalho. ?? significa um arquivo não rastreado.
Leia as duas alterações distintas. --no-pager exibe a saída diretamente em vez de abrir um visualizador com rolagem. --cached compara o índice, a área de preparação do Git, com o commit atual. Sem essa opção, diff compara os arquivos de trabalho com o índice. -- separa as opções do caminho de arquivo seguinte:
git --no-pager diff --cached -- preview.txt
git --no-pager diff -- preview.txt
A adição preparada é Plan: add dusk photographs.. A adição extra não preparada é Draft: try the violet cover.. As duas versões devem sobreviver separadamente; registrá-las em um commit, descartá-las ou fundi-las em um único estado não é a tarefa de manutenção.
Leia a anotação particular sem modificá-la. cat exibe o arquivo:
cat private-note.txt
Mantenha Do not publish supplier prices. como uma anotação não rastreada. Um status aparentemente limpo obtido pela remoção desse trabalho não é sucesso. A seguir, dê à manutenção seu próprio diretório e índice.
Abra uma Worktree de Manutenção Separada
Nesta etapa, abra a branch existente com suporte ao lado do trabalho inacabado da main. Você também reconhecerá uma recusa inofensiva quando uma branch já está em uso.
Permaneça em Workspace, em /home/labex/project/release-desk/editor. Liste as branches locais:
git --no-pager branch
main é a atual e release/1.0 já existe. Uma worktree vinculada é outro diretório de trabalho conectado ao mesmo repositório. Ela compartilha commits e referências de branches, mas mantém sua própria branch em uso, HEAD e índice. Criar uma não guarda temporariamente nem descarta o rascunho do diretório principal.
Primeiro, observe um caso protegido. Espera-se que o comando a seguir falhe com main is already checked out e um status diferente de zero. Execute-o separadamente. .. significa o diretório pai, portanto o diretório solicitado ficaria ao lado de editor:
git worktree add ../busy-preview main
O Git se recusa a abrir uma segunda vez a branch que já está em uso. Não adicione uma opção de força. Inspecione a entrada existente:
git worktree list
Ela identifica editor em main. Nenhum reset corretivo é necessário. Agora abra explicitamente a branch de manutenção separada já existente:
git worktree add ../supported-v1 release/1.0
Aqui, ../supported-v1 é o novo diretório de trabalho e release/1.0 é a branch existente a abrir. Omitir a branch poderia criar uma nova branch a partir do ponto inicial errado, portanto mantenha os dois argumentos.
Liste as duas worktrees reais e entre na de manutenção:
git worktree list
cd ../supported-v1
git branch --show-current
git status --short
Espere release/1.0 e nenhuma saída de arquivos alterados. Esse índice limpo é separado do trabalho inacabado da main. A entrada .git de uma worktree vinculada normalmente é um pequeno arquivo que aponta para metadados compartilhados do repositório; ela não é um clone independente.
Leia sua identidade da versão com suporte e a configuração de download:
cat release.txt
cat full-guide.path
ls downloads
A identidade continua sendo Pocket Edition 1.0. A configuração do link é /downloads/harbour-guid-v1.txt, mas o arquivo real do guia completo é harbour-guide-v1.txt: falta um e no link. Preserve os arquivos comuns, a formatação e todo o conteúdo não relacionado. O ponto de verificação avalia o vínculo nativo e a preservação da main, não apenas a existência de uma pasta.
Corrija o Link e Preserve o Rascunho
Nesta etapa, corrija um link versionado, registre um commit de manutenção, teste o guia antigo completo e confirme que o trabalho original preparado e não preparado permanece separado.
Permaneça em Workspace, em /home/labex/project/release-desk/supported-v1. O arquivo de configuração contém um caminho absoluto de site e uma quebra de linha. printf exibe um valor usando um formato: %s significa texto e \n adiciona a quebra de linha. As aspas simples preservam esse formato. > substitui apenas o arquivo nomeado pelo valor exibido. Use-o apenas para este pequeno arquivo de configuração:
printf '%s\n' '/downloads/harbour-guide-v1.txt' > full-guide.path
Revise a correção de uma linha antes de prepará-la:
git --no-pager diff -- full-guide.path
Espere apenas a mudança de harbour-guid-v1.txt para harbour-guide-v1.txt. Prepare esse arquivo e inspecione o patch preparado:
git add full-guide.path
git --no-pager diff --cached -- full-guide.path
add grava o arquivo desta worktree no índice desta worktree. Ele não prepara o rascunho da main. Registre a correção; -m fornece diretamente uma mensagem significativa, com aspas que preservam seus espaços:
git commit -m "Repair the supported Harbour guide link"
Revise o histórico de manutenção. --oneline mostra uma linha curta por commit e --decorate mostra rótulos de branches/tags:
git --no-pager log --oneline --decorate
git status --short
Deve haver uma correção diretamente acima do commit original da versão com suporte, nenhum commit de reformulação Explorer e uma worktree de manutenção limpa. A tag preparada supported-start marca a ponta original da manutenção; mantenha-a inalterada. Um commit move essa branch com suporte, que é o que sua prévia local lê. Nenhum push remoto nem implantação hospedada faz parte deste cenário.
Mude para Release Desk. Clique em Release Desk no cabeçalho para voltar à visão geral e depois em Open supported release. Confira Pocket Edition 1.0, Harbour Loop, 3.2 km e North Pier.
Procure Pocket Edition 1.0 à esquerda e os dois links de download à direita; em uma tela estreita, o painel de downloads fica abaixo dos detalhes da versão.
Clique em Download full guide e abra o download real harbour-guide-v1.txt pela lista de Downloads do navegador. Ele deve incluir o início em North Pier, as três instruções numeradas passando por Clock Steps, o antigo abrigo de barcos e Anchor Square, a distância de 3.2 km e o lembrete final sobre o caminho e o lixo. Uma resposta 200 ou apenas um nome de arquivo não comprovaria o conteúdo completo.
Clique em Download quick start novamente e confirme que a lista curta original ainda funciona. Em All releases, abra a prévia de desenvolvimento e confirme que Explorer Edition 2.0 está inalterada. Volte com All releases.
Mude para Workspace e volte ao diretório 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
Espere main, os originais MM preview.txt e ?? private-note.txt, a mesma frase preparada do plano de fotos, a mesma frase separada não preparada da capa violeta e a anotação particular inalterada. O ponto de verificação confere a branch corrigida e os downloads reais junto com esses fatos preservados. Deixe a worktree vinculada disponível; removê-la não faz parte da entrega.
Resumo
Você abriu uma branch de manutenção existente em uma worktree vinculada real, reconheceu a recusa de proteção de uma branch em uso e corrigiu um download da versão com suporte sem perturbar o trabalho original preparado e não preparado. A edição antiga, os dois downloads úteis e a anotação particular permaneceram intactos.
O próximo laboratório guiado, inicializado de forma independente, reutiliza uma correção isolada já existente no desenvolvimento em vez de editá-la novamente. Ele adiciona cherry-pick, mantendo as mesmas decisões sobre branch e preservação do rascunho.
