Aide-mémoire de la syntaxe de recherche

La recherche dans Agenda est simple et rapide : il vous suffit de saisir quelques termes de recherche pour effectuer une recherche instantanée dans toutes vos notes. Les résultats présents dans la vue d’ensemble ou le projet actuellement sélectionné apparaissent en haut de la liste des résultats, ceux des projets archivés ou de la corbeille figurent à la fin.

Vous pouvez toutefois créer des requêtes bien plus complexes, à la fois en cliquant ou en touchant les jetons de recherche créés dans le champ de recherche lorsque vous appuyez sur la barre d’espace ou la touche Retour, mais aussi grâce à un système très semblable à celui des actions de texte (voir le chapitre Aide-mémoire des actions de texte), en combinaison avec une puissante autocomplétion.

Les propriétés de recherche sont précédées d’une barre oblique inverse (\) qui appelle un menu d’autocomplétion affichant les propriétés de recherche disponibles, que vous pouvez filtrer davantage en saisissant les premiers caractères de l’action que vous souhaitez utiliser.

Astuce : sur iPhone et iPad sans clavier physique, saisir la barre oblique inverse peut être un peu fastidieux. Vous pouvez à la place simplement toucher l’icône de loupe dans le champ de recherche. Bien pratique !

De même, sur certains claviers, comme les claviers chinois ou japonais, il est difficile de saisir une barre oblique inverse ; c’est pourquoi, partout où une barre oblique inverse est indiquée, vous pouvez également utiliser deux accents graves (``) ou deux points médians (··).

Beaucoup de ces propriétés peuvent accepter ce que l’on appelle des paramètres entre parenthèses (de la même façon que vous pouvez ajouter des paramètres de valeur aux étiquettes, voir le chapitre Étiquettes, personnes, actions de texte et liens), afin d’affiner davantage le comportement de ces actions. Par exemple, \title(starts-with: yak) recherche le mot yak au début du titre de la note.

Les paramètres signalés comme Par défaut sont considérés comme le paramètre par défaut si aucun n’est fourni. Par exemple, \tag(important) équivaut à \tag(name: important).

Vous trouverez ci-dessous un aperçu complet des propriétés de recherche actuellement prises en charge par Agenda.

Propriétés des notes

\all

• recherche dans tous les champs d’une note (Par défaut)
• synonymes : everything

\on-the-agenda

• recherche sur le statut Sur l’agenda d’une note
• synonymes : ontheagenda, ota, agenda

\title

• recherche sur le titre d’une note
• synonymes : ti

\assigned-date

• recherche sur la date attribuée à une note, c’est-à-dire une note à laquelle une date unique a été attribuée
• synonymes :
• raccourcis : \today, \tomorrow, \yesterday, \monday, \tuesday, \wednesday, \thursday, \friday, \saturday, \sunday

\start-date

• recherche sur la date de début d’une note, c’est-à-dire le premier jour d’une note à laquelle une plage de dates a été attribuée
• synonymes :

\end-date

• recherche sur la date de fin d’une note, c’est-à-dire le dernier jour d’une note à laquelle une plage de dates a été attribuée
• synonymes :

Date attribuée ou date de début/fin : \assigned-date concerne les notes auxquelles une date unique a été attribuée, tandis que \start-date et \end-date concernent les notes auxquelles une plage de dates a été attribuée. Si une note ne comporte qu’une seule date, \assigned-date et \start-date correspondront aux mêmes notes, leurs résultats se recoupent donc. La différence n’apparaît que lorsque des notes comportent des plages de dates.

\linked-event

• recherche sur l’événement lié à une note
• synonymes :

\calendar

• recherche sur le calendrier de l’événement lié à une note
• synonymes :

\due-date

• recherche sur la date d’échéance des rappels présents dans une note
• synonymes :

\color

• recherche sur la couleur d’arrière-plan d’une note
• synonymes :

\pinned

• recherche sur le statut épinglé d’une note
• synonymes :

\footnote

• recherche sur le statut de note de bas de page d’une note
• synonymes :

\done

• recherche sur le statut d’achèvement d’une note
• synonymes :

\locked

• recherche sur le statut verrouillé d’une note
• synonymes :

\shared

• recherche sur le statut partagé d’une note
• synonymes :

\edited-date

• recherche sur la date de modification d’une note
• synonymes :

\creation-date

• recherche sur la date de création d’une note
• synonymes :

\template

• recherche sur le modèle utilisé pour créer une note
• synonymes :

Contenu des notes

\tag

• recherche sur l’étiquette dans le contenu d’une note
• synonymes : #

Paramètres

• name - le nom de l’étiquette - Par défaut, Requis
• color - le nom ou la valeur hexadécimale de la couleur de l’étiquette - Premium
• value, text, string - une valeur textuelle facultative - Deuxième valeur par défaut
• day, on, after, before, until, from, in - une valeur de jour facultative
• date, at - une valeur de date facultative
• int, integer, number, level - une valeur entière facultative
• float, double - une valeur décimale facultative

