Les balises meta HTML Nonli permettent à un éditeur de remplacer ou d'enrichir les informations collectées sur la page d'un article. Cette référence répertorie chaque balise nli:* comprise par le scraper organique, l'attribut HTML exact qu'elle accepte et le comportement appliqué lorsqu'elle est absente.
Utilisez l'attribut indiqué dans le tableau. La prise en charge n'est volontairement pas uniforme : la plupart des surcharges Open Graph et article acceptent uniquement property, nli:tag accepte uniquement name, et les champs génériques plus récents acceptent les deux.
1. Démarrage rapide#
Placez les balises dans le <head> de la page. Utilisez des valeurs non vides, des fuseaux horaires explicites et des URL HTTPS publiques absolues pour les médias.
1<meta property="nli:title" content="Le conseil municipal adopte le budget 2027">2<meta property="nli:description" content="Le conseil a adopté le budget après trois heures de débat.">3<meta property="nli:type" content="article">4<meta name="nli:url" content="https://actualites.example.com/politique/budget-municipal-2027">5
6<meta property="nli:image" content="https://media.example.com/budget-municipal-large.jpg">7<meta property="nli:image:alt" content="Les élus votent dans la salle du conseil">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="Politique">13<meta name="nli:tag" content="conseil municipal">14<meta name="nli:tag" content="budget">15
16<meta name="nli:video" content="https://media.example.com/budget-municipal-16x9.mp4">2. Inventaire complet des champs#
« Premier résultat » signifie qu'une seule valeur est conservée : n'émettez pas le même champ sémantique avec name et property. « Aucun fallback » signifie que le champ de destination reste vide lorsque la balise est absente.
| Balise | Attribut accepté | Cardinalité | Format de valeur | Signification dans Nonli | Priorité ou fusion | Fallback en cas d'absence | Disponibilité |
|---|---|---|---|---|---|---|---|
nli:title | property | Scalaire | Texte brut non vide | Titre Open Graph | Remplace les valeurs configurées et og:title | XPath de titre configuré, puis og:title | Disponible |
nli:description | property | Scalaire | Texte brut non vide | Description Open Graph | Remplace les valeurs configurées et og:description | XPath de description configuré, puis og:description | Disponible |
nli:image | property | Répétable | URL HTTPS publique absolue d'une image | Collection principale d'images Open Graph | La liste nli:image complète remplace les images ordinaires de l'article | XPath d'image configuré, puis og:image, og:image:url et og:image:secure_url | Disponible |
nli:image:alt | property | Scalaire | Texte brut non vide | Texte alternatif de l'image principale | Remplace og:image:alt | og:image:alt | Disponible |
nli:type | property | Scalaire | Type d'objet Open Graph, par exemple article | Type de contenu Open Graph | Remplace og:type | og:type | Disponible |
nli:url | name ou property | Scalaire, premier résultat | URL canonique HTTPS absolue | URL canonique du contenu organique | Prioritaire sur le lien canonique | <link rel="canonical"> | Disponible |
nli:content_tier | property | Scalaire | Texte de niveau défini par l'éditeur, par exemple free ou premium | Niveau d'accès de l'article | Remplace la valeur article:* correspondante | article:content_tier avec property, puis name | Disponible |
nli:location | property | Répétable | Nom ou identifiant de lieu non vide | Collection de lieux de l'article | La liste nli:location remplace la liste article:* correspondante | article:location avec property, puis name | Disponible |
nli:opinion | property | Scalaire | Marqueur d'opinion défini par l'éditeur | Valeur d'opinion de l'article | Remplace la valeur article:* correspondante | article:opinion avec property, puis name | Disponible |
nli:author | property | Répétable | Nom d'auteur ou URL absolue d'un profil | Collection d'auteurs de l'article | La liste nli:author remplace la liste article:* correspondante | article:author avec property, puis name | Disponible |
nli:published_time | property | Scalaire | Date et heure ISO 8601 avec fuseau | Date de publication de l'article | Remplace les dates configurées et ordinaires | XPath de date configuré, puis article:published_time, puis og:article:published_time | Disponible |
nli:modified_time | property | Scalaire | Date et heure ISO 8601 avec fuseau | Date de mise à jour de l'article | Remplace la valeur article:* correspondante | article:modified_time avec property, puis name | Disponible |
nli:section | property | Scalaire | Nom de rubrique non vide | Rubrique de l'article | Remplace la valeur article:* correspondante | article:section avec property, puis name | Disponible |
nli:tag | name | Répétable | Une étiquette par élément | Collection nettoyée d'étiquettes de l'article | Fusionnée avec article:tag et les tags XPath configurés ; elle ne les remplace pas | Les autres sources de tags restent disponibles | Disponible |
nli:image1 | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Emplacement d'image organique personnalisé 1 | Indépendant de la collection d'images principale | Aucun fallback | Disponible |
nli:image2 | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Emplacement d'image organique personnalisé 2 | Indépendant de la collection d'images principale | Aucun fallback | Disponible |
nli:image3 | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Emplacement d'image organique personnalisé 3 | Indépendant de la collection d'images principale | Aucun fallback | Disponible |
nli:image4 | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Emplacement d'image organique personnalisé 4 | Indépendant de la collection d'images principale | Aucun fallback | Disponible |
nli:image5 | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Emplacement d'image organique personnalisé 5 | Indépendant de la collection d'images principale | Aucun fallback | Disponible |
nli:image6 | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Emplacement d'image organique personnalisé 6 | Indépendant de la collection d'images principale | Aucun fallback | Disponible |
nli:video | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue et directe d'une vidéo | Vidéo organique standard ou historique | Une valeur valide remplace l'URL de la première vidéo Schema.org détectée | Premier VideoObject Schema.org valide ; le comportement existant de découverte/import de miniature s'applique | Disponible ; l'association multi-rendu est planifiée dans l'API #4640 |
nli:video:image | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Miniature du rendu standard | Ne doit affecter que le rendu nli:video correspondant | Découverte existante de la miniature de la vidéo standard | Planifiée dans l'API #4640 ; pas encore prise en charge |
nli:short | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue et directe d'une vidéo | Rendu vertical ou short | Crée un rendu indépendant de nli:video | Aucun rendu short | Planifiée dans l'API #4640 ; pas encore prise en charge |
nli:short:image | name ou property | Scalaire, premier résultat | URL HTTPS publique absolue d'une image | Miniature du rendu short | Ne doit affecter que le rendu nli:short correspondant | Découverte existante de la miniature du short | Planifiée dans l'API #4640 ; pas encore prise en charge |
3. Remplacer, répéter ou fusionner#
3.1. Surcharges scalaires#
Un champ scalaire conserve une seule valeur. Lorsqu'un champ scalaire nli:* pris en charge est présent, il est prioritaire sur le fallback indiqué. Émettez-le une seule fois. Pour les champs acceptant les deux attributs, l'emploi simultané de name et property crée un premier résultat ambigu qui dépend de l'ordre du document.
3.2. Remplacements répétables#
Répétez nli:image, nli:location ou nli:author une fois par valeur. Dès qu'au moins une valeur propre à Nonli est trouvée, cette liste remplace la liste Open Graph ou article:* correspondante.
1<meta property="nli:image" content="https://media.example.com/article-large.jpg">2<meta property="nli:image" content="https://media.example.com/article-carre.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="Bruxelles">3.3. Tags fusionnés#
nli:tag constitue l'exception volontaire. Répétez-le avec name : Nonli fusionne ses valeurs avec article:tag et tout extracteur de tags configuré, puis nettoie la liste obtenue.
1<meta property="article:tag" content="Europe">2<meta name="nli:tag" content="Union européenne">3<meta name="nli:tag" content="élections">4. Dates et URL#
Les dates doivent être des dates-heures ISO 8601 valides avec un fuseau explicite. Ces exemples représentent des instants précis :
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">N'utilisez ni date seule comme 2026-08-25, ni heure sans fuseau comme 2026-08-25T09:30:00. Une date invalide peut faire échouer le scraping au lieu d'activer le fallback.
Pour les images et les vidéos, utilisez des URL HTTPS directes, absolues et publiquement accessibles qui renvoient le fichier média. Les URL relatives, les pages de lecteur HTML, les sessions de navigateur, les URL signées temporaires et les URL exigeant des cookies ne sont pas des entrées d'intégration sûres.
5. Images principales, emplacements personnalisés et miniatures vidéo#
Ces familles d'images sont indépendantes :
nli:imageest la collection répétable d'images principales de l'article ;nli:image1ànli:image6sont six emplacements personnalisés distincts utilisés lors de la sélection d'image par un robot ;nli:video:imageest prévue comme miniature de la seule vidéo standard ;nli:short:imageest prévue comme miniature du seul short.
Une image personnalisée numérotée ne rejoint ni ne remplace nli:image. Une miniature de rendu ne doit jamais devenir une image d'article ou la miniature de l'autre rendu.
6. Rendus vidéo standard et short#
Au 25 août 2026, seule nli:video est disponible. Le travail API et domaine suivi dans nonli/api#4640 est toujours ouvert : nli:short, nli:video:image et nli:short:image ne doivent donc pas encore être utilisées comme entrées de production.
La syntaxe cible complète ci-dessous est fournie pour préparer l'implémentation. Elle ne deviendra valide qu'après le déploiement de l'API #4640 et la réussite de ses tests de compatibilité HTML :
1<!-- Disponible aujourd'hui ; deviendra le rendu standard du contrat multi-rendu -->2<meta name="nli:video" content="https://media.example.com/reportage-16x9.mp4">3
4<!-- Planifié dans l'API #4640 ; pas encore pris en charge -->5<meta name="nli:video:image" content="https://media.example.com/reportage-16x9.jpg">6<meta name="nli:short" content="https://media.example.com/reportage-9x16.mp4">7<meta name="nli:short:image" content="https://media.example.com/reportage-9x16.jpg">Après déploiement, chaque vidéo pourra exister seule. Une miniature sans sa vidéo correspondante sera ignorée et ne créera pas de rendu. Si un rendu n'a pas de miniature dédiée, il conservera son comportement existant de découverte/import sans emprunter l'image de l'autre rendu.
7. Valeurs vides ou invalides#
- N'émettez pas de balise meta lorsque sa valeur est inconnue.
- Les valeurs vides de
nli:videoetnli:image1…nli:image6sont ignorées. - Pour les autres surcharges, un élément vide peut être considéré comme présent et bloquer son fallback ; utilisez uniquement des contenus non vides.
- Une URL
nli:videoinvalide ne remplace pas une vidéo Schema.org valide. - Une valeur relative de
nli:urlpeut être résolue par rapport à la page scrapée, mais les éditeurs doivent émettre une URL canonique HTTPS absolue et stable. - Si les versions
nameetpropertyd'un même champ générique coexistent, le premier élément correspondant gagne ; n'en émettez qu'un.
8. HTML ou MRSS ?#
Utilisez ces balises lorsque Nonli scrape une page d'article HTML. Si votre CMS exporte un flux contenant des médias vidéo, utilisez plutôt le guide des flux vidéo MRSS. Il explique comment regrouper les rendus standard et short avec leurs miniatures dans une même entrée.