Qualcard

Introdução

Projeto de Aprendizado de temas diversos via repetição espaçada de cartões (flash cards).

Regras Implementadas

• A cada execução são apresentados 10 cartões
• Prioridades nos 10 cartões:

  • 9 cartões para reforço por repetição se houver atrasados
  • 1 ou mais cartões novos, se houverem, até completar 10 cartões
  • Qualquer quantidade de cartões repetidos não atrasados para completar a lista de 10
• Os cartões apresentados são auto-avaliados pelo estudante com uma nota N de 0 a 5 (sendo 0 para não conhecer/lembrar, e 5 para acerto com facilidade e confiança)
• Cartões que recebem a nota zero são repetidos ao final, quantas vezes forem necessárias, até que receba nota maior. Os zeros acumulam para cálculo da nota que passa a ser uma média.
• De posse da nota (N), uma nova média (M1) é calculada com a fórmula: M1 = (M0 + N) / 2, onde M0 é a média anterior. No primeiro ciclo, M1 = N - 23%.
• Uma vez apresentados, os cartões são agendados para reapresentação com a seguinte escala:

  • (H) Nota == 0.00 -> reapresentar hoje ao final
  • (G) Média <= 0.60 -> reagendar para 1 dia
  • (F) Média <= 1.35 -> reagendar para 2 dias
  • (E) Média <= 2.20 -> reagendar para 3 dias
  • (D) Média <= 3.05 -> reagendar para 5 dias
  • (C) Média <= 3.90 -> reagendar para 7 dias
  • (B) Média <= 4.92 -> reagendar para 9 dias
  • (A) Caso contrário -> reagendar para 11 dias
• Iniciando um cartão com a nota máxima 5.0, registrada como 5-23%=3.84, e recebendo sempre a nota máxima 5.0, sua progressão é: 3.84 (C), 4.42 (B), 4.71 (B), 4.85 (B), 4.93 (A).
• A nota, para efeito da porcentagem final, decai com o tempo:

  • Decaimento com taxa de 1 ponto a cada meia semana (3.5 dias).
  • Isso significa que se um cartão estiver com nota máxima 5.0, seu valor será considerado zero para efeito de cálculo de porcentagem após 25 dias vencido.
  • No mesmo exemplo, a nota máxima 5.0 será avaliada em 4.0 (perda de 1 ponto) em aproximadamente 10.5 dias.
  • Quando na reapresentação do cartão atrasado, para cálculo de M1, a nota M0 continua tendo o valor 5.0.
• (Atenção: opção ainda não implementada) Quando todos os cartões estiverem com média (A) ou (B), i.é, Nota>3.90, e dentro do prazo de revisão, o programa parabeniza o estudante e imprime um certificado com:

  • Nome completo e usuário
  • Data de início
  • Data de conclusão
  • Carga horária
  • Número de cartões aprendidos
  • Pontuação obtida (coluna Compl.%)
  • Tema do estudo
  • Número de série de certificação
  • Assinatura do Prof. Dr. Ruben Carlo Benante rcb@beco.cc
• As médias usadas para agendamento têm um decaimento suave contínuo pelo período que o programa deixa de ser usado. Para evitar este decaimento, deve-se usar o programa no mínimo uma vez a cada dois dias.

O programa qualcard aceita as seguintes chaves:

 -h,  --help    : mostra o help
 -c,  --version : mostra a versão e informações de direitos reservados.
 -v,  --verbose : ativa o modo verbose (cumulativo).
 -q,  --quiet   : ativa o modo quieto (cumulativo).
 -s,  --status  : mostra o //status//, cartões para revisão, e termina.
 -i,  --invert  : inverte a ordem de apresentação, mostrando primeiro o verso do cartão. Para treinar o sentido contrário.

 -u username,  --user username     : mostra o perfil do usuário. (default, usuário atual).
 -p username,  --path username     : ajusta a pasta de configurações (use com -s).
 -d file.ex4,  --database file.ex4 : seleciona base de dados.

O qualcard permite você criar seus próprios cartões de modo simples, bastando editar um arquivo texto. As especificações a serem seguidas são dadas abaixo.

Vamos exemplificar as definições levando em consideração um conjunto de cartões para aprendizado de classes gramaticais de palavras em português.

O arquivo de cartões deve ter a seguinte definição de nomenclatura:

theme-front-verse.ex4

Isto é:

• theme: o tema do cartão. Por exemplo, no nosso caso, o tema poderia ser gramatica (não use acentos em nomes de arquivo).
• front: Em seguida precisamos declarar o que representa a frente do cartão. No nosso exemplo, a frente do cartão será uma palavra qualquer em português que devemos lembrar da sua classe gramatical. Então teremos, por exemplo palavra.
• verse: E agora o que contém o verso do cartão. No nosso exemplo classe pode ser usada.
• ex4: o arquivo deve ter a extensão .ex4

