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.
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.
| Tag | Accepteret attribut | Kardinalitet | Værdiformat | Tilknyttet betydning | Prioritet eller sammenfletning | Reserveværdi når tagget mangler | Tilgængelighed |
|---|---|---|---|---|---|---|---|
nli:title | property | Skalar | Almindelig tekst, ikke tom | Open Graph-titel | Erstatter konfigurerede værdier og og:title-værdier | Konfigureret XPath til titlen, derefter og:title | Tilgængelig |
nli:description | property | Skalar | Almindelig tekst, ikke tom | Open Graph-beskrivelse | Erstatter konfigurerede værdier og og:description-værdier | Konfigureret XPath til beskrivelsen, derefter og:description | Tilgængelig |
nli:image | property | Kan gentages | Absolut, offentlig HTTPS-URL til et billede | Primær samling af Open Graph-billeder | Hele nli:image-listen erstatter almindelige artikelbilleder | Konfigureret XPath til billedet, derefter og:image, og:image:url og til sidst og:image:secure_url | Tilgængelig |
nli:image:alt | property | Skalar | Almindelig tekst, ikke tom | Alternativ tekst til det primære billede | Erstatter og:image:alt | og:image:alt | Tilgængelig |
nli:type | property | Skalar | Open Graph-objekttype, for eksempel article | Open Graph-indholdstype | Erstatter og:type | og:type | Tilgængelig |
nli:url | name eller property | Skalar, første match | Absolut, kanonisk HTTPS-URL | Organisk kanonisk URL | Har forrang for det kanoniske link | <link rel="canonical"> | Tilgængelig |
nli:content_tier | property | Skalar | Niveautekst defineret af udgiveren, for eksempel free eller premium | Artiklens indholdsniveau | Erstatter den tilsvarende article:*-værdi | article:content_tier med property, derefter name | Tilgængelig |
nli:location | property | Kan gentages | Stedsnavn eller identifikator, ikke tom | Samling af artikelsteder | nli:location-listen erstatter den tilsvarende article:*-liste | article:location med property, derefter name | Tilgængelig |
nli:opinion | property | Skalar | Opinionsmarkør defineret af udgiveren | Artiklens opinionsværdi | Erstatter den tilsvarende article:*-værdi | article:opinion med property, derefter name | Tilgængelig |
nli:author | property | Kan gentages | Forfatternavn eller absolut profil-URL | Samling af artikelforfattere | nli:author-listen erstatter den tilsvarende article:*-liste | article:author med property, derefter name | Tilgængelig |
nli:published_time | property | Skalar | ISO 8601-dato og -klokkeslæt med tidszone | Artiklens publiceringstidspunkt | Erstatter konfigurerede og almindelige artikeldatoer | Konfigureret XPath til datoen, derefter article:published_time og til sidst og:article:published_time | Tilgængelig |
nli:modified_time | property | Skalar | ISO 8601-dato og -klokkeslæt med tidszone | Artiklens opdateringstidspunkt | Erstatter den tilsvarende article:*-værdi | article:modified_time med property, derefter name | Tilgængelig |
nli:section | property | Skalar | Sektionsnavn, ikke tomt | Artikelsektion | Erstatter den tilsvarende article:*-værdi | article:section med property, derefter name | Tilgængelig |
nli:tag | name | Kan gentages | Ét tag pr. element | Renset samling af artikeltags | Flettes med article:tag og konfigurerede XPath-tags; erstatter dem ikke | Andre tagkilder er stadig tilgængelige | Tilgængelig |
nli:image1 | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Tilpasset organisk billedplads 1 | Uafhængig af den primære billedsamling | Ingen reserveværdi | Tilgængelig |
nli:image2 | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Tilpasset organisk billedplads 2 | Uafhængig af den primære billedsamling | Ingen reserveværdi | Tilgængelig |
nli:image3 | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Tilpasset organisk billedplads 3 | Uafhængig af den primære billedsamling | Ingen reserveværdi | Tilgængelig |
nli:image4 | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Tilpasset organisk billedplads 4 | Uafhængig af den primære billedsamling | Ingen reserveværdi | Tilgængelig |
nli:image5 | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Tilpasset organisk billedplads 5 | Uafhængig af den primære billedsamling | Ingen reserveværdi | Tilgængelig |
nli:image6 | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Tilpasset organisk billedplads 6 | Uafhængig af den primære billedsamling | Ingen reserveværdi | Tilgængelig |
nli:video | name eller property | Skalar, første match | Direkte, absolut, offentlig HTTPS-URL til en video | Organisk standardvideo eller ældre organisk video | En gyldig værdi erstatter den første fundne Schema.org-video-URL | Første gyldige Schema.org-VideoObject; den eksisterende adfærd for fund og import af miniaturer gælder | Tilgængelig; tilknytning af flere udgaver er planlagt i API #4640 |
nli:video:image | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Miniature til standardudgaven | Må kun påvirke den tilsvarende nli:video-udgave | Eksisterende fund af miniaturer til standardvideoer | Planlagt i API #4640; understøttes ikke i øjeblikket |
nli:short | name eller property | Skalar, første match | Direkte, absolut, offentlig HTTPS-URL til en video | Lodret eller kort udgave | Opretter en udgave uafhængigt af nli:video | Ingen kort udgave | Planlagt i API #4640; understøttes ikke i øjeblikket |
nli:short:image | name eller property | Skalar, første match | Absolut, offentlig HTTPS-URL til et billede | Miniature til den korte udgave | Må kun påvirke den tilsvarende nli:short-udgave | Eksisterende fund af miniaturer til korte videoer | Planlagt 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.
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.
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:
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:imageer den primære samling af artikelbilleder og kan gentages;nli:image1til og mednli:image6er seks separate tilpassede billedpladser som robotternes billedvalg bruger;nli:video:imageer planlagt som miniature til standardvideoen alene;nli:short:imageer 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:
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:videoognli:image1…nli:image6ignoreres. - 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:urlkan 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 enproperty-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.