Perso – AZquiz

Balises | Ascii | Exposant | Grec | Math | Image
Les quiz personnels sont rédigés dans un traitement de texte
(word, Bloc-notes,… seuls les caractères ascii sont pris en compte sans formatage).
Les quiz personnels sont chargés en mémoire dans AZquiz sous Windows par copier/coller du texte brut, ou par lecture de fichier texte non formaté « *.txt »
(Rq: uniquement avec la version Windows car les fichiers et le presse-papier ne sont pas gérés par les versions html5 et Android).
Les quiz personnels chargés en mémoire peuvent être enregistrés dans le compte en ligne.
(onglet « List », rubrique « Perso. », menu « Compte » ou icône associée).
Le fichier exemple_complet.doc peut servir de référence pour la rédaction des quiz perso.

BalisesAsciix^2 et x_2GrecMathImage

Structure de rédaction

Un fichier de quiz est constitué:

de commentaires (commençant par //)
d’un titre (commençant par la balise Titre:),
d’une succession de contenus (questions, images, blocs de contenu texte pour des explications),
de réglages spécifiques au quiz (optionnel, sinon les « Réglages quiz » par défaut sont appliqués).

Un contenu peut être:

une question de type choix unique, multiple, ouverte ou à trou (double underscore __),
un texte sur une ou plusieurs lignes (retour à la ligne ou balise ),
un lien vers une image de type « http://www.azquiz.net/img/image123456.jpg »

Les règles suivantes s’appliquent aux fichiers de quiz:

le texte ne doit contenir que des caractères ascii,
les caractères non-ascii (exposants et indices, grec, math) sont représentés par des balises de type html,
le texte peut être formaté pour en faciliter la lecture (style, couleur, gras), mais ce formatage sera ignoré lors du copier/coller,
un même fichier peut contenir plusieurs quiz, la balise Titre: définissant le début d’un nouveau quiz,
la balise spéciale //Fin permet d’ignorer la suite du fichier,
une vingtaine de quiz maxi par fichier permet d’éviter un temps de chargement trop long.

Mise en forme du contenu

L’utilisation d’une mise en forme via les styles dans un traitement de texte facilite la lecture des quiz. Cette méthode est recommandée et présentée dans le fichier exemple_complet.doc ci-dessus. Lors du chargement en mémoire par copier/coller, la mise en forme sera ignorée
(Ctrl-A puis Ctrl-C ou sélectionner tout et copier dans le traitement de texte, puis Ctrl-V ou Coller dans l’onglet « List » d’AZquiz).

Attention à ne pas utiliser de caractères non-ascii pour la rédaction.

L’édition des quiz dans le logiciel reste possible mais non recommandée. Un des avantages principaux d’AZquiz est son système de chargement des quiz en mémoire via copier/coller, rendant la rédaction dans un traitement de texte beaucoup plus pratique que d’autres logiciels de gestion de quiz.

Balises de définition de contenu

« //… » : définit une ligne de commentaires ignorée par le logiciel
« //Fin » définit la fin de l’analyse du contenu par le logiciel
« Titre: » : permet de définir le titre du quiz, et de passer au quiz suivant si le fichier en contient plusieurs
« Réglages: » : optionnel, permet de définir les réglages spécifiques d’un quiz appliqués en lieu et place des réglages par défaut ci-dessous. Les paramètres sont: « Formation » ou « Evaluation », « Corrigé » ou « Sans corrigé », « Explications » ou « Sans explications », « Aléatoire » ou « Ordre », « Positif » ou « Négatif ».
Si le quiz est utilisé en classe, les réglages appliqués sont ceux du quiz en classe et les réglages spécifiques sont ignorés.

« Qx.xx: » : permet de définir le texte d’une question (qcu, qcm, question à trou ou ouverte)
a. (ou b., c., d., etc…) permet de définir les propositions de réponses pour une question de type qcu ou qcm
« __« : définit un trou dans le texte, pour les questions de type texte à trou sans proposition de réponse
« Réponse: » : permet de définir les propositions justes (ex: « r:abc »), séparées par une virgule pour une question à trou ou ouverte si plusieurs réponses sont acceptées. Les minuscules et majuscules ne sont pas différenciées. (ex: « rep:27, 27.2 », « Réponse: France », inutile de rajouter france ou FRANCE »)
« Barème: » : optionnel, doit être située après la ligne contenant la balise « Réponse: », permet de définir le barème de la question (défaut 1 point par question)
« Information: » : permet de définir un texte d’explication lors de l’affichage du corrigé (texte unique non conditionné par la réponse)
« Image: » : suivie par un URL (entête « http:// » optionnel), permet d’afficher une image avant une question. Si l’URL est hors du domaine azquiz.net, l’image peut ne pas être affichée avec la version html5 d’AZquiz (protection xss du html5 de certains navigateur contre une exécution malicieuse de code hors domaine). Deux balises images qui se suivent sont affichées sur la même page. Une question ou un contenu suivant une (ou deux) balise(s) image(s) est affichée sur la même page.
« Lien: » : suivie par un URL (entête « http:// » optionnel), affiche un lien vers une page web.
Texte sans balise: ce texte est défaut considéré comme du contenu. Si des propositions de réponse (a., b. etc…) ou la balise « Réponse: » suivent, alors ce texte est considéré comme une question (même en l’absence de la balise « Q: »)
Les questions et les informations peuvent être rédigées sur plusieurs lignes. Une ligne blanche force le passage à un contenu suivant.
Un retour à la ligne peut être forcé dans une proposition de réponse (ou dans une question), en utilisant la balise html «  « .

Exemples de syntaxe

Exemples de syntaxe: exemple_1.txt, exemple_2.txt, exemple_3.txt, exemple_4.txt.
Exemple de syntaxe pour une image:
image: www.azquiz.net/img/drapeau_francais_400x225.jpg
Ex. de syntaxe pour une question à choix unique:
(qcu une seule réponse juste)

Q: Quelle est la couleur du cheval blanc d'Henri IV

a) bleu

b) blanc

c) rouge