Pronto, o nome do nosso arquivo de cartões será:

gramatica-palavra-classe.ex4

Agora vamos editar esse arquivo e inserir os cartões propriamente ditos.

Você pode salvá-lo onde desejar, pois pode-se indicar o local com a chave -d, como vimos na seção anterior. Por exemplo, se criar uma pasta em

/home/seuusuario/qualcard

fica fácil encontrar e editar os mesmos, incluindo cada vez mais cartões. Para executar o qualcard com o banco de dados gramatica-palavra-classe.ex4 salvo na pasta acima, basta digitar o comando:

$ qualcard -d /home/seuusuario/qualcard/gramatica-palavra-classe.ex4

E o programa iniciará sua atividade.

Mas existe uma pasta padrão, que permite identificar suas bases de dados automaticamente. Se você salvar a mesma base .ex4 acima na pasta:

/home/seuusuario/.config/qualcard

E rodar o programa diretamente com o comando

$ qualcard

Ele identificará sua base e mostrará a mesma na lista junto com as bases já instaladas no sistema.

Os cartões do qualcard são linhas no arquivo texto cujo nome criamos anteriormente. Cada cartão deve estar em uma única linha. Mas isso não significa que não podemos usar quebra-de-linhas ou outros caracteres especiais.

Uma linha deve ter o seguinte formato:

texto da frente do cartão::texto do verso do cartão

Ou seja, o texto da frente, separado por um duplo dois-pontos, e o texto do verso. Simples assim.

Pode-se usar acentos no arquivo, sem problemas. Pode-se inclusive usar caracteres de outros idiomas, pois o arquivo é UTF-8.

No nosso exemplo, podemos inserir os seguintes 3 cartões, um em cada linha:

Livraria::substantivo comum, simples e concreto, gênero feminino.
Conclave::substantivo coletivo (de pessoas). Grupo de cardeais reunidos para eleger o papa.
Classifique até em: Ele foi até o fundo do mar.::Preposição simples essencial.

Se rodarmos o programa qualcard, o cartão 3 apareceria como:

-----------------------------------------------------------
Card 3 (new card for today)

Classifique até em: Ele foi até o fundo do mar.

---------------Press <ENTER> to turn the card--------------

 Preposição simples essencial.

Your self-evaluation (from 0 to 5, default 1) is: 1
Old score: 0.0, new score: 0.8, revision set to 26-Oct-2021
-----------------------------------------------------------

Para enfeitar um cartão, o qualcard aceita os seguintes caracteres especiais:

• \n → quebra uma linha
• \t → insere uma tabulação horizontal
• \\ → insere uma barra invertida
• \:: → insere um duplo dois-pontos (caso precise usar este símbolo na frente do cartão)

Vamos usar esses caracteres especiais para melhorar nosso cartão 3 acima:

Classifique "até" em:\n\tEle foi até o fundo do mar.::Preposição simples essencial.

E agora o resultado:

-----------------------------------------------------------
Card 3 (new card for today)

Classifique "até" em: 
        Ele foi até o fundo do mar.

---------------Press <ENTER> to turn the card--------------

 Preposição simples essencial.

Your self-evaluation (from 0 to 5, default 1) is: 1
Old score: 0.0, new score: 0.8, revision set to 26-Oct-2021
-----------------------------------------------------------

Download

Qualcard é um software livre e está disponível, com código fonte, na página de github do Prof. Ruben C Benante, no endereço https://github.com/drbeco/qualcard

Licença

Autor

• Prof. Dr. Ruben Carlo Benante

  • Email: rcb@beco.cc
  • Data da criação: 2016-04-07

Licença pt_BR

qualcard : um programa para estudar cartões usando repetição espaçada.

Copyright (C) 2016-2022 Ruben Carlo Benante rcb@beco.cc

Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da Licença Pública Geral GNU, conforme publicada pela Free Software Foundation; tanto a versão 2 da Licença como (a seu critério) qualquer versão mais nova.

Este programa é distribuído na expectativa de ser útil, mas SEM QUALQUER GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou de ADEQUAÇÃO A QUALQUER PROPÓSITO EM PARTICULAR. Consulte a Licença Pública Geral GNU para obter mais detalhes.

Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este programa; se não, escreva para a Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

License en_US

qualcard : a program to study cards using spaced repetition.

Copyright (C) 2016-2022 Ruben Carlo Benante rcb@beco.cc

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Baixe aqui o ebook do Qualcard :: Mille Parole

benante2021-qualcard-mille-parole-ed1.pdf

Livro completo para seu estudo de Italiano.