# PragmaDevinettes

Le fichier serie_data.js empêche d'ouvrir l'application. ;-(
PragmaDevinettes

## Comment ça marche ?

### Qu'est-ce que PragmaDevinettes ?

Diffusée gratuitement par l'association PragmaTICE, PragmaDevinettes est une application Web qui permet de générer des devinettes multimédias. Elle est utilisable sans connexion Internet, avec tout navigateur récent, sur ordinateur, tablette ou smartphone.

Une série de devinettes comprend 5 devinettes présentées aléatoirement. Chaque devinette (question + réponse) est constituée :

- d'une question : 1 fichier "son" au format MP3, nommé q1.mp3 pour la première devinette, q2.mp3 pour la deuxième devinette, etc jusqu'à q5.mp3.
- d'une réponse matérialisée par 2 fichiers :
  - 1 fichier "image" au format JPG, nommé r1.jpg pour la première devinette, r2.jpg pour la deuxième devinette, etc jusqu'à r5.jpg.
  - 1 fichier "son" au format MP3, nommé r1.mp3 pour la première devinette, r2.mp3 pour la deuxième devinette, etc jusqu'à r5.mp3.

À partir de ces 15 fichiers (3 fichiers par devinette), le programme génère aléatoirement 5 devinettes.

Pour chaque devinette, le joueur écoute la question (q?.mp3), et clique sur l'image attendue (r?.jpg). Si sa réponse n'est pas correcte, il clique sur une autre image... Si sa réponse est correcte, il entend la réponse (r?.mp3).

### Comment créer sa propre série de devinettes ?

Cette opération n'est pas possible en ligne. Il faut impérativement télécharger l'application.

1. Préparer les 15 fichiers de la nouvelle série de la devinette (5 questions MP3, 5 réponses JPG et 5 réponses MP3).
   Attention ! Les images doivent être au format JPG (extension .jpg) et si possible carrées. Une taille de 300px*300px est recommandée.
2. Depuis le dossier [pragmadevinettes], ouvrir le dossier [mes_series], puis le dossier [ma_serie].
3. Remplacer chacun des 15 fichiers par ses propres fichiers.

### Comment ajouter d'autres séries de devinettes ?

1. Préparer les 15 fichiers de la nouvelle série de la devinette (5 questions MP3, 5 réponses JPG et 5 réponses MP3).
   Attention ! Les images doivent être au format JPG (extension .jpg) et si possible carrées. Une taille de 300px*300px est recommandée.
2. Créer le dossier de la série de devinettes (sans accent ni espace), et y copier-coller les 15 fichiers préparés.
   Ce dossier ne sera pas reconnu automatiquement : dans le fichier "serie_data.js", il va falloir préciser le nom du dossier et le nom de la série.
3. Ouvrir* le fichier "serie_data.js" qui se trouve dans le dossier [les_series] de l'application.
   Voici la première ligne de ce fichier : `serie[0] = ["ma_serie",""];`
   Ajouter une ligne en incrémentant 1, tout en respectant la syntaxe :
   `serie[1] = ["nom_du_dossier","nom de la série"];`
   Pour ajouter une nouvelle série, ajouter la ligne :
   `serie[2] = ["nom_du_dossier_autre_serie","Nom de l'autre série"];`
   etc...

(*) Le fichier "serie_data.js" peut être ouvert avec un éditeur de texte tel que le bloc-notes de Windows, ou le logiciel gratuit Notepad++. S'il est ouvert avec MSWord ou LibreOffice Writer, si le programme demande comment enregistrer ce fichier, choisir le format texte avec l'encodage UTF-8.

### Téléchargement de PragmaDevinettes

Les 2 versions ci-dessous, téléchargeables au format ZIP (donc à décompresser), ont des programmes identiques. Ce sont les devinettes disponibles qui les différencient :

La version de base ne contient qu'une série d'exemples de devinettes. Elle permet de créer sa propre série de devinettes en remplaçant les fichiers présents dans le dossier [mes_series/ma_serie]. Son utilisation en l'état ne présente aucun intérêt.

La version jouable contient des devinettes produites à l'aide des médias d'animaux de l'application EALOR, également disponibles dans l'application PragmaBavard. Elle peut être utilisée en l'état, et peut être complétée le cas échéant par ses propres devinettes.

### Crédits

Conception et développement | Eric Chenavier, pour PragmaTICE
Icônes | Flaticon
Images | Pixabay
Frameworks & plugins | Jquery

L'application PragmaDevinettes peut être remixée, arrangée, et adaptée à des fins non commerciales, sous réserve de citer la source originale et de la partager selon les mêmes conditions (licence Creative Commons BY NC SA).