Guia Rápido de Ações de Texto

As ações no Agenda permitem digitar comandos curtos que, ao serem concluídos, são convertidos dinamicamente e expandidos em texto simples, ou invocam determinada ação, como marcar uma nota como Na Agenda. Pense nisso como uma maneira rápida de acionar uma ação, como digitar \remind para inserir um lembrete ou \date para inserir a data atual.

As ações são precedidas por um caractere de barra invertida (\) que abre um menu de autocompletar mostrando as ações disponíveis, que pode ser filtrado digitando os primeiros caracteres da ação que você quer usar.

Dica: No iPhone e no iPad sem teclado físico, digitar o caractere de barra invertida pode ser um pouco trabalhoso. Em vez disso, basta tocar e segurar o botão de mais acima do teclado para acionar o menu de ações. Prático!

Da mesma forma, em alguns teclados, como os chineses ou japoneses, é difícil digitar uma barra invertida; portanto, sempre que uma barra invertida for mostrada, você também pode usar duas crases (``) ou dois caracteres de ponto central (··).

Muitas dessas ações podem receber os chamados parâmetros entre parênteses (de forma parecida com a adição de parâmetros de valor às tags, descrita no capítulo Tags, Pessoas, Ações de Texto e Links), para refinar ainda mais o comportamento dessas ações. Por exemplo, \date(in: 2 weeks) insere a data daqui a duas semanas em vez da data atual.

Os parâmetros marcados como Padrão são considerados o parâmetro padrão quando nenhum é fornecido. Por exemplo, \tag(important) é considerado o mesmo que \tag(name: important).

A maioria das ações também funciona dentro de modelos e, além disso, os modelos aceitam algumas ações que só funcionam neles; para uma visão geral delas, consulte o capítulo Criando e Usando Modelos.

Abaixo você encontra uma visão geral completa das Ações que o Agenda atualmente aceita.

Inserir

\tag

• insere um token de tag no texto da nota
• sinônimos: #, \insert-tag

Parâmetros

• name - o nome da tag - Padrão, Obrigatório
• color - o nome ou o valor hexadecimal da cor da tag - Premium
• value, text, string - um valor de texto opcional - Segundo Padrão
• day, on, after, before, until, from, in - um valor de dia opcional
• date, at - um valor de data opcional
• int, integer, number, level - um valor inteiro opcional
• float, double - um valor de ponto flutuante opcional

Exemplos

