Шпаргалка по синтаксису поиска

Поиск в Agenda прост и быстр: достаточно ввести несколько поисковых слов, и вы мгновенно найдёте их во всех своих заметках. Совпадения из текущего выбранного обзора или проекта показываются в начале списка результатов, а совпадения из архивированных проектов или корзины — в конце.

Однако вы можете составлять и куда более сложные запросы — как нажимая на поисковые токены в поле поиска, которые создаются при нажатии пробела или клавиши ввода, так и с помощью системы, очень похожей на текстовые действия (см. главу Шпаргалка по текстовым действиям), в сочетании с мощным автодополнением.

Свойствам поиска предшествует символ обратной косой черты (\), который вызывает меню автодополнения со списком доступных свойств для поиска; список можно сузить, набрав первые несколько символов нужного действия.

Совет: На iPhone и iPad без аппаратной клавиатуры вводить обратную косую черту бывает неудобно. Вместо этого можно просто нажать на значок лупы в поле поиска. Удобно!

Точно так же на некоторых клавиатурах, например китайской или японской, обратную косую черту набрать сложно, поэтому везде, где показан символ обратной косой черты, можно также использовать две обратные кавычки (``) или два символа средней точки (··).

Многие из этих свойств могут принимать так называемые параметры в скобках (подобно тому, как можно добавлять параметры-значения к тегам, см. главу Теги, люди, текстовые действия и ссылки), чтобы дополнительно уточнить поведение этих действий. Например, \title(starts-with: yak) ищет слово yak в начале заголовка заметки.

Параметры, помеченные как По умолчанию, считаются параметром по умолчанию, если ни один не указан. Например, \tag(important) равнозначно \tag(name: important).

Ниже вы найдёте полный обзор свойств поиска, которые Agenda поддерживает на данный момент.

Свойства заметки

\all

• ищет по всем полям заметки (По умолчанию)
• синонимы: everything

\on-the-agenda

• ищет по статусу «На Повестке» у заметки
• синонимы: ontheagenda, ota, agenda

\title

• ищет по заголовку заметки
• синонимы: ti

\assigned-date

• ищет по назначенной дате заметки, то есть по заметке с одной назначенной датой
• синонимы:
• сокращения: \today, \tomorrow, \yesterday, \monday, \tuesday, \wednesday, \thursday, \friday, \saturday, \sunday

\start-date

• ищет по дате начала заметки, то есть по первому дню заметки, которой назначен диапазон дат
• синонимы:

\end-date

• ищет по дате окончания заметки, то есть по последнему дню заметки, которой назначен диапазон дат
• синонимы:

Назначенная дата и дата начала/окончания: \assigned-date относится к заметкам с одной датой, а \start-date и \end-date — к заметкам с диапазоном дат. Если у заметки только одна дата, \assigned-date и \start-date найдут одни и те же заметки, поэтому их результаты пересекаются. Разница становится заметной только тогда, когда у заметок появляются диапазоны дат.

\linked-event

• ищет по событию, связанному с заметкой
• синонимы:

\calendar

• ищет по календарю события, связанного с заметкой
• синонимы:

\due-date

• ищет по сроку напоминаний, имеющихся в заметке
• синонимы:

\color

• ищет по цвету фона заметки
• синонимы:

\pinned

• ищет по статусу закрепления заметки
• синонимы:

\footnote

• ищет по статусу примечания у заметки
• синонимы:

\done

• ищет по статусу выполнения заметки
• синонимы:

\locked

• ищет по статусу блокировки заметки
• синонимы:

\shared

• ищет по статусу общего доступа к заметке
• синонимы:

\edited-date

• ищет по дате изменения заметки
• синонимы:

\creation-date

• ищет по дате создания заметки
• синонимы:

\template

• ищет по шаблону, использованному для создания заметки
• синонимы:

Содержимое заметки

\tag

• ищет по тегу в содержимом заметки
• синонимы: #

Параметры

• name — имя тега — По умолчанию, Требуется
• color — название или шестнадцатеричное значение цвета тега — Премиум
• value, text, string — необязательное текстовое значение — Второй по умолчанию
• day, on, after, before, until, from, in — необязательное значение дня
• date, at — необязательное значение даты
• int, integer, number, level — необязательное целочисленное значение
• float, double — необязательное значение с плавающей точкой

Примеры

