Ir para o conteúdo
Gerir links

O link funciona no site, mas não ao compartilhar

Resolva o caminho relativo em endereço completo, confira o destino com WikiURL e teste o link recebido antes de criar uma versão curta ou QR.

WikiURL · Gestão · Publicado

Um site e um documento unidos por uma corrente completa, com elos soltos e um envelope ao lado.

Identifique o que falta antes de encaminhar

No seu site, o link do programa de um encontro abre corretamente. Depois você copia agenda.pdf ou um caminho iniciado por barra em um email e o destinatário não chega ao arquivo. As perguntas consultadas mostram esse problema e a surpresa quando uma construção perde parte do caminho base. Antes de culpar email ou encurtador, veja o que foi copiado: uma referência relativa precisa de contexto para obter o destino completo. Dentro de um site pode ser perfeitamente válida. Para compartilhar fora desse contexto, prepare uma URL web completa e verificada. Este guia separa resolver o endereço de demonstrar que o documento existe e é o esperado pelo público.

Identifique a base que dá sentido ao caminho

A MDN explica que a resolução usa uma URL base; não consiste simplesmente em colar duas cadeias. Num documento HTML, a base normalmente depende de sua localização, mas um elemento base com href pode alterá-la. Se o código só mostra um caminho, não adivinhe domínio ou pasta ausente. Prefira copiar o endereço do link pela função do navegador e revisar o resultado, em vez de transcrever o atributo. Se mantém o site, compare a base real do documento com o destino esperado antes de corrigir. Não acrescente uma etiqueta base à página inteira como reparo rápido: ela pode mudar a resolução de outras referências além da investigada. Determine primeiro o contexto.

Confira o efeito das barras no exemplo

As três expressões mostram a resolução com o construtor URL. O domínio example.invalid e o arquivo são fictícios; não provam a existência de programa para baixar. Com a base terminada em event/, agenda.pdf produz um endereço nessa pasta. Se a referência começa com/agenda.pdf, o resultado parte da raiz da mesma origem. Quando a base termina em event sem barra final, agenda.pdf substitui esse último segmento, retornando à raiz. MDN e RFC3986 descrevem essas diferenças. Não adicione ou remova barras por costume. Escolha o endereço correspondente ao recurso real e confira a saída completa, não apenas o nome final do arquivo. A construção sozinha não demonstra disponibilidade.

Anote os resultados: primeiro https://example.invalid/event/agenda.pdf, depois https://example.invalid/agenda.pdf e novamente https://example.invalid/agenda.pdf. Duas expressões com o mesmo resultado não provam que a pasta event existe ou deve ser omitida no seu site. No teste real, registre endereço calculado, documento aberto e acesso do público separadamente. Deixe não verificado aquilo que não observou. Os resultados mostram resolução local de cadeias, não download nem disponibilidade de servidores.

new URL("agenda.pdf", "https://example.invalid/event/").href
new URL("/agenda.pdf", "https://example.invalid/event/").href
new URL("agenda.pdf", "https://example.invalid/event").href

Valide o recurso depois de resolver

Confira se a URL resultante tem domínio e caminho esperados. Um construtor pode produzir um endereço sintaticamente válido para o recurso errado; não concede permissões nem verifica conteúdo. Se o destino é público, sem segredos ou dados pessoais, coloque o endereço completo no verificador Wiki URL e registre resposta HTTP e URL final. Abra também o recurso para confirmar o programa correto e o acesso do público previsto. Uma resposta200 isolada não demonstra nenhuma dessas coisas. Com redirecionamentos, confira o destino final antes de aprovar. Para documentos privados, use meios autorizados e evite ferramentas externas. Mantenha separadas a resposta técnica, a revisão de conteúdo e a autorização de acesso.

Distribua o endereço aprovado e teste o recebido

Depois de verificar a URL completa, use-a no email ou documento final. Se o editor aceita nomes de link, preserve o destino aprovado mesmo que o texto diga Programa do encontro. Não substitua o endereço real por caminho incompleto apenas para encurtar a apresentação. Se precisar de link curto ou QR, crie no Wiki URL a partir do destino completo aprovado e teste essa versão exata. O encurtador não adivinha site ou pasta ausente na referência relativa nem publica o arquivo por você. Abra novamente o link da versão recebida ou exportada, não só da prévia do editor. Esse teste revela diferenças entre original e material distribuído e verifica o percurso do leitor.

Mantenha contexto, destino e evidência juntos

Guarde referência original, base usada, URL resolvida e versão compartilhada para reproduzir o caso ao mudar pasta, modelo ou site. Não altere indiscriminadamente todas as referências relativas: o problema é transportar o link para fora do contexto, não proibir técnica válida dentro das páginas. Se o arquivo mudar de lugar, revise referências e materiais circulantes e combine com o responsável como manter acesso. Não prometa atualização automática de QR anterior. O resultado útil reúne endereço completo para o documento esperado e teste do percurso real. Wiki URL ajuda a verificar e distribuir o endereço; resolvê-lo não substitui revisão do conteúdo nem permissões. Registre essas responsabilidades junto das observações correspondentes.

Abrir a ferramenta →

Fontes e documentação

← Todos os guias