100%
Entrar
Entrar

Lançada a versão 4.0.0 do volto-code-block

A nova versão do complemento para Volto documenta seus blocos para agentes de inteligência artificial, traz legenda ao Diagrama Mermaid e corrige o botão de copiar do Bloco de Código.

volto-code-block-4-0-0.png

Foi lançada a versão 4.0.0 do @plonegovbr/volto-code-block, complemento para o Volto mantido pela comunidade PloneGov-BR. Ele oferece três blocos para quem escreve sobre tecnologia: o Bloco de Código, com destaque de sintaxe; o Diagrama Mermaid, que desenha diagramas a partir de uma definição em texto; e o Bloco Gist, que incorpora Gists públicos do GitHub.

A página do projeto traz exemplos dos três blocos, com legenda, e as instruções de instalação. O complemento já está em uso neste site.

Blocos documentados para agentes

A principal novidade é a documentação dos três blocos para o endpoint @blocks-schema, disponível a partir do Volto 19.6. Cada bloco descreve seus campos, com exemplos e o schema, e assim um agente de inteligência artificial conectado por MCP aprende a escrever esses blocos sem instruções feitas à mão. Os exemplos da página do projeto foram gravados dessa forma.

Os formulários da barra lateral agora leem o schema da configuração do bloco. Dessa forma, um blockSchema personalizado vale para os dois lugares, e os formulários passam a mostrar os erros de validação.

Legenda, tamanho e alinhamento

O Diagrama Mermaid ganhou legenda, e os blocos de código e Gist passaram a ter opções de tamanho e alinhamento. O Bloco de Código também passou a destacar a sintaxe de TOML.

Correções

  • O botão de copiar voltou ao seu lugar e agora está sempre visível.
  • A opção de quebrar linhas longas voltou a funcionar.
  • Código com linguagem desconhecida ou sem linguagem definida é exibido, em vez de causar erro.
  • A descrição da legenda usa uma marcação HTML válida.

Por dentro do complemento

O complemento foi convertido para TypeScript, atualizado para o Volto 19.6.1 e alinhado ao cookieplone-templates. Os testes de aceitação passaram do Cypress para o Playwright. A versão também traz a contribuição de Matheus Nunes Santana.

Instalação

Em um projeto Plone 6 com Volto, adicione o pacote às chaves addons e dependencies do arquivo package.json:

"addons": [
    "@plonegovbr/volto-code-block"
],
"dependencies": {
    "@plonegovbr/volto-code-block": "4.0.0"
}

O complemento é desenvolvido e testado com o Volto 19.6.

O código está no GitHub, o pacote no npm, e os blocos podem ser vistos no Storybook. Os erros conhecidos estão registrados nas issues do projeto.

PlonePlone 6Volto