Como gerar meta tags Open Graph a partir dos dados da página

Para que serve o gerador

O gerador cria marcação de meta tags Open Graph a partir dos dados da página que fornecer. É útil quando pretende preparar informações como título, descrição, imagem ou endereço da página para serem incluídas na marcação, sem escrever cada elemento manualmente.

O título é o ponto de partida: a marcação só é produzida quando esse campo tem um valor preenchido. Os restantes campos são opcionais e permitem adaptar os dados apresentados. Assim, pode começar com o essencial e acrescentar imagem, URL, nome do site, tipo e localidade quando esses valores fizerem sentido para a página.

Como gerar a marcação

1. Introduza um título com conteúdo no campo correspondente. Sem um título preenchido, o processamento pode terminar sem gerar marcação.

2. Preencha a descrição que pretende associar à página. O título e a descrição fazem parte da marcação produzida quando existe um título válido.

3. Se necessário, adicione o URL da imagem. O elemento de imagem só é incluído quando é fornecido um valor para esse campo.

4. Adicione o URL da página e o nome do site apenas quando quiser que esses dados façam parte do resultado. Cada elemento opcional depende do respetivo valor introduzido.

5. Reveja o tipo e a localidade. Se não indicar outros valores, o tipo usado é website e a localidade usada é en_US.

6. Gere a marcação e copie o resultado para o local onde está a preparar os metadados da página. Os valores inseridos são escapados para HTML na marcação gerada, o que preserva caracteres especiais no conteúdo.

Como interpretar o resultado

Comece por confirmar se o resultado contém os elementos de título e descrição. Quando o título foi preenchido, esses elementos fazem parte da marcação. Se tiver fornecido uma imagem, um URL ou um nome de site, procure também os elementos correspondentes; a ausência de um destes valores significa que o respetivo elemento opcional não é incluído.

Se não indicou um tipo ou uma localidade, interprete website e en_US como os valores predefinidos usados no resultado. Se precisava de outros valores, volte aos campos opcionais e gere uma nova versão. Caracteres como &, aspas ou sinais angulares podem surgir na forma escapada própria de HTML, em vez de aparecerem literalmente como foram escritos.

Exemplo prático

Uma pessoa está a preparar os metadados de uma página sobre caminhadas no Gerês e quer incluir título, descrição, imagem e endereço da página.

Introduza o título “Guia de caminhadas no Gerês”, a descrição “Percursos e recomendações para planear a próxima caminhada”, o URL de uma imagem e o URL da página, deixando o tipo e a localidade sem alteração; depois gere a marcação.

O resultado deverá conter elementos para título e descrição. Como foram fornecidos um URL de imagem e um URL de página, deverá também conter os elementos correspondentes; tipo e localidade deverão assumir website e en_US se não forem alterados.

Limitações

• Sem um título com conteúdo, o resultado não inclui marcação gerada; os elementos opcionais também dependem dos valores que forem fornecidos.

Erros comuns

• Deixar o título vazio: o processamento pode terminar sem marcação. Introduza um título com conteúdo antes de gerar o resultado.

Perguntas frequentes

É necessário preencher o título?

Quando pretende obter marcação, sim: é necessário fornecer um título com conteúdo. Se o título estiver vazio, o processamento termina sem produzir marcação.

Tenho de indicar um URL de imagem?

Não. O URL da imagem é opcional e o respetivo elemento só aparece quando é fornecido um valor para esse campo.

Quais são os valores predefinidos do tipo e da localidade?

Se não indicar outro valor, o tipo usado é website e a localidade usada é en_US. Pode fornecer valores diferentes nos campos opcionais correspondentes.