De HTML-metatags van Nonli gebruiken

Q: De HTML-metatags van Nonli gebruiken

Volledige referentie voor de HTML-metatags van Nonli: geaccepteerde attributen, waardeformaten, terugvalopties, afbeeldingsslots, artikelmetadata en videoversies.

Met de HTML-metatags van Nonli kan een uitgever de gegevens die van een artikelpagina worden verzameld overschrijven of aanvullen. Deze referentie somt elke nli:*-tag op die de organische scraper ondersteunt, met het exacte HTML-attribuut dat de tag accepteert en wat er gebeurt wanneer de tag ontbreekt.

Gebruik het attribuut dat in de tabel staat. De ondersteuning is bewust niet uniform: de meeste Open Graph- en artikeloverschrijvingen accepteren alleen property, nli:tag accepteert alleen name, en nieuwere generieke velden accepteren beide.

1. Snel aan de slag#

Plaats de tags in de <head> van de pagina. Gebruik niet-lege waarden, expliciete tijdzones en absolute, openbare HTTPS-URL's voor media.

html

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. Volledig overzicht van de velden#

“Eerste match” betekent dat slechts één waarde wordt behouden; geef hetzelfde semantische veld niet op met zowel name als property. “Geen terugval” betekent dat de bestemming leeg blijft wanneer de tag ontbreekt.

