Como gerar marcação HTML para Twitter Cards

Introduza um título não vazio e, se necessário, preencha os campos opcionais para gerar a marcação HTML de meta tags do Twitter Card. O tipo predefinido é summary_large_image, e os valores são protegidos por escape HTML na marcação gerada.

Para que serve o gerador

O Twitter Card Generator cria marcação HTML de meta tags para cartões do Twitter a partir de um título e de detalhes opcionais. É útil quando pretende preparar os elementos de metadados de uma página antes de os inserir no HTML do seu site. O resultado é uma estrutura de marcação que pode analisar e adaptar ao contexto da página.

O título é o ponto de partida: sem um título preenchido, não são gerados dados nem marcação. Quando existe um título, o resultado inclui os metadados do tipo de cartão e do título. Pode ainda acrescentar uma descrição, um URL de imagem, o site e o criador.

Como gerar a marcação passo a passo

1. Abra o gerador e localize os controlos destinados ao título e aos detalhes do cartão.
2. Introduza um título não vazio para a página ou publicação. Este campo é necessário para obter marcação.
3. Se forem relevantes para a página, preencha a descrição, o URL da imagem, o site e o criador. Os campos opcionais só acrescentam os metadados correspondentes quando têm conteúdo.
4. Reveja o tipo de cartão apresentado. Se não escolher outra opção, o valor predefinido é summary_large_image.
5. Execute a geração e copie ou consulte a marcação HTML apresentada.
6. Antes de publicar, confirme se os valores inseridos correspondem à página. O gerador aplica escape HTML aos valores antes de os inserir na marcação, mas isso não substitui a sua revisão editorial nem a integração no HTML do site.

Como ler e verificar o resultado

A presença de um título determina se existe resultado. Com esse campo preenchido, procure pelo menos os metadados relativos ao tipo de cartão e ao título. Uma descrição, um URL de imagem, o site ou o criador só deverão aparecer quando os respetivos campos tiverem sido preenchidos.

O resultado é marcação HTML de meta tags, não uma pré-visualização garantida nem uma confirmação de aceitação pela plataforma. A inclusão de um URL de imagem também não significa que o URL tenha sido validado. Use a saída como base para a implementação e reveja o conteúdo no local onde será publicado.

O tipo predefinido summary_large_image indica a opção usada quando não é selecionado outro tipo. Se o resultado não contiver marcação, confirme primeiro se o título tem conteúdo; um título vazio conduz a uma saída sem marcação nem entradas de metadados.

Exemplo prático

Uma pessoa está a preparar os metadados de uma página de receita antes de publicar o respetivo HTML.

Para uma publicação sobre uma receita, introduza o título da publicação, acrescente uma descrição e indique o URL da imagem. Gere a marcação e confirme a presença dos metadados associados a esses valores.

A saída deverá apresentar marcação HTML de meta tags com o tipo de cartão e o título; a descrição e o URL da imagem deverão surgir como campos correspondentes quando forem preenchidos.

Limitações

• A ferramenta gera marcação HTML de meta tags, mas a saída não constitui uma garantia de pré-visualização, aceitação pela plataforma ou validação de URLs.

Erros comuns

• Causa: o título ficou vazio. Ação corretiva: introduza um título não vazio e gere a marcação novamente; sem esse valor, não é produzido qualquer resultado.

Perguntas frequentes

É obrigatório preencher todos os campos?

Sim, desde que introduza um título não vazio. Com o título preenchido, são gerados os metadados do tipo de cartão e do título; os restantes campos são opcionais.

Que tipo de cartão é usado por predefinição?

Quando não seleciona outro tipo, o gerador utiliza summary_large_image como valor predefinido.

O que acontece se eu deixar o título vazio?

Não. Um título vazio produz uma saída sem marcação nem entradas de metadados. Preencha o título e tente gerar novamente.