Exemples

• \tag(name: important) - crée l’étiquette #important, équivalent à \tag(important)
• \tag(important, color: blue) - crée l’étiquette #important de couleur bleue
• \tag(important, color: #333) - crée l’étiquette #important avec la couleur hexadécimale #333
• \tag(priority, value: high) - crée l’étiquette #priority(high), équivalent à \tag(priority, high)
• \tag(due, day: tomorrow) - crée l’étiquette #due(6 April 2022)
• \tag(due, in: 3 weeks) - crée l’étiquette #due(26 April 2022)
• \tag(deadline, at: 17 oct 2022 13pm) - crée l’étiquette #deadline(17 Oct 2022 at 13.00)
• \tag(priority, int: 1, color: red) - crée l’étiquette #priority(1) en rouge
• \tag(version, float: 2.1) - crée l’étiquette #version(2.1)

\person

• recherche sur la personne dans le contenu d’une note
• synonymes : @, contact

Paramètres

• name, alias, nickname - le nom de la personne - Par défaut, Requis

Exemples

• \person(name: Tom G) - crée la personne @(Tom G), équivalent à \person(Tom G)

\reminder

• recherche sur le rappel dans le contenu d’une note
• synonymes : \remind,

Paramètres

• none - insère un rappel fictif qui n’est pas programmé
• due-date - une chaîne en langage naturel représentant une date future - Par défaut
• title - le titre du rappel à programmer
• list - la liste de l’app Rappels dans laquelle programmer le rappel
• all-day - programme le rappel comme un rappel sur toute la journée

Exemples

• \reminder - crée un rappel non programmé et ouvre le menu contextuel de modification
• \reminder(today) - programme un rappel pour aujourd’hui dans 30 minutes
• \reminder(today at 6pm) - programme un rappel pour aujourd’hui à 18 heures
• \reminder(tomorrow evening) - programme un rappel pour demain à 18 heures
• \reminder(in 3 weeks) - programme un rappel dans 21 jours
• \reminder(25 dec 2020, at 8pm)` - programme un rappel le 25 décembre 2020 à 20 heures
• \reminder(today at 6pm, list: important) - programme un rappel pour aujourd’hui à 18 heures dans la liste de rappels « important »
• \reminder(all-day: tomorrow) - programme un rappel sur toute la journée pour demain

\table

• recherche sur le tableau dans le contenu d’une note
• synonymes :

\link

• recherche sur le lien dans le contenu d’une note
• synonymes :

\attachment

• recherche sur l’élément lié dans le contenu d’une note
• synonymes :

\drawing

• recherche sur le dessin dans le contenu d’une note
• synonymes :

\starred

• recherche sur le statut d’étoile dans le contenu d’une note
• synonymes :

\has-todo

• recherche selon la présence d’éléments à faire dans le contenu d’une note
• synonymes :

\has-checklist

• recherche selon la présence d’une liste de contrôle dans le contenu d’une note
• synonymes :

\has-list

• recherche selon la présence d’une liste à puces, d’une liste numérotée ou d’une liste de contrôle dans le contenu d’une note
• synonymes :

\has-code

• recherche selon la présence d’un extrait de code dans le contenu d’une note
• synonymes :

\has-quote

• recherche selon la présence d’une citation dans le contenu d’une note
• synonymes :

Projets et catégories

\category

• recherche sur la catégorie qui contient une note
• synonymes :

\project

• recherche sur le projet qui contient une note
• synonymes :

\archived

• recherche selon qu’une note fait partie ou non d’un projet archivé
• synonymes :

Préréglages

\recently-edited

• recherche sur les notes récemment modifiées
• synonymes :

\now

• recherche sur les notes actuellement en cours
• synonymes :

\upcoming

• recherche sur les notes à venir
• synonymes :

\earlier

• recherche sur les notes qui viennent de se terminer
• synonymes :

\on-this-day

• recherche sur les notes du passé attribuées au même jour d’une année précédente.
• synonymes :

\random

• renvoie un nombre donné de notes sélectionnées au hasard
• synonymes :

Opérateurs

AND

• les deux termes doivent être présents
• synonymes : &&

OR

• l’un des termes doit être présent
• synonymes : ||

NOT

• le terme ne doit pas être présent
• synonymes : !

Correspondances littérales

() et ""

Regroupement

Localisation

Notez que toutes les actions et tous les paramètres doivent être correctement localisés selon la langue de l’app. Vous pouvez dans ce cas utiliser soit la variante anglaise ci-dessus, soit les variantes traduites. Notez que même si les actions peuvent comporter des accents et/ou des majuscules, il n’est pas nécessaire de les saisir : par exemple, dans la version française d’Agenda, vous pouvez obtenir une liste numérotée en saisissant l’une des formes suivantes :

• \numérotée
• \numerotee
• \Numérotée
• \numbered