Tag	Geaccepteerd attribuut	Kardinaliteit	Waardeformaat	Toegewezen betekenis	Voorrang of samenvoeggedrag	Terugval bij ontbreken	Beschikbaarheid
`nli:title`	`property`	Scalair	Niet-lege platte tekst	Open Graph-titel	Vervangt de geconfigureerde waarden en de `og:title`-waarden	Geconfigureerde XPath voor de titel, daarna `og:title`	Beschikbaar
`nli:description`	`property`	Scalair	Niet-lege platte tekst	Open Graph-beschrijving	Vervangt de geconfigureerde waarden en de `og:description`-waarden	Geconfigureerde XPath voor de beschrijving, daarna `og:description`	Beschikbaar
`nli:image`	`property`	Herhaalbaar	Absolute openbare HTTPS-URL van een afbeelding	Hoofdverzameling van Open Graph-afbeeldingen	De volledige `nli:image`-lijst vervangt de gewone artikelafbeeldingen	Geconfigureerde XPath voor afbeeldingen, daarna `og:image`, `og:image:url` en vervolgens `og:image:secure_url`	Beschikbaar
`nli:image:alt`	`property`	Scalair	Niet-lege platte tekst	Alternatieve tekst van de hoofdafbeelding	Vervangt `og:image:alt`	`og:image:alt`	Beschikbaar
`nli:type`	`property`	Scalair	Open Graph-objecttype, bijvoorbeeld `article`	Open Graph-contenttype	Vervangt `og:type`	`og:type`	Beschikbaar
`nli:url`	`name` of `property`	Scalair, eerste match	Absolute canonieke HTTPS-URL	Organische canonieke URL	Heeft voorrang op de canonieke link	`<link rel="canonical">`	Beschikbaar
`nli:content_tier`	`property`	Scalair	Door de uitgever gedefinieerde niveautekst, bijvoorbeeld `free` of `premium`	Contentniveau van het artikel	Vervangt de overeenkomstige `article:*`-waarde	`article:content_tier` met `property`, daarna met `name`	Beschikbaar
`nli:location`	`property`	Herhaalbaar	Niet-lege plaatsnaam of ID	Verzameling locaties van het artikel	De `nli:location`-lijst vervangt de overeenkomstige `article:*`-lijst	`article:location` met `property`, daarna met `name`	Beschikbaar
`nli:opinion`	`property`	Scalair	Door de uitgever gedefinieerde opiniemarkering	Opiniewaarde van het artikel	Vervangt de overeenkomstige `article:*`-waarde	`article:opinion` met `property`, daarna met `name`	Beschikbaar
`nli:author`	`property`	Herhaalbaar	Naam van de auteur of absolute profiel-URL	Verzameling auteurs van het artikel	De `nli:author`-lijst vervangt de overeenkomstige `article:*`-lijst	`article:author` met `property`, daarna met `name`	Beschikbaar
`nli:published_time`	`property`	Scalair	ISO 8601-datum en -tijd met tijdzone	Publicatietijdstip van het artikel	Vervangt de geconfigureerde en de gewone artikeldatums	Geconfigureerde XPath voor de datum, daarna `article:published_time` en vervolgens `og:article:published_time`	Beschikbaar
`nli:modified_time`	`property`	Scalair	ISO 8601-datum en -tijd met tijdzone	Tijdstip van bijwerking van het artikel	Vervangt de overeenkomstige `article:*`-waarde	`article:modified_time` met `property`, daarna met `name`	Beschikbaar
`nli:section`	`property`	Scalair	Niet-lege rubrieknaam	Rubriek van het artikel	Vervangt de overeenkomstige `article:*`-waarde	`article:section` met `property`, daarna met `name`	Beschikbaar
`nli:tag`	`name`	Herhaalbaar	Eén tag per element	Opgeschoonde verzameling artikeltags	Samengevoegd met `article:tag` en de tags uit de geconfigureerde XPath; vervangt deze niet	Andere tagbronnen blijven beschikbaar	Beschikbaar
`nli:image1`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Aangepast organisch afbeeldingsslot 1	Onafhankelijk van de hoofdverzameling afbeeldingen	Geen terugval	Beschikbaar
`nli:image2`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Aangepast organisch afbeeldingsslot 2	Onafhankelijk van de hoofdverzameling afbeeldingen	Geen terugval	Beschikbaar
`nli:image3`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Aangepast organisch afbeeldingsslot 3	Onafhankelijk van de hoofdverzameling afbeeldingen	Geen terugval	Beschikbaar
`nli:image4`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Aangepast organisch afbeeldingsslot 4	Onafhankelijk van de hoofdverzameling afbeeldingen	Geen terugval	Beschikbaar
`nli:image5`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Aangepast organisch afbeeldingsslot 5	Onafhankelijk van de hoofdverzameling afbeeldingen	Geen terugval	Beschikbaar
`nli:image6`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Aangepast organisch afbeeldingsslot 6	Onafhankelijk van de hoofdverzameling afbeeldingen	Geen terugval	Beschikbaar
`nli:video`	`name` of `property`	Scalair, eerste match	Directe absolute openbare HTTPS-URL van een video	Standaard- of oudere organische video	Een geldige waarde vervangt de eerst gevonden Schema.org-video-URL	Eerste geldige Schema.org-`VideoObject`; het bestaande gedrag voor het vinden en importeren van miniaturen blijft van toepassing	Beschikbaar; de koppeling van meerdere versies is gepland in API #4640
`nli:video:image`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Miniatuur van de standaardversie	Mag alleen de bijbehorende `nli:video`-versie beïnvloeden	Bestaande detectie van miniaturen voor standaardvideo's	Gepland in API #4640; momenteel niet ondersteund
`nli:short`	`name` of `property`	Scalair, eerste match	Directe absolute openbare HTTPS-URL van een video	Verticale of korte versie	Maakt een versie aan die onafhankelijk is van `nli:video`	Geen korte versie	Gepland in API #4640; momenteel niet ondersteund
`nli:short:image`	`name` of `property`	Scalair, eerste match	Absolute openbare HTTPS-URL van een afbeelding	Miniatuur van de korte versie	Mag alleen de bijbehorende `nli:short`-versie beïnvloeden	Bestaande detectie van miniaturen voor korte video's	Gepland in API #4640; momenteel niet ondersteund

3. Overschrijven, herhalen of samenvoegen#

3.1. Scalaire overschrijvingen#

Een scalair veld behoudt één waarde. Wanneer een ondersteunde scalaire nli:*-tag aanwezig is, heeft die voorrang op de vermelde terugval. Geef het veld één keer op. Bij velden die beide attributen accepteren, leidt het gebruik van beide tot een dubbelzinnig resultaat van de eerste match, dat afhangt van de volgorde in het document.

3.2. Herhaalbare vervangingen#

