
Minilição · Português
Como corrigir a prévia do seu site ao compartilhar um link
Dê a um assistente título, descrição e imagem fornecida e depois verifique o cartão produzido por um link público real.
Para quem é esta lição?
Para donos de sites cujos links compartilhados mostram uma prévia ausente ou enganosa. Um assistente de programação pode adicionar os metadados da página; você examina o cartão realmente compartilhado.
Antes de começar
Sua própria página HTTPS pública de prática e a imagem fornecida para o cartão. Um assistente pode editar e publicar os arquivos. Plataformas sociais não conseguem obter uma página privada localhost e suas prévias em cache podem precisar de atualização.
Tempo estimado: 15–27 min
Estimativas com os arquivos iniciais e as contas e ferramentas necessárias já prontas. Configuração, filas de publicação e esperas de e-mail ou DNS exigem tempo adicional. As plataformas guardam resultados em cache e decidem o que mostrar. Uma verificação local de metadados não comprova uma prévia real no LinkedIn, Slack ou WhatsApp.
O que você vai aprender
- Conecte título, descrição e imagem pretendidos.
- Verifique se a imagem pode ser obtida publicamente.
- Examine a prévia real da plataforma e seus limites.
Etapa 1
Escolha o cartão que quer compartilhar
A prévia é gerada a partir de uma página obtida publicamente.
Abra a página fornecida. Seu título é “Practical notes for building a website” e ela inclui share-card.jpg. Decida se o título, a descrição curta e a imagem descrevem com precisão o que o visitante abrirá.
Dê ao assistente o endereço HTTPS público real e peça para conectar esses valores de compartilhamento. A origem reservada https://YOUR-SITE.example/ é um modelo; a plataforma não pode buscar uma imagem que só existe no seu notebook.
Um exemplo concreto
A descrição fornecida é “Small examples, working files and clear checks for your next website feature.” Com o título, promete notas práticas sobre sites, não uma página inicial sem relação.
Use a página e a imagem de compartilhamento fornecidas. Adicione título e descrição específicos do artigo e URL pública absoluta da imagem, mantendo o conteúdo visível consistente. Ajude a verificar a página e a imagem publicadas sem sessão iniciada e depois examine uma prévia real de compartilhamento. Cuide do código de metadados. Não alegue uma atualização na plataforma só por uma imagem local ou solicitação de atualização do cache do provedor.Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Faça o link compartilhado explicar seu destino
Uma prévia precisa de metadados da página e de uma imagem que a plataforma realmente consiga buscar.
Uma prévia costuma ser montada por uma plataforma que busca a URL e lê os metadados. Ela não é simplesmente uma captura do que seu navegador conectado vê.
Esta lição fornece uma seção head do HTML completa e uma nova imagem de compartilhamento. Você substituirá a origem reservada do exemplo, publicará sua própria página de prática e examinará o que uma solicitação sem autenticação recebe.
Exemplo resolvido
Um título útil informa o que a página oferece. “My site” (meu site) dá muito menos contexto que “Practical notes for building a website” (notas práticas para criar um site), seguido de uma descrição curta.
Extra implementation exercise
Por que uma miniatura pode funcionar no seu computador e falhar no Slack?
Mostrar uma solução comentada
A plataforma não consegue acessar localhost nem sua sessão autenticada. Ela também precisa de uma URL de imagem acessível e de metadados HTML corretos no endereço exato compartilhado.
- Reconhece que a plataforma precisa de acesso público pela rede.
- Verifica a URL compartilhada e a imagem separadamente.
Erro comum
Testar apenas em um navegador já autenticado.
Etapa 2
Verifique a imagem publicada
Examine o caminho de imagem que o cartão realmente referencia.
Publique a alteração de prática quando pronta e depois abra a URL real da imagem de compartilhamento sem sessão iniciada. Peça ao assistente para confirmar que é a imagem pretendida em vez de arquivo ausente ou página de login.
Mudar a imagem visível da página não muda necessariamente o valor separado usado no compartilhamento. Verifique também a referência entregue.
Um exemplo concreto
Se a URL da imagem abre a página inicial HTML em vez de share-card.jpg, o servidor ainda pode retornar 200. A URL funciona como página, mas não fornece uma imagem para o cartão.
Experimente
A URL da imagem de compartilhamento retorna 200, mas exibe uma página HTML. Isso é uma verificação de imagem bem-sucedida? O que corrigir?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Não. O cartão precisa de uma imagem real na URL. Pediria ao assistente para publicar share-card.jpg nesse caminho e verificar que uma solicitação sem login retorna a imagem com conteúdo image/jpeg, não a página inicial alternativa.
- Rejeita uma página HTML alternativa como imagem mesmo com resposta 200.
- Confere a URL pública configurada exata e o conteúdo real da imagem.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Coloque a prévia no HTML inicial
Use URLs absolutas canônicas e de imagem que funcionem em uma busca externa.
Examine a seção head do HTML fornecido. og:title, og:description, og:type, og:url e og:image descrevem esta página exata. O caminho da imagem é absoluto porque um robô remoto precisa de um destino inequívoco.
Substitua YOUR-SITE.example em todos os lugares. A imagem é um arquivo real incluído na oficina. Não dependa de JavaScript para inserir metadados essenciais depois do carregamento; o comportamento dos robôs varia.
O cartão horizontal fornecido tem 1672 × 941 pixels. Plataformas podem recortar ou redimensionar de formas diferentes; mantenha detalhes importantes longe das bordas e examine o resultado real. É um recurso inicial, não uma promessa de recorte idêntico em todas as plataformas. Confirme que share-card.jpg está na pasta pública implantada.
Antes de testar qualquer plataforma, abra sua URL og:image implantada exata sem estar conectado e confira uma resposta image/jpeg bem-sucedida com a imagem real visível. Arquivo ausente, origem reservada ou resposta HTML de substituição não passam nessa verificação.
Exemplo resolvido
Uma imagem relativa correta no corpo não corrige um og:image absoluto quebrado. Examine os dois destinos em vez de supor que são iguais.
<meta property="og:image"
content="https://YOUR-SITE.example/share-card.jpg">
<meta property="og:type" content="website">Extra implementation exercise
Você mudou a imagem visível, mas deixou og:image apontando para um arquivo ausente. Qual imagem o robô vai tentar buscar?
Mostrar uma solução comentada
Normalmente tentará a imagem dos metadados, que continua quebrada. Corrija a URL og:image e verifique a resposta real.
- Lê o destino dos metadados.
- Não deduz a prévia a partir do corpo renderizado.
Erro comum
Deixar origens provisórias nos metadados implantados.
Etapa 3
Examine uma prévia real da plataforma
Considere a obtenção remota e o cache.
Depois de publicar, confira as URLs de página e imagem sem login. Use uma ferramenta como LinkedIn Post Inspector, quando disponível, ou compartilhe o link de prática em privado e examine o cartão real. Compare título, descrição e recorte exibidos.
Anote a plataforma e o que mostrou. Se os arquivos públicos estão atuais, mas o cartão é antigo, investigue o cache; pedir atualização é uma etapa, não um resultado visível.
Um exemplo concreto
Comparação ilustrativa: A página pública fornece o título novo e o JPEG, enquanto a plataforma examinada ainda mostra um título antigo. Isso aponta para cache específico dela, não comprova atualização em todas as plataformas.
LinkedIn Post Inspector · Meta Sharing Debugger
Experimente
Que cartão a plataforma escolhida mostrou e o que continua incerto?
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Resultado ilustrativo: A página e o JPEG estão atuais, mas a plataforma ainda mostra o título anterior. Registraria essa prévia antiga, pediria atualização na ferramenta disponível e examinaria o cartão novamente. Um teste apenas no LinkedIn não permitiria afirmar que o WhatsApp atualizou.
- Registra o cartão real em uma plataforma identificada e compara título/imagem com a página.
- Distingue a saída pública atual de um cartão possivelmente em cache.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Verifique a resposta antes de culpar o cache
Verifique HTML bruto, redirecionamentos e acesso à imagem e depois teste a plataforma.
Abra a URL compartilhada exata sem entrar e examine a fonte bruta. Siga os redirecionamentos e confira o status final. Busque a imagem separadamente: ela precisa retornar bytes de imagem com tipo de conteúdo adequado, não HTML de substituição.
Depois de a saída do servidor estar correta, use a ferramenta de inspeção da plataforma quando disponível e tente um compartilhamento novo. Mensagens existentes podem manter prévias antigas em cache. Atualizar o cache do seu navegador não limpa o cache de uma plataforma social.
Por exemplo, abra LinkedIn Post Inspector com sua conta e informe a URL pública exata. Meta Sharing Debugger é outra ferramenta específica de plataforma e pode exigir acesso. Nas ferramentas do navegador, selecione a solicitação da imagem em Network e examine Headers → Content-Type e a prévia da resposta. As ferramentas ainda podem estar indisponíveis ou usar cache.
A página e a imagem de destino precisam ser acessíveis sem sua sessão de proprietário por visitantes ou robôs. A ferramenta de diagnóstico é separada: LinkedIn ou Meta podem exigir acesso para usar o inspetor. Entrar na ferramenta não torna um destino privado acessível ao robô. Se não tiver acesso, registre a limitação e separe as verificações de resposta bruta de uma prévia de plataforma não observada.
No WhatsApp ou Slack, compartilhe a URL pública de prática em uma conversa de teste que você controla e registre a prévia ou sua ausência. Não afirme que uma plataforma passou quando só examinou respostas HTTP; se faltar conta ou ferramenta, registre o limite.
Exemplo resolvido
Uma solicitação de imagem que retorna 200 text/html pode ser uma página de substituição de aplicação de página única. Status 200 sozinho não prova que uma imagem foi servida.
LinkedIn Post Inspector · Meta Sharing Debugger
Extra implementation exercise
A solicitação og:image retorna 200 com uma página de acesso. A verificação da imagem teve sucesso?
Mostrar uma solução comentada
Não. O robô recebeu HTML em vez da imagem. Corrija rotas e acesso para a URL retornar o arquivo real sem entrar na conta.
- Verifica tipo de conteúdo e corpo além do status.
- Exige acesso sem autenticação aos bytes reais da imagem.
Erro comum
Tratar qualquer resposta 200 como prova do recurso esperado.
Etapa 4
Conclua um cartão específico do artigo
Mantenha alinhadas a identidade compartilhada e a página real.
Peça ao assistente para adicionar o artigo de referência “Fix a mismatched contact link”, com seu próprio título de compartilhamento, descrição e URL. Pode reutilizar share-card.jpg; sua identidade ainda deve descrever o artigo, não a página inicial.
Publique o artigo no site de prática, abra sua página pública exata e a imagem e confira o cartão novamente. Registre qualquer plataforma cuja verificação não foi possível.
Um exemplo concreto
O título do cartão deve ser “Fix a mismatched contact link”. A descrição explica comparar href e id, corrigir a âncora e conferir o resultado. Reutilizar o título genérico da página inicial esconderia o que esse link ensina.
Experimente
Materiais para começar
Os arquivos e conteúdos de teste estão incluídos. A verificação real exige sua própria conta, caixa de entrada ou domínio conforme os pré-requisitos. É possível inspecionar localmente; marque etapas reais não executadas como não testadas.
Apresente o link do artigo e o registro real de verificação de imagem e plataforma.
O que entregar A URL pública de prática e os resultados observados de imagem e prévia, incluindo limitações de cache.
Converse com o tutor sobre sua resposta
Mostrar uma solução comentada
Entrega ilustrativa: article.html identifica “Fix a mismatched contact link”, descreve a correção e aponta à URL publicada; share-card.jpg abre sem login. A plataforma examinada mostra o título do artigo. As demais não foram testadas, então não afirmei atualização das suas prévias.
- Dá ao artigo seu próprio título, descrição e URL pública correspondentes.
- Fornece observações reais de imagem/plataforma e identifica plataformas não verificadas.
Arquivos desta etapa
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Sua tarefa: obter a prévia de um artigo específico
Dê ao link direto para um artigo específico seu próprio título, descrição e imagem corretos.
Crie uma página de artigo com seus metadados e uma mensagem descritiva de compartilhamento. Mantenha canonical/og:url nesse artigo, não na página inicial.
Publique apenas no site de prática, teste as respostas sem autenticação e registre a prévia real de uma plataforma se disponível. Se ela recusar ou mantiver um resultado antigo, documente a observação em vez de declarar sucesso pelo HTML sozinho.
Exemplo resolvido
Dois artigos diferentes que sempre mostram a prévia da página inicial podem ser compartilháveis tecnicamente, mas não ajudam o destinatário a entender o link específico.
O roteiro completo de referência está em reference/assignment-walkthrough.txt. Compare as etapas com seu resultado; preencha o registro de teste com observações do seu próprio projeto.
Extra implementation exercise
Produza uma prévia própria do artigo e um registro de teste de resposta e plataforma.
Mostrar uma solução comentada
Substitua a origem reservada em canonical, og:url e og:image. Publique o JPEG fornecido junto ao HTML. Abra as duas URLs exatas desconectado e examine a resposta em Network: a página deve ser HTML e a imagem, bytes reais image/jpeg, não HTML de substituição.
Para um artigo específico, dê a ele seu próprio título, descrição e URL canônica/OG em vez de reutilizar a identidade da página inicial. O artigo completo de referência demonstra essa seção head separada do HTML.
Use LinkedIn Post Inspector ou Meta Sharing Debugger quando sua conta tiver acesso e registre o resultado real e a hora do teste. Uma prévia antiga em cache é uma observação diferente de uma saída atual incorreta do servidor. Verificações de fonte local não comprovam uma prévia real do WhatsApp.
- Os metadados descrevem o artigo exato compartilhado.
- O HTML bruto e o acesso à imagem são verificados; o resultado da plataforma é registrado com honestidade.
Erro comum
Afirmar que examinar a fonte local prova que o WhatsApp atualizou a prévia.
Esta lição foi útil?
Deixe uma curtida ou compartilhe com alguém que possa aproveitar.
Continue aprendendo
- Como criar seu primeiro site pessoal
- Como publicar seu site pelo GitHub
- Como conectar um domínio próprio ao seu site
- Como configurar e-mail no seu próprio domínio
- Como tornar seu site utilizável em celulares
- Como acelerar o carregamento das imagens do seu site
- Como receber os comentários do seu site na sua caixa de entrada
- Como adicionar assinaturas por e-mail ao seu site
- Como enviar e-mails automáticos pelo seu site
- Como salvar envios de formulário em um banco de dados
- Como permitir que as pessoas entrem no seu site
- Como manter uma página privada
- Como permitir que usuários editem as informações do perfil
- Como permitir que usuários enviem imagens
- Como manter chaves de API fora do frontend
- Como mostrar dados de uma API externa no seu site
- Como adicionar um chatbot de IA ao seu site
- Como fazer um chatbot responder com base no seu conteúdo
- Como adicionar um blog ao seu site
- Como adicionar busca ao seu site
- Como adicionar outro idioma ao seu site
- Como ajudar o Google a encontrar seu site
- Como medir visitas e ações úteis no seu site
- Como permitir que visitantes agendem um horário
- Como aceitar um pagamento no seu site
- Como visualizar mudanças do site antes de publicar
- Como desfazer uma implantação com falha do seu site
- Como fazer backup e restaurar os dados do seu site
- Como encontrar e corrigir erros no seu site no ar