Pular para o conteúdo

Mensagens de erro

Markdown para LLMs (em inglês)llms.txt

O compilador do Folio nunca para no primeiro problema: ele sempre gera a melhor apresentação possível e uma lista de diagnósticos. No editor, cada diagnóstico aparece sublinhado no texto e no painel inferior, com:

ParteExemplo
GravidadeErro (algo foi descartado ou não funciona) ou aviso (funciona, mas provavelmente não como você queria).
CódigoF209. O código é estável e não muda entre versões.
PosiçãoLinha e coluna do trecho com problema.
Mensagematributo desconhecido: colr
DicaVocê quis dizer color?

Erros dentro de um componente são indicados na linha onde o componente é usado, com o sufixo “(no componente nome)”. Erros em um @style aparecem uma vez, na definição, e não em cada uso.

FamíliaAssunto
F1xxEstrutura: blocos, tabelas, código, gráficos e ícones.
F2xxAtributos: sintaxe das chaves, estilos e nomes de atributos.
F3xxValores de atributos.
F4xxComponentes e espaços nomeados.
F5xxDefinições do preâmbulo e tema do projeto.

Erro. Mensagem: ::: fecha um bloco, mas nenhum bloco está aberto aqui.

Um ::: sozinho na linha fecha o último bloco aberto. Aqui não há nenhum bloco aberto, geralmente porque há um ::: a mais.

# Resultados
Crescemos 38%.
:::

Como corrigir: remova a linha ou abra um bloco antes dela, como ::: columns.

Erro. Mensagem: o bloco columns foi aberto mas nunca fechado.

Todo bloco aberto com ::: nome precisa de uma linha ::: que o feche. Cada slide é lido separadamente, então o bloco precisa ser fechado antes do próximo ---.

::: columns
Esquerda
Direita

Como corrigir: adicione uma linha contendo apenas ::: no fim do bloco.

Erro. Mensagem: @theme só pode ser usado no início do documento, antes do primeiro slide.

Definições com @ (@title, @theme, @color, @style, @component e as demais) só valem no preâmbulo. Depois que o primeiro slide começa, elas são descartadas.

# Abertura
---
@theme ink
# Segundo slide

Como corrigir: mova a definição para o topo do arquivo, antes de qualquer conteúdo.

Erro. Mensagem: falta o nome do bloco depois de :::.

Uma linha que começa com ::: ou :: e tem outro conteúdo precisa ter o nome do bloco logo em seguida.

::: {.card}
Texto
:::

Como corrigir: escreva o nome do bloco antes dos atributos, como ::: box {.card}.

Erro. Mensagem: bloco de código sem fechamento.

Um bloco de código aberto com ``` precisa de outra linha com ``` para terminar. Sem ela, todo o resto do slide vira código.

```js
console.log("oi")

Como corrigir: feche o bloco com uma linha contendo ```.

Erro. Mensagem: tabela sem linha separadora depois do cabeçalho.

A segunda linha de uma tabela precisa ser a linha separadora, que divide o cabeçalho dos dados.

| Produto | Preço |
| Café | 12 |

Como corrigir: adicione uma linha como | --- | --- | logo abaixo do cabeçalho.

F107 · Linha de tabela com outro número de colunas

Seção intitulada “F107 · Linha de tabela com outro número de colunas”

Aviso. Mensagem: esta linha tem 3 colunas, mas o cabeçalho tem 2.

Uma linha da tabela tem mais ou menos células que o cabeçalho.

| Produto | Preço |
| --- | --- |
| Café | 12 | extra |

Como corrigir: deixe todas as linhas com o mesmo número de células do cabeçalho. Para escrever | dentro de uma célula, use \|.

Erro. Mensagem: bloco desconhecido: colums.

O nome depois de ::: ou :: não é um bloco embutido nem um componente definido no documento ou no tema do projeto. A dica sugere o nome mais parecido.

::: colums
Texto
:::

Como corrigir: corrija o nome (aqui, columns) ou defina o componente com @component. Veja a lista em Blocos.

Aviso. Mensagem: divider não aceita conteúdo; use :: divider em uma linha só.

icon, spacer e divider não têm conteúdo. Abertos com :::, o conteúdo entre eles e o ::: de fechamento é ignorado.

