Hydra Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{ :qualcard-logo-fin.png?500 |qualcard}}

====== Qualcard ======

<markdown>

## 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.
</markdown>

===== Chaves da linha de comando =====

O programa ''qualcard'' aceita as seguintes chaves:

<code>
 -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.
</code>

===== Como criar cartões =====

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.


==== Nome do arquivo de cartões ====

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.

==== Localização do arquivo de cartões ====

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.


==== Formato dos cartões ====

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
  -----------------------------------------------------------


=== Caracteres especiais ===

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
  -----------------------------------------------------------


<markdown>
## Download ##

Qualcard é um software livre e está disponível, com código fonte, na página de github do [Prof. Ruben C Benante](https://github.com/drbeco), 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/>.


</markdown>

===== Qualcard :: Mille Parole - O livro =====

Baixe aqui o ebook do ''Qualcard :: Mille Parole'' 

{{:benante2021-qualcard-mille-parole-ed1.pdf}}

Livro completo para seu estudo de Italiano.