Шпаргалка по текстовым действиям

Действия в Agenda позволяют вводить короткие команды, которые по завершении динамически преобразуются и разворачиваются в обычный текст либо запускают определённое действие, например помечают заметку как «На Повестке». Считайте это быстрым способом запустить действие: например, ввести \remind, чтобы вставить напоминание, или \date, чтобы вставить текущую дату.

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

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

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

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

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

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

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

Вставка

\tag

• вставляет токен тега в текст заметки
• синонимы: #, \insert-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

• вставляет токен человека в текст заметки
• синонимы: @, \insert-person, contact

Параметры

• name, alias, nickname - имя человека - По умолчанию, обязательный

Примеры

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

\reminder

• вставляет и планирует напоминание в приложении Напоминания
• синонимы: \remind, \insert-reminder

Параметры

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

Примеры

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

\star

• вставляет звёздочку в конец текущего абзаца в тексте заметки
• синонимы: #star, \insert-star, \flag

Параметры

• none - вставляет звёздочку в конец абзаца

Примеры

• \star - создаёт звёздочку в конце абзаца, равнозначно #star

\date

• вставляет текущую дату в заголовок или текст заметки
• синонимы: \insert-date

Параметры

• none - вставляет текущую дату в формате по умолчанию
• full, long, medium, short - стандартный формат даты в указанном виде - По умолчанию
• format - дата в пользовательском формате, см. совет и примечание ниже
• locale - региональные настройки для форматирования даты
• timezone - часовой пояс для форматирования даты
• in, for, offset - дата, отличная от сегодняшней
• default-format - устанавливает формат по умолчанию для \date равным указанному пользовательскому формату

Примеры

• \date - 22-07-20
• \date(full) - Wednesday, July 22, 2020
• \date(short) - 7/22/20
• \date(format: dd-MM-yy) - 22-07-20
• \date(full, locale: no) - onsdag 22. juli 2020
• \date(for: tomorrow) - 23-07-20
• \date(in: 2 days) - 24-07-20
• \date(offset: 3 weeks) - 12-08-20
• \date(default-format: dd-MM-yy) - 22-07-20 (и устанавливает этот формат как формат по умолчанию)

Совет: Полный обзор поддерживаемых форматов даты смотрите на http://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns. Например: \date(EEE\, MMM d\, ''yy) даст Wed, Jul 22, ‘20. Обратите внимание, что запятые в шаблоне нужно экранировать косой чертой, иначе они будут восприняты как начало следующего параметра. То же касается двоеточий, как в этом примере: \time(format: HH\:MM), дающем 18:34.

Важно: Когда формат указан как параметр — будь то пользовательский формат или один из full, long, medium, short — он также становится форматом по умолчанию, когда вы опускаете параметр и вводите просто \date. Чтобы вернуть формат к medium, один раз введите \date(default).

\time

• вставляет текущее время в заголовок или текст заметки

Параметры

• none - вставляет текущее время в формате по умолчанию
• full, long, medium, short - стандартный формат времени в указанном виде - По умолчанию
• format - время в пользовательском формате, см. совет и примечание выше
• locale - региональные настройки для форматирования времени
• timezone - часовой пояс для форматирования времени
• default-format - устанавливает формат по умолчанию для \time равным указанному пользовательскому формату

Примеры

• \time - 12:27
• \time(full) - 12:27:15 PM Western European Summer Time
• \time(short) - 12:27
• \time(format: HH\\:mm\\:ss) - 12:27:33
• \time(medium, locale: en_US_POSIX) - 12:27:15 PM

Совет: Полный список региональных настроек смотрите на https://gist.github.com/jacobbubu/1836273, список идентификаторов часовых поясов — на https://apphelp.readdle.com/calendars/index.php?pg=kb.page&id=588

\now

• вставляет текущие дату и время в заголовок или текст заметки
• синонимы: \timestamp

Параметры

• none - вставляет текущие дату и время в формате по умолчанию
• full, long, medium, short - стандартный формат времени в указанном виде - По умолчанию
• format - время в пользовательском формате, см. совет и примечание выше
• locale - региональные настройки для форматирования даты и времени
• timezone - часовой пояс для форматирования даты и времени
• default-format - устанавливает формат по умолчанию для \now равным указанному пользовательскому формату

