Slik bruker du Nonlis HTML-metakoder

Q: Slik bruker du Nonlis HTML-metakoder

Fullstendig referanse for Nonlis HTML-metakoder: godtatte attributter, verdiformater, reserveløsninger, bildeplasser, artikkelmetadata og videoversjoner.

Med Nonlis HTML-metakoder kan en utgiver overstyre eller utfylle informasjonen som hentes fra en artikkelside. Denne referansen lister opp alle nli:*-kodene som den organiske scraperen støtter, den nøyaktige HTML-attributten hver kode godtar, og hva som skjer når koden mangler.

Bruk attributten som vises i tabellen. Støtten er med vilje ikke lik for alle: De fleste overstyringer av Open Graph og artikkeldata godtar bare property, nli:tag godtar bare name, og nyere generiske felt godtar begge.

1. Hurtigstart#

Plasser kodene i <head> på siden. Bruk verdier som ikke er tomme, eksplisitte tidssoner og absolutte offentlige HTTPS-URL-er for 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. Fullstendig oversikt over feltene#

«Første treff» betyr at bare én verdi beholdes. Ikke bruk både name og property for samme semantiske felt. «Ingen reserveløsning» betyr at målet forblir tomt når koden mangler.

Kode	Godtatt attributt	Antall verdier	Verdiformat	Tilordnet betydning	Prioritet eller sammenslåing	Reserveløsning når koden mangler	Tilgjengelighet
`nli:title`	`property`	Enkeltverdi	Ren tekst som ikke er tom	Open Graph-tittel	Erstatter konfigurerte verdier og `og:title`	Konfigurert XPath for tittel, deretter `og:title`	Tilgjengelig
`nli:description`	`property`	Enkeltverdi	Ren tekst som ikke er tom	Open Graph-beskrivelse	Erstatter konfigurerte verdier og `og:description`	Konfigurert XPath for beskrivelse, deretter `og:description`	Tilgjengelig
`nli:image`	`property`	Kan gjentas	Absolutt offentlig HTTPS-URL til et bilde	Samling av hovedbilder i Open Graph	Hele `nli:image`-listen erstatter vanlige artikkelbilder	Konfigurert XPath for bilde, deretter `og:image`, `og:image:url`, så `og:image:secure_url`	Tilgjengelig
`nli:image:alt`	`property`	Enkeltverdi	Ren tekst som ikke er tom	Alternativ tekst for hovedbildet	Erstatter `og:image:alt`	`og:image:alt`	Tilgjengelig
`nli:type`	`property`	Enkeltverdi	Open Graph-objekttype, for eksempel `article`	Open Graph-innholdstype	Erstatter `og:type`	`og:type`	Tilgjengelig
`nli:url`	`name` eller `property`	Enkeltverdi, første treff	Absolutt kanonisk HTTPS-URL	Kanonisk URL for organisk innhold	Har forrang over den kanoniske lenken	`<link rel="canonical">`	Tilgjengelig
`nli:content_tier`	`property`	Enkeltverdi	Tekst for nivå definert av utgiveren, for eksempel `free` eller `premium`	Innholdsnivå for artikkelen	Erstatter den tilsvarende `article:*`-verdien	`article:content_tier` med `property`, deretter `name`	Tilgjengelig
`nli:location`	`property`	Kan gjentas	Stedsnavn eller identifikator som ikke er tom	Samling av steder for artikkelen	`nli:location`-listen erstatter den tilsvarende `article:*`-listen	`article:location` med `property`, deretter `name`	Tilgjengelig
`nli:opinion`	`property`	Enkeltverdi	Merking av meningsstoff definert av utgiveren	Verdi for meningsstoff i artikkelen	Erstatter den tilsvarende `article:*`-verdien	`article:opinion` med `property`, deretter `name`	Tilgjengelig
`nli:author`	`property`	Kan gjentas	Forfatternavn eller absolutt URL til profilen	Samling av forfattere for artikkelen	`nli:author`-listen erstatter den tilsvarende `article:*`-listen	`article:author` med `property`, deretter `name`	Tilgjengelig
`nli:published_time`	`property`	Enkeltverdi	ISO 8601-dato og -klokkeslett med tidssone	Publiseringstidspunkt for artikkelen	Erstatter konfigurerte datoer og vanlige artikkeldatoer	Konfigurert XPath for dato, deretter `article:published_time`, så `og:article:published_time`	Tilgjengelig
`nli:modified_time`	`property`	Enkeltverdi	ISO 8601-dato og -klokkeslett med tidssone	Oppdateringstidspunkt for artikkelen	Erstatter den tilsvarende `article:*`-verdien	`article:modified_time` med `property`, deretter `name`	Tilgjengelig
`nli:section`	`property`	Enkeltverdi	Seksjonsnavn som ikke er tomt	Artikkelens seksjon	Erstatter den tilsvarende `article:*`-verdien	`article:section` med `property`, deretter `name`	Tilgjengelig
`nli:tag`	`name`	Kan gjentas	Én etikett per element	Renset samling av artikkeletiketter	Slås sammen med `article:tag` og etiketter fra konfigurert XPath, og erstatter dem ikke	De andre kildene til etiketter er fortsatt tilgjengelige	Tilgjengelig
`nli:image1`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Egendefinert bildeplass 1 for organisk innhold	Uavhengig av samlingen av hovedbilder	Ingen reserveløsning	Tilgjengelig
`nli:image2`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Egendefinert bildeplass 2 for organisk innhold	Uavhengig av samlingen av hovedbilder	Ingen reserveløsning	Tilgjengelig
`nli:image3`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Egendefinert bildeplass 3 for organisk innhold	Uavhengig av samlingen av hovedbilder	Ingen reserveløsning	Tilgjengelig
`nli:image4`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Egendefinert bildeplass 4 for organisk innhold	Uavhengig av samlingen av hovedbilder	Ingen reserveløsning	Tilgjengelig
`nli:image5`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Egendefinert bildeplass 5 for organisk innhold	Uavhengig av samlingen av hovedbilder	Ingen reserveløsning	Tilgjengelig
`nli:image6`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Egendefinert bildeplass 6 for organisk innhold	Uavhengig av samlingen av hovedbilder	Ingen reserveløsning	Tilgjengelig
`nli:video`	`name` eller `property`	Enkeltverdi, første treff	Direkte, absolutt offentlig HTTPS-URL til en video	Standardvideo eller eldre video for organisk innhold	En gyldig verdi erstatter den første Schema.org-video-URL-en som oppdages	Første gyldige Schema.org-`VideoObject`. Den eksisterende oppdagelsen og importen av miniatyrbilder gjelder	Tilgjengelig. Tilknytning av flere versjoner er planlagt i API #4640
`nli:video:image`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Miniatyrbilde for standardversjonen	Skal bare påvirke den tilhørende `nli:video`-versjonen	Eksisterende oppdagelse av miniatyrbilde for standardvideo	Planlagt i API #4640, støttes ikke for øyeblikket
`nli:short`	`name` eller `property`	Enkeltverdi, første treff	Direkte, absolutt offentlig HTTPS-URL til en video	Vertikal versjon eller kortversjon	Oppretter en versjon som er uavhengig av `nli:video`	Ingen kortversjon	Planlagt i API #4640, støttes ikke for øyeblikket
`nli:short:image`	`name` eller `property`	Enkeltverdi, første treff	Absolutt offentlig HTTPS-URL til et bilde	Miniatyrbilde for kortversjonen	Skal bare påvirke den tilhørende `nli:short`-versjonen	Eksisterende oppdagelse av miniatyrbilde for kortvideo	Planlagt i API #4640, støttes ikke for øyeblikket

