.. Copyright (C) 2020 Marco de Freitas. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". .. Didacto documentation master file, created by sphinx-quickstart on Mon Apr 6 13:20:00 2020. Didacto ======= Une solution simple pour organiser votre enseignement Didacto est né de la volonté de simplifier une situation d'enseignement instrumental banale. Vous pensez qu'il est temps maintenant que votre élève apprenne *ceci* ou *cela* et vous cherchez un morceau qui pourrait l'aider à se concentrer sur ce sujet à l'aide un contexte musical riche et stimulant. Didacto permet de parcourir les fichiers de votre répertoire d'enseignement à la recherche du morceau pertinent. Pour cela, Didacto crée un index des mots clés utilisés dans les fichiers pdf de votre corpus d'enseignement. Les fichiers et leur chemin d'accès sont affichés en regard des mots clés. Les fichiers PDF, ainsi que les fichiers sources de votre logiciel de notation musicale, peuvent être ouverts facilement. Vous pouvez modifier les mots clés d'un morceau. Didacto vous permet également d'enregistrer une brève définition de vos mots clés. Didacto est un logiciel libre publié sous `licence GPL3 `_ ou ultérieure. Remerciements à `Itopie Informatique `_, Jonhatan Blum, Joris Schaller, Noam Kestin, Ninn Langel .. toctree:: :maxdepth: 2 :caption: Contenu: .. Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` Premiers pas ============ .. image:: images/didacto_complet.png :width: 400 :alt: didacto 1. Indiquer où se trouve vos partitions en format PDF en cliquant sur le bouton *choisir* Dans la colonne *Mots-clés* apparaît le symbole ensemble vide **ø**, qui indique que vous n'avez probablement pas encore ajouté des mots-clés dans le champ *Mots-clés* de vos partitions. En cliquant sur le symbole **ø** Didacto affiche dans la colonne *Fichier* la liste des fichiers PDF indexés. 2. Ajouter des mots clés dans vos partitions au format PDF: Un clique-droit sur le nom du fichier sélectionné ouvre un menu contextuel, choisir "Modifier mots clés". Didacto ouvre une boîte de dialogue qui vous permet de remplacer le symbole **ø** par les mots clés de votre choix. Didacto affiche maintenant la liste des mots clés utilisés dans les PDF de votre répertoire. Un double clique sur un mots clés fait apparaître les noms des fichiers PDF qui mentionnent ce mots clés. Le mots clés sélectionné est affiché au pied de la fenêtre. Le bouton *Définir* permet d'ajouter une brève définition pour ce mots clés. Un double clique sur le nom d'un fichier ouvre le PDF. Un clique droit affiche les options d'éditions: modifier le fichier source, modifier le champ *Mots-clés* du PDF lui-même. Installation ============ Installation sur macOS ---------------------- Une version compilée pour macOS est disponible `ici `__ Télécharger puis décompresser le dossier zip sur votre ordinateur, double cliquer sur le fichier /didacto.app/Contents/MacOS/didacto Installation sur Windows ------------------------ Une version compilée pour Windows est disponible `ici `__ Télécharger puis décompresser le dossier zip sur votre ordinateur, double cliquer sur le fichier didacto.exe Installation avec pip ------------------------------------------- Vous pouvez utiliser et modifier cette application en important le code source avec le gestionnaire de paquet PIP. Pour cela, vous devez avoir une version de Python >= 3.7.5. La libraire *python-tk* est indispensable, vous pouvez l'installer: Sur Debian/Ubuntu:: sudo apt-get install python-tk Sur ArchLinux:: sudo pacman -S tk Après avoir vérifié que votre système réponds aux pré-requis. Installer le paquet avec PyPI/Pip:: pip install didacto Pour une installation manuelle avec pipenv pipenv install python -m didacto Pour une installation manuelle avec pip pip install -r requirements.txt python -m didacto Utilisation =========== Indexer le champ mots clés d'un corpus de partition au format PDF ----------------------------------------------------------------- * Choisir un dossier: Bouton choisir, ou, Fichier>Choisir Dossier, ou, ctrl+i * Inclure les sous-dossier: cocher la case correspondante Gestion de l'affichage ---------------------- * Rafraîchir l'affichage: Bouton rafraîchir, ou, Fichier>Rafraîchir, ou, ctrl+r * Ouvrir/fermer tout: cocher la case correspondante Manipulation des fichiers ------------------------- * Ouvrir un fichier PDF: double clique sur le nom * Modifier le champ Mots clés d'un PDF: clique droit, puis, choisir *Modifier Mots clés* * Modifier le fichier d'origine : clique droit sur le nom, puis, choisir *Ouvrir fichier source* Dictionnaire des mots clés -------------------------- Un dictionnaire des définition des mots clés est stocké par didacto. * Afficher une définition: cliquer sur mots clés. * Modifier une définition: cliquer sur le mots clés puis bouton *Définir* Réglage des préférences ----------------------- Lancez Didacto et allez à Ouvrir>Fichier>Préférences. .. image:: images/didacto_prefs_window.png :width: 400 :alt: didacto, fenêtre de préférences * Choisissez votre emplacement par défaut. Ce dossier sera automatiquement indexé à chaque ouverture de Didacto. * Choisissez un séparateur. Les fichiers Pdf ont un champ de mots clés unique. Spécifiez qu’un séparateur est nécessaire pour gérer plusieurs mots clés dans ce champ unique. Le séparateur est soit l’espace blanc "keyword1 Keyword2 Keyword3" ou la virgule "keyword1,Keyword2,keyword3". Les mots clés peuvent être des concepts multi-mots. Avec l’espace blanc séparateur utiliser snake_caze "multi_word_concept1 multi_word_concept2". Avec le séparateur virgule utiliser l’espace blanc normal « concept multi-mot1, concept multi-mot2 ». * Choisissez le format de fichier de votre logiciel d'édition musicale. Ceci vous permettra d'ouvrir le fichier à partir du quel vous avez créé le PDF afin d'effectuer des changements tels que l'ajout de mots-clés. Conseils pour le choix des mots clés ------------------------------------ Nous recommandons de commencer avec des contenus d'apprentissage déterminés par la question "qu'est-ce que mon élève pourrait apprendre en travaillant ce morceau". Rappelez-vous que l'interface de Didacto fonctionne comme un outil de recherche qui n'accepte qu'un seul critère. Didacto est un ami qui vous aide à faire des choix dynamiques en situation d'enseignement. Ce n'est pas un outil de recherche avancé, il faut donc éviter de travailler avec des catégories trop fines. Quelque chose comme "introduction aux doubles-cordes sur les cordes de mi et la pour élèves de niveau moyen" ne marchera pas. Par contre, en combinant Didacto et un minimum de structure de votre répertoire avec des sous-dossiers, vous aurez une plus grande souplesse.