Skip to content

Latest commit

 

History

35 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WebLab — Laboratório de Desenvolvimento Web

DOI

Apostila online, gratuita e autocontida de desenvolvimento web, escrita e revisada por professores da UNEMAT — Campus Sinop (FACET) (ver autoria e créditos). Nasceu das disciplinas presenciais e é publicada aberta: serve a qualquer pessoa que queira aprender, em qualquer época — sem datas, notas ou prazos no material.

No ar em https://weblab.aprendabit.com

Trilha Disciplina Aulas Projeto fio-condutor
Nível 1 — Introdução ao Desenvolvimento Web FACET-SNP-319 15 Site de um evento acadêmico (HTML → CSS → JS)
Nível 2 — Desenvolvimento Web FACET-SNP-307 16 Café Cerrado (estático → SPA → Express + OAuth Google + CRUD)
Nível 3 — Frameworks Modernos FACET-SNP-310 15 UniEventos (Vue 3 + Vuetify + Pinia + Express + MySQL/Supabase + Firebase)
Deploy & Ferramentas transversal 11 Publicar os três projetos acima

Mais o Banco de Desafios (todos os desafios das aulas + projetos integradores, filtráveis) e Links úteis.

Como está organizado

fontes/            ★ conteúdo canônico em Markdown
  ESPECIFICACAO.md   regras editoriais (estrutura das aulas, formato dos desafios, stack, armadilhas)
  nivel-1/ nivel-2/ nivel-3/ deploy/   uma aula por arquivo
  desafios/projetos-integradores.md · links.md · home.md
build/             gerador do site (Python 3.12, python-markdown + pygments)
  config.py          trilhas, aulas, cronograma 2026.2, avaliações — ÚNICO lugar com datas
  render.py          Markdown → HTML, callouts, blocos de código, extração de desafios
  lint.py            valida as fontes (seções obrigatórias, mínimos, fences, placeholders)
  paginas.py         templates · theme.css / app.js design system e comportamento
  build.py           gera site/ (aulas, índices, apostilas únicas, banco, links, busca, sitemap)
  tests/             pytest
site/              saída gerada (não versionada)
deploy.sh          build + rsync para o servidor
docs/              planos de curso (PDF), fontes brutas, spec e plano de implementação

Editar e publicar

python3 -m venv --system-site-packages .venv && .venv/bin/pip install pytest markdown pygments
.venv/bin/python -m pytest build/tests -q      # testes do gerador
.venv/bin/python build/lint.py                 # valida todas as fontes
.venv/bin/python build/build.py                # gera site/ (falha se o lint acusar erro)
.venv/bin/python build/build.py --parcial      # gera só o que existe (durante a escrita)
./deploy.sh                                    # build + rsync → https://weblab.aprendabit.com

Para escrever ou alterar uma aula, siga fontes/ESPECIFICACAO.md. O lint rejeita aulas sem a estrutura completa (Objetivos → Pré-requisitos → Roteiro → teoria → Mão na massa → Laboratório A/B/C → 🏆 Desafios → Erros comuns → Atividade assíncrona → Checkpoint → Para aprofundar).

Para adicionar uma aula ou trilha: inclua-a em build/config.py, crie o arquivo em fontes/<trilha>/ e rode o build.

O conteúdo é atemporal e aberto — nenhuma aula tem datas, semestre, turma, nota ou prazo; cada unidade fecha com um marco do projeto, não com uma avaliação. Para publicar o calendário de um semestre no índice das trilhas, preencha SEMESTRE, CRONOGRAMA e o prazo de cada avaliação em build/config.py; o formato e o calendário de 2026.2 estão em docs/calendario-2026-2.md.

Recursos do site

Tema claro/escuro · busca global · botão Copiar em todo código · sumário lateral · apostila em arquivo único por trilha · progresso local (aulas concluídas e desafios feitos, salvos no navegador) · Banco de Desafios com filtros · impressão limpa (Ctrl+P) · atalhos j/k//.

Licença

Conteúdo sob CC BY 4.0; o gerador do site, sob licença MIT. Ver LICENSE.

Como citar: pelo DOI conceitual 10.5281/zenodo.22220024, que resolve sempre para a versão mais recente. Veja CITATION.cff — o GitHub monta a citação no botão Cite this repository. O roteiro do depósito está em docs/doi-zenodo.md.

About

WebLab — curso online aberto de desenvolvimento web (pt-BR): 57 aulas, banco de desafios e o gerador do site em Python · weblab.aprendabit.com

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages