Renan, o Professor — Academia de Português Brasileiro
Curso gratuito e estático de português brasileiro, alinhado ao QECR
(Pre-A1 a C2), com centenas de exercícios interativos corrigidos no
próprio navegador. Site-irmão de
englishclasses — mesma
filosofia ($0, GitHub Pages, sem backend), arquitetura adaptada e
reconstruída inteiramente para o português.
Ao vivo: https://renangrossi.github.io/aulasdeportugues/
Estado atual
- Currículo completo: os sete níveis do QECR, de Pre-A1 a C2, estão
100% publicados — 73 lições, 223 blocos de exercícios, 459 itens
corrigíveis automaticamente. Nenhuma página de nível mostra mais
"Em breve".
- "AI Teacher" (Professor IA): código completo (widget + Cloudflare
Worker + catálogo do curso), mas ainda não implantado — o botão
fica oculto (
AI_TEACHER_ENABLED = False em scripts/site_chrome.py)
até que o Worker seja implantado de verdade. Ver worker/README.md
para o passo a passo de deploy.
- Sem áudio pré-gravado: os botões de "Ouvir" usam a Web Speech API do
próprio navegador (
assets/js/listening.js) — grátis, sem arquivos.
- Próximos passos naturais (não feitos ainda): mais lições por nível
(o roteiro atual é uma cobertura sólida, não exaustiva, de cada
nível), implantar o Worker do "AI Teacher", e áudio pré-gravado real.
Arquitetura
curriculum/{nivel}/{id}.json -- fonte única de verdade de cada lição
curriculum/index.json -- sequência de unidades/lições por nível
scripts/build_lesson.py -- curriculum/*.json -> niveis/{nivel}/{slug}.html
scripts/build_level_page.py -- curriculum/index.json -> niveis/{nivel}.html
scripts/build_home.py -- index.html
scripts/build_utility_pages.py -- dicionario/exercicios/verbos-irregulares/
progresso/revisao-de-hoje/teste-de-nivelamento
scripts/build_data_indexes.py -- assets/data/search-index.json e
assets/data/exercise-items-index.json
scripts/site_chrome.py -- cabeçalho/rodapé/nav compartilhados
Todas as páginas HTML deste repositório (exceto os scripts em si) são
geradas — não edite niveis/*.html, index.html ou as páginas
utilitárias diretamente; edite o JSON/Python correspondente e rode:
python3 scripts/build_lesson.py # todas as lições
python3 scripts/build_level_page.py # as 7 páginas de nível
python3 scripts/build_home.py # index.html
python3 scripts/build_utility_pages.py # páginas utilitárias
python3 scripts/build_data_indexes.py # índices de busca e revisão
(Ou rode os cinco em sequência — não há dependência entre eles além da
ordem lógica acima.)
Motor de exercícios
assets/js/exercises.js é praticamente idêntico ao do site em inglês —
o motor não sabe nada sobre o idioma do conteúdo, só sobre o formato
JSON de cada exercício (curriculum/SCHEMA.md documenta o formato de
lição completo; o formato de cada exercício é o mesmo lido por
exercises.js, ver o comentário no topo daquele arquivo).
Design
assets/css/tokens.css define uma identidade brasileira própria — verde-
mata, terracota, ouro e azul-céu sobre superfícies de areia/marfim,
tipografia Lora + Source Sans 3 — usando os mesmos nomes de variável
que o restante do sistema de estilos (base.css, components.css,
layout.css, exercises.css, lessons.css, search.css,
dark-mode.css) já espera, para que esses arquivos pudessem ser
reaproveitados quase sem alteração.
Progresso e repetição espaçada
Ver docs/gamification.md.
Publicar no GitHub Pages
Este repositório já está configurado para GitHub Pages a partir da
branch main, raiz do repositório (sem Jekyll — ver .nojekyll). Basta
dar git push na branch main; o GitHub reconstrói o site
automaticamente.
Licença
Todos os direitos reservados — © Renan, o Professor.