::: divider
Texto
:::

Como corrigir: use a forma de uma linha, :: divider, e coloque o texto fora do bloco.

Aviso. Mensagem: o texto 3 depois de grid será ignorado.

Só icon e spacer recebem um valor depois do nome. Nos outros blocos embutidos, o texto solto é ignorado.

::: grid 3
A
B
C
:::

Como corrigir: use atributos entre chaves, como ::: grid {cols=3}.

Erro. Mensagem: o gráfico precisa de uma tabela com os dados.

O bloco chart desenha os dados de uma tabela Markdown que fica dentro dele. Sem tabela, o gráfico não é desenhado.

::: chart {type=bar}
Vendas por mês
:::

Como corrigir: coloque uma tabela dentro do bloco. A primeira coluna são os rótulos e as demais são as séries. Veja Gráficos.

Erro. Mensagem: doze não é um número.

Todas as células de dados de um gráfico, fora a primeira coluna, precisam ser números. A célula inválida conta como 0.

::: chart
| Mês | Vendas |
| --- | ---: |
| Jan | doze |
:::

Como corrigir: use números como 42, 3.5 ou 3,5. Um % no fim é aceito.

Erro. Mensagem: a tabela do gráfico precisa de pelo menos uma coluna de valores.

A tabela tem só a coluna de rótulos, então não há o que desenhar.

::: chart
| Mês |
| --- |
| Jan |
:::

Como corrigir: adicione pelo menos uma coluna de valores à tabela.

Erro. Mensagem: informe o nome do ícone.

:: icon {size=3xl}

Como corrigir: escreva o nome depois de icon, como :: icon rocket {size=3xl}. Os nomes estão em Ícones.

Erro. Mensagem: ícone desconhecido: foguete.

O nome não está na lista de ícones embutidos. Quando há um nome parecido, a dica o sugere.

:: icon foguete

Como corrigir: use um nome da lista em Ícones, como rocket.

Erro. Mensagem: . precisa ser seguido de um nome.

Dentro das chaves, . precisa vir colado ao nome de um estilo e # ao nome de um id.

Texto {. color=accent}

