Sådan bruger du Nonlis HTML-metatags

Med Nonlis HTML-metatags kan en udgiver tilsidesætte eller berige de oplysninger der indsamles fra en artikelside. Denne reference viser alle nli:*-tags som den organiske scraper understøtter, den præcise HTML-attribut hvert tag accepterer, og hvad der sker når tagget mangler.

Brug den attribut der står i tabellen. Understøttelsen er bevidst ikke ens for alle tags: de fleste tilsidesættelser af Open Graph og artikeldata accepterer kun property, nli:tag accepterer kun name, og nyere generiske felter accepterer begge.

1. Kom hurtigt i gang#

Placer tags i sidens <head>. Brug værdier der ikke er tomme, angiv tidszoner udtrykkeligt, og brug absolutte, offentlige HTTPS-URL'er til medier.

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. Komplet oversigt over felter#

»Første match« betyder at kun én værdi bevares; angiv ikke det samme semantiske felt med både name og property. »Ingen reserveværdi« betyder at destinationen forbliver tom når tagget mangler.

TagAccepteret attributKardinalitetVærdiformatTilknyttet betydningPrioritet eller sammenfletningReserveværdi når tagget manglerTilgængelighed
nli:titlepropertySkalarAlmindelig tekst, ikke tomOpen Graph-titelErstatter konfigurerede værdier og og:title-værdierKonfigureret XPath til titlen, derefter og:titleTilgængelig
nli:descriptionpropertySkalarAlmindelig tekst, ikke tomOpen Graph-beskrivelseErstatter konfigurerede værdier og og:description-værdierKonfigureret XPath til beskrivelsen, derefter og:descriptionTilgængelig
nli:imagepropertyKan gentagesAbsolut, offentlig HTTPS-URL til et billedePrimær samling af Open Graph-billederHele nli:image-listen erstatter almindelige artikelbillederKonfigureret XPath til billedet, derefter og:image, og:image:url og til sidst og:image:secure_urlTilgængelig
nli:image:altpropertySkalarAlmindelig tekst, ikke tomAlternativ tekst til det primære billedeErstatter og:image:altog:image:altTilgængelig
nli:typepropertySkalarOpen Graph-objekttype, for eksempel articleOpen Graph-indholdstypeErstatter og:typeog:typeTilgængelig
nli:urlname eller propertySkalar, første matchAbsolut, kanonisk HTTPS-URLOrganisk kanonisk URLHar forrang for det kanoniske link<link rel="canonical">Tilgængelig
nli:content_tierpropertySkalarNiveautekst defineret af udgiveren, for eksempel free eller premiumArtiklens indholdsniveauErstatter den tilsvarende article:*-værdiarticle:content_tier med property, derefter nameTilgængelig
nli:locationpropertyKan gentagesStedsnavn eller identifikator, ikke tomSamling af artikelstedernli:location-listen erstatter den tilsvarende article:*-listearticle:location med property, derefter nameTilgængelig
nli:opinionpropertySkalarOpinionsmarkør defineret af udgiverenArtiklens opinionsværdiErstatter den tilsvarende article:*-værdiarticle:opinion med property, derefter nameTilgængelig
nli:authorpropertyKan gentagesForfatternavn eller absolut profil-URLSamling af artikelforfatterenli:author-listen erstatter den tilsvarende article:*-listearticle:author med property, derefter nameTilgængelig
nli:published_timepropertySkalarISO 8601-dato og -klokkeslæt med tidszoneArtiklens publiceringstidspunktErstatter konfigurerede og almindelige artikeldatoerKonfigureret XPath til datoen, derefter article:published_time og til sidst og:article:published_timeTilgængelig
nli:modified_timepropertySkalarISO 8601-dato og -klokkeslæt med tidszoneArtiklens opdateringstidspunktErstatter den tilsvarende article:*-værdiarticle:modified_time med property, derefter nameTilgængelig
nli:sectionpropertySkalarSektionsnavn, ikke tomtArtikelsektionErstatter den tilsvarende article:*-værdiarticle:section med property, derefter nameTilgængelig
nli:tagnameKan gentagesÉt tag pr. elementRenset samling af artikeltagsFlettes med article:tag og konfigurerede XPath-tags; erstatter dem ikkeAndre tagkilder er stadig tilgængeligeTilgængelig
nli:image1name eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeTilpasset organisk billedplads 1Uafhængig af den primære billedsamlingIngen reserveværdiTilgængelig
nli:image2name eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeTilpasset organisk billedplads 2Uafhængig af den primære billedsamlingIngen reserveværdiTilgængelig
nli:image3name eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeTilpasset organisk billedplads 3Uafhængig af den primære billedsamlingIngen reserveværdiTilgængelig
nli:image4name eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeTilpasset organisk billedplads 4Uafhængig af den primære billedsamlingIngen reserveværdiTilgængelig
nli:image5name eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeTilpasset organisk billedplads 5Uafhængig af den primære billedsamlingIngen reserveværdiTilgængelig
nli:image6name eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeTilpasset organisk billedplads 6Uafhængig af den primære billedsamlingIngen reserveværdiTilgængelig
nli:videoname eller propertySkalar, første matchDirekte, absolut, offentlig HTTPS-URL til en videoOrganisk standardvideo eller ældre organisk videoEn gyldig værdi erstatter den første fundne Schema.org-video-URLFørste gyldige Schema.org-VideoObject; den eksisterende adfærd for fund og import af miniaturer gælderTilgængelig; tilknytning af flere udgaver er planlagt i API #4640
nli:video:imagename eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeMiniature til standardudgavenMå kun påvirke den tilsvarende nli:video-udgaveEksisterende fund af miniaturer til standardvideoerPlanlagt i API #4640; understøttes ikke i øjeblikket
nli:shortname eller propertySkalar, første matchDirekte, absolut, offentlig HTTPS-URL til en videoLodret eller kort udgaveOpretter en udgave uafhængigt af nli:videoIngen kort udgavePlanlagt i API #4640; understøttes ikke i øjeblikket
nli:short:imagename eller propertySkalar, første matchAbsolut, offentlig HTTPS-URL til et billedeMiniature til den korte udgaveMå kun påvirke den tilsvarende nli:short-udgaveEksisterende fund af miniaturer til korte videoerPlanlagt i API #4640; understøttes ikke i øjeblikket

3. Tilsidesæt, gentag eller flet#

3.1. Skalare tilsidesættelser#

Et skalart felt beholder én værdi. Når en understøttet nli:*-skalar er til stede, har den forrang for den angivne reserveværdi. Angiv feltet én gang. Hvis et felt accepterer begge attributter og du bruger begge, får du et tvetydigt resultat af første match der afhænger af rækkefølgen i dokumentet.

3.2. Gentagelige erstatninger#

Gentag nli:image, nli:location eller nli:author én gang pr. værdi. Hvis der findes mindst én Nonli-specifik værdi, erstatter listen den tilsvarende Open Graph- eller article:*-liste.

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

nli:tag er den bevidste undtagelse. Gentag det med name, så fletter Nonli værdierne med article:tag og eventuelle konfigurerede tagudtrækkere og renser derefter den samlede liste.

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

4. Datoer og URL'er#

Datoer skal være gyldige ISO 8601-datoer med klokkeslæt og en udtrykkelig tidszone. Disse eksempler angiver præcise tidspunkter:

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

Brug ikke en værdi med kun en dato, som 2026-08-25, eller et klokkeslæt uden tidszone, som 2026-08-25T09:30:00. En ugyldig dato kan få scrapingen til at mislykkes i stedet for at aktivere reserveværdien.

Brug direkte, absolutte HTTPS-URL'er til billeder og videoer, og sørg for at de returnerer mediefilen offentligt. Relative URL'er, HTML-sider med en afspiller, browsersessioner, signerede URL'er der udløber, og URL'er der kræver cookies, er usikre input til en integration.

5. Primære billeder, tilpassede billedpladser og videominiaturer#

Disse billedgrupper er uafhængige af hinanden:

  • nli:image er den primære samling af artikelbilleder og kan gentages;
  • nli:image1 til og med nli:image6 er seks separate tilpassede billedpladser som robotternes billedvalg bruger;
  • nli:video:image er planlagt som miniature til standardvideoen alene;
  • nli:short:image er planlagt som miniature til den korte video alene.

Et nummereret tilpasset billede bliver ikke en del af nli:image og erstatter det heller ikke. En miniature til en udgave må aldrig blive et artikelbillede eller miniature til den anden udgave.

6. Standardudgave og kort udgave af video#

Pr. 25. august 2026 er kun nli:video tilgængelig. API- og domænearbejdet der følges i nonli/api#4640, er stadig åbent, så nli:short, nli:video:image og nli:short:image må endnu ikke bruges som input i produktion.

Den komplette målsyntaks nedenfor er til brug i planlægningen af implementeringen. Den bliver først gyldig når API #4640 er udrullet og dets HTML-kompatibilitetstest er bestået:

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

Efter udrulningen kan hver video optræde alene. En miniature uden den tilhørende video bliver ignoreret og opretter ikke en udgave. Hvis en udgave ikke har sin egen miniature, beholder den sin eksisterende adfærd for fund og import og låner ikke billedet fra den anden udgave.

7. Tomme og ugyldige værdier#

  • Angiv ikke et metaelement når værdien er ukendt.
  • Tomme værdier i nli:video og nli:image1…nli:image6 ignoreres.
  • For andre tilsidesættelser kan et tomt element tælle som til stede og forhindre at reserveværdien bruges; brug kun indhold der ikke er tomt.
  • En ugyldig nli:video-URL erstatter ikke en gyldig Schema.org-video.
  • En relativ nli:url kan opløses i forhold til den scrapede side, men udgivere bør angive én stabil, absolut, kanonisk HTTPS-URL.
  • Hvis både en name-version og en property-version af det samme generiske felt findes, vinder det første matchende element; angiv kun ét.

8. HTML eller MRSS?#

Brug disse tags når Nonli scraper en HTML-artikelside. Hvis dit CMS eksporterer et feed med videomaterialer, skal du i stedet bruge guiden til video-MRSS-feeds. Den forklarer hvordan du samler standardudgaver og korte udgaver med hver deres miniature i ét feedelement.

Var denne artikel nyttig?

Book en personlig demo med vores team.