Réponse: b

Information: La réponse est dans la question, le cheval blanc est ... blanc!

Ex. de syntaxe pour une question à choix multiple:
(qcm car plusieurs réponses justes, 3 coches pour faciliter la réponse)

Q: Quelles couleurs composent le drapeau français

a) bleu

b) blanc

c) vert

d) rouge

e) jaune

Réponse: a,b,d

Ex. de syntaxe pour une question ouverte:
(question ouverte car pas de proposition de réponse, « ? » rajouté automatiquement, plusieurs réponses justes acceptées)

Q: Quelle est la couleur du cheval blanc d'Henri IV

Réponse: blanc, Blanc, blanche

Ex. de syntaxe pour une question à trou:
(noter le double underscore __, trou à compléter)

Q: La couleur du cheval __ d'Henri IV est le blanc!

Réponse: blanc

Ex. de syntaxe pour un bloc texte sur plusieurs lignes:

Les questions suivantes vont porter sur la couleur du cheval d'Henri IV

Il est généralement admis qu'il est blanc.

Rq: Le saut de ligne est reconnu dans les blocs texte, les questions et les explications. Pour forcer un saut de ligne dans un titre ou une proposition de réponse, il convient d’utiliser la balise html .

Autres exemples acceptés

Q1: Texte d'une question à choix multiple

a. 1ère proposition

b. 2ème proposition

c. 3ème proposition

R:ab

Information: Les 1ère et 2ème propositions sont justes

Rq: il faut éviter de numéroter les propositions dans le texte car elles peuvent être présentées dans un ordre aléatoire selon réglages. Cette question et ses réponses n’est donc pas bien formulée.

Q: Texte d'une question à choix unique

1:

2:

3:

4:

R : 2

Q: Texte d'une question à choix multiple

présentée sur deux lignes

a)

b.

c:

Réponse:123

Texte d'une question à choix multiple

p.

p.

p.

p.

Réponse:14

