insper-education / active-handout Goto Github PK

Ideally this should also save the unsent report for later.

Acho que fica muito poluído um box dentro de outro, sugiro apenas remover o admonition da resposta, talvez mudar alguma na fonte para marcar que o texto pertence a resposta e não pergunta.

Implement a way to add videos to a handout. We suggest the use a custom admonition like below. The developed plugin would replace the link with a video player so that the reader can watch the video.

!!! video
    [Video title](link to the video)

Requirements:

1. support both local videos and youtube links
2. present a QRCode to the video if the page is printed

!!! task
   Describe task here

Pode possuir:

• contador de tarefas
• checkbox indicando conclusão
• lista de tarefas
• box especial

Add documentation for:

• parsons
• templating
• fix content order in the reference section
• homepage refers to a Use cases section that does not exist
• Getting started tutorial

Report to database

• Progress
• Quiz
• Short answer

Professor could chose to the report be anonymous, if not ask student id.

Pergunta do tipo que precisa ligar a pergunta com a resposta, pensei que o formato poderia ser:

!!! question matching
     !!! question
          - question a
          - question b
          - question c

     !!! pair
        - pair a
        - pair b
        - pair c

ref:

Having all the courses form a "book" of sorts can be incredibly useful for courses where handouts are mostly used without computers. It is also important if the authors decide to assign a ISBN to the materials and publish them elsewhere as well.

This issue comprises not only generating the book using an existing package but also testing some existing materials to understand the limitations and problems that could arise from using such tool.

It would be nice to have students page feedback.

1. Think on course material what would we ask and want to know from students?

ref: https://docs.elementary.io/develop/

Add a checkbox to each task in order to:

1. Explicit the task
2. Do not let the student go on without completing everything

Actions:

• !!! progress only allow to continue once all tasks are done

Idea:

Exemplo: https://insper-education.github.io/active-handout/reference/basic-editing/

Especificar interface de visualização de dados do report.

Add date of last modification in footer.

No meu celular o prompt para pedir o dado do usuário não aparece quando abro no safari-ios.

Uma ideia é trocar o prompt por alguma outra coisa.. um form modal?

https://jqueryui.com/dialog/#modal-form

It might be a good idea to integrate with external content (LMS or other websites) using a modal iframe. The student clicks a link and the website "takes over" the handout. When the activity is finished the student can close the modal window and continue the handout .

criar página com guia de principiantes para markdown

We frequently add reference material links (datasheets, wikipedia articles, etc) in handouts. Add a way to track which ones were clicked.

Mudar de nome para active-handout, faz a ponte com active learning

Question: How to show the correct answer? Maybe with a line under the studets response (on the same cell)

To be use on cases like:

Port from

• https://github.com/Insper/supercomp/tree/master/custom_theme/partials
• https://github.com/Insper/supercomp/tree/master/material/css

Acontece muitas vezes do aluno estar com a página aberta no navegador com uma versão antiga, poderíamos indicar para o aluno atualizar a página.

Pensar em como seria um quadro de avisos dentro do active-handout. Muitas vezes os avisos ficam perdidos no teams ou no blackbaord, seria legal de ter uma forma padrão de adicionar avisos.

• Alerta ao aluno de um aviso novo (popup?)

Criar um jeito fácil de inserir PDFs na página, talvez assim:

!!! pdf
    url

Devemos permitir a configuração do width e height? Se sim, talvez tratar o PDF como uma imagem seja mais apropriado: ![]( *.pdf){width=500}.

Também seria interessante a ferramenta adicionar uma opção de abrir o pdf em ferramenta externa.

Exemplo de uso:

• http://127.0.0.1:8000/Lab-10-RTOS-WIFI/#winc1500

No final deve converter para algo como:

<div style="text-align: center;" class="no-print"><embed src="url" width="650" height="500"></div>

Hide report firebase secrets, can we use github environment var?

O botão de checkpoint só permite continuar se todas as pendências (quiz, short question, ...) tiverem sido respondidas, mas não existe nenhum aviso ao aluno.

Solução:

Deixar o botão disabled com uma mensagem embaixo falando que precisa responder antes de prosseguir.

Current behavior:

• "The page has been update" shows on any page when the site has been updated.

Expected behavior:

• The message should only shown on the updated pages

Dois tipo:

• Revela o resto da página
• Só reporta o progresso

Dúvidas:

• Usar botão do material? https://squidfunk.github.io/mkdocs-material/reference/buttons/
• Botão que reinicia os Checkpoints?
• O botão some e não tem mais nenhuma ref. para o aluno que ali era um checkpoint, podemos colocar uma linha no lugar?

O código está usando snake_case, mas em JS o padrão é lowerCamelCase.

Devemos atualizar os nomes de variáveis e funções para camel case.

Proposed markup:

!!! drawing 
    Enunciado aqui. 
    ![caption](image.png)

Criar um plugin de notificações. Definir funções que possam ser chamadas a partir de outros plugins sempre que for necessário notificar o usuário.

Allow to have multiple correct options on question choice module