bethania_porto_santos/dist-windows/LEIA-ME.txt

65 lines
3.2 KiB
Plaintext
Raw Permalink Normal View History

PlanoDeAtaque (Windows) — gerador do PPTX por quinzena
=========================================================
O QUE TEM NESTA PASTA
----------------------
- PlanoDeAtaque.bat -> clique duas vezes aqui para rodar
- python\ -> Python "portatil" com tudo que o programa
precisa ja embutido (nao precisa instalar
Python nem nada no computador)
- gerar_plano.py -> o programa em si
- cores.json -> arquivo de entrada com as cores usadas no PPTX
- 022-26_Plano-de-Ataque-Teste.pptx -> modelo (slide 2 = layout de uma quinzena)
- 022_26-Planejamento-Teste.xlsx -> planilha de planejamento (aba "Planejamento")
COMO USAR
---------
1. Deixe nesta pasta SEMPRE apenas 1 arquivo .json de cores, 1 .pptx modelo e
1 .xlsx de planejamento (pode trocar o conteudo/nome dos arquivos, contanto
que continue tendo so um de cada tipo). Nao mexa na pasta "python".
2. De dois cliques em "PlanoDeAtaque.bat".
(Se o Windows/SmartScreen avisar "Windows protegeu o computador", clique em
"Mais informacoes" -> "Executar assim mesmo" -- isso acontece porque o
arquivo nao tem uma assinatura digital paga, nao porque tem algo de errado.)
3. Uma janela preta (prompt de comando) vai abrir, mostrar o andamento e gerar
"<nome-do-modelo>_ATUALIZADO.pptx" na mesma pasta.
4. Aperte qualquer tecla para fechar a janela quando terminar.
5. Pode rodar quantas vezes quiser (sobrescreve o arquivo gerado a cada vez).
COMO EDITAR AS CORES (cores.json)
----------------------------------
Abra o cores.json com o Bloco de Notas (ou qualquer editor de texto). Para
cada estrutura (geotecnia / superestrutura / infraestrutura) existem dois
status: "andamento" e "concluido". Cada um tem:
- "preenchimento": cor de dentro do quadrado/quadrante (hexadecimal, sem #)
- "borda": cor do contorno (hexadecimal, sem #)
- "alpha_preenchimento": opacidade do preenchimento no DESENHO, de 0 a 100
(100 = solido; um valor mais baixo deixa a planta aparecer por baixo
da cor). A legenda do slide sempre aparece solida (100%), independente
deste valor.
Tambem da para ajustar:
- "marcador_fracao": tamanho dos marcadores de pilar/bloco, em fracao do
espacamento entre colunas (0.42 = 42%). Valores menores = marcadores
menores.
- "quinzena.duracao_dias": quantos dias tem cada quinzena (padrao 14)
- "quinzena.data_inicio": data de inicio da primeira quinzena (AAAA-MM-DD)
- "quinzena.numero_inicial": numero da primeira quinzena gerada (padrao 2,
igual ao slide-modelo original "Quinzena 02")
Depois de editar e salvar o cores.json, so rodar o PlanoDeAtaque.bat de novo.
SE DER ERRO
------------
A janela preta explica o que falta (por exemplo, "nenhum arquivo .xlsx
encontrado" ou "mais de um arquivo .pptx encontrado"). Corrija a pasta
conforme a mensagem e rode novamente.
OBSERVACAO TECNICA
--------------------
Esta pasta usa o "Python embutido" (embeddable) oficial do python.org dentro
de python\, com as bibliotecas ja instaladas em python\Lib\site-packages.
Isso significa que a pasta inteira precisa ficar junta -- pode mover a pasta
toda para outro lugar, mas nao pode separar o PlanoDeAtaque.bat da pasta
python\.