3. Overstyre, gjenta eller slå sammen#

3.1. Overstyring av enkeltverdier#

Et felt med enkeltverdi beholder én verdi. Når en støttet nli:*-enkeltverdi finnes, har den forrang over den oppførte reserveløsningen. Bruk feltet én gang. For felt som godtar begge attributtene, gir bruk av begge et tvetydig førstetreff som avhenger av rekkefølgen i dokumentet.

3.2. Erstatning med gjentatte verdier#

Gjenta nli:image, nli:location eller nli:author én gang per verdi. Hvis minst én Nonli-spesifikk verdi blir funnet, erstatter den listen den tilsvarende Open Graph-listen eller article:*-listen.

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. Sammenslåtte etiketter#

nli:tag er det bevisste unntaket. Gjenta den med name. Nonli slår verdiene sammen med article:tag og eventuelle konfigurerte uttrekk av etiketter, og renser deretter den samlede listen.

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 må være gyldige ISO 8601-datoer og -klokkeslett med en eksplisitt tidssone. Disse eksemplene representerer nøyaktige 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">

Ikke bruk en verdi med bare dato, som 2026-08-25, eller et klokkeslett uten sone, som 2026-08-25T09:30:00. En ugyldig dato kan få skrapingen til å mislykkes i stedet for å aktivere reserveløsningen.