Rq: le « Q: » est optionnel. Il est requis si la ligne précédente contient une explication (on peut à défaut insérer une ligne de commentaire //). Les propositions de réponse sont numérotées ou non abcd ou 1234. La réponse juste 14 concerne les propositions p. dans leur ordre.

Q: Texte d'une question ouverte

(le point d'interrogation sera rajouté automatiquement)

Réponse: réponse n°1, Réponse N°2, autre réponse

Q: Texte d'une __ à trou

(trou détecté par une double underscore)

Réponse: question, Question, QUESTION

Rq: Les trois réponses sont de toutes façons considérées comme justes car majuscules et minuscules ne sont pas différenciées. Il est donc inutile de mettre les 3 réponses.

L’intégration des quiz par copier/coller dans AZquiz ne prend en compte que les 256 caractères ascii. Certains n’étant pas accessibles au clavier, comme ±, × ou ÷, ils sont obtenus sous windows par une combinaison de la touche Alt et d’un code numérique (ex Alt 0215 pour ×).

Tableau des symboles ascii spéciaux et de leur raccourcis clavier (ces symboles peuvent être insérés directement dans le texte des quiz)
balise html	€	&permil;	&OElig;	&oelig;	©	«
Raccourci clavier	alt 0128	alt 0137	alt 0140	alt 0156	alt 0169	alt 0174
Symbole Ascii	€	‰	Œ	œ	©	®
balise html	¼	½	¾	±	×	÷
Raccourci clavier	alt 0188	alt 0189	alt 0190	alt 0177	alt 0215	alt 0247
Symbole Ascii	¼	½	¾	±	×	÷
balise html	¿	À	Ç	È	É	Ê
Raccourci clavier	alt 0191	alt 0192	alt 0199	alt 0200	alt 0201	alt 0202
Symbole Ascii	¿	À	Ç	È	É	Ê
balise html
Raccourci clavier
Symbole Ascii

Exposants et caractères spéciaux
L’intégration des quiz par copier/coller dans AZquiz ne prend en compte que les 256 caractères ascii et aucun formatage. En conséquence, la mise en indice ou en exposant est réalisé par les descripteurs spéciaux _x ou ^x, ou via les balises html _x et ^x (ne vous inquiétez pas, c’est très simple). La mise en indice ou en exposant est limitée aux chiffres et au point (et le n en exposant). L’utilisation de ces balises est détaillée ci-dessous.
Balises de mise en indice ou en exposant

« _ » (ou balises …): mise en indice, uniquement +-.0123456789,
« ^ » (ou balises …): mise en exposant, uniquement +-.0123456789 et n.
ex: « a_1=10^3, a_2=10^-3, a_1×a_2=10^3×10^-3=1 » dans le texte donne « a₁=10³, a₂=10^-3, a₁×a₂=10³×10^-3=1″
ex: « Re=Dvρ/μ=40.10^-3×1.25×1000/10^-3=50 000 » dans le texte donne « Re=Dvρ/μ=40.10^-3×1.25×1000/10^-3=50 000″

L’intégration des quiz par copier/coller dans AZquiz ne prends en compte que les 256 caractères ascii. Les lettres grecques n’appartenant pas au code ascii sont représentés par leur balise html.

Tableau des lettres grecques et de leur balise html
(ces lettres peuvent être affichés dans AZquiz en insérant la balise html associée dans le texte du quiz)

balise
html

Caractère

balise
html

Caractère

balise
html

Caractère

balise
html

Caractère

balise
html

Caractère

balise
html

&thetasym;

Caractère

balise
html

Caractère

balise
html

&sigmaf;

&upsih;

Caractère

L’intégration des quiz par copier/coller dans AZquiz ne prends en compte que les 256 caractères ascii. Les symboles mathématiques n’appartenant pas au code ascii sont représentés par leur balise html.

Tableau des symboles mathématiques et de leur balise html
(ces symboles peuvent être affichés dans AZquiz en insérant la balise html associée dans le texte du quiz)

balise
html

•

&frac13;

&frac23;

←

↑

→

↓

Symbole

•

⅓

⅔

←

↑

→

↓

balise
html

↔

⇐

&uArr;

⇒

&dArr;

⇔

Symbole

↔

⇐

⇑

⇒

⇓

⇔

balise
html

∀

∂

∃

∅

∇

∈

∉

Symbole

∀

∂

∃

∅

∇

∈

∉

balise
html

&ni;

∏

∑

−

Symbole

∋

∏

∑

−

balise
html

√

&prop;

∞

&ang;

&and;

&or;

∩

Symbole

√

∝

∞

∠

∧

∨

∩

balise
html

∪

∫

≈

≠

&equiv;

Symbole

∪

∫

≈

≠

≡

balise
html

≤

≥

⊂

⊃

&nsub;

&sube;

&supe;

Symbole

≤

≥

⊂

⊃

⊄

⊆

⊇

balise
html

&oplus;

&otimes;

&perp;

⋅

Symbole

⊕

⊗

⊥

⋅

balise
html

&fnof;

&naturals;

&integers;

&reals;

&complexes;

&real;

&cross;

Symbole

ℕ

ℤ

ℝ

ℂ

ℜ

✗

balise
html

&check;

Symbole

✓

Gestion des images

Les images, présentées dans l’application sont chargées grace à leur lien URL statique (entête « http:// optionnel). Un exemple de syntaxe pour une image suivie d’une question est présenté ci-dessous:

Image: www.azquiz.net/img/drapeau_francais_400x225.jpg

Q: Quelles couleurs composent le drapeau Français?

a. rouge

b. vert

c. bleu

d. blanc

e. noir

Réponse: acd

Seules les images hébergées sur www.azquiz.net sont affichées dans la version html5 exécutée dans le navigateur, car la protection xss de la plupart des navigateurs bloque le chargement d’images à partir d’un domaine autre que celui de l’application pour des raisons de sécurité. Pour une plus grande compatibilité, il est donc conseillé d’héberger ses images dans son compte en ligne. L’utilisation d’images web ou d’images personnelles hébergées sur des serveurs tiers est néanmoins fonctionnelle dans les versions Windows et Android.

Images exportées sur le serveur AZquiz

L’exportation d’images sur son compte en ligne se fait via la version Windows du logiciel, onglet « List », rubrique « Perso. », menu « Compte/Exporter une image » ou l’icône associée. Le nombre d’images hébergées par compte est limité (de 100 à 250 selon le type de compte, 10 en période d’essai gratuite). La taille des images est limitée à 95.9 ko par image. Les formats d’image acceptés sont jpg (sauf N/B), png et gif. Dimensionner les images avant upload dans photofiltre pour limiter la taille à 400×400 px² et 30ko. Choisir le format png pour les schémas ou croquis avec moins de 16 couleur, et le format jpg qualité 70% pour les autres images.

Les images peuvent être supprimées du compte en suivant la procédure suivante.

lister ses images via l’onglet « List », rubrique « Perso. », menu « Lister mes images », choisir « Yes » pour intégrer la liste des images comme quiz perso.
cocher « afficher/masquer les boutons d’édition de quiz » sur l’onglet « List », rubrique « Perso. »,
éditer le quiz « Liste des images… » ainsi obtenu via le bouton « Editer le quiz » ,
supprimer l’image en cliquant sur l’icone poubelle de l’enregistrement associé,
pour éviter d’enregistrer le quiz « Liste des images…. », le supprimer ou recharger les quiz perso.

Images disponibles sur le web

On peut utiliser des liens directs d’images déjà hébergées sur le web et libres de droits. Il suffit souvent de faire clic droit / copier l’url de l’image pour en récupérer le lien. Cette méthode est rapide et utile pour mettre une image d’illustration en tête de quiz par exemple. Néanmoins, elle n’est pas recommandée pour illustrer chaque question du quiz pour plusieurs raisons: son lien peut être modifié ou supprimé par l’éditeur du site, vous ne connaissez pas toujours la taille de l’image chargée, cela peut être considéré comme du vol de bande passante de l’hébergeur de l’image. Il est donc conseillé d’éditer ses propres images, de les réduire à une taille de 50 à 90ko, puis de les héberger sur le serveur AZquiz dans son compte.

Des sites hébergent de nombreuses images dont certains sont listés ci-dessous.

Images hébergées sur des serveurs tiers

Les hébergements suivants peuvent être utilisés (toujours rechercher le lien direct):

D’autres hébergeurs peuvent être utilisés en effectuant sur google une recherche avec ces mots clef: hébergeur image lien direct gratuit…

Lorsqu’on obtient le lien direct soit par exemple « http://gratisheberge.net/img/img123456.jpg », il suffit pour intégrer l’image dans un quiz, de créer une ligne « image: gratisheberge.net/img/img123456.jpg » dans le fichier de quiz.

Les hébergements suivants ne peuvent pas être utilisés car ils ne fournissent pas d’URL statique dit « lien direct »: Google Drive, Google+, Picassa, flickr, Dropbox, box.net, amazon cloud drive, hubic.com…