Documentação
🏠 Início

Guia Rápido do Nuwell

Aprenda como utilizar as ferramentas interativas, publicar apresentações de slides dinâmicas e engajar seus alunos com equações, quizzes e códigos executáveis ao vivo.

Para Professores (Criando Aulas)

1. Importar Materiais

Arraste seus arquivos de aula diretamente para o builder. O Nuwell é compatível com os formatos que você já utiliza: Markdown (.md), LaTeX (.tex), Jupyter Notebook (.ipynb), PowerPoint (.pptx) e arquivos de imagem ou código.

  • Importação de múltiplos arquivos simultâneos.
  • Criação rápida de slides a partir de mensagens textuais simples.
Tela de Importação do Professor

2. Configurar Apresentação

Configure os detalhes da sua apresentação no painel. Ajuste as informações que serão mostradas na capa dos slides, altere a cor de destaque da interface e defina os limites padrão de tempo.

  • Configuração de Nome, E-mail, Instituição e Título da Aula.
  • Controle do número de alunos esperados e tempo limite das atividades.
Tela de Configuração do Professor

3. Criar slides

Visualize os arquivos preparados antes de iniciar a sessão. Reordene-os facilmente usando os botões de movimentação e confira uma prévia do conteúdo em tempo real no painel de visualização.

  • Mova arquivos para cima ou para baixo para reordenar os slides.
  • Visualize códigos e textos antes de clicar em "Criar slides" para gerar a sessão.
Tela de Organização e Publicação

Para Alunos (Participando da Aula)

Acesso Simplificado via Código

Sem downloads, sem necessidade de criar contas ou preencher cadastros. Para entrar na aula, o aluno precisa apenas acessar o site, abrir a janela de entrada e digitar o código compartilhado pelo professor.

  • Acesso instantâneo de qualquer dispositivo (celular, tablet ou PC).
  • O aluno define um apelido de exibição amigável para a aula.
Janela de Acesso do Aluno

Interatividade em Tempo Real

À medida que o professor apresenta e ativa as atividades, a tela do aluno atualiza de forma síncrona. Os alunos podem responder quizzes e enviar resoluções de questões abertas.

  • Envio de Fotos: Ideal para anexar a resolução de contas escritas à mão em papel.
  • Autocomplete com TAB: Auxilia na digitação rápida de comandos.
  • Alteração de Apelido: Caso queira trocar seu nome durante a aula.
💡 Dica Importante

As imagens e arquivos enviados pelos alunos são transmitidos em tempo real para o monitor de progresso do professor, facilitando o feedback e a correção imediata na aula.

Sintaxe de Markdown Interativo

O Nuwell estende a sintaxe tradicional de Markdown com blocos interativos. Escreva estas marcações em seus arquivos .md ou .tex para criar slides interativos automaticamente:

📝 Quiz (:::quiz)

Insere uma questão de múltipla escolha com correção automática.

:::quiz
Qual comando inicia o servidor?
- [ ] npm init
- [x] npm start
- [ ] npm build
:::
  • Texto no início vira o enunciado.
  • Alternativas iniciam com - [ ] (incorreta) ou - [x] (correta).
  • Mínimo de 2 alternativas obrigatório.

💬 Resposta Aberta (:::open-answer)

Permite que alunos enviem texto ou fotos/desenhos de resoluções.

:::open-answer
Explique a diferença entre let e const em JS.
:::
  • Conteúdo entre as marcações vira a pergunta.
  • Suporta envio de anexos fotográficos pelos alunos.

📐 Gráfico TikZ (:::tikz)

Renderiza diagramas LaTeX em vetor ou cria sessões de digitação.

:::tikz mode=render
\draw (0,0) -- (2,0);
\draw (0,0) -- (0,2);
:::
  • mode=render (padrão) desenha a figura.
  • mode=typing cria slide interativo de digitação.

🖼️ Figuras com Legenda (:::figure)

Insere imagens com numeração automática e referências cruzadas.

Veja a @fig:exemplo.

:::figure {#fig:exemplo}
![Capa](capa.webp)
Diagrama estrutural do sistema.
:::
  • {#fig:id} define o identificador para referências.
  • O texto com @fig:id vira "Figura N" no slide.

📊 Tabelas Interativas (:::table)

Cria tabelas com ordenação, buscas e gráficos ao vivo.

:::table Desempenho
| Disciplina | Média | Faltas |
| ---------- | ----- | ------ |
| Cálculo I  | 6.4   | 12     |
| Física I   | 5.9   | 15     |
:::
  • Gera gráficos automáticos (linhas, barras, mapa de calor).
  • Suporta arquivos CSV externos com source: arquivo.csv.

⏱️ Cronômetro (:::clock)

Insere um timer regulável para atividades ou intervalos.

:::clock mode=activity
duration: 10
title: Resolva a questão da folha.
bullets:
- Use caneta preta.
- Envie a foto no painel.
:::
  • duration define o tempo inicial em minutos.
  • mode suporta timer, activity ou break.

🎥 Vídeo Inline (:::video)

Embuta vídeos locais ou externos no slide.

:::video
source: experimento.mp4
:::
  • Aponta para arquivo de vídeo enviado ou URL direta.

📇 Capa da Aula (:::head)

Define metadados da capa sem precisar preencher formulários.

:::head
title: Aula de Grafos e Árvores
name: Prof. Ada Lovelace
institution: UFSCar
email: ada@ufscar.br
:::
  • Reconhece campos title, name, institution e email.

Recursos Especiais e Overlays

Matemática e Gráficos

Nuwell foi desenvolvido com foco em disciplinas de exatas. O sistema detecta e renderiza automaticamente expressões matemáticas em formato LaTeX, facilitando a exibição de matrizes, limites e integrais.

  • Renderização rápida e limpa de fórmulas matemáticas.
  • Visualizações gráficas dinâmicas com tabelas de calor e plots interativos.

Modo Contingência (Offline)

A aula não para se a internet oscilar. Se o backend ou o servidor de WebSocket perder conexão, a interface entra em modo de contingência local automaticamente.

  • Acesso offline aos slides já carregados em cache.
  • Mensagem informativa indicando a pausa na sincronização global temporariamente.