As meta tags HTML da Nonli permitem a um editor substituir ou enriquecer as informações recolhidas a partir da página de um artigo. Esta referência lista todas as tags nli:* suportadas pelo scraper orgânico, o atributo HTML exato que cada uma aceita e o que acontece quando a tag está ausente.
Use o atributo indicado na tabela. O suporte não é uniforme de forma intencional: a maioria das substituições de Open Graph e de artigo aceita apenas property, nli:tag aceita apenas name e os campos genéricos mais recentes aceitam ambos.
1. Início rápido#
Coloque as tags no <head> da página. Use valores não vazios, fusos horários explícitos e URLs HTTPS absolutos e públicos para os conteúdos multimédia.
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. Inventário completo dos campos#
«Primeira correspondência» significa que só é mantido um valor; não emita o mesmo campo semântico com name e com property. «Sem valor de recurso» significa que o destino fica vazio quando a tag está ausente.
| Tag | Atributo aceite | Cardinalidade | Formato do valor | Significado mapeado | Precedência ou comportamento de fusão | Valor de recurso quando ausente | Disponibilidade |
|---|---|---|---|---|---|---|---|
nli:title | property | Escalar | Texto simples não vazio | Título Open Graph | Substitui os valores configurados e og:title | XPath do título configurado, depois og:title | Disponível |
nli:description | property | Escalar | Texto simples não vazio | Descrição Open Graph | Substitui os valores configurados e og:description | XPath da descrição configurado, depois og:description | Disponível |
nli:image | property | Repetível | URL HTTPS absoluto e público de uma imagem | Coleção principal de imagens Open Graph | A lista completa de nli:image substitui as imagens normais do artigo | XPath da imagem configurado, depois og:image, og:image:url e, por fim, og:image:secure_url | Disponível |
nli:image:alt | property | Escalar | Texto simples não vazio | Texto alternativo da imagem principal | Substitui og:image:alt | og:image:alt | Disponível |
nli:type | property | Escalar | Tipo de objeto Open Graph, por exemplo article | Tipo de conteúdo Open Graph | Substitui og:type | og:type | Disponível |
nli:url | name ou property | Escalar, primeira correspondência | URL HTTPS canónico absoluto | URL canónico orgânico | Tem prioridade sobre o link canónico | <link rel="canonical"> | Disponível |
nli:content_tier | property | Escalar | Texto de nível definido pelo editor, por exemplo free ou premium | Nível de conteúdo do artigo | Substitui o valor article:* correspondente | article:content_tier com property, depois name | Disponível |
nli:location | property | Repetível | Nome ou identificador de local não vazio | Coleção de locais do artigo | A lista de nli:location substitui a lista article:* correspondente | article:location com property, depois name | Disponível |
nli:opinion | property | Escalar | Marcador de opinião definido pelo editor | Valor de opinião do artigo | Substitui o valor article:* correspondente | article:opinion com property, depois name | Disponível |
nli:author | property | Repetível | Nome do autor ou URL absoluto do perfil | Coleção de autores do artigo | A lista de nli:author substitui a lista article:* correspondente | article:author com property, depois name | Disponível |
nli:published_time | property | Escalar | Data e hora ISO 8601 com fuso horário | Hora de publicação do artigo | Substitui as datas configuradas e as datas normais do artigo | XPath da data configurado, depois article:published_time e, por fim, og:article:published_time | Disponível |
nli:modified_time | property | Escalar | Data e hora ISO 8601 com fuso horário | Hora de atualização do artigo | Substitui o valor article:* correspondente | article:modified_time com property, depois name | Disponível |
nli:section | property | Escalar | Nome de secção não vazio | Secção do artigo | Substitui o valor article:* correspondente | article:section com property, depois name | Disponível |
nli:tag | name | Repetível | Uma etiqueta por elemento | Coleção limpa de etiquetas do artigo | Fundida com article:tag e com as etiquetas do XPath configurado; não as substitui | As outras fontes de etiquetas continuam disponíveis | Disponível |
nli:image1 | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Posição de imagem orgânica personalizada 1 | Independente da coleção principal de imagens | Sem valor de recurso | Disponível |
nli:image2 | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Posição de imagem orgânica personalizada 2 | Independente da coleção principal de imagens | Sem valor de recurso | Disponível |
nli:image3 | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Posição de imagem orgânica personalizada 3 | Independente da coleção principal de imagens | Sem valor de recurso | Disponível |
nli:image4 | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Posição de imagem orgânica personalizada 4 | Independente da coleção principal de imagens | Sem valor de recurso | Disponível |
nli:image5 | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Posição de imagem orgânica personalizada 5 | Independente da coleção principal de imagens | Sem valor de recurso | Disponível |
nli:image6 | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Posição de imagem orgânica personalizada 6 | Independente da coleção principal de imagens | Sem valor de recurso | Disponível |
nli:video | name ou property | Escalar, primeira correspondência | URL HTTPS direto, absoluto e público de um vídeo | Vídeo orgânico padrão ou legado | Um valor válido substitui o primeiro URL de vídeo Schema.org encontrado | Primeiro VideoObject Schema.org válido; aplica-se o comportamento existente de deteção/importação de miniaturas | Disponível; a associação de várias versões está planeada na API #4640 |
nli:video:image | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Miniatura da versão padrão | Deve afetar apenas a versão nli:video correspondente | Deteção existente da miniatura do vídeo padrão | Planeado na API #4640; ainda não suportado |
nli:short | name ou property | Escalar, primeira correspondência | URL HTTPS direto, absoluto e público de um vídeo | Versão vertical ou curta | Cria uma versão independente de nli:video | Sem versão curta | Planeado na API #4640; ainda não suportado |
nli:short:image | name ou property | Escalar, primeira correspondência | URL HTTPS absoluto e público de uma imagem | Miniatura da versão curta | Deve afetar apenas a versão nli:short correspondente | Deteção existente da miniatura do vídeo curto | Planeado na API #4640; ainda não suportado |
3. Substituir, repetir ou fundir#
3.1. Substituições escalares#
Um campo escalar mantém um único valor. Quando um campo escalar nli:* suportado está presente, tem prioridade sobre o valor de recurso indicado. Emita o campo uma única vez. Nos campos que aceitam os dois atributos, usar ambos cria um resultado de primeira correspondência ambíguo, que depende da ordem no documento.
3.2. Substituições repetíveis#
Repita nli:image, nli:location ou nli:author uma vez por valor. Se for encontrado pelo menos um valor específico da Nonli, essa lista substitui a lista Open Graph ou article:* correspondente.
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. Etiquetas fundidas#
nli:tag é a exceção deliberada. Repita-a com name; a Nonli funde os seus valores com article:tag e com qualquer extrator de etiquetas configurado e, em seguida, limpa a lista combinada.
1<meta property="article:tag" content="Europe">2<meta name="nli:tag" content="European Union">3<meta name="nli:tag" content="elections">4. Datas e URLs#
As datas têm de ser datas e horas ISO 8601 válidas, com um fuso horário explícito. Estes exemplos representam instantes precisos:
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ão use um valor só com a data, como 2026-08-25, nem uma hora sem fuso, como 2026-08-25T09:30:00. Uma data inválida pode fazer falhar o scraping em vez de ativar o valor de recurso.
Para imagens e vídeos, use URLs HTTPS diretos e absolutos que devolvam o ficheiro multimédia publicamente. URLs relativos, páginas HTML de leitores de vídeo, sessões do navegador, URLs assinados com expiração e URLs que exijam cookies são entradas de integração inseguras.
5. Imagens principais, posições personalizadas e miniaturas de vídeo#
Estas famílias de imagens são independentes:
nli:imageé a coleção repetível de imagens principais do artigo;nli:image1anli:image6são seis posições personalizadas distintas, usadas na seleção de imagens pelos bots;nli:video:imageestá planeada como miniatura apenas do vídeo padrão;nli:short:imageestá planeada como miniatura apenas do vídeo curto.
Uma imagem personalizada numerada não se junta a nli:image nem a substitui. A miniatura de uma versão nunca deve tornar-se uma imagem do artigo nem a miniatura da outra versão.
6. Versões de vídeo padrão e curta#
A 25 de agosto de 2026, apenas nli:video está disponível. O trabalho de API/domínio acompanhado em nonli/api#4640 continua em aberto, pelo que nli:short, nli:video:image e nli:short:image ainda não devem ser usadas como entradas de produção.
A sintaxe-alvo completa abaixo é fornecida para o planeamento da implementação. Só passa a ser válida depois de a API #4640 ser implementada e de os respetivos testes de compatibilidade HTML passarem:
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">Depois da implementação, cada vídeo poderá aparecer sozinho. Uma miniatura sem o vídeo correspondente será ignorada e não criará nenhuma versão. Se uma versão não tiver miniatura própria, manterá o comportamento existente de deteção/importação dessa versão e não usará a imagem da outra versão.
7. Valores vazios e inválidos#
- Não emita um elemento meta quando o seu valor for desconhecido.
- Os valores vazios de
nli:videoe denli:image1…nli:image6são ignorados. - Nas outras substituições, um elemento vazio pode contar como presente e suprimir o seu valor de recurso; use apenas conteúdo não vazio.
- Um URL
nli:videoinválido não substitui um vídeo Schema.org válido. - Um
nli:urlrelativo pode ser resolvido em relação à página analisada, mas os editores devem emitir um único URL HTTPS canónico, absoluto e estável. - Se coexistirem as versões
nameepropertydo mesmo campo genérico, prevalece o primeiro elemento correspondente; emita apenas uma.
8. HTML ou MRSS?#
Use estas tags quando a Nonli faz o scraping de uma página de artigo HTML. Se o seu CMS exportar um feed com ficheiros de vídeo, use antes o guia do feed MRSS de vídeo. Explica como agrupar as versões padrão e curta, cada uma com a sua miniatura, num único item do feed.