Rédiger un document sur Chocolatine

Chaque bloc peut être édité et sauvegardé séparément. Il existe 3 types de blocs : - **[COURS](document.php?idsb=531)** pour rédiger votre cours avec toutes les balises standards du HTML plus les balises spéciales chocolatine, - **[QUESTION](document.php?idsb=537)** pour insérer des questions ou des lots de questions directement dans le document, - **[LEXÈME](document.php?idsb=3592)** qui correspond à la définition d'un mot. Cette définition apparaîtra en info-bulle partout où le mot est présent dans les documents du chapitre.

Bloc COURS

En plus de toutes les balises standards HTML et de toutes les classes Bootstrap, vous trouverez ci-dessous différentes balises spéciales de Chocolatine.
+ d'infos sur le HTML + d'infos sur Bootstrap

Mise en forme du texte

Balises de coloration (style Bootstrap) :

Vous pouvez cumuler toutes les balises de mise en forme. Exemples | Code | Résultat En ligne : | Voici un fond jaune dans une ligne. | Voici un fond jaune dans une ligne. En bloc : |

Voici un fond bleu
sur plusieurs lignes.

|

Voici un fond bleu
sur plusieurs lignes.

Cumulable : | En gras italique rouge sur fond vert.| En gras italique rouge sur fond vert.

Voici quelques styles de cadres prédéfinis : Des exercices numérotés avec la balise . Un danger avec la balise . Une alerte avec la balise . Une validation avec la balise . Un conseil avec la balise . Une remarque avec la balise .

Ajouter une image

Glisser-déposer une image directement dans la zone de texte pour y insérer une image. Vous pouvez recadrer l'image avant qu'elle soit téléversée vers le serveur et le code de la zone de texte est automatiquement complété avec le code HTML adéquat.
La plupart des formats d'image sont acceptés (jpg, png, gif, webp, svg...).

Quelques attributs spéciaux :

Rédiger des formules mathématiques

Exemple : ;AsciiMath (en ligne);LaTeX (en ligne); LaTeX (en bloc) Syntaxe;Syntaxe AsciiMath;Syntaxe LaTeX;Syntaxe LaTeX Encadré par : ; des anti-guillements ; des simples dollars
(en ligne) ; des double-dollars
(en bloc) Code source :; `3/4`; Équation : $a^{2}+2b+c=12$; Somme : $$\sum_{1}^{10}x^{2}$$ Affichage :; `3/4`; Équation : $a^{2}+2b+c=12$; Somme : $$\sum_{1}^{10}x^{2}$$

Insérer un tableau en CSV

En glissant-déposant un fichier .csv celui-ci génère automatiquement un tableau.

La balise vous permet de rédiger rapidement un tableau.

Cette balise accepte les attributs : - pour modifier le délimiteur de colonne - pour supprimer la mise ne forme par défaut de la première ligne de titre - pour centrer le contenu des cellules - pour ajouter un titre au dessus du tableau - pour ajouter un style CSS au tableau

Inclure des codes sources

Avec les balises vous pouvez mettre en coloration syntaxique du code HTML au sein d'une ligne.
Il existe aussi les balises : , , , , , , , , pour le markdown, , pour python, et pour du pseudo-code.

Exemples	Code	Résultat
Dans une ligne :	a = 2 est une affectation.	a = 2 est une affectation
En bloc avec numérotation des lignes : En ajoutant l'attribut pre.	a = 2 b = a*5	a = 2 b = a*5
En bloc sans numérotation des lignes : L'ajout de l'attribut sans-numéro supprime la numérotation des lignes réalisée par défaut. Dans ce cas l'attribut pre est facultatif.	a = 2 b = a*5	a = 2 b = a*5

Ajouter des info-bulles

Ajouter des bulles d'information dans votre document avec les attributs pop et pop-def

Code | Résultat|Explications Un TAD... | Un TAD...|Le texte sous l'info-bulle apparaît en gras. Voici le drapeau Tahitien. | Voici le drapeau Tahitien.|Autre syntaxe avec le même résultat. spécifier | spécifier|Le texte sous l'info-bulle apparaît bleu et en gras. Quel chat mignon ! | Quel chat mignon !|Autre syntaxe avec le même résultat
mais offrant plus de possibilité.