Herhaal nli:image, nli:location of nli:author één keer per waarde. Als ten minste één Nonli-specifieke waarde wordt gevonden, vervangt die lijst de overeenkomstige Open Graph- of article:*-lijst.

html

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. Samengevoegde tags#

nli:tag is de bewuste uitzondering. Herhaal deze tag met name; Nonli voegt de waarden samen met article:tag en eventuele geconfigureerde tagextractors, en schoont daarna de gecombineerde lijst op.

html

1<meta property="article:tag" content="Europe">
2<meta name="nli:tag" content="European Union">
3<meta name="nli:tag" content="elections">

4. Datums en URL's#

Datums moeten geldige ISO 8601-datum-tijdwaarden zijn met een expliciete tijdzone. Deze voorbeelden geven precieze tijdstippen weer:

html

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">

Gebruik geen waarde met alleen een datum, zoals 2026-08-25, of een tijd zonder tijdzone, zoals 2026-08-25T09:30:00. Een ongeldige datum kan ervoor zorgen dat het scrapen mislukt in plaats van dat de terugval wordt geactiveerd.

Gebruik voor afbeeldingen en video's directe, absolute HTTPS-URL's die het mediabestand openbaar teruggeven. Relatieve URL's, HTML-spelerpagina's, browsersessies, verlopende ondertekende URL's en URL's waarvoor cookies nodig zijn, zijn onveilige invoer voor een integratie.

5. Hoofdafbeeldingen, aangepaste slots en videominiaturen#

Deze afbeeldingsfamilies zijn onafhankelijk van elkaar:

nli:image is de herhaalbare verzameling hoofdafbeeldingen van het artikel;
nli:image1 tot en met nli:image6 zijn zes afzonderlijke aangepaste slots die bij de afbeeldingsselectie van bots worden gebruikt;
nli:video:image is gepland als miniatuur van alleen de standaardvideo;
nli:short:image is gepland als miniatuur van alleen de korte video.

Een genummerde aangepaste afbeelding wordt niet aan nli:image toegevoegd en vervangt die ook niet. Een miniatuur van een versie mag nooit een artikelafbeelding worden of de miniatuur van de andere versie.

6. Standaard- en korte videoversies#

Op 25 augustus 2026 is alleen nli:video beschikbaar. Het API- en domeinwerk dat wordt gevolgd in nonli/api#4640 loopt nog, dus nli:short, nli:video:image en nli:short:image mogen nog niet als productie-invoer worden gebruikt.

De volledige doelsyntaxis hieronder is bedoeld voor de implementatieplanning. Deze wordt pas geldig nadat API #4640 is uitgerold en de HTML-compatibiliteitstests ervan slagen:

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">

Na de uitrol mag elke video afzonderlijk voorkomen. Een miniatuur zonder bijbehorende video wordt genegeerd en maakt geen versie aan. Als een versie geen eigen miniatuur heeft, behoudt die het bestaande detectie- en importgedrag van die versie en leent die niet de afbeelding van de andere versie.

7. Lege en ongeldige waarden#

Geef geen meta-element op wanneer de waarde ervan onbekend is.
Lege waarden voor nli:video en nli:image1…nli:image6 worden genegeerd.
Bij andere overschrijvingen kan een leeg element als aanwezig gelden en de terugval onderdrukken; gebruik alleen niet-lege content.
Een ongeldige nli:video-URL vervangt geen geldige Schema.org-video.
Een relatieve nli:url kan ten opzichte van de gescrapete pagina worden omgezet, maar uitgevers moeten één stabiele, absolute canonieke HTTPS-URL opgeven.
Als name- en property-versies van hetzelfde generieke veld naast elkaar bestaan, wint het eerste overeenkomende element; geef er maar één op.

8. HTML of MRSS?#

Gebruik deze tags wanneer Nonli een HTML-artikelpagina scrapet. Als uw CMS een feed met videobestanden exporteert, gebruik dan in plaats daarvan de handleiding voor de MRSS-videofeed. Daarin leest u hoe u standaard- en korte versies met hun eigen miniaturen in één feeditem groepeert.

Was dit artikel nuttig?