Примеры

• \now - 22-07-20 02:30
• \now(full) - Wednesday, July 22, 2020 at 2:29:53 AM Western European Summer Time
• \now(short) - 7/22/20, 2:30 AM
• \now(format: dd-MM-yy HH\\:mm\\:ss) - 22-07-20 02:30:30
• \now(medium, locale: en_US_POSIX) - Jul 22, 2020 at 2:31:03 AM

\expression

• вставляет вычисленный результат выражения в текст заметки
• синонимы: \formula, \insert-expression, \math

Параметры

• math - математическое выражение для вычисления - По умолчанию
• sum, add, total - разделённый запятыми список значений для суммирования
• count - разделённый запятыми список значений для подсчёта
• min, minimum - разделённый запятыми список значений, из которых выбирается минимальное
• max, maximum - разделённый запятыми список значений, из которых выбирается максимальное
• average, avg - разделённый запятыми список значений, для которых вычисляется среднее
• median, med - разделённый запятыми список значений, для которых вычисляется медиана
• stddev, standard-deviation, stdev - разделённый запятыми список значений, для которых вычисляется стандартное отклонение
• sqrt, square-root - значение, из которого извлекается квадратный корень
• log, lg, logarithm - значение, для которого вычисляется логарифм
• ln, natural-logarithm - значение, для которого вычисляется натуральный логарифм
• random, rdm - случайное значение между 0 и указанным числом

Примеры

• \expression(5 * 8) - 40
• \expression(sum: 2, 5, 7) - 14
• \expression(count: 2, 5, 7) - 3
• \expression(min: 2, 5, 7) - 2
• \expression(max: 2, 5, 7) - 7
• \expression(average: 2, 5, 7) - 4.666…
• \expression(median: 2, 5, 7) - 5
• \expression(stddev: 2, 5, 7) - 2.0548…
• \expression(sqrt: 9) - 3
• \expression(log: 9) - 0.9542…
• \expression(ln: 9) - 2.197…
• \expression(random: 9) - 7
• \expression(random: 1.0) - 0.598

\horizontal-rule

• вставляет горизонтальную линию (разделитель) в текст заметки
• синонимы: \rule, \insert-horizontal-rule, \hr

Примеры

• \rule - вставляет горизонтальную линию

\table

• вставляет таблицу в текст заметки
• синонимы: \insert-table, \tb

Параметры

• none - вставляет стандартную таблицу 2x2
• size, dimensions - размер нужной таблицы в формате столбцы x строки - По умолчанию
• columns, c - количество столбцов в таблице
• rows, r - количество строк в таблице

Примеры

• \table - вставляет стандартную таблицу 2x2
• \table(3x4) - вставляет таблицу с 3 столбцами и 4 строками
• \table(columns: 4) - вставляет таблицу с 4 столбцами и 2 строками
• \table(rows: 4) - вставляет таблицу с 2 столбцами и 4 строками
• \table(r: 3, c: 4) - вставляет таблицу с 4 столбцами и 3 строками

\link

