Så använder du Nonlis HTML-metataggar

Q: Så använder du Nonlis HTML-metataggar

Fullständig referens för Nonlis HTML-metataggar: accepterade attribut, värdeformat, reservvärden, bildplatser, artikelmetadata och videoversioner.

Med Nonlis HTML-metataggar kan en utgivare ersätta eller berika informationen som samlas in från en artikelsida. Den här referensen listar varje nli:*-tagg som stöds av den organiska insamlingen (scraper), exakt vilket HTML-attribut taggen accepterar och vad som händer när taggen saknas.

Använd det attribut som anges i tabellen. Stödet är avsiktligt inte enhetligt: de flesta ersättningar för Open Graph och artiklar accepterar bara property, nli:tag accepterar bara name och nyare generiska fält accepterar båda.

1. Snabbstart#

Placera taggarna i sidans <head>. Använd värden som inte är tomma, tydliga tidszoner och absoluta, publika HTTPS-URL:er för 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. Fullständig förteckning över fälten#

”Första träff” betyder att bara ett värde behålls; ange inte samma semantiska fält med både name och property. ”Inget reservvärde” betyder att målfältet förblir tomt när taggen saknas.

Tagg	Accepterat attribut	Kardinalitet	Värdeformat	Motsvarande betydelse	Prioritet eller sammanslagning	Reservvärde när taggen saknas	Tillgänglighet
`nli:title`	`property`	Skalär	Ren text som inte är tom	Open Graph-titel	Ersätter konfigurerade värden och `og:title`	Konfigurerad XPath för titel, sedan `og:title`	Tillgänglig
`nli:description`	`property`	Skalär	Ren text som inte är tom	Open Graph-beskrivning	Ersätter konfigurerade värden och `og:description`	Konfigurerad XPath för beskrivning, sedan `og:description`	Tillgänglig
`nli:image`	`property`	Upprepbar	Absolut, publik HTTPS-URL till en bild	Huvudsaklig samling av Open Graph-bilder	Hela `nli:image`-listan ersätter artikelns vanliga bilder	Konfigurerad XPath för bild, sedan `og:image`, `og:image:url` och därefter `og:image:secure_url`	Tillgänglig
`nli:image:alt`	`property`	Skalär	Ren text som inte är tom	Alternativtext för huvudbilden	Ersätter `og:image:alt`	`og:image:alt`	Tillgänglig
`nli:type`	`property`	Skalär	Objekttyp enligt Open Graph, till exempel `article`	Innehållstyp enligt Open Graph	Ersätter `og:type`	`og:type`	Tillgänglig
`nli:url`	`name` eller `property`	Skalär, första träff	Absolut, kanonisk HTTPS-URL	Organisk kanonisk URL	Har företräde framför den kanoniska länken	`<link rel="canonical">`	Tillgänglig
`nli:content_tier`	`property`	Skalär	Text för innehållsnivå som utgivaren definierar, till exempel `free` eller `premium`	Artikelns innehållsnivå	Ersätter motsvarande `article:*`-värde	`article:content_tier` med `property`, sedan `name`	Tillgänglig
`nli:location`	`property`	Upprepbar	Ortnamn eller identifierare som inte är tom	Samling av platser för artikeln	`nli:location`-listan ersätter motsvarande `article:*`-lista	`article:location` med `property`, sedan `name`	Tillgänglig
`nli:opinion`	`property`	Skalär	Markör för opinionsinnehåll som utgivaren definierar	Artikelns opinionsvärde	Ersätter motsvarande `article:*`-värde	`article:opinion` med `property`, sedan `name`	Tillgänglig
`nli:author`	`property`	Upprepbar	Författarens namn eller absolut URL till en profil	Samling av författare för artikeln	`nli:author`-listan ersätter motsvarande `article:*`-lista	`article:author` med `property`, sedan `name`	Tillgänglig
`nli:published_time`	`property`	Skalär	Datum och tid enligt ISO 8601 med tidszon	Artikelns publiceringstidpunkt	Ersätter konfigurerade och vanliga artikeldatum	Konfigurerad XPath för datum, sedan `article:published_time` och därefter `og:article:published_time`	Tillgänglig
`nli:modified_time`	`property`	Skalär	Datum och tid enligt ISO 8601 med tidszon	Artikelns uppdateringstidpunkt	Ersätter motsvarande `article:*`-värde	`article:modified_time` med `property`, sedan `name`	Tillgänglig
`nli:section`	`property`	Skalär	Sektionsnamn som inte är tomt	Artikelns sektion	Ersätter motsvarande `article:*`-värde	`article:section` med `property`, sedan `name`	Tillgänglig
`nli:tag`	`name`	Upprepbar	En tagg per element	Rensad samling av artikeltaggar	Slås samman med `article:tag` och taggar från konfigurerad XPath; ersätter dem inte	Andra källor till taggar förblir tillgängliga	Tillgänglig
`nli:image1`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Anpassad organisk bildplats 1	Oberoende av huvudsamlingen av bilder	Inget reservvärde	Tillgänglig
`nli:image2`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Anpassad organisk bildplats 2	Oberoende av huvudsamlingen av bilder	Inget reservvärde	Tillgänglig
`nli:image3`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Anpassad organisk bildplats 3	Oberoende av huvudsamlingen av bilder	Inget reservvärde	Tillgänglig
`nli:image4`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Anpassad organisk bildplats 4	Oberoende av huvudsamlingen av bilder	Inget reservvärde	Tillgänglig
`nli:image5`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Anpassad organisk bildplats 5	Oberoende av huvudsamlingen av bilder	Inget reservvärde	Tillgänglig
`nli:image6`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Anpassad organisk bildplats 6	Oberoende av huvudsamlingen av bilder	Inget reservvärde	Tillgänglig
`nli:video`	`name` eller `property`	Skalär, första träff	Direkt, absolut och publik HTTPS-URL till en video	Organisk standardvideo eller äldre organisk video	Ett giltigt värde ersätter den första video-URL som hittas via Schema.org	Första giltiga `VideoObject` enligt Schema.org; den befintliga sökningen efter och importen av miniatyrbilder gäller	Tillgänglig; koppling av flera versioner planeras i API #4640
`nli:video:image`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Miniatyrbild för standardversionen	Får bara påverka den motsvarande `nli:video`-versionen	Befintlig sökning efter miniatyrbilder för standardvideo	Planeras i API #4640; stöds inte för närvarande
`nli:short`	`name` eller `property`	Skalär, första träff	Direkt, absolut och publik HTTPS-URL till en video	Stående version eller short-version	Skapar en version som är oberoende av `nli:video`	Ingen short-version	Planeras i API #4640; stöds inte för närvarande
`nli:short:image`	`name` eller `property`	Skalär, första träff	Absolut, publik HTTPS-URL till en bild	Miniatyrbild för short-versionen	Får bara påverka den motsvarande `nli:short`-versionen	Befintlig sökning efter miniatyrbilder för korta videor	Planeras i API #4640; stöds inte för närvarande

