Introdução
A caminhada comunitária de amanhã precisa de um guia que continue funcionando quando sua origem estiver indisponível. Você levará cinco páginas, três ilustrações, uma folha de estilos e uma ficha de observação imprimível para um diretório separado. Salvar só a página inicial não oferece esse percurso de leitura.
Use Source Guide para explorar o original, Workstation para baixar e Field Copy para ler seus arquivos. Você interromperá somente o serviço de origem fornecido e abrirá uma ficha ainda não lida e a folha a partir da cópia movida. A conexão com LabEx continuará disponível: isto simula perder a origem do conteúdo, não desconectar a plataforma inteira.
A familiaridade básica com o terminal é suficiente. URLs, opções de download e links relativos são explicados aqui. Todos os textos e ilustrações são materiais didáticos sintéticos originais, não conselhos reais de identificação, coleta de alimentos ou segurança. O site e a saída dos comandos permanecem em inglês em todos os idiomas dos documentos.
Salve uma página e veja seus limites
Nesta etapa, você seguirá o percurso real de leitura e salvará uma única página HTML como comparação controlada. Este primeiro salvamento é deliberadamente incompleto; ainda não é o guia pronto.
Percorra o original
Abra Source Guide, escolha Woodland e selecione Start the route. Siga Silver leaf, leia o parágrafo e veja a ilustração, depois use Return to the route. Abra Open observation sheet: é um documento SVG real com espaços para desenho e observações. Use o botão Voltar do navegador. Deixe Amber cap e Reed fan sem ler para o teste posterior com a origem interrompida.
A página inicial, a rota e as três fichas são cinco arquivos HTML diferentes. Imagens, estilos CSS e a ficha SVG também são arquivos separados. Harbor event — online only, outside this guide é uma atividade vizinha intencionalmente excluída e não faz parte do percurso offline.
Leia uma URL e salve a página inicial
Mude para Workstation. pwd mostra o diretório atual. O terminal preparado começa na área de trabalho do projeto:
pwd
/home/labex/project
Se necessário, cd muda de diretório:
cd /home/labex/project
O terminal alcança a origem em http://127.0.0.1:8081/woodland/index.html. http:// seleciona HTTP; 127.0.0.1 significa esta mesma máquina do laboratório; 8081 é a porta da origem; /woodland/index.html é o caminho solicitado. A aba Source Guide expõe esse mesmo serviço por um endereço de navegador da plataforma. Não digite o endereço de loopback do terminal no navegador do seu próprio computador.
wget recupera uma URL. A opção -O, com O maiúsculo, nomeia um arquivo de saída e o sobrescreve em uma nova tentativa. Este comando salva apenas o HTML da página inicial:
wget -O first-save.html http://127.0.0.1:8081/woodland/index.html
Procure 200 OK e a mensagem de arquivo salvo. Tempos e contagens de bytes podem variar. ls permite listar um arquivo para confirmar seu nome:
ls first-save.html
Abra Field Copy e siga First single-page save. O título e o texto existem, mas faltam ilustrações e estilos. Start the route retorna o erro local 404: File not found, pois a rota não foi baixada. Use Return to local files para voltar à mesa de leitura. É uma limitação esperada, não um defeito do original. Um 404 significa que o servidor respondeu, mas não possui aquele caminho; uma falha de conexão significa que o próprio serviço não pôde ser alcançado.
A mesa local serve arquivos de /home/labex/project na porta 8082. Ela nunca busca arquivos ausentes na origem.
Colete o guia dentro do escopo permitido
Nesta etapa, você reunirá as páginas vinculadas e seus recursos sem baixar o evento vizinho. Primeiro, separe os caminhos URL do guia dos diretórios de saída na máquina.
Defina um limite útil
A origem tem esta estrutura:
/woodland/ homepage, route, species cards
/shared/woodland/ CSS, three illustrations, observation sheet
/harbor/ a different activity: exclude it
As três fichas estão em /woodland/species/. A ficha de observação e os estilos ficam fora de /woodland/, no diretório compartilhado explicitamente autorizado. Restringir tudo aos descendentes do diretório inicial seria estreito demais. Baixar o host inteiro seria amplo demais.
A opção --recursive do Wget segue links, e --level=inf remove seu limite habitual de cinco níveis. Aqui o site é pequeno e controlado; a profundidade ilimitada continua delimitada pelos caminhos permitidos. --page-requisites também coleta dependências de exibição, como imagens e folhas de estilos. A coleta recursiva encontra arquivos vinculados, não qualquer arquivo sem link que possa existir no servidor.
--include-directories=/woodland,/shared/woodland autoriza essas duas árvores. A vírgula une os prefixos URL permitidos sem espaços. Assim, inclui os caminhos mais profundos das espécies e exclui /harbor/. Não é necessário --no-parent: essa opção bloquearia o diretório irmão compartilhado necessário aqui.
--no-host-directories evita um diretório com o nome do host na saída. --directory-prefix=raw-guide coloca a hierarquia URL preservada sob seu diretório local raw-guide/, criado automaticamente. Execute este único comando; o terminal pode quebrar sua exibição em mais de uma linha:
wget --recursive --level=inf --page-requisites --no-host-directories --directory-prefix=raw-guide --include-directories=/woodland,/shared/woodland http://127.0.0.1:8081/woodland/index.html
Wget também lê e salva o robots.txt da origem, que permite este download didático. São metadados do rastreador, não outra página do guia. Espere cinco páginas HTML, cinco recursos compartilhados e esses metadados: onze arquivos ao todo.
find raw-guide -type f lista arquivos comuns em toda a árvore. -type f seleciona arquivos em vez de diretórios:
find raw-guide -type f
Confirme as duas árvores previstas e robots.txt; não deve existir um diretório harbor/. A ordem da listagem não importa.
Veja por que arquivos completos ainda precisam de links utilizáveis
Em Field Copy, abra Raw collected guide. Seu HTML ainda usa caminhos como /shared/woodland/guide.css. Uma barra inicial começa na raiz do servidor de leitura, não em raw-guide/. Os arquivos estão em raw-guide/shared/woodland/, portanto os caminhos não convertidos ainda não chegam aos alvos.
Essa diferença importa: coletar os arquivos certos e fazer a navegação apontar para eles são tarefas separadas. Volte à mesa local. Preserve raw-guide/ como comparação e crie uma cópia portátil limpa a seguir.
Se Wget informar falha de conexão, execute source-control start em Workstation e tente novamente. Esse comando preparado inicia apenas a origem fornecida; não baixa nem altera suas cópias. Para repetir com um destino vazio, rm -r raw-guide remove somente esse diretório de comparação descartável e seu conteúdo. Confira a escrita antes de usar esse comando opcional de recuperação.
Faça a navegação acompanhar a cópia
Nesta etapa, você criará o diretório portátil field-guide/ e usará seus links reais. Wget pode reescrever os links baixados ao terminar a coleta.
--convert-links transforma links para arquivos baixados em caminhos relativos. Por exemplo, a página inicial copiada usa ../shared/woodland/guide.css; .. significa seu diretório pai. Uma ficha mais profunda usa mais um .. para alcançar os mesmos recursos compartilhados. Esses caminhos viajam com o diretório em vez de depender da raiz do servidor de leitura.
Repita a coleta delimitada em um novo destino, adicionando a conversão de links. A origem ainda está funcionando:
wget --recursive --level=inf --page-requisites --convert-links --no-host-directories --directory-prefix=field-guide --include-directories=/woodland,/shared/woodland http://127.0.0.1:8081/woodland/index.html
Espere a mensagem final Converted links. A conversão ocorre depois do download, quando Wget sabe quais destinos foram salvos. Os links para o evento Harbor excluído continuam como referências online; seu rótulo mantém explicitamente o evento fora do guia offline.
grep exibe linhas de texto correspondentes. Procure o nome da folha de estilos para ver a referência relativa no seu HTML real:
grep 'guide.css' field-guide/woodland/index.html
A saída é uma longa linha HTML. Localize ../shared/woodland/guide.css nela; não é necessário entender ou editar HTML. As aspas de 'guide.css' passam o padrão como um único argumento.
Em Field Copy, escolha Downloaded guide. O layout e as três ilustrações devem aparecer. Abra Start the route, depois Silver leaf e All field notes. Observe o endereço do navegador: os links permanecem sob /field-guide/, no serviço Field Copy. Deixe as outras duas fichas fechadas para a próxima etapa.
Se receber 404, compare o endereço solicitado com find field-guide -type f: um arquivo ausente exige coleta; um caminho raiz incorreto exige conversão. Para recomeçar limpo, o comando opcional rm -r field-guide remove apenas esse diretório portátil gerado; depois repita o comando completo. Reutilizar um destino Wget existente pode gerar duplicatas numeradas. Portanto, um arquivo .1 salvo não é o resultado pretendido.
Interrompa a origem e mova o guia
Nesta etapa, você testará a razão de criar esta cópia: outra pessoa pode usá-la depois que a origem for interrompida e o diretório de download mudar de lugar.
Remova a dependência da origem
Em Workstation, use o comando de parada preparado. Ele afeta somente a porta 8081; seu terminal e Field Copy continuam disponíveis:
source-control stop
Source stopped; Field Copy is still running.
Recarregue Source Guide. Uma falha de conexão ou de gateway da plataforma é esperada porque o processo de origem parou. Uma página em cache não prova que a origem continua ativa. Em Workstation, curl solicita um endereço e --max-time 3 limita a espera a três segundos. O sufixo || true permite que o shell continue após essa requisição intencionalmente malsucedida:
curl --max-time 3 http://127.0.0.1:8081/woodland/index.html || true
Espere uma falha de conexão, não o HTML do guia. Isso confirma que a origem está indisponível a partir do próprio laboratório. Agora use Field Copy para abrir Downloaded guide, Start the route e a ficha ainda não lida Amber cap. O parágrafo e a imagem reais devem carregar. Abra Observation sheet ali; deve aparecer o SVG imprimível real. Esses endereços locais são diferentes das URLs originais da origem.
Entregue um diretório que possa se mover
O diretório vazio handover/ já foi fornecido. mv move o diretório completo com todos os seus elementos. A barra final de handover/ explicita que o destino é um diretório:
mv field-guide handover/
A localização antiga do download não existe mais. Liste o diretório movido:
ls handover/field-guide
robots.txt shared woodland
Abra Field Copy em uma nova janela privada ou use uma nova aba e, a partir da mesa de leitura, entre em Moved handover guide. A janela privada pode exigir o login normal da plataforma; uma nova aba de Field Copy basta para o percurso do aluno. A URL movida é /handover/field-guide/woodland/index.html, servida pelo leitor local. Não volte por um favorito antigo obsoleto.
Siga Start the route, abra a ficha ainda não lida Reed fan, volte por All field notes e abra Observation sheet. A ficha pode ser salva ou impressa pelo menu do navegador. São arquivos reais, não uma animação de sucesso. O link Harbor event fica fora do escopo offline e não precisa funcionar após a remoção da origem.
Se uma página necessária falhar agora, restaure a origem com source-control start, repare um download limpo usando a etapa anterior e substitua o diretório de entrega incompleto depois de conferir seu caminho. Então interrompa a origem e repita o percurso movido. Não é preciso reiniciar todo o laboratório. Preserve a entrega completa como resultado final.
Seu produto final é handover/field-guide/, com conteúdo e recursos compartilhados. Este laboratório verifica a leitura no navegador por um servidor estático comum; não promete comportamento idêntico de file:// em todos os navegadores nem download do diretório inteiro para seu computador com um clique na plataforma.
Resumo
Você comparou uma única página HTML salva com uma coleta recursiva delimitada, incluiu dependências compartilhadas e converteu links em caminhos relativos. Depois interrompeu pessoalmente a origem, utilizou conteúdo ainda não lido da cópia local independente e moveu o diretório completo para o local de entrega.
O resultado útil é o próprio guia: cinco páginas legíveis, três ilustrações, uma folha de estilos e a ficha de observação real, além dos metadados do rastreador. Disponibilidade da origem, escopo de download e navegação local funcional são propriedades diferentes; você testou as três.