• \tag(name: important) - cria a tag #important, igual a \tag(important)
• \tag(important, color: blue) - cria a tag #important com a cor azul
• \tag(important, color: #333) - cria a tag #important com a cor hexadecimal #333
• \tag(priority, value: high) - cria a tag #priority(high), igual a \tag(priority, high)
• \tag(due, day: tomorrow) - cria a tag #due(6 April 2022)
• \tag(due, in: 3 weeks) - cria a tag #due(26 April 2022)
• \tag(deadline, at: 17 oct 2022 13pm) - cria a tag #deadline(17 Oct 2022 at 13.00)
• \tag(priority, int: 1, color: red) - cria a tag #priority(1) em vermelho
• \tag(version, float: 2.1) - cria a tag #version(2.1)

\person

• insere um token de pessoa no texto da nota
• sinônimos: @, \insert-person, contact

Parâmetros

• name, alias, nickname - o nome da pessoa - Padrão, Obrigatório

Exemplos

• \person(name: Tom G) - cria a pessoa @(Tom G), igual a \person(Tom G)

\reminder

• insere e agenda um lembrete no aplicativo Lembretes
• sinônimos: \remind, \insert-reminder

Parâmetros

• none - insere um lembrete de marcação que não é agendado
• due-date - um texto em linguagem natural representando uma data no futuro - Padrão
• title - o título do lembrete a agendar
• list - a lista, no aplicativo Lembretes, na qual agendar o lembrete
• all-day - agenda o lembrete como um lembrete de dia inteiro

Exemplos

• \reminder - cria um lembrete não agendado e abre o balão de edição
• \reminder(today) - agenda um lembrete para hoje daqui a 30 minutos
• \reminder(today at 6pm) - agenda um lembrete para hoje às 18 horas
• \reminder(tomorrow evening) - agenda um lembrete para amanhã às 18 horas
• \reminder(in 3 weeks) - agenda um lembrete para daqui a 21 dias
• \reminder(25 dec 2020, at 8pm)` - agenda um lembrete para 25 de dezembro de 2020 às 20 horas
• \reminder(today at 6pm, list: important) - agenda um lembrete para hoje às 18 horas na lista de lembretes “important”
• \reminder(all-day: tomorrow) - agenda um lembrete de dia inteiro para amanhã

\star

• insere uma estrela no fim do parágrafo atual, no texto da nota
• sinônimos: #star, \insert-star, \flag

Parâmetros

• none - insere uma estrela no fim do parágrafo

Exemplos

• \star - cria uma estrela no fim do parágrafo, igual a #star

\date

• insere a data atual no título ou no texto da nota
• sinônimos: \insert-date

Parâmetros

• none - insere a data atual no formato padrão
• full, long, medium, short - um formato de data padrão na forma indicada - Padrão
• format - uma data com formatação personalizada, veja a dica e a nota abaixo
• locale - a localidade a usar na formatação da data
• timezone - o fuso horário a usar na formatação da data
• in, for, offset - uma data diferente de hoje
• default-format - define o formato padrão de \date como o formato personalizado fornecido

Exemplos

• \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 (e define este formato como padrão)

Dica: Para uma visão geral completa dos formatos de data suportados, consulte http://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns. Como exemplo: \date(EEE\, MMM d\, ''yy) resultará em Wed, Jul 22, ‘20. Note como as vírgulas do padrão precisam ser escapadas com uma barra, ou serão vistas como um próximo parâmetro. O mesmo vale para os dois-pontos, como neste exemplo: \time(format: HH\:MM), resultando em 18:34.

Importante: Quando um formato é fornecido como parâmetro, seja personalizado, seja um dos formatos full, long, medium, short, ele também se torna o formato padrão quando você omite o parâmetro e digita apenas \date. Para restaurar o formato de volta para medium, você pode digitar \date(default) uma vez.

\time

• insere a hora atual no título ou no texto da nota

Parâmetros

• none - insere a hora atual no formato padrão
• full, long, medium, short - um formato de hora padrão na forma indicada - Padrão
• format - uma hora com formatação personalizada, veja a dica e a nota acima
• locale - a localidade a usar na formatação da hora
• timezone - o fuso horário a usar na formatação da hora
• default-format - define o formato padrão de \time como o formato personalizado fornecido

Exemplos

• \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

Dica: Para uma lista completa de localidades, veja https://gist.github.com/jacobbubu/1836273; para uma lista de identificadores de fuso horário, veja https://apphelp.readdle.com/calendars/index.php?pg=kb.page&id=588

\now

• insere a data e a hora atuais no título ou no texto da nota
• sinônimos: \timestamp

Parâmetros

• none - insere a data e a hora atuais no formato padrão
• full, long, medium, short - um formato de hora padrão na forma indicada - Padrão
• format - uma hora com formatação personalizada, veja a dica e a nota acima
• locale - a localidade a usar na formatação da data e da hora
• timezone - o fuso horário a usar na formatação da data e da hora
• default-format - define o formato padrão de \now como o formato personalizado fornecido

Exemplos

• \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

• insere no texto da nota o resultado calculado de uma expressão
• sinônimos: \formula, \insert-expression, \math

Parâmetros

• math - uma expressão matemática a ser calculada - Padrão
• sum, add, total - uma lista de valores separados por vírgula a serem somados
• count - uma lista de valores separados por vírgula a serem contados
• min, minimum - uma lista de valores separados por vírgula da qual se escolhe o valor mínimo
• max, maximum - uma lista de valores separados por vírgula da qual se escolhe o valor máximo
• average, avg - uma lista de valores separados por vírgula dos quais se tira a média
• median, med - uma lista de valores separados por vírgula dos quais se tira a mediana
• stddev, standard-deviation, stdev - uma lista de valores separados por vírgula dos quais se tira o desvio padrão
• sqrt, square-root - um valor do qual se extrai a raiz quadrada
• log, lg, logarithm - um valor do qual se extrai o logaritmo
• ln, natural-logarithm - um valor do qual se extrai o logaritmo natural
• random, rdm - um valor aleatório entre 0 e o número fornecido

Exemplos

• \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

• insere uma regra horizontal (linha separadora) no texto da nota
• sinônimos: \rule, \insert-horizontal-rule, \hr

Exemplos

• \rule - insere uma regra horizontal

\table

• insere uma tabela no texto da nota
• sinônimos: \insert-table, \tb

Parâmetros

• none - insere uma tabela padrão 2x2
• size, dimensions - o tamanho da tabela desejada, no formato colunas x linhas - Padrão
• columns, c - o número de colunas que a tabela deve ter
• rows, r - o número de linhas que a tabela deve ter

Exemplos

• \table - insere uma tabela padrão 2x2
• \table(3x4) - insere uma tabela com 3 colunas e 4 linhas
• \table(columns: 4) - insere uma tabela com 4 colunas e 2 linhas
• \table(rows: 4) - insere uma tabela com 2 colunas e 4 linhas
• \table(r: 3, c: 4) - insere uma tabela com 4 colunas e 3 linhas

\link

• insere no texto da nota um link da web ou um link para um projeto ou nota
• sinônimos: \url, \insert-link, \ref, \href, [[
• abreviações: \project, \note

Parâmetros

• url - o url do link a ser inserido Padrão
• description, dimensions - o texto descritivo do link - Segundo Padrão
• project, project-title, to - o nome do projeto para o qual o link deve apontar
• note, note-title - o título da nota para a qual o link deve apontar

Exemplos

• \link(apple.com, apple website) - insere o texto apple website com um link para apple.com
• \link(url: http://microsoft.com, description: microsoft) - insere o texto microsoft com um link para microsoft.com
• \link(project: Developing Yak App, description: YakApp) - insere o texto YakApp com um link para o projeto chamado Developing Yak App
• \link(note-title: Meeting the developers) - insere um link para a nota com o título Meeting the developers

Dica: Em vez de usar \link, você também pode usar o atalho [[ para inserir um link para outro projeto ou nota. Pode até digitar [[recent para ver uma lista de todas as notas editadas recentemente às quais criar um link.

\summary

• insere um resumo no texto da nota, no local da seleção ou do cursor
• sinônimos: \summarize, \insert-summary

Parâmetros

• none - insere um resumo de todos os itens de lista desmarcados
• list - insere um resumo dos itens de lista com base em um dos seguintes critérios: - Padrão
  • checked - todos os itens marcados
  • unchecked - todos os itens de lista desmarcados
  • starred - todos os parágrafos marcados com estrela
  • tagged - todos os parágrafos que contêm uma tag
  • assigned - todos os parágrafos que contêm um token de pessoa
• tag - o nome da tag a ser resumida
• person - o nome da pessoa a ser resumida

Exemplos

• \summary - insere um resumo de todos os itens de lista desmarcados da nota
• \summary(list: checked) - insere um resumo de todos os itens de lista marcados da nota
• \summary(starred) - insere um resumo de todos os parágrafos marcados com estrela
• \summary(tag: urgent) - insere um resumo de todos os parágrafos que têm a tag chamada urgent
• \summary(tag: priority[1]) - insere um resumo de todos os parágrafos que têm a tag chamada priority com o valor 1 (note o uso de colchetes em vez de parênteses)
• \summary(person: tom) - insere um resumo de todos os parágrafos que têm a pessoa chamada tom

\attachment

• insere um anexo no texto da nota, abrindo a caixa de diálogo de abrir arquivo para escolher o arquivo a anexar
• sinônimos: \attach, \file, \insert-attachment

Parâmetros

• none - abre o seletor de arquivos para escolher um anexo a ser inserido
• description, title, name - o texto a ser usado como descrição do arquivo que será importado como anexo - Padrão

Exemplos

• \attach - abre o seletor de arquivos
• \attach(My File) - abre o seletor de arquivos e, após a importação, usa My File como descrição do anexo

\drawing

• insere um desenho no texto da nota, mostrando a tela de desenho - apenas iOS e iPadOS
• sinônimos: \draw, \insert-drawing

Parâmetros

• none - mostra uma nova tela de desenho
• description, title, name - o texto a ser usado como descrição do desenho - Padrão

Exemplos

• \draw - abre uma nova tela de desenho
• \draw(My Drawing) - abre uma nova tela de desenho, usando My Drawing como descrição do desenho

\template

• insere o conteúdo de um modelo no texto da nota, no ponto de inserção ou substituindo a seleção
• sinônimos: \insert-template

Parâmetros

• name - o nome do modelo a ser usado - Padrão, Obrigatório
• input - o texto que deve substituir o marcador de posição de entrada no modelo

Exemplos

• \template(Book Review) - insere o conteúdo do modelo Book Review
• \template(Book Review, input: The title of this book) - insere o conteúdo do modelo Book Review, substituindo o marcador de posição \input pelo texto The title of this book.

Estilo de parágrafo

\body

• restaura o estilo de parágrafo para texto de corpo simples
• sinônimos: \p

Exemplos

• \body - redefine toda a formatação, de modo que, ao digitar, o estilo de parágrafo seja texto de corpo

\heading

• define o estilo de parágrafo como título
• abreviações: \heading1, \h1, \heading2, \h2, subheading, \heading3, \h3, \heading4, \h4

Parâmetros

• level - o nível de título a usar - Padrão

Exemplos

• \heading - muda o estilo para Título, equivalente a \heading1 e \h1
• \heading(level: 2) - muda o estilo para subtítulo, equivalente a \heading2, \h2 e \subheading
• \h3 - muda o estilo para título menor

\preformatted

• restaura o estilo de parágrafo para texto pré-formatado
• sinônimos: \pre

Exemplos

• \pre - muda o estilo para texto pré-formatado, equivalente a \preformatted

\list

• define o estilo de parágrafo como lista não ordenada com traços ou marcadores (conforme sua preferência)
• sinônimos: \ul, \dashed, \bulleted

Exemplos

• \list - muda o estilo para uma lista com traços, equivalente a \ul, ou a digitar um traço, asterisco ou marcador seguido de um espaço

\numbered

• define o estilo de parágrafo como lista numerada (ordenada)
• sinônimos: \ol

Parâmetros

• none - define o estilo como lista numerada começando em 1
• start, from - o número inicial da lista

Exemplos

• \numbered - muda o estilo para uma lista numerada começando em 1, equivalente a 1. seguido de um espaço
• \numbered(start: 5) - muda o estilo para uma lista numerada começando em 5, equivalente a digitar 5. seguido de um espaço

\checklist

• define o estilo de parágrafo como lista de verificação
• sinônimos: \cl

Exemplos

• \checklist - muda o estilo para lista de verificação, equivalente a \cl

Ações de Lista

\check

• marca o item de lista de verificação da linha atual

Parâmetros

• none - marca o item de lista de verificação da linha atual
• all - marca todos os itens da lista de verificação da qual a linha atual faz parte

Exemplos

• \check - marca o item de lista de verificação da linha atual
• \check(all) - marca todos os itens da lista de verificação

\check-all

• marca todos os itens da lista de verificação da qual a linha atual faz parte
• sinônimos: \all

Exemplos

• \all - marca todos os itens da lista de verificação atual

\uncheck

• desmarca o item de lista de verificação da linha atual

Parâmetros

• none - desmarca o item de lista de verificação da linha atual
• all - desmarca todos os itens da lista de verificação da qual a linha atual faz parte

Exemplos

• \uncheck - desmarca o item de lista de verificação da linha atual
• \uncheck(all) - desmarca todos os itens da lista de verificação

\reset

• desmarca todos os itens da lista de verificação da qual a linha atual faz parte

Exemplos

• \reset - desmarca todos os itens da lista de verificação atual

\sort

• ordena a lista de verificação da qual a linha atual faz parte, movendo os itens marcados para o fim

Exemplos

• \sort - move os itens marcados da lista atual para o fim

Formatação

\bold

• alterna a formatação em negrito
• sinônimos: \b

Exemplos

• \b - alterna a formatação em negrito, equivalente a \bold

\italic

• alterna a formatação em itálico
• sinônimos: \i

Exemplos

• \i - alterna a formatação em itálico, equivalente a \italic

\underline

• alterna a formatação sublinhada
• sinônimos: \u

Exemplos

• \u - alterna a formatação sublinhada, equivalente a \underline

\fixed-width

• alterna a formatação de largura fixa
• sinônimos: \fixed

Exemplos

• \fixed - alterna a formatação de largura fixa, equivalente a \fixed-width

\strikethrough

• alterna a formatação riscada
• sinônimos: \strike

Exemplos

• \strikethrough - alterna a formatação riscada, equivalente a \strike

\superscript

• alterna a formatação sobrescrita
• sinônimos: \sup

Exemplos

• \sup - alterna a formatação sobrescrita, equivalente a \superscript

\subscript

• alterna a formatação subscrita
• sinônimos: \sub

Exemplos

• \sub - alterna a formatação subscrita, equivalente a \subscript

\color

• alterna a formatação de cor do texto
• sinônimos: \text-color

Parâmetros

• color - o nome da cor a ser usada - Padrão, Obrigatório

Exemplos

• \text-color(color: green) - alterna para a cor de texto verde, equivalente a \color(green)
• \color(#333) - alterna para a cor de texto hexadecimal #333

\highlight

• alterna a formatação de destaque do texto

Parâmetros

• color - o nome da cor a ser usada - Padrão, Obrigatório

Exemplos

• \highlight(color: blue) - alterna para o destaque de texto azul, equivalente a \highlight(blue)
• \highlight(#333) - alterna para o destaque de texto na cor hexadecimal #333

\clear

• remove toda a formatação, voltando ao texto simples
• sinônimos: \c

Exemplos

• \clear - redefine toda a formatação de estilo alinhado

Ações de Nota

\on-the-agenda

• marca a nota como “Na Agenda”, ou desmarca, se ela já estiver marcada assim
• sinônimos: \ota, \ontheagenda, \agenda

Exemplos

• \ota - marca a nota como “Na Agenda”, equivalente a \on-the-agenda

\done

• marca a nota como Concluída

Exemplos

• \done - marca a nota como concluída

\undone

• desmarca a nota como Concluída

Exemplos

• \undone - desmarca a nota como concluída

\pin

• fixa a nota no topo do projeto

Exemplos

• \pin - fixa a nota

\footnote

• transforma a nota em uma nota de rodapé, fixada no fim do projeto

Exemplos

• \footnote - transforma a nota em nota de rodapé

\unpin

• faz a nota fixada ou a nota de rodapé voltar a ser uma nota comum

Exemplos

• \unpin - transforma a nota fixada ou de rodapé de volta em nota comum

\assign-date

• atribui a data fornecida à nota atual
• sinônimos: \assign
• abreviações: \today, \tomorrow, \yesterday, \monday, \tuesday, \wednesday, \thursday, \friday, \saturday, \sunday

Parâmetros

• day, on, after, before, until, from, in - uma representação em linguagem natural do dia a ser atribuído - Padrão
• date, at - uma representação em linguagem natural da data a ser atribuída

Exemplos

• \assign(17 oct 2022) - atribui a nota a 17 de outubro de 2022
• \assign(in: 3 weeks) - atribui a nota a 3 semanas a partir de hoje
• \assign(tomorrow) - atribui a nota a amanhã
• \assign(next Wednesday) - atribui a nota à próxima quarta-feira
• \today - atribui a nota a hoje
• \friday - atribui a nota à sexta-feira que vem

\link-event

• vincula o evento fornecido à nota atual
• sinônimos: \event

Parâmetros

• day, on, after, before, until, from, in - uma representação em linguagem natural do dia em que buscar eventos - Padrão
• date, at - uma representação em linguagem natural da data em que buscar eventos
• calendar - o calendário ao qual a busca deve se limitar

Exemplos

• \event(17 oct 2022) - mostra os eventos de calendário do dia 17 de outubro aos quais a nota pode ser vinculada
• \event(calendar: Work, 17 oct 2022) - mostra os eventos do calendário Work no dia 17 de outubro aos quais a nota pode ser vinculada

\new

Adicionado no Agenda 15

• adiciona uma nova nota após a nota atual

Parâmetros

• none- adiciona uma nova nota após a nota atual
• title - o título da nota que será criada - Padrão
• template- o modelo a usar na nova nota

Exemplos

• \new - cria uma nova nota após a nota em que você está
• \new(Part Two) - cria uma nova nota com o título Part Two
• \new(title: 15 Dec, template: Daily Meeting) - cria uma nova nota com o título 15 Dec usando o modelo Daily Meeting.

\split

• divide a nota atual no ponto de inserção

Parâmetros

• none- divide a nota atual no ponto de inserção - Padrão
• title - o título da nota que será separada da nota atual

Exemplos

• \split - divide a nota atual no ponto de inserção
• \split(title: Part Two) - divide a nota atual no ponto de inserção, criando uma nova nota com o título Part Two

\duplicate

• duplica a nota atual

Parâmetros

• none- duplica a nota atual - Padrão
• title - o título da nota duplicada

Exemplos

• \duplicate - divide a nota atual no ponto de inserção, equivalente a \new
• \duplicate(title: Part Two) - cria uma duplicata da nota atual com o título Part Two

\move

• move a nota atual para um projeto diferente

Parâmetros

• project, project-title, to - o título do projeto para o qual a nota deve ir - Padrão, Obrigatório

Exemplos

• \move(to: Developing Yak App) - move a nota atual para o projeto Developing Yak App

\print

• imprime a nota atual

Exemplos

• \print - imprime a nota

Escapando

Ações

Se você não quiser que uma ação seja executada e prefira que ela permaneça como texto, pode precedê-la com uma barra invertida adicional, assim: \\tag(name: Alex). A ação então não resultará na criação da tag Alex, e sim permanecerá como \tag(name: Alex). Como alternativa, você pode mudar o estilo de parágrafo para Pré-formatado ou o estilo alinhado para largura fixa, a fim de impedir que as ações sejam executadas.

Parâmetros

Os dois-pontos e a vírgula têm um significado especial nas listas de parâmetros das ações; se o argumento de um parâmetro precisar conter um desses caracteres, você pode escapá-los usando uma barra invertida.

Por exemplo, sem escape, \date(format: YYYY, dd-MM) é interpretado incorretamente e mostra apenas o ano 2022; em vez disso, você pode usar \date(format: YYYY\, dd-MM) para mostrar 2022, 07-04

Da mesma forma, sem escape \split(Newsflash: ABC) não seria interpretado corretamente, enquanto \split(Newsflash\: ABC) sim.

Localização

Observe que todas as ações e parâmetros devem estar devidamente localizados de acordo com o idioma do aplicativo. Nesse caso, você pode usar tanto a variante em inglês acima quanto as variantes traduzidas. Note que, embora as ações possam conter acentos e/ou maiúsculas, não é necessário digitá-los; por exemplo, na versão francesa do Agenda, você pode obter uma lista numerada digitando qualquer uma das seguintes opções:

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