Ajout de boutons

Copier dans le presse-papier

L'ajout de l'attribut ou de la classe with-copy-button ou avec-bouton-copier à une balise, permet d'ajouter à sa suite un bouton permettant à l'utilisateur de copier-coller son contenu dans sont presse-papier. Code | Résultat Saisir : NLXYGX893 | Saisir : NLXYGX893

Afficher/Cacher

Ajouter un bonton d'affichage avec l'attribut with-button ou avec-bouton
Code | Résultat

Il faut faire ...

|

Il faut faire ...

Il faut faire ...

|

Il faut faire ...

Cacher aux élèves

- Pour nrendre une balise visible seulement des professeurs, ajouter l'attribut only-prof ou prof-seul. - Vous pouvez également faire apparaître un bouton permettant d'afficher le contenu d'une balise avec l'attribut with-button-prof ou avec-bouton-prof. Dans ce cas, le bouton et le contenu qu'il permet d'afficher ne sont visible que des professeurs.

Mettre en colonne

En insérant l'élément entre deux parties de votre bloc, ceux-ci s'afficheront en colonnes égales.
Avec auto, les colonnes s'adaptent à leur contenu
et avec 3 la partie précédente n'occupera que les 3/12 de la largeur disponible.

Code	Résultat
a = 2 + 3 b = a*5 Bonjour !	a = 2 b = a*5 Bonjour !

Écrire en MarkDown

Pour rédiger en MarkDown, utilisez la balise ....
+ d'infos sur le MarkDown

Bloc QUESTION

Un bloc QUESTION permet d'inclure dans votre document, une ou plusieurs de vos questions.

Pour cela, les questions doivent avoir déjà été rédigées dans la page Mes contenus puis repérées leur numéro.

Ensuite, il suffit de compléter le bloc avec :

• le ou les numéros des questions
  exemple : 845 1821
• et/ou le numéro d'une question et de la variante souhaitée
  exemple : 845-2 correspond à la variante n°2 de la question n°845
• et/ou le numéro d'un lot de questions
  exemple : lot-146 permet d'inclure toutes les questions du lot 146
• et/ou le numéro d'un lot et le niveau souhaité
  exemple : lot-146-1 permet d'inclure uniquement les questions facile (1) du lot n°146

Exemple : Sachant que huit exemples de questions ont été rédigées et regroupées dans le lot n°146, en complétant le bloc par : lot-146 on obtient l'affichage :

La progression (mémorisation) pour un utilisateur répondant à des questions incluses dans un document est bien prise en compte.

Bloc LEXÈME

Un bloc LEXÈME contient une définition associée à un ou plusieurs mots ou expressions (appelés lemmes). Cette définition apparaîtra alors comme une bulle d'information à chaque apparition d'un des lemmes dans les documents de votre programme.

Comment rédiger ce bloc ?

Voici le contenu du bloc qui permet d'obtenir la bulle d'information présente au-dessus du mot "LEXÈME". lemmes : lexème définition : Il s'agit d'une entrée dans un dictionnaire.

Ce bloc peut être défini dans n'importe quel document d'un programme et peut éventuellement être caché (bouton en mode édition ) comme tout autre bloc.

Voici à quoi ressemble le bloc lorsqu'il n'est pas caché :

Les bulles lexicales sont automatiquement accompagné d'un lien vers le bloc d'origine du lexème même s'il est caché. Permettant ainsi d'accéder directement au bon endroit du cours abordant ce sujet.

Portée de la définition

Pour définir la portée d'une définition, c'est-à-dire le domaine dans lequel apparaîtra la bulle lexicale, il suffit de renseigner la clé portée avec :

• programme (par défaut) : pour que la bulle lexicale apparaisse dans tous les documents de tous les chapitres du programme,
• chapitre : pour limiter l'apparition de la bulle lexicale aux seuls documents du chapitre,
• document : pour limiter l'apparition au seul document.

lemmes : lexème portée : chapitre définition : Un lexème est une entrée dans un dictionnaire.

Règle de priorité des bulles lexicale

Une forme de lemme englobant une autre est prioritaire. Si plusieurs définitions existe pour un même lemme, la définition définie dans le document est prioritaire sur celle définie dans le chapitre qui est prioritaire sur celle définie dans le programme.