Metatagi HTML Nonli pozwalają wydawcy nadpisać lub wzbogacić informacje pobierane ze strony artykułu. Ta dokumentacja wymienia wszystkie tagi nli:* obsługiwane przez organiczny scraper, dokładny atrybut HTML, który każdy z nich akceptuje, oraz to, co się dzieje, gdy tagu brakuje.
Używaj atrybutu wskazanego w tabeli. Obsługa celowo nie jest jednolita: większość nadpisań Open Graph i artykułu akceptuje tylko property, nli:tag akceptuje tylko name, a nowsze pola ogólne akceptują oba atrybuty.
1. Szybki start#
Umieść tagi w sekcji <head> strony. Używaj niepustych wartości, jawnie podanych stref czasowych i bezwzględnych, publicznych adresów URL HTTPS dla multimediów.
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. Pełny wykaz pól#
„Pierwsze dopasowanie” oznacza, że zachowywana jest tylko jedna wartość; nie emituj tego samego pola semantycznego jednocześnie z name i property. „Brak wartości zastępczej” oznacza, że pole docelowe pozostaje puste, gdy tagu brakuje.
| Tag | Akceptowany atrybut | Liczność | Format wartości | Znaczenie | Pierwszeństwo lub scalanie | Wartość zastępcza przy braku tagu | Dostępność |
|---|---|---|---|---|---|---|---|
nli:title | property | Skalarny | Niepusty zwykły tekst | Tytuł Open Graph | Zastępuje wartości skonfigurowane i og:title | Skonfigurowany XPath tytułu, następnie og:title | Dostępny |
nli:description | property | Skalarny | Niepusty zwykły tekst | Opis Open Graph | Zastępuje wartości skonfigurowane i og:description | Skonfigurowany XPath opisu, następnie og:description | Dostępny |
nli:image | property | Powtarzalny | Bezwzględny, publiczny adres URL HTTPS obrazu | Główna kolekcja obrazów Open Graph | Pełna lista nli:image zastępuje zwykłe obrazy artykułu | Skonfigurowany XPath obrazu, następnie og:image, og:image:url, a potem og:image:secure_url | Dostępny |
nli:image:alt | property | Skalarny | Niepusty zwykły tekst | Tekst alternatywny głównego obrazu | Zastępuje og:image:alt | og:image:alt | Dostępny |
nli:type | property | Skalarny | Typ obiektu Open Graph, na przykład article | Typ treści Open Graph | Zastępuje og:type | og:type | Dostępny |
nli:url | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny kanoniczny adres URL HTTPS | Organiczny adres kanoniczny | Ma pierwszeństwo przed linkiem kanonicznym | <link rel="canonical"> | Dostępny |
nli:content_tier | property | Skalarny | Tekst poziomu określony przez wydawcę, na przykład free lub premium | Poziom dostępu do treści artykułu | Zastępuje odpowiednią wartość article:* | article:content_tier z property, następnie z name | Dostępny |
nli:location | property | Powtarzalny | Niepusta nazwa lub identyfikator miejsca | Kolekcja lokalizacji artykułu | Lista nli:location zastępuje odpowiednią listę article:* | article:location z property, następnie z name | Dostępny |
nli:opinion | property | Skalarny | Znacznik opinii określony przez wydawcę | Wartość opinii artykułu | Zastępuje odpowiednią wartość article:* | article:opinion z property, następnie z name | Dostępny |
nli:author | property | Powtarzalny | Imię i nazwisko autora lub bezwzględny adres URL profilu | Kolekcja autorów artykułu | Lista nli:author zastępuje odpowiednią listę article:* | article:author z property, następnie z name | Dostępny |
nli:published_time | property | Skalarny | Data i godzina w formacie ISO 8601 ze strefą czasową | Czas publikacji artykułu | Zastępuje skonfigurowane i zwykłe daty artykułu | Skonfigurowany XPath daty, następnie article:published_time, a potem og:article:published_time | Dostępny |
nli:modified_time | property | Skalarny | Data i godzina w formacie ISO 8601 ze strefą czasową | Czas aktualizacji artykułu | Zastępuje odpowiednią wartość article:* | article:modified_time z property, następnie z name | Dostępny |
nli:section | property | Skalarny | Niepusta nazwa działu | Dział artykułu | Zastępuje odpowiednią wartość article:* | article:section z property, następnie z name | Dostępny |
nli:tag | name | Powtarzalny | Jeden tag na element | Oczyszczona kolekcja tagów artykułu | Scalany z article:tag i tagami ze skonfigurowanego XPath; nie zastępuje ich | Pozostałe źródła tagów pozostają dostępne | Dostępny |
nli:image1 | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Własny slot obrazu organicznego 1 | Niezależny od głównej kolekcji obrazów | Brak wartości zastępczej | Dostępny |
nli:image2 | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Własny slot obrazu organicznego 2 | Niezależny od głównej kolekcji obrazów | Brak wartości zastępczej | Dostępny |
nli:image3 | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Własny slot obrazu organicznego 3 | Niezależny od głównej kolekcji obrazów | Brak wartości zastępczej | Dostępny |
nli:image4 | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Własny slot obrazu organicznego 4 | Niezależny od głównej kolekcji obrazów | Brak wartości zastępczej | Dostępny |
nli:image5 | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Własny slot obrazu organicznego 5 | Niezależny od głównej kolekcji obrazów | Brak wartości zastępczej | Dostępny |
nli:image6 | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Własny slot obrazu organicznego 6 | Niezależny od głównej kolekcji obrazów | Brak wartości zastępczej | Dostępny |
nli:video | name lub property | Skalarny, pierwsze dopasowanie | Bezpośredni, bezwzględny, publiczny adres URL HTTPS wideo | Standardowe lub starsze wideo organiczne | Prawidłowa wartość zastępuje pierwszy wykryty adres URL wideo Schema.org | Pierwszy prawidłowy obiekt Schema.org VideoObject; obowiązuje dotychczasowe wykrywanie i importowanie miniatur | Dostępny; powiązanie wielu wersji jest planowane w API #4640 |
nli:video:image | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Miniatura wersji standardowej | Musi dotyczyć tylko odpowiadającej jej wersji nli:video | Dotychczasowe wykrywanie miniatur standardowego wideo | Planowany w API #4640; obecnie nieobsługiwany |
nli:short | name lub property | Skalarny, pierwsze dopasowanie | Bezpośredni, bezwzględny, publiczny adres URL HTTPS wideo | Wersja pionowa lub krótka | Tworzy wersję niezależną od nli:video | Brak krótkiej wersji | Planowany w API #4640; obecnie nieobsługiwany |
nli:short:image | name lub property | Skalarny, pierwsze dopasowanie | Bezwzględny, publiczny adres URL HTTPS obrazu | Miniatura krótkiej wersji | Musi dotyczyć tylko odpowiadającej jej wersji nli:short | Dotychczasowe wykrywanie miniatur krótkiego wideo | Planowany w API #4640; obecnie nieobsługiwany |
3. Nadpisywanie, powtarzanie lub scalanie#
3.1. Nadpisania skalarne#
Pole skalarne przechowuje jedną wartość. Gdy obecny jest obsługiwany skalarny tag nli:*, ma on pierwszeństwo przed wymienioną dla niego wartością zastępczą. Emituj pole tylko raz. W przypadku pól akceptujących oba atrybuty użycie obu daje niejednoznaczny wynik pierwszego dopasowania, zależny od kolejności w dokumencie.
3.2. Zastępowanie list powtarzalnych#
Powtarzaj nli:image, nli:location lub nli:author raz dla każdej wartości. Jeśli zostanie znaleziona co najmniej jedna wartość specyficzna dla Nonli, ta lista zastępuje odpowiednią listę Open Graph lub article:*.
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. Scalane tagi#
nli:tag to celowy wyjątek. Powtarzaj go z atrybutem name; Nonli scala jego wartości z article:tag i dowolnym skonfigurowanym ekstraktorem tagów, a następnie oczyszcza połączoną listę.
1<meta property="article:tag" content="Europe">2<meta name="nli:tag" content="European Union">3<meta name="nli:tag" content="elections">4. Daty i adresy URL#
Daty muszą być prawidłowymi wartościami daty i godziny w formacie ISO 8601 z jawnie podaną strefą czasową. Te przykłady przedstawiają precyzyjne momenty w czasie:
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">Nie używaj wartości zawierającej samą datę, takiej jak 2026-08-25, ani godziny bez strefy, takiej jak 2026-08-25T09:30:00. Nieprawidłowa data może spowodować niepowodzenie scrapowania zamiast użycia wartości zastępczej.
W przypadku obrazów i wideo używaj bezpośrednich, bezwzględnych adresów URL HTTPS, które publicznie zwracają plik multimedialny. Względne adresy URL, strony HTML z odtwarzaczem, sesje przeglądarki, wygasające podpisane adresy URL i adresy URL wymagające plików cookie są niebezpiecznymi danymi wejściowymi integracji.
5. Obrazy główne, własne sloty i miniatury wideo#
Te rodziny obrazów są od siebie niezależne:
nli:imageto powtarzalna kolekcja głównych obrazów artykułu;nli:image1donli:image6to sześć oddzielnych własnych slotów używanych przy wyborze obrazu przez boty;nli:video:imagejest planowany wyłącznie jako miniatura standardowego wideo;nli:short:imagejest planowany wyłącznie jako miniatura krótkiego wideo.
Numerowany własny obraz nie dołącza do nli:image ani go nie zastępuje. Miniatura wersji nigdy nie może stać się obrazem artykułu ani miniaturą drugiej wersji.
6. Standardowa i krótka wersja wideo#
Na dzień 25 sierpnia 2026 dostępny jest tylko nli:video. Prace nad API i domeną śledzone w nonli/api#4640 wciąż trwają, dlatego nli:short, nli:video:image i nli:short:image nie mogą jeszcze być używane jako dane wejściowe w środowisku produkcyjnym.
Pełna docelowa składnia poniżej służy do planowania implementacji. Stanie się prawidłowa dopiero po wdrożeniu API #4640 i pomyślnym przejściu jego testów zgodności 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">Po wdrożeniu każde wideo będzie mogło występować samodzielnie. Miniatura bez odpowiadającego jej wideo zostanie zignorowana i nie utworzy wersji. Jeśli wersja nie ma dedykowanej miniatury, zachowa dotychczasowe wykrywanie i importowanie miniatur dla tej wersji i nie przejmie obrazu drugiej wersji.
7. Puste i nieprawidłowe wartości#
- Nie emituj elementu meta, gdy jego wartość jest nieznana.
- Puste wartości
nli:videoinli:image1…nli:image6są ignorowane. - W przypadku pozostałych nadpisań pusty element może zostać uznany za obecny i zablokować wartość zastępczą; używaj wyłącznie niepustej treści.
- Nieprawidłowy adres URL
nli:videonie zastępuje prawidłowego wideo Schema.org. - Względny
nli:urlmoże zostać rozwiązany względem scrapowanej strony, ale wydawcy powinni emitować jeden stabilny, bezwzględny kanoniczny adres URL HTTPS. - Jeśli wersje
nameipropertytego samego pola ogólnego występują jednocześnie, wygrywa pierwszy pasujący element; emituj tylko jeden.
8. HTML czy MRSS?#
Używaj tych tagów, gdy Nonli scrapuje stronę artykułu HTML. Jeśli Twój CMS eksportuje kanał z materiałami wideo, skorzystaj zamiast tego z przewodnika po kanale wideo MRSS. Wyjaśnia on, jak w jednym elemencie kanału zgrupować wersje standardowe i krótkie z ich własnymi miniaturami.