Como editar

Adicionar/remover páginas

Manual didático

Como adicionar, remover e editar páginas.

Pense no projeto como uma fábrica: o arquivo de dados descreve os botões; o gerador monta as páginas; a tela principal e a sidebar são recriadas automaticamente.

⚙Abrir CRUD em Ajustes
1

Editar

JSON

Dados ficam em geradores/paginas.json.

2

Gerar

.py

Arquivos finais saem em paginas/.

Fluxograma em formato de historinha

do botão até a página
Cena 1💡

A ideia nasce

Você decide: “quero uma página chamada Relatórios”. Ela precisa de nome, cor, ícone, subtítulo e conteúdo.

Cena 2🧾

O cadastro é feito

Você registra esses dados pelo CRUD da página Ajustes ou edita manualmente geradores/paginas.json.

Cena 3⚙

O gerador trabalha

Ao rodar python geradores/gerar_todas_paginas.py, o projeto lê o cadastro e monta os arquivos.

Cena 4📁

A pasta aparece

Surge paginas/pagina_relatorios/ com HTML, CSS e JS próprios para editar individualmente.

Cena 5🚀

O botão funciona

O botão entra no menu principal, aparece na sidebar e abre a nova página com appbar, navbar e layout wide.

Caminho 1: criar página pela interface

mais fácil
▶

1. Inicie o editor

No terminal, na pasta do projeto, execute:

python executar_editor_paginas.py
⚙

2. Abra Ajustes

Entre na página Ajustes. O painel deve mostrar status conectado. Se não conectar, confira se o servidor está aberto.

＋

3. Clique em Novo

Preencha id, nome, subtítulo, cor, RGB, emoji e conteúdo HTML. O id não deve ter acento nem espaço.

💾

4. Salve

O Python atualiza o JSON, cria a pasta da página, cria o gerador individual e atualiza o menu principal.

Caminho 2: criar página manualmente

controle total

Passo 1 Abra o arquivo de cadastro

Abra geradores/paginas.json. Ele possui uma lista de páginas. Cada página é um objeto com campos como id, nome, cor e content.

Passo 2 Copie um bloco existente

Copie uma página parecida e altere os valores. Exemplo mínimo:

{
  "id": "relatorios",
  "nome": "Relatórios",
  "subtitulo": "Painéis e gráficos",
  "emoji": "▣",
  "icon": "bx-bar-chart-alt-2",
  "cor": "#22c55e",
  "rgb": "34,197,94",
  "effect": "random",
  "transition": "flash",
  "content": "<section class='hero-page'>...</section>"
}

Passo 3 Rode o gerador

Use o comando geral para reconstruir tudo:

python geradores/gerar_todas_paginas.py

Depois disso, a página aparece no menu principal, na sidebar e ganha seu próprio geradores/gerar_relatorios.py.

Como remover uma página sem deixar resto

limpeza segura
1

Remover pelo CRUD

Na página Ajustes, selecione a página e clique em Excluir selecionada. O servidor remove o cadastro, a pasta final e o gerador individual.

2

Remover manualmente

Apague o objeto da página em geradores/paginas.json.

3

Limpar arquivos

Exclua paginas/pagina_id/ e geradores/gerar_id.py, caso queira limpeza total.

4

Gerar de novo

Rode python geradores/gerar_todas_paginas.py para retirar o botão do menu e da sidebar.

Checklist antes de finalizar

não quebrar
  • ✓O id está em minúsculas, sem acento e sem espaço.
  • ✓O rgb combina com a cor hexadecimal, porque ele alimenta brilhos, transparências e animações.
  • ✓O conteúdo usa classes existentes, como hero-page, panel, card, section-block e grid.
  • ✓Você rodou o gerador depois de editar o cadastro.
  • ✓Você testou o botão no menu principal, a sidebar e o retorno ao menu.