• вставляет веб-ссылку или ссылку на проект или заметку в текст заметки
• синонимы: \url, \insert-link, \ref, \href, [[
• сокращения: \project, \note

Параметры

• url - веб-адрес вставляемой ссылки По умолчанию
• description, dimensions - описательный текст ссылки - Второй по умолчанию
• project, project-title, to - название проекта, на который должна указывать ссылка
• note, note-title - заголовок заметки, на которую должна указывать ссылка

Примеры

• \link(apple.com, apple website) - вставляет текст apple website со ссылкой на apple.com
• \link(url: http://microsoft.com, description: microsoft) - вставляет текст microsoft со ссылкой на microsoft.com
• \link(project: Developing Yak App, description: YakApp) - вставляет текст YakApp со ссылкой на проект Developing Yak App
• \link(note-title: Meeting the developers) - вставляет ссылку на заметку с заголовком Meeting the developers

Совет: Вместо \link можно также использовать сокращение [[, чтобы вставить ссылку на другой проект или заметку. Можно даже ввести [[recent, чтобы увидеть список всех недавно изменённых заметок, на которые можно сослаться.

\summary

• вставляет сводку в текст заметки в месте выделения или курсора
• синонимы: \summarize, \insert-summary

Параметры

• none - вставляет сводку всех неотмеченных пунктов списка
• list - вставляет сводку пунктов списка по одному из следующих критериев: - По умолчанию
  • checked - все отмеченные пункты
  • unchecked - все неотмеченные пункты списка
  • starred - все абзацы, помеченные звёздочкой
  • tagged - все абзацы, содержащие тег
  • assigned - все абзацы, содержащие токен человека
• tag - название тега, по которому строится сводка
• person - имя человека, по которому строится сводка

Примеры

• \summary - вставляет сводку всех неотмеченных пунктов списка в заметке
• \summary(list: checked) - вставляет сводку всех отмеченных пунктов списка в заметке
• \summary(starred) - вставляет сводку всех абзацев, помеченных звёздочкой
• \summary(tag: urgent) - вставляет сводку всех абзацев с тегом urgent
• \summary(tag: priority[1]) - вставляет сводку всех абзацев с тегом priority со значением 1 (обратите внимание на использование квадратных скобок вместо круглых)
• \summary(person: tom) - вставляет сводку всех абзацев с человеком по имени tom

\attachment

• вставляет вложение в текст заметки, открывает диалог выбора файла для прикрепления
• синонимы: \attach, \file, \insert-attachment

Параметры

• none - открывает окно выбора файла для вставки вложения
• description, title, name - текст, который следует использовать как описание файла, импортируемого как вложение - По умолчанию

Примеры

• \attach - открывает окно выбора файла
• \attach(My File) - открывает окно выбора файла и после импорта использует My File как описание вложения

\drawing

• вставляет рисунок в текст заметки, показывает холст для рисования - только iOS и iPadOS
• синонимы: \draw, \insert-drawing

Параметры

• none - показывает новый холст для рисования
• description, title, name - текст, который следует использовать как описание рисунка - По умолчанию

Примеры

• \draw - открывает новый холст для рисования
• \draw(My Drawing) - открывает новый холст для рисования, используя My Drawing как описание рисунка

\template

• вставляет содержимое шаблона в текст заметки в точке вставки или вместо выделения
• синонимы: \insert-template

Параметры

• name - название используемого шаблона - По умолчанию, обязательный
• input - текст, которым следует заменить заготовку ввода в шаблоне

Примеры

• \template(Book Review) - вставляет содержимое шаблона Book Review
• \template(Book Review, input: The title of this book) - вставляет содержимое шаблона Book Review, заменяя заготовку \input текстом The title of this book.

Стиль параграфа

\body

• сбрасывает стиль параграфа обратно на обычный основной текст
• синонимы: \p

Примеры

• \body - сбрасывает всё форматирование, так что при вводе стилем параграфа становится основной текст

\heading

• задаёт стилю параграфа значение «заголовок»
• сокращения: \heading1, \h1, \heading2, \h2, subheading, \heading3, \h3, \heading4, \h4

Параметры

• level - используемый уровень заголовка - По умолчанию

Примеры

• \heading - меняет стиль на «Заголовок», равнозначно \heading1 и \h1
• \heading(level: 2) - меняет стиль на подзаголовок, равнозначно \heading2, \h2 и \subheading
• \h3 - меняет стиль на малый заголовок

\preformatted

• возвращает стилю параграфа значение «преформатированный текст»
• синонимы: \pre

Примеры

• \pre - меняет стиль на преформатированный текст, равнозначно \preformatted

\list

• задаёт стилю параграфа маркированный список с тире или буллитами (в зависимости от ваших настроек)
• синонимы: \ul, \dashed, \bulleted

Примеры

• \list - меняет стиль на список с тире, равнозначно \ul, либо вводу тире, звёздочки или буллита с последующим пробелом

\numbered

• задаёт стилю параграфа нумерованный (упорядоченный) список
• синонимы: \ol

Параметры

• none - задаёт стиль нумерованного списка, начинающегося с 1
• start, from - начальный номер списка

Примеры

• \numbered - меняет стиль на нумерованный список, начинающийся с 1, равнозначно вводу 1. с последующим пробелом
• \numbered(start: 5) - меняет стиль на нумерованный список, начинающийся с 5, равнозначно вводу 5. с последующим пробелом

\checklist

• задаёт стилю параграфа контрольный список
• синонимы: \cl

Примеры

• \checklist - меняет стиль на контрольный список, равнозначно \cl

Действия со списками

\check

• отмечает пункт контрольного списка в текущей строке

Параметры

• none - отмечает пункт контрольного списка в текущей строке
• all - отмечает все пункты контрольного списка в списке, частью которого является текущая строка

Примеры

• \check - отмечает пункт контрольного списка в текущей строке
• \check(all) - отмечает все пункты контрольного списка в списке

\check-all

• отмечает все пункты контрольного списка в списке, частью которого является текущая строка
• синонимы: \all

Примеры

• \all - отмечает все пункты контрольного списка в текущем списке

\uncheck

• снимает отметку с пункта контрольного списка в текущей строке

Параметры

• none - снимает отметку с пункта контрольного списка в текущей строке
• all - снимает отметки со всех пунктов контрольного списка в списке, частью которого является текущая строка

Примеры

• \uncheck - снимает отметку с пункта контрольного списка в текущей строке
• \uncheck(all) - снимает отметки со всех пунктов контрольного списка в списке

\reset

• снимает отметки со всех пунктов контрольного списка в списке, частью которого является текущая строка

Примеры

• \reset - снимает отметки со всех пунктов контрольного списка в текущем списке

\sort

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

Примеры

• \sort - перемещает отмеченные пункты текущего списка вниз

Форматирование

\bold

• включает и выключает жирное начертание
• синонимы: \b

Примеры

• \b - включает и выключает жирное начертание, равнозначно \bold

\italic

• включает и выключает курсив
• синонимы: \i

Примеры

• \i - включает и выключает курсив, равнозначно \italic

\underline

• включает и выключает подчёркивание
• синонимы: \u

Примеры

• \u - включает и выключает подчёркивание, равнозначно \underline

\fixed-width

• включает и выключает моноширинное начертание
• синонимы: \fixed

Примеры

• \fixed - включает и выключает моноширинное начертание, равнозначно \fixed-width

\strikethrough

• включает и выключает зачёркивание
• синонимы: \strike

Примеры

• \strikethrough - включает и выключает зачёркивание, равнозначно \strike

\superscript

• включает и выключает верхний индекс
• синонимы: \sup

Примеры

• \sup - включает и выключает верхний индекс, равнозначно \superscript

\subscript

• включает и выключает нижний индекс
• синонимы: \sub

Примеры

• \sub - включает и выключает нижний индекс, равнозначно \subscript

\color

• включает и выключает цвет текста
• синонимы: \text-color

Параметры

• color - название используемого цвета - По умолчанию, обязательный

Примеры

• \text-color(color: green) - переключает цвет текста на зелёный, равнозначно \color(green)
• \color(#333) - переключает цвет текста на шестнадцатеричный цвет #333

\highlight

• включает и выключает подсветку текста

Параметры

• color - название используемого цвета - По умолчанию, обязательный

Примеры

• \highlight(color: blue) - переключает подсветку текста на синюю, равнозначно \highlight(blue)
• \highlight(#333) - переключает подсветку текста на шестнадцатеричный цвет #333

\clear

• убирает всё форматирование, возвращая обычный текст
• синонимы: \c

Примеры

• \clear - сбрасывает всё форматирование внутри текста

Действия с заметками

\on-the-agenda

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

Примеры

• \ota - помечает заметку как «На Повестке», равнозначно \on-the-agenda

\done

• помечает заметку выполненной

Примеры

• \done - помечает заметку выполненной

\undone

• снимает с заметки пометку «выполнено»

Примеры

• \undone - снимает с заметки пометку «выполнено»

\pin

• закрепляет заметку вверху проекта

Примеры

• \pin - закрепляет заметку

\footnote

• превращает заметку в примечание, закреплённое внизу проекта

Примеры

• \footnote - превращает заметку в примечание

\unpin

• возвращает закреплённую заметку или примечание в обычную заметку

Примеры

• \unpin - превращает закреплённую заметку или примечание обратно в обычную заметку

\assign-date

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

Параметры

• day, on, after, before, until, from, in - представление дня на естественном языке, который следует назначить - По умолчанию
• date, at - представление даты на естественном языке, которую следует назначить

Примеры

• \assign(17 oct 2022) - назначает заметке 17 октября 2022 года
• \assign(in: 3 weeks) - назначает заметке день через 3 недели от сегодняшнего
• \assign(tomorrow) - назначает заметке завтрашний день
• \assign(next Wednesday) - назначает заметке следующую среду
• \today - назначает заметке сегодняшний день
• \friday - назначает заметке ближайшую пятницу

\link-event

• связывает указанное событие с текущей заметкой
• синонимы: \event

Параметры

• day, on, after, before, until, from, in - представление дня на естественном языке, в котором следует искать события - По умолчанию
• date, at - представление даты на естественном языке, в которой следует искать события
• calendar - календарь, которым следует ограничить поиск

Примеры

• \event(17 oct 2022) - показывает события календаря на 17 октября, с которыми можно связать заметку
• \event(calendar: Work, 17 oct 2022) - показывает события из календаря Work на 17 октября, с которыми можно связать заметку

\new

Добавлено в Agenda 15

• добавляет новую заметку после текущей

Параметры

• none- добавляет новую заметку после текущей
• title - заголовок создаваемой заметки - По умолчанию
• template- шаблон, используемый для новой заметки

Примеры

• \new - создаёт новую заметку после той, в которой вы сейчас находитесь
• \new(Part Two) - создаёт новую заметку с заголовком Part Two
• \new(title: 15 Dec, template: Daily Meeting) - создаёт новую заметку с заголовком 15 Dec по шаблону Daily Meeting.

\split

• разделяет текущую заметку в точке вставки

Параметры

• none- разделяет текущую заметку в точке вставки - По умолчанию
• title - заголовок заметки, которая будет отделена от текущей

Примеры

• \split - разделяет текущую заметку в точке вставки
• \split(title: Part Two) - разделяет текущую заметку в точке вставки, создавая новую заметку с заголовком Part Two

\duplicate

• создаёт копию текущей заметки

Параметры

• none- создаёт копию текущей заметки - По умолчанию
• title - заголовок скопированной заметки

Примеры

• \duplicate - разделяет текущую заметку в точке вставки, равнозначно \new
• \duplicate(title: Part Two) - создаёт копию текущей заметки с заголовком Part Two

\move

• перемещает текущую заметку в другой проект

Параметры

• project, project-title, to - название проекта, в который следует переместить заметку - По умолчанию, обязательный

Примеры

• \move(to: Developing Yak App) - перемещает текущую заметку в проект Developing Yak App

\print

• печатает текущую заметку

Примеры

• \print - печатает заметку

Экранирование

Действия

Если вы не хотите, чтобы действие выполнялось, и предпочитаете оставить его в виде текста, поставьте перед действием дополнительный символ обратной косой черты, вот так: \\tag(name: Alex). Тогда действие не приведёт к созданию тега Alex, а останется в виде \tag(name: Alex). Кроме того, можно сменить стиль параграфа на преформатированный или стиль внутри текста на моноширинный, чтобы действия не выполнялись.

Параметры

Двоеточие и запятая имеют особое значение в списках параметров действий; если аргумент параметра должен содержать один из этих символов, его можно экранировать с помощью обратной косой черты.

Например, без экранирования \date(format: YYYY, dd-MM) разбирается неправильно и показывает только год 2022, тогда как \date(format: YYYY\, dd-MM) покажет 2022, 07-04

Аналогично, без экранирования \split(Newsflash: ABC) не будет разобрано правильно, а \split(Newsflash\: ABC) — будет.

Локализация

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

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