Annotation

Note

Disponible à partir de la version 0.5.0.

Un geste de type Annotation se comporte comme la commande Commenter la sélection ou le curseur, à deux différences près : la rédaction s’ouvre avec la catégorie choisie, et le champ est prérempli par un texte de départ. C’est la Capture de QuickAdd, appliquée au commentaire.

interface AnnotationGeste extends GesteBase {
  kind: "annotation";
  category: string | "ask" | "";
  initialText: string;
}

Catégorie

Le champ « Catégorie » reçoit l’une de vos catégories, ou l’une de deux valeurs particulières. « Demander à chaque fois » ("ask") affiche un sélecteur de catégorie avant l’ouverture de la rédaction. « Aucune » ("") crée le commentaire sans catégorie.

Texte de départ

Le Texte de départ peut contenir des variables, résolues au lancement du geste. Le curseur se place à {{cursor}} si le texte le contient, à la fin sinon. Une variable {{VALUE:libellé}} demande une valeur avant l’ouverture de la rédaction.

Deux exemples

Ils sont donnés à titre d’exemple ; le plugin ne les crée pas.

Nom	Catégorie	Texte de départ
Objection	#objection	Objection :
À vérifier	#a-verifier	Vérifier {{VALUE:quoi ?}}

Le premier ouvre une rédaction dans la catégorie « Objection », prête à recevoir l’argument. Le second demande ce qu’il faut vérifier, puis écrit « Vérifier … » avec la réponse, de sorte que l’élément se lise bien une fois extrait.

La note de méthode L’objection et la vérification montre ces deux gestes à l’œuvre.