I meta tag HTML di Nonli permettono a un editore di sostituire o arricchire le informazioni raccolte dalla pagina di un articolo. Questo riferimento elenca ogni tag nli:* supportato dallo scraper organico, l'attributo HTML esatto che accetta e che cosa succede quando il tag è assente.
Usa l'attributo indicato nella tabella. Il supporto è volutamente non uniforme: la maggior parte degli override di Open Graph e dell'articolo accetta solo property, nli:tag accetta solo name e i campi generici più recenti accettano entrambi.
1. Avvio rapido#
Inserisci i tag nel <head> della pagina. Usa valori non vuoti, fusi orari espliciti e URL HTTPS pubblici assoluti per i contenuti multimediali.
1<meta property="nli:title" content="City council approves the 2027 budget">2<meta property="nli:description" content="The council approved the budget after a three-hour debate.">3<meta property="nli:type" content="article">4<meta name="nli:url" content="https://news.example.com/politics/city-budget-2027">5
6<meta property="nli:image" content="https://media.example.com/city-budget-wide.jpg">7<meta property="nli:image:alt" content="Councillors voting in the city chamber">8
9<meta property="nli:author" content="Alex Morgan">10<meta property="nli:published_time" content="2026-08-25T09:30:00+02:00">11<meta property="nli:modified_time" content="2026-08-25T10:15:00+02:00">12<meta property="nli:section" content="Politics">13<meta name="nli:tag" content="city council">14<meta name="nli:tag" content="budget">15
16<meta name="nli:video" content="https://media.example.com/city-budget-16x9.mp4">2. Inventario completo dei campi#
«Prima corrispondenza» significa che viene mantenuto un solo valore: non emettere lo stesso campo semantico sia con name sia con property. «Nessun fallback» significa che la destinazione resta vuota quando il tag è assente.
| Tag | Attributo accettato | Cardinalità | Formato del valore | Significato associato | Precedenza o comportamento di unione | Fallback in assenza | Disponibilità |
|---|---|---|---|---|---|---|---|
nli:title | property | Scalare | Testo semplice non vuoto | Titolo Open Graph | Sostituisce i valori configurati e og:title | XPath del titolo configurato, poi og:title | Disponibile |
nli:description | property | Scalare | Testo semplice non vuoto | Descrizione Open Graph | Sostituisce i valori configurati e og:description | XPath della descrizione configurata, poi og:description | Disponibile |
nli:image | property | Ripetibile | URL assoluto HTTPS pubblico di un'immagine | Raccolta delle immagini Open Graph principali | L'intero elenco nli:image sostituisce le immagini ordinarie dell'articolo | XPath dell'immagine configurata, poi og:image, og:image:url, poi og:image:secure_url | Disponibile |
nli:image:alt | property | Scalare | Testo semplice non vuoto | Testo alternativo dell'immagine principale | Sostituisce og:image:alt | og:image:alt | Disponibile |
nli:type | property | Scalare | Tipo di oggetto Open Graph, ad esempio article | Tipo di contenuto Open Graph | Sostituisce og:type | og:type | Disponibile |
nli:url | name o property | Scalare, prima corrispondenza | URL canonico assoluto HTTPS | URL canonico organico | Ha la priorità sul link canonical | <link rel="canonical"> | Disponibile |
nli:content_tier | property | Scalare | Testo del livello definito dall'editore, ad esempio free o premium | Livello di contenuto dell'articolo | Sostituisce il valore article:* corrispondente | article:content_tier con property, poi name | Disponibile |
nli:location | property | Ripetibile | Nome o identificatore di luogo non vuoto | Raccolta dei luoghi dell'articolo | L'elenco nli:location sostituisce l'elenco article:* corrispondente | article:location con property, poi name | Disponibile |
nli:opinion | property | Scalare | Indicatore di opinione definito dall'editore | Valore di opinione dell'articolo | Sostituisce il valore article:* corrispondente | article:opinion con property, poi name | Disponibile |
nli:author | property | Ripetibile | Nome dell'autore o URL assoluto del profilo | Raccolta degli autori dell'articolo | L'elenco nli:author sostituisce l'elenco article:* corrispondente | article:author con property, poi name | Disponibile |
nli:published_time | property | Scalare | Data e ora ISO 8601 con fuso orario | Data di pubblicazione dell'articolo | Sostituisce le date configurate e le date ordinarie dell'articolo | XPath della data configurata, poi article:published_time, poi og:article:published_time | Disponibile |
nli:modified_time | property | Scalare | Data e ora ISO 8601 con fuso orario | Data di aggiornamento dell'articolo | Sostituisce il valore article:* corrispondente | article:modified_time con property, poi name | Disponibile |
nli:section | property | Scalare | Nome di sezione non vuoto | Sezione dell'articolo | Sostituisce il valore article:* corrispondente | article:section con property, poi name | Disponibile |
nli:tag | name | Ripetibile | Un tag per elemento | Raccolta dei tag dell'articolo ripuliti | Unito a article:tag e ai tag degli XPath configurati; non li sostituisce | Le altre fonti di tag restano disponibili | Disponibile |
nli:image1 | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Slot immagine organico personalizzato 1 | Indipendente dalla raccolta delle immagini principali | Nessun fallback | Disponibile |
nli:image2 | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Slot immagine organico personalizzato 2 | Indipendente dalla raccolta delle immagini principali | Nessun fallback | Disponibile |
nli:image3 | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Slot immagine organico personalizzato 3 | Indipendente dalla raccolta delle immagini principali | Nessun fallback | Disponibile |
nli:image4 | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Slot immagine organico personalizzato 4 | Indipendente dalla raccolta delle immagini principali | Nessun fallback | Disponibile |
nli:image5 | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Slot immagine organico personalizzato 5 | Indipendente dalla raccolta delle immagini principali | Nessun fallback | Disponibile |
nli:image6 | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Slot immagine organico personalizzato 6 | Indipendente dalla raccolta delle immagini principali | Nessun fallback | Disponibile |
nli:video | name o property | Scalare, prima corrispondenza | URL HTTPS pubblico assoluto e diretto di un video | Video organico standard o legacy | Un valore valido sostituisce il primo URL video Schema.org individuato | Primo VideoObject Schema.org valido; si applica il comportamento esistente di individuazione e importazione della miniatura | Disponibile; l'associazione di più versioni è pianificata nell'API #4640 |
nli:video:image | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Miniatura della versione standard | Deve riguardare solo la versione nli:video corrispondente | Individuazione esistente della miniatura del video standard | Pianificato nell'API #4640; non ancora supportato |
nli:short | name o property | Scalare, prima corrispondenza | URL HTTPS pubblico assoluto e diretto di un video | Versione verticale o short | Crea una versione indipendente da nli:video | Nessuna versione short | Pianificato nell'API #4640; non ancora supportato |
nli:short:image | name o property | Scalare, prima corrispondenza | URL assoluto HTTPS pubblico di un'immagine | Miniatura della versione short | Deve riguardare solo la versione nli:short corrispondente | Individuazione esistente della miniatura del video short | Pianificato nell'API #4640; non ancora supportato |
3. Sostituire, ripetere o unire#
3.1. Override scalari#
Un campo scalare mantiene un solo valore. Quando è presente un campo scalare nli:* supportato, ha la priorità sul fallback indicato. Emetti il campo una sola volta. Per i campi che accettano entrambi gli attributi, usarli entrambi crea un risultato ambiguo di prima corrispondenza, che dipende dall'ordine del documento.
3.2. Sostituzioni ripetibili#
Ripeti nli:image, nli:location o nli:author una volta per ogni valore. Se viene trovato almeno un valore specifico di Nonli, quell'elenco sostituisce l'elenco Open Graph o article:* corrispondente.
1<meta property="nli:image" content="https://media.example.com/story-wide.jpg">2<meta property="nli:image" content="https://media.example.com/story-square.jpg">3<meta property="nli:author" content="Alex Morgan">4<meta property="nli:author" content="Sam Lee">5<meta property="nli:location" content="Paris">6<meta property="nli:location" content="Brussels">3.3. Tag uniti#
nli:tag è l'eccezione voluta. Ripetilo con name: Nonli unisce i suoi valori a article:tag e a qualsiasi estrattore di tag configurato, poi ripulisce l'elenco combinato.
1<meta property="article:tag" content="Europe">2<meta name="nli:tag" content="European Union">3<meta name="nli:tag" content="elections">4. Date e URL#
Le date devono essere valide date e ore ISO 8601 con un fuso orario esplicito. Questi esempi rappresentano istanti precisi:
1<meta property="nli:published_time" content="2026-08-25T09:30:00+02:00">2<meta property="nli:modified_time" content="2026-08-25T08:15:00Z">Non usare un valore con la sola data come 2026-08-25 né un'ora senza fuso orario come 2026-08-25T09:30:00. Una data non valida può far fallire lo scraping invece di attivare il fallback.
Per immagini e video usa URL HTTPS diretti e assoluti che restituiscono pubblicamente il file multimediale. URL relativi, pagine di player HTML, sessioni del browser, URL firmati con scadenza e URL che richiedono cookie sono input di integrazione poco sicuri.
5. Immagini principali, slot personalizzati e miniature video#
Queste famiglie di immagini sono indipendenti:
nli:imageè la raccolta ripetibile delle immagini principali dell'articolo;- da
nli:image1anli:image6sono sei slot personalizzati distinti, usati dalla selezione delle immagini dei bot; nli:video:imageè pianificato come miniatura del solo video standard;nli:short:imageè pianificato come miniatura del solo video short.
Un'immagine personalizzata numerata non si unisce a nli:image né la sostituisce. La miniatura di una versione non deve mai diventare un'immagine dell'articolo né la miniatura dell'altra versione.
6. Versioni video standard e short#
Al 25 agosto 2026 è disponibile solo nli:video. Il lavoro su API e dominio tracciato da nonli/api#4640 è ancora aperto, quindi nli:short, nli:video:image e nli:short:image non devono ancora essere usati come input di produzione.
La sintassi completa di destinazione qui sotto è fornita per la pianificazione dell'implementazione. Diventa valida solo dopo il rilascio dell'API #4640 e il superamento dei suoi test di compatibilità HTML:
1<!-- Available today; becomes the standard rendition in the multi-rendition contract -->2<meta name="nli:video" content="https://media.example.com/report-16x9.mp4">3
4<!-- Planned in API #4640; not currently supported -->5<meta name="nli:video:image" content="https://media.example.com/report-16x9.jpg">6<meta name="nli:short" content="https://media.example.com/report-9x16.mp4">7<meta name="nli:short:image" content="https://media.example.com/report-9x16.jpg">Una volta rilasciato, ogni video potrà comparire da solo. Una miniatura senza il video corrispondente verrà ignorata e non creerà una versione. Se una versione non ha una miniatura dedicata, manterrà il comportamento esistente di individuazione e importazione di quella versione e non prenderà in prestito l'immagine dell'altra.
7. Valori vuoti e non validi#
- Non emettere un elemento meta quando il suo valore è sconosciuto.
- I valori vuoti di
nli:videoe danli:image1anli:image6vengono ignorati. - Per gli altri override, un elemento vuoto può essere considerato presente e impedire il fallback: usa solo contenuti non vuoti.
- Un URL
nli:videonon valido non sostituisce un video Schema.org valido. - Un
nli:urlrelativo può essere risolto rispetto alla pagina analizzata, ma gli editori dovrebbero emettere un unico URL canonico HTTPS assoluto e stabile. - Se coesistono le versioni
nameepropertydello stesso campo generico, vince il primo elemento corrispondente: emettine uno solo.
8. HTML o MRSS?#
Usa questi tag quando Nonli analizza la pagina HTML di un articolo. Se il tuo CMS esporta un feed con asset video, usa invece la guida al feed MRSS video. Spiega come raggruppare in un unico elemento del feed le versioni standard e short con le rispettive miniature.