Come generare il markup Open Graph da titolo e descrizione

A cosa serve

Questo strumento serve a preparare il markup dei metadati orientati all’anteprima quando una pagina viene condivisa. Puoi compilare un titolo e aggiungere descrizione, immagine, URL, nome del sito, tipo e lingua come valori testuali; i campi sono facoltativi. Il risultato è utile per controllare quali informazioni verrebbero rappresentate nel markup, senza trattarlo come una garanzia sul modo in cui una piattaforma sociale mostrerà il collegamento.

Come generare il markup

1. Inserisci un titolo nel campo dedicato. Se vuoi arricchire il markup, aggiungi una descrizione, l’URL, l’URL dell’immagine e il nome del sito. Puoi anche indicare il tipo e la lingua; se lasci questi ultimi due campi vuoti, vengono usati rispettivamente website ed en_US.

2. Controlla i valori prima di generare il risultato. Un URL o un riferimento all’immagine viene considerato soltanto quando il relativo campo contiene un valore; lo stesso vale per il nome del sito. Il contenuto fornito viene trasformato in markup con i caratteri speciali HTML sottoposti a escape.

3. Avvia la generazione e leggi il markup restituito. Con un titolo compilato, cerca i metadati relativi a titolo e descrizione, oltre a quelli relativi a tipo e lingua. Gli elementi per immagine, URL e nome del sito compaiono solo se hai compilato i rispettivi campi.

4. Se vuoi un risultato più essenziale, lascia vuoti i campi opzionali e rigenera. Se invece elimini anche il titolo, l’operazione va a buon fine ma non restituisce voci di metadati.

Come leggere il risultato

La presenza del titolo è il discrimine principale. Con un titolo non vuoto, il risultato comprende i metadati di titolo e descrizione anche se la descrizione è vuota, insieme a tipo e lingua. Se tipo e lingua non sono stati indicati, il risultato usa website e en_US. Gli altri elementi non vanno cercati se il campo corrispondente è rimasto vuoto.

Un titolo vuoto non segnala necessariamente un errore: il percorso supportato termina con successo e senza voci di metadati. Per questo, un risultato vuoto può dipendere dall’input e non da un problema nella generazione. Inoltre, il markup viene costruito a partire dai valori testuali forniti: il fatto che contenga un URL o un’immagine non dimostra che tali risorse siano state controllate.

Esempio pratico

Una redazione vuole preparare il markup di condivisione per un articolo e compila il titolo, la descrizione, l’URL della pagina e l’URL dell’immagine.

Inserisci il titolo, la descrizione, un URL e un URL per l’immagine, poi avvia la generazione lasciando tipo e lingua senza valore.

Il risultato segnala un’esecuzione riuscita e contiene metadati per titolo e descrizione, oltre a tipo e lingua; i metadati per URL e immagine compaiono perché i relativi campi sono valorizzati.

Limiti

• Il risultato rappresenta markup generato dai valori inseriti. La presenza di un URL o di un riferimento a un’immagine nel markup non va interpretata come verifica della risorsa o come garanzia del modo in cui una piattaforma sociale mostrerà il collegamento.

Errori comuni

• Risultato senza metadati: il titolo è stato lasciato vuoto. Inserisci un titolo e genera di nuovo il markup; il percorso con titolo valorizzato produce i metadati di titolo e descrizione.

Domande frequenti

La descrizione è necessaria per generare i metadati?

No: la descrizione è facoltativa e non è necessaria per generare i metadati, anche se viene inclusa nel markup finale anche quando lasciata vuota. Se il titolo è vuoto, l’operazione riesce senza restituire voci di metadati.

Cosa succede se lascio vuoti URL, immagine o nome del sito?

I relativi tag vengono generati solo se compili i rispettivi campi con valori non vuoti; in caso contrario, non vengono inclusi nel markup.

Quali valori usa lo strumento per tipo e lingua?

Se il titolo non è vuoto e lasci tipo o lingua senza valore, il risultato usa website per il tipo e en_US per la lingua.