• \tag(name: important) — создаёт тег #important, равнозначно \tag(important)
• \tag(important, color: blue) — создаёт тег #important синего цвета
• \tag(important, color: #333) — создаёт тег #important с шестнадцатеричным цветом #333
• \tag(priority, value: high) — создаёт тег #priority(high), равнозначно \tag(priority, high)
• \tag(due, day: tomorrow) — создаёт тег #due(6 April 2022)
• \tag(due, in: 3 weeks) — создаёт тег #due(26 April 2022)
• \tag(deadline, at: 17 oct 2022 13pm) — создаёт тег #deadline(17 Oct 2022 at 13.00)
• \tag(priority, int: 1, color: red) — создаёт тег #priority(1) красного цвета
• \tag(version, float: 2.1) — создаёт тег #version(2.1)

\person

• ищет по человеку в содержимом заметки
• синонимы: @, contact

Параметры

• name, alias, nickname — имя человека — По умолчанию, Требуется

Примеры

• \person(name: Tom G) — создаёт человека @(Tom G), равнозначно \person(Tom G)

\reminder

• ищет по напоминанию в содержимом заметки
• синонимы: \remind,

Параметры

• none — вставляет заготовку напоминания без назначенного срока
• due-date — строка на естественном языке, обозначающая дату в будущем — По умолчанию
• title — заголовок создаваемого напоминания
• list — список в приложении Напоминания, в который добавляется напоминание
• all-day — создаёт напоминание на весь день

Примеры

• \reminder — создаёт напоминание без срока и открывает всплывающее окно редактирования
• \reminder(today) — создаёт напоминание на сегодня через 30 минут
• \reminder(today at 6pm) — создаёт напоминание на сегодня на 18:00
• \reminder(tomorrow evening) — создаёт напоминание на завтра на 18:00
• \reminder(in 3 weeks) — создаёт напоминание через 21 день
• \reminder(25 dec 2020, at 8pm)` — создаёт напоминание на 25 декабря 2020 года на 20:00
• \reminder(today at 6pm, list: important) — создаёт напоминание на сегодня на 18:00 в списке напоминаний «important»
• \reminder(all-day: tomorrow) — создаёт напоминание на весь день завтра

\table

• ищет по таблице в содержимом заметки
• синонимы:

\link

• ищет по ссылке в содержимом заметки
• синонимы:

\attachment

• ищет по вложению в содержимом заметки
• синонимы:

\drawing

• ищет по рисунку в содержимом заметки
• синонимы:

\starred

• ищет по статусу звёздочки в содержимом заметки
• синонимы:

\has-todo

• ищет по наличию пунктов списка дел в содержимом заметки
• синонимы:

\has-checklist

• ищет по наличию контрольного списка в содержимом заметки
• синонимы:

\has-list

• ищет по наличию нумерованного, маркированного или контрольного списка в содержимом заметки
• синонимы:

\has-code

• ищет по наличию фрагмента кода в содержимом заметки
• синонимы:

\has-quote

• ищет по наличию цитаты в содержимом заметки
• синонимы:

Проекты и категории

\category

• ищет по категории, содержащей заметку
• синонимы:

\project

• ищет по проекту, содержащему заметку
• синонимы:

\archived

• ищет по тому, входит ли заметка в архивированный проект
• синонимы:

Предустановки

\recently-edited

• ищет недавно изменённые заметки
• синонимы:

\now

• ищет заметки, актуальные в данный момент
• синонимы:

\upcoming

• ищет предстоящие заметки
• синонимы:

\earlier

• ищет заметки, которые только что завершились
• синонимы:

\on-this-day

• ищет заметки из прошлого, назначенные на тот же день в предыдущем году.
• синонимы:

\random

• возвращает заданное количество случайно выбранных заметок
• синонимы:

Операторы

AND

• оба слова должны присутствовать
• синонимы: &&

OR

• должно присутствовать одно из слов
• синонимы: ||

NOT

• слово не должно присутствовать
• синонимы: !

Точные совпадения

() и ""

Группировка

Локализация

Обратите внимание, что все действия и параметры должны быть надлежащим образом локализованы в соответствии с языком приложения. В этом случае можно использовать как приведённый выше английский вариант, так и переведённые варианты. Учтите, что хотя действия могут содержать диакритические знаки и/или заглавные буквы, вводить их не обязательно: например, во французской версии Agenda нумерованный список можно получить, набрав любой из следующих вариантов:

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