3. Ersätta, upprepa eller slå samman#

3.1. Skalära ersättningar#

Ett skalärt fält behåller ett enda värde. När en nli:*-skalär som stöds finns på sidan, har den företräde framför sitt angivna reservvärde. Ange fältet en gång. Om båda attributen används för ett fält som accepterar båda, blir resultatet för första träff tvetydigt och beroende av ordningen i dokumentet.

3.2. Upprepbara ersättningar#

Upprepa nli:image, nli:location eller nli:author en gång per värde. Om minst ett Nonli-specifikt värde hittas, ersätter den listan motsvarande lista från Open Graph eller article:*.

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. Sammanslagna taggar#

nli:tag är det avsiktliga undantaget. Upprepa den med name; Nonli slår samman dess värden med article:tag och eventuell konfigurerad taggextrahering och rensar sedan den sammanslagna listan.

html

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

4. Datum och URL:er#

Datum måste vara giltiga datum och tider enligt ISO 8601 med en tydlig tidszon. De här exemplen motsvarar exakta tidpunkter:

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

Använd inte ett värde med enbart datum, till exempel 2026-08-25, eller en tid utan tidszon, till exempel 2026-08-25T09:30:00. Ett ogiltigt datum kan få insamlingen att misslyckas i stället för att reservvärdet används.

För bilder och videor, använd direkta, absoluta HTTPS-URL:er som returnerar mediefilen publikt. Relativa URL:er, HTML-sidor med spelare, webbläsarsessioner, signerade URL:er som löper ut och URL:er som kräver cookies är osäkra indata för en integration.

5. Huvudbilder, anpassade platser och miniatyrbilder för video#

De här bildfamiljerna är oberoende av varandra:

nli:image är den upprepbara huvudsamlingen av artikelbilder;
nli:image1 till nli:image6 är sex separata anpassade platser som används när botar väljer bild;
nli:video:image planeras som miniatyrbild enbart för standardvideon;
nli:short:image planeras som miniatyrbild enbart för den korta videon.

En numrerad anpassad bild läggs inte till i och ersätter inte nli:image. En miniatyrbild för en version får aldrig bli en artikelbild eller miniatyrbild för den andra versionen.

6. Standard- och short-versioner av video#

Per den 25 augusti 2026 är bara nli:video tillgänglig. API- och domänarbetet som följs i nonli/api#4640 pågår fortfarande, så nli:short, nli:video:image och nli:short:image får ännu inte användas som indata i produktion.

Den fullständiga målsyntaxen nedan tillhandahålls för planering av implementeringen. Den blir giltig först när API #4640 har driftsatts och dess kompatibilitetstester för HTML har godkänts:

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

När detta har driftsatts, kan varje video förekomma ensam. En miniatyrbild utan motsvarande video ignoreras och skapar ingen version. Om en version saknar egen miniatyrbild, behåller den versionens befintliga beteende för sökning och import och lånar inte den andra versionens bild.

7. Tomma och ogiltiga värden#

Ange inte ett meta-element när dess värde är okänt.
Tomma värden för nli:video och nli:image1…nli:image6 ignoreras.
För andra ersättningar kan ett tomt element räknas som angivet och förhindra reservvärdet; använd bara innehåll som inte är tomt.
En ogiltig nli:video-URL ersätter inte en giltig video från Schema.org.
En relativ nli:url kan tolkas utifrån den hämtade sidan, men utgivare bör ange en stabil, absolut och kanonisk HTTPS-URL.
Om versioner av samma generiska fält med name och property förekommer samtidigt, vinner det första matchande elementet; ange bara en.

8. HTML eller MRSS?#

Använd de här taggarna när Nonli hämtar innehållet från en HTML-artikelsida. Om ditt CMS exporterar ett flöde med videofiler, använd i stället guiden om MRSS-videoflöden. Den förklarar hur du grupperar standard- och short-versioner med sina egna miniatyrbilder i en och samma post i flödet.

Var den här artikeln till hjälp?