{{ :qualcard-logo-fin.png?500 |qualcard}} ====== 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 * 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. ===== Chaves da linha de comando ===== 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. ===== 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 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 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](https://github.com/drbeco), no endereço https://github.com/drbeco/qualcard ## Licença ## ### Autor ### * Prof. Dr. Ruben Carlo Benante - Email: - 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 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 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 . ===== 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.