Pular para o conteúdo

icones componentes starlight mdx

Aprimorar a apresentação visual das páginas de documentação do SinergIA com ícones auxiliares em links e componentes visuais nos conteúdos mais ricos. Converter os arquivos .md principais para .mdx para habilitar o uso de componentes Starlight (Card, CardGrid, Badge, LinkCard) e aplicar:

  • CardGrid + Card com ícones para visualizar grupos de risco, princípios do framework e instâncias de governança
  • Badge com variantes semânticas (danger, caution, success, note, default) nas colunas de severidade e nível das tabelas
  • LinkCard nos CTAs de navegação e links para recursos externos, substituindo os links de texto simples com setas
  • framework/riscos.mdx (substituiu riscos.md)
  • framework/etica-ia.mdx (substituiu etica-ia.md — que já tinha import não funcional em .md)
  • framework/pv-gti.mdx (substituiu pv-gti.md)
  • framework/principios.mdx (substituiu principios.md)
  • referencia/normas/aie-autoavaliacao-ia.mdx (substituiu aie-autoavaliacao-ia.md)

riscos.mdx:

  • CardGrid com 4 Card (ícones: error, warning, information, setting) na intro
  • Badge em todas as colunas de Severidade: danger para Alta/Excessiva, caution para Média
  • LinkCard substituindo → Ver classificação completa de risco ético →

etica-ia.mdx:

  • CardGrid com 6 Card para os princípios éticos AIE (ícones: approve-check-circle, open-book, warning, seti:lock, setting, heart)
  • Badge na tabela de classificação de risco ético: success/caution/danger por nível
  • Badge na tabela de Base Normativa: status das normas
  • Badge nos resultados da autoavaliação (risco Médio, Nível 4 — Alta Aderência)
  • LinkCard para referência AIE Gov.BR

pv-gti.mdx:

  • CardGrid com 2 Card para CGTI (ícone: setting) e GT-IA (ícone: comment)
  • Badge na tabela de tipos de uso de IA: níveis por tipo
  • Badge na tabela de autonomia escalonada: cor por nível (note/caution/danger)
  • CardGrid com 2 LinkCard para Ética e Impacto Social + Riscos e Limitações
  • LinkCard adicional para lista de riscos na seção de Política de Riscos

principios.mdx:

  • CardGrid com 10 Card no topo — resumo visual dos 10 princípios com ícones distintos
  • LinkCard para etica-ia.mdx ao final do princípio 10

aie-autoavaliacao-ia.mdx:

  • Badge na tabela de níveis de risco: success/caution/danger/danger
  • LinkCard para acesso oficial Gov.BR
  • LinkCard para página de Ética e Impacto Social no SinergIA

Nenhuma alteração necessária no astro.config.mjs. Os slugs do Starlight são derivados do caminho do arquivo sem extensão, portanto .mdx e .md geram o mesmo URL.