Como corrigir: escreva o nome junto, como {.destaque} ou {#abertura}, ou remova o caractere solto.

Erro. Mensagem: aspas não fechadas no valor do atributo.

Um valor que começa com aspas precisa terminar com a mesma aspa.

![Foto](https://example.com/foto.jpg){fit="cover}

Como corrigir: feche o valor com a mesma aspa que o abriu: {fit="cover"}. No fim de títulos, parágrafos e blocos, chaves com aspas abertas não são reconhecidas como atributos e aparecem como texto no slide.

Erro. Mensagem: o atributo color está sem valor depois de =.

Há um = sem nada depois. Normalmente vem acompanhado de um F301, porque o valor vazio também é inválido.

# Título {color=}

Como corrigir: informe o valor ({color=accent}) ou remova o atributo.

Erro. Mensagem: trecho inválido em atributos: @destaque.

Dentro das chaves só são aceitos .estilo, #id, chave=valor, chave="valor com espaços" e chave.

Texto {@destaque}

Como corrigir: use a forma certa, aqui {.destaque}. Nomes de atributos começam com uma letra.

Aviso. Mensagem: #id só tem efeito no separador de slide (--- {#id}).

Ids identificam slides, para links como [voltar](#abertura). Em outros blocos, o id é ignorado.

# Abertura {#inicio}

Como corrigir: coloque o id no separador do slide, como --- {#inicio}.

Erro. Mensagem: o estilo .laco referencia a si mesmo.

Um @style inclui a si mesmo, diretamente ou por meio de outros estilos. Como o estilo ainda não existe enquanto a própria definição é lida, o compilador também mostra um F207 no mesmo lugar.

@style laco {.laco color=accent}
Texto {.laco}

Como corrigir: remova a referência circular. Um estilo só pode incluir estilos definidos antes dele.

Erro. Mensagem: estilo desconhecido: .destaqe.

O nome depois do . não é um estilo embutido, um @style nem um token de cor. A dica sugere o nome mais parecido.

Texto {.destaqe}

Como corrigir: corrija o nome ou declare o estilo no início do documento com @style nome {atributos}. Veja os estilos embutidos.

Aviso. Mensagem: já existe outro slide com o id #resumo.

Dois slides têm o mesmo id, então um link #resumo só pode levar a um deles.

--- {#resumo}
# Resumo
--- {#resumo}
# Conclusão

Como corrigir: dê um id diferente a cada slide.

Erro. Mensagem: atributo desconhecido: colr.

O nome não é um atributo de estilo nem um atributo próprio do bloco em que aparece. A dica sugere o nome mais parecido ou lista os atributos aceitos ali.

# Título {colr=coral}

Como corrigir: corrija o nome. Atributos próprios, como cols ou fit, só valem nos blocos certos. Veja Atributos.

Erro. Mensagem: depende do atributo, por exemplo tamanho inválido: gigante ou cor desconhecida: corall.

O atributo existe, mas o valor não é aceito. O atributo é ignorado, e a dica diz quais valores são válidos.

# Título {size=gigante color=corall}

Situações comuns:

SituaçãoExemplo inválidoExemplo válido
Cor desconhecida ou hexadecimal malformadocolor=corall, color=#12color=coral, color=#123
Opacidade de cor fora de 0 a 100color=accent/150color=accent/40
Nome fora da escala ou número fora da faixasize=gigante, pad=900size=5xl, pad=xl
Fonte não declaradafont=titulofont=display ou @font titulo …
Peso inválidoweight=450weight=500
Booleano inválidoitalic=talvezitalic ou italic=false
Alinhamento inválidoalign=middlealign=center
Sombra inválidashadow=xlshadow=lg
Borda com espessura acima de 40border="80 coral"border="4 coral"
Medida inválidaw=200%, w=metadew=50%, w=480
Atributo que precisa de valor, usado sozinho{size}{size=xl}
Endereço não permitido em link ou imagem[x](javascript:…), ![x](arquivo.png)https://…, asset:<id>
Ajuste de imagem inválidofit=stretchfit=cover
Colunas da grade fora de 1 a 12cols=20cols=4
Proporções de colunas inválidaswidths="a b"widths="2 1"
Tipo de gráfico inválidotype=radartype=line
Tamanho de spacer inválido:: spacer enorme:: spacer 3xl
Etapa fora de 1 a 99step=0step=1

Como corrigir: use um dos valores indicados na dica. As escalas e faixas completas estão em Atributos.

Aviso. Mensagem: widths tem 3 valores, mas há 1 colunas.

O número de proporções em widths é diferente do número de filhos do columns.

::: columns {widths="2 1 1"}
Esquerda
:::

Como corrigir: informe uma proporção para cada coluna, ou ajuste as colunas. Lembre que cada filho direto é uma coluna; agrupe vários elementos com ::: stack.

Erro. Mensagem: $content só pode ser usado dentro de um @component.

$content marca onde entra o conteúdo passado a um componente, então só faz sentido no corpo de um @component.

# Título
$content

Como corrigir: remova a linha ou mova-a para o corpo de um componente. Para escrever o texto literal, use \$content.

Erro. Mensagem: o componente eco usa a si mesmo.

Um componente usa a si mesmo, diretamente ou por meio de outros componentes. Componentes não têm recursão, então o uso é descartado.

@component eco
:: eco
@end
:: eco

Como corrigir: remova o uso circular do corpo do componente.

Erro. Mensagem: componentes aninhados demais (limite: 16 níveis).

Um componente usa outro, que usa outro, e assim por diante, por mais de 16 níveis. O exemplo abaixo está abreviado: com as 17 definições completas, o erro aparece no uso de n1.

@component n1
:: n2
@end
@component n2
:: n3
@end
// n3 a n16 seguem o mesmo padrão, cada um usando o seguinte
@component n17
Fim
@end
:: n1

Como corrigir: simplifique a cadeia de componentes, juntando níveis intermediários.

Erro. Mensagem: componentes recebem apenas parâmetros, não .estilos nem #id.

Ao usar um componente, as chaves só aceitam parâmetros nomeados.

@component selo {texto}
::: box {.card}
$texto
:::
@end
:: selo {.dark texto=Novo}

Como corrigir: envolva o componente num bloco com o estilo (::: box {.dark} … :: selo {texto=Novo} … :::) ou crie um parâmetro para isso.

Erro. Mensagem: o componente selo não tem o parâmetro cor.

O parâmetro não foi declarado na definição do componente. A dica lista os parâmetros existentes.

@component selo {texto}
::: box {.card}
$texto
:::
@end
:: selo {texto=Novo cor=accent}

Como corrigir: corrija o nome ou declare o parâmetro, como @component selo {texto cor=accent}.

Erro. Mensagem: componentes recebem parâmetros nomeados entre chaves.

Componentes não recebem valores posicionais: todo parâmetro precisa de nome.

@component selo {texto=Novo}
::: box {.card}
$texto
:::
@end
:: selo Promoção

Como corrigir: passe o valor como parâmetro nomeado: :: selo {texto=Promoção}.

Erro. Mensagem: falta o parâmetro obrigatório texto do componente selo.

Parâmetros declarados sem valor padrão são obrigatórios.

@component selo {texto}
::: box {.card}
$texto
:::
@end
:: selo

Como corrigir: informe o parâmetro (:: selo {texto=Novo}) ou dê a ele um valor padrão na definição (@component selo {texto=Novo}).

Erro. Mensagem: o componente selo usa $titulo, que não é um parâmetro declarado.

O corpo do componente usa $titulo no meio de um texto ou atributo, mas titulo não está na lista de parâmetros.

@component selo {texto}
::: box {.card}
## $titulo
$texto
:::
@end
:: selo {texto=Novo}

Como corrigir: declare o parâmetro (@component selo {texto titulo}) ou corrija o nome. Sozinho numa linha, $nome é um espaço nomeado e não gera este erro.

Aviso. Mensagem: o componente selo não usa $content; o conteúdo será ignorado.

O componente foi usado com ::: e recebeu conteúdo, mas o corpo não tem $content.

@component selo {texto}
::: box {.card}
$texto
:::
@end
::: selo {texto=Novo}
Este parágrafo é ignorado.
:::

Como corrigir: adicione $content ao corpo do componente ou use a forma de uma linha (:: selo {texto=Novo}).

Erro. Mensagem: box já é um bloco da linguagem e não pode ser redefinido.

Os nomes stack, row, columns, grid, box, steps, notes, chart, icon, spacer, divider e slot são reservados.

@component box
Texto
@end

Como corrigir: escolha outro nome, como caixa ou cartao.

Erro. Mensagem: o componente selo foi definido mais de uma vez.

O mesmo documento define dois componentes com o mesmo nome. A segunda definição é descartada.

@component selo
Novo
@end
@component selo
Promoção
@end

Como corrigir: remova uma das definições ou renomeie uma delas. Redefinir na apresentação um componente do tema do projeto é permitido e não gera este erro.

Erro. Mensagem: o componente dupla não tem o espaço lado-c.

::: slot preenche um espaço que o componente não declara. A dica sugere o nome mais parecido.

@component dupla {titulo}
## $titulo
$content
$lado-b
@end
::: dupla {titulo=Comparação}
Antes
::: slot lado-c
Depois
:::
:::

Como corrigir: use o nome de um espaço existente (aqui, lado-b) ou declare o espaço no componente com $lado-c sozinho numa linha.

Erro. Mensagem: informe o nome do espaço.

@component dupla {titulo}
## $titulo
$content
$lado-b
@end
::: dupla {titulo=Comparação}
Antes
::: slot
Depois
:::
:::

Como corrigir: escreva o nome do espaço depois de slot, como ::: slot lado-b.

Erro. Mensagem: ::: slot só pode ser usado dentro de um componente.

::: slot só funciona como filho direto do uso de um componente contêiner. Fora dele, o compilador também avisa que o nome é ignorado (F110).

::: slot lado-b
Depois
:::

Como corrigir: coloque o ::: slot dentro de ::: componente … :::, ou remova o bloco.

Erro. Mensagem: o espaço lado-b foi preenchido mais de uma vez.

@component dupla {titulo}
## $titulo
$content
$lado-b
@end
::: dupla {titulo=Comparação}
::: slot lado-b
Depois
:::
::: slot lado-b
De novo
:::
:::

Como corrigir: junte o conteúdo num único ::: slot lado-b.

Erro. Mensagem: @title precisa de um valor.

@title, @author, @theme, @version e @aspect precisam de um valor na mesma linha.

@title
# Abertura

Como corrigir: informe o valor, como @title Relatório anual, ou remova a linha.

Erro. Mensagem: @color espera um nome e um valor.

@color
# Abertura

Como corrigir: informe o nome do token e a cor, como @color marca #ff6b4a.

Erro. Mensagem: @style espera um nome e atributos.

@style destaque
# Abertura

Como corrigir: informe o nome e os atributos entre chaves, como @style destaque {color=coral weight=bold}.

Erro. Mensagem: @component sem @end (ou @header, @footer).

Sem @end, todo o restante do documento é lido como corpo do bloco, e a apresentação fica sem slides.

@component selo {texto}
::: box {.card}
$texto
:::
# Abertura

Como corrigir: termine o @component, @header ou @footer com uma linha @end.

Erro. Mensagem: @end sem um bloco aberto.

@end
# Abertura

Como corrigir: remova o @end ou adicione antes dele o @component, @header ou @footer que ele deveria fechar.

Erro. Mensagem: definição desconhecida: @tema.

O nome depois de @ não é uma definição da linguagem. A dica sugere a mais parecida.

@tema ink
# Abertura

Como corrigir: use uma das definições: @title, @author, @theme, @version, @aspect, @color, @font, @style, @component, @header, @footer ou @end.

Erro. Mensagem: nome da fonte sem aspas de fechamento.

@font titulo "Bebas Neue 400
# Abertura

Como corrigir: feche as aspas depois do nome da família: @font titulo "Bebas Neue" 400.

Erro. Mensagem: nome de fonte inválido: Open-Sans.

O nome da família só pode ter letras, números e espaços, e não pode ser vazio.

@font titulo "Open-Sans"
# Abertura

Como corrigir: use o nome da família como aparece no Google Fonts, entre aspas: @font titulo "Open Sans".

Erro. Mensagem: peso de fonte inválido: 450.

@font titulo "Inter" 450
# Abertura

Como corrigir: use pesos de 100 a 900, de 100 em 100, como 400 ou 500.

Erro. Mensagem: @component precisa de um nome.

@component {texto}
$texto
@end

Como corrigir: escreva o nome logo depois de @component: @component selo {texto}.

Erro. Mensagem: nome de componente inválido: Selo.

Nomes de componente começam com letra minúscula e usam apenas letras minúsculas, números e hífens.

@component Selo {texto}
$texto
@end

Como corrigir: use um nome como selo ou selo-novo.

Erro. Mensagem: parâmetros de componente não aceitam .estilo nem #id.

A lista entre chaves de @component declara parâmetros, não estilos.

@component selo {.card texto}
$texto
@end

Como corrigir: remova o .estilo ou #id da lista e aplique o estilo num bloco do corpo, como ::: box {.card}.

Erro. Mensagem: tema desconhecido: dark.

O tema não existe, e o documento usa o tema paper.

@theme dark
# Abertura

Como corrigir: use paper, ink ou editorial. Veja Temas embutidos.

@theme não cria nem dá nome a um tema: ele só escolhe a base. Para ter um tema seu, mantenha uma base e ajuste com @color, @font e @style. Na Biblioteca, o nome do tema vai no campo Nome. Veja Temas.

Erro. Mensagem: versão da linguagem não suportada: 2.

@version 2
# Abertura

Como corrigir: use @version 1, a versão atual, ou remova a linha.

Erro. Mensagem: proporção não suportada: 21:9.

@aspect 21:9
# Abertura

Como corrigir: use 16:9 (padrão) ou 4:3.

Erro. Mensagem: nome de cor inválido: Marca.

Tokens de cor começam com letra minúscula e usam apenas letras minúsculas, números e hífens.

@color Marca #ff6b4a
# Abertura

Como corrigir: use um nome como marca ou marca-escura.

Erro. Mensagem: nome de fonte inválido: Titulo.

O nome do token (a primeira palavra depois de @font) segue a mesma regra dos tokens de cor.

@font Titulo "Bebas Neue" 400
# Abertura

Como corrigir: use um nome como titulo, e aplique com {font=titulo}.

Erro. Mensagem: nome de estilo inválido: Destaque.

@style Destaque {color=accent weight=bold}
# Abertura

Como corrigir: use letras minúsculas, números e hífens, como destaque.

Erro. Mensagem: o tema do projeto só pode ter definições, não slides.

Aparece apenas no editor do tema do projeto, nunca nas apresentações. O exemplo abaixo é o texto do tema do projeto.

@theme ink
@color marca #12a37f
# Abertura

Como corrigir: deixe no tema apenas linhas que começam com @ (@theme, @color, @font, @style e @component), além de linhas vazias e comentários. O conteúdo dos slides vai em cada apresentação.

Aviso. Mensagem: @title no tema do projeto é ignorado; defina-o em cada apresentação.

Aparece apenas no editor do tema do projeto. Título e autor são de cada apresentação, então são ignorados no tema.

@title Relatório anual
@theme ink

Como corrigir: remova a linha do tema e escreva @title ou @author no início de cada apresentação.

Erro. Mensagem: @footer foi definido mais de uma vez.

Cada apresentação tem um cabeçalho e um rodapé. O segundo bloco é ignorado.

@footer
Confidencial
@end
@footer
$page / $pages
@end
# Abertura

Como corrigir: junte o conteúdo em um único bloco, por exemplo com ::: columns. Veja Cabeçalho e rodapé.

F522 · Campo desconhecido no cabeçalho ou rodapé

Seção intitulada “F522 · Campo desconhecido no cabeçalho ou rodapé”

Erro. Mensagem: @footer usa $pagina, que não é um campo disponível.

Dentro de @header e @footer, $ seguido de um nome é um campo automático. A dica sugere o campo mais parecido.

@footer
Página $pagina
@end
# Abertura
---
# Agenda

Como corrigir: use um dos campos: $page, $pages, $title, $author ou $date.

F523 · Revelação passo a passo no cabeçalho ou rodapé

Seção intitulada “F523 · Revelação passo a passo no cabeçalho ou rodapé”

Aviso. Mensagem: @footer aparece sempre inteiro; step e ::: steps são ignorados nele.

@footer
::: steps
- Primeiro
- Segundo
:::
@end
# Abertura
---
# Agenda

Como corrigir: tire step e ::: steps do bloco. Para revelar algo aos poucos, faça isso dentro do slide.

Aviso. Mensagem: notas do apresentador dentro de @footer são ignoradas.

@footer
Confidencial
::: notes
Lembrar de citar o contrato.
:::
@end
# Abertura
---
# Agenda

Como corrigir: escreva ::: notes dentro do slide em que a nota deve aparecer.

Aviso. Mensagem: o texto Confidencial depois de @footer será ignorado.

A linha do @header ou @footer só aceita atributos entre chaves. O conteúdo vai nas linhas seguintes, até @end.

@footer Confidencial
@end
# Abertura

Como corrigir: passe o texto para a linha de baixo. Para desligar o rodapé que vem do tema do projeto, use @footer none.

F530 · Definição que não cabe no tipo de item da Biblioteca

Seção intitulada “F530 · Definição que não cabe no tipo de item da Biblioteca”

Erro. Mensagem: @theme não pode ser usado em uma paleta.

Cada tipo de item da Biblioteca aceita só algumas definições: paletas levam @color e @font; estilos levam também @style; componentes levam também @component; temas aceitam qualquer definição de tema.

@theme paper
@color marca #349ef4

Como corrigir: apague a linha apontada ou salve o item com outro tipo, por exemplo Tema em vez de Paleta.

F531 · Item da Biblioteca sem definição principal

Seção intitulada “F531 · Item da Biblioteca sem definição principal”

Erro. Mensagem: escolha qual componente é o principal.

Componentes e estilos da Biblioteca precisam dizer qual definição é a principal, aquela que quem usar o item vai chamar.

Como corrigir: no editor da Biblioteca, escolha a Definição principal.

Erro. Mensagem: componente não encontrado(a): cartao.

A definição principal escolhida não existe no texto do item, ou foi renomeada.

Como corrigir: escolha outra definição principal ou corrija o nome no texto.

Erro. Mensagem: tipo de item desconhecido: slide.

O item foi enviado com um tipo que a Biblioteca não conhece. Os tipos válidos são tema, componente, estilo e paleta (modelos são validados como tema).

Como corrigir: salve o item de novo pelo app, escolhendo um dos tipos da lista.