Breve: coleções de resumos e folhas de fórmulas em LaTeX organizadas por disciplina.

• Requisitos
• Uso rapido
• Construcoes por capitulo
• Alvo combinado
• Integracao continua (CI)
• Contribuicao
• Licenca

• TeX (pdflatex) — TeX Live ou similar. Observação: o pacote siunitx é necessário; no Debian/Ubuntu instale texlive-science.
• make

• Gerar o documento principal:

make all

• Gerar toda a disciplina (PDF dentro da pasta da disciplina):

make fisicas        # -> fisicas/fisicas.pdf
make calculos       # -> calculos/calculos.pdf

• Gerar um capítulo específico (exemplos):

make fisicaiii cap30                  # forma posicional

Observações:

• Arquivos temporários (build_*.tex, .aux, .log, .synctex.gz) são removidos automaticamente após build bem-sucedido.

Para ciclos de desenvolvimento rápidos, há um modo "fast" que compila em modo rascunho e roda pdflatex apenas uma vez:

make fisicas-fast      # equivalente a: make fisicas FAST=1
# ou
make fisicas FAST=1

Útil para checar o layout sem processar imagens pesadas.

Gera um PDF por capítulo (arquivo individual dentro do diretório da disciplina). Use o alvo disciplinas (pt) ou disciplines (en) com a variável contendo disciplinas separadas por vírgula.

Exemplos:

# gera um PDF por capítulo em calculos/ e fisicas/
make disciplines="calculos,fisicas"       # ou make disciplinas="calculos,fisicas"

# gerar só calculos
make disciplines="calculos"

Comportamento:

• Cria um PDF para cada entrada listada em CALCULOS_INCLUDES e FISICAS_INCLUDES (por exemplo: calculos/calculoi/calculoi_calculo_basico.pdf, fisicas/fisicaiii/fisicaiii_cap30.pdf).
• Silencioso por padrão; passe VERBOSE=1 para ver os passos:

make disciplines="calculos,fisicas" VERBOSE=1

O alvo combined gera um único PDF combined.pdf contendo as seções de Cálculos e Físicas.

make combined VERBOSE=1

Há um workflow GitHub Actions em .github/workflows/test-builds.yml que executa em push e em pull requests. O job:

• instala pacotes LaTeX mínimos na runner;
• executa make disciplines=calculos,fisicas VERBOSE=1 (gera PDFs por capítulo);
• executa make combined VERBOSE=1 (gera combined.pdf);
• publica os PDFs como artifacts para inspeção.

O job falhará caso qualquer build retorne erro — útil como teste automático de regressão.

Para reproduzir o que o CI faz, execute localmente:

# gerar um PDF por capítulo para calculos e fisicas
make disciplines="calculos,fisicas" VERBOSE=1

# gerar combinado
make combined VERBOSE=1

Os arquivos são gerados nas pastas correspondentes (e.g., calculos/...pdf, fisicas/...pdf) e combined.pdf é criado no repositório raiz.

• Envie PRs para mudanças; inclua uma descrição clara e, quando possível, um teste ou verificação simples.
• Prefira imagens vetoriais (TikZ, PDF) e considere marcar recursos pesados para serem ignorados em builds rápidos (FAST=1).
• Ao alterar Makefile ou scripts de build, adicione verificações que possam ser executadas no CI.

• Pedro — mantenedor do repositório

MIT — veja LICENSE.

Se quiser, adiciono um badge do CI (status) no topo do README e/ou um alvo verify no Makefile que confirme a existência dos PDFs esperados (útil para CI).

Obrigado — documentação simplificada e focada nas operações de build está pronta. Se quiser, posso também abrir um PR com essas mudanças, adicionar o badge do workflow e criar um alvo verify que o CI utilize para validar os PDFs.