For bilder og videoer bruker du direkte, absolutte HTTPS-URL-er som returnerer mediefilen offentlig. Relative URL-er, HTML-spillersider, nettleserøkter, signerte URL-er som utløper og URL-er som krever informasjonskapsler, er usikre inndata for en integrasjon.

5. Hovedbilder, egendefinerte plasser og miniatyrbilder for video#

Disse bildefamiliene er uavhengige av hverandre:

nli:image er samlingen av hovedbilder for artikkelen, og den kan gjentas
nli:image1 til og med nli:image6 er seks separate egendefinerte plasser som brukes når roboter velger bilde
nli:video:image er planlagt som miniatyrbilde bare for standardvideoen
nli:short:image er planlagt som miniatyrbilde bare for kortvideoen

Et nummerert egendefinert bilde blir ikke med i nli:image og erstatter det ikke. Et miniatyrbilde for en versjon må aldri bli et artikkelbilde eller miniatyrbildet til den andre versjonen.

6. Standardversjon og kortversjon av video#

Per 25. august 2026 er bare nli:video tilgjengelig. API- og domenearbeidet som spores i nonli/api#4640, er fortsatt åpent, så nli:short, nli:video:image og nli:short:image må ikke brukes som inndata i produksjon ennå.

Den fullstendige målsyntaksen nedenfor er gitt for implementeringsplanlegging. Den blir først gyldig etter at API #4640 er utrullet og HTML-kompatibilitetstestene er bestått:

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

Etter utrullingen kan hver video stå alene. Et miniatyrbilde uten tilhørende video blir ignorert og oppretter ingen versjon. Hvis en versjon ikke har et eget miniatyrbilde, beholder versjonen den eksisterende oppdagelsen og importen sin, og den låner ikke bildet til den andre versjonen.

7. Tomme og ugyldige verdier#

Ikke bruk et meta-element når verdien er ukjent.
Tomme verdier for nli:video og nli:image1…nli:image6 blir ignorert.
For andre overstyringer kan et tomt element telle som til stede og undertrykke reserveløsningen. Bruk bare innhold som ikke er tomt.
En ugyldig nli:video-URL erstatter ikke en gyldig Schema.org-video.
En relativ nli:url kan løses opp mot den skrapte siden, men utgivere bør bruke én stabil, absolutt, kanonisk HTTPS-URL.
Hvis name- og property-versjonene av samme generiske felt finnes samtidig, vinner det første elementet som samsvarer. Bruk bare én av dem.

8. HTML eller MRSS?#

Bruk disse kodene når Nonli skraper en HTML-artikkelside. Hvis CMS-et ditt eksporterer en feed med videoressurser, bruker du i stedet veiledningen for MRSS-videofeeden. Den forklarer hvordan du grupperer standardversjoner og kortversjoner med egne miniatyrbilder i ett feedelement.

Var denne artikkelen nyttig?