Referência de ações de texto
As ações na Agenda permitem-te escrever comandos curtos que, ao serem concluídos, são dinamicamente convertidos e expandidos em texto simples, ou desencadeiam uma determinada ação, como marcar uma nota como Na Agenda. Pensa nelas como uma forma rápida de desencadear uma ação, como escrever \remind para inserir um lembrete ou \date para inserir a data atual.
As ações são precedidas por uma barra invertida (\) que invoca um menu de preenchimento automático com as ações disponíveis, e que pode ser filtrado escrevendo os primeiros caracteres da ação que queres usar.
Dica: No iPhone e no iPad sem teclado físico, escrever a barra invertida pode ser um pouco incómodo. Em alternativa, podes simplesmente tocar sem largar no botão de adição por cima do teclado para abrir o menu de ações. Prático!
Do mesmo modo, em alguns teclados, como os chineses ou japoneses, é difícil escrever uma barra invertida; por isso, sempre que for mostrada uma barra invertida, podes também usar dois acentos graves (``) ou dois pontos médios (
··).
Muitas destas ações podem receber os chamados parâmetros entre parênteses (à semelhança do que acontece com os parâmetros de valor nas etiquetas, descritos no capítulo Etiquetas, pessoas, ações de texto e ligações), para refinar ainda mais o seu comportamento. Por exemplo, \date(in: 2 weeks) insere a data daqui a duas semanas em vez da data atual.
Os parâmetros assinalados como Predefinido são considerados o parâmetro predefinido quando nenhum é indicado. Por exemplo, \tag(important) é considerado equivalente a \tag(name: important).
A maioria das ações também funciona dentro de modelos e, além disso, os modelos suportam algumas ações que só funcionam em modelos; para uma visão geral destas, consulta o capítulo Criar e usar modelos.
Abaixo encontras uma visão geral completa das ações que a Agenda atualmente suporta.
Inserir
\tag
- insere uma etiqueta no texto da nota
- sinónimos:
#,\insert-tag
Parâmetros
name- o nome da etiqueta - Predefinido, Obrigatóriocolor- o nome ou o valor hexadecimal da cor da etiqueta - Premiumvalue,text,string- um valor de texto opcional - Segundo predefinidoday,on,after,before,until,from,in- um valor de dia opcionaldate,at- um valor de data opcionalint,integer,number,level- um valor inteiro opcionalfloat,double- um valor decimal opcional
Exemplos
\tag(name: important)- cria a etiqueta#important, equivalente a\tag(important)\tag(important, color: blue)- cria a etiqueta#importantcom a cor azul\tag(important, color: #333)- cria a etiqueta#importantcom a cor hexadecimal #333\tag(priority, value: high)- cria a etiqueta#priority(high), equivalente a\tag(priority, high)\tag(due, day: tomorrow)- cria a etiqueta#due(6 April 2022)\tag(due, in: 3 weeks)- cria a etiqueta#due(26 April 2022)\tag(deadline, at: 17 oct 2022 13pm)- cria a etiqueta#deadline(17 Oct 2022 at 13.00)\tag(priority, int: 1, color: red)- cria a etiqueta#priority(1)a vermelho\tag(version, float: 2.1)- cria a etiqueta#version(2.1)
\person
- insere uma etiqueta de pessoa no texto da nota
- sinónimos:
@,\insert-person,contact
Parâmetros
name,alias,nickname- o nome da pessoa - Predefinido, Obrigatório
Exemplos
\person(name: Tom G)- cria a pessoa@(Tom G), equivalente a\person(Tom G)
\reminder
- insere e agenda um lembrete na aplicação Lembretes
- sinónimos:
\remind,\insert-reminder
Parâmetros
none- insere um lembrete de marcação de lugar que não é agendadodue-date- uma expressão em linguagem natural que representa uma data no futuro - Predefinidotitle- o título do lembrete a agendarlist- a lista da aplicação Lembretes na qual agendar o lembreteall-day- agenda o lembrete como um lembrete de dia inteiro
Exemplos
\reminder- cria um lembrete não agendado e abre o popover 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, equivalente 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 predefinidofull,long,medium,short- um formato de data padrão na forma indicada - Predefinidoformat- uma data com formato personalizado, ver dica e nota abaixolocale- a região a usar para formatar a datatimezone- o fuso horário a usar para formatar a datain,for,offset- uma data diferente de hojedefault-format- define o formato predefinido de\datecomo o formato personalizado indicado
Exemplos
\date- 22-07-20\date(full)- quarta-feira, 22 de julho de 2020\date(short)- 22/07/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 predefinido)
Dica: Para uma visão geral completa dos formatos de data suportados, consulta http://www.unicode.org/reports/tr35/tr35-31/tr35-dates.html#Date_Format_Patterns. Por exemplo:
\date(EEE\, MMM d\, ''yy)resultará em Wed, Jul 22, ‘20. Repara que as vírgulas no padrão têm de ser escapadas com uma barra, caso contrário são interpretadas como um parâmetro seguinte. O mesmo se aplica aos dois pontos, como neste exemplo:\time(format: HH\:MM), que resulta em 18:34.
Importante: Quando é indicado um formato como parâmetro, seja um personalizado, seja um dos formatos full, long, medium ou short, esse passa também a ser o formato predefinido quando omites o parâmetro escrevendo apenas
\date. Para repores o formato em medium, podes escrever\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 predefinidofull,long,medium,short- um formato de hora padrão na forma indicada - Predefinidoformat- uma hora com formato personalizado, ver dica e nota acimalocale- a região a usar para formatar a horatimezone- o fuso horário a usar para formatar a horadefault-format- define o formato predefinido de\timecomo o formato personalizado indicado
Exemplos
\time- 12:27\time(full)- 12:27:15 Hora de Verão da Europa Ocidental\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 regiões, consulta https://gist.github.com/jacobbubu/1836273; para uma lista de identificadores de fuso horário, consulta 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 predefinidofull,long,medium,short- um formato de hora padrão na forma indicada - Predefinidoformat- uma hora com formato personalizado, ver dica e nota acimalocale- a região a usar para formatar a data e a horatimezone- o fuso horário a usar para formatar a data e a horadefault-format- define o formato predefinido de\nowcomo o formato personalizado indicado
Exemplos
\now- 22-07-20 02:30\now(full)- quarta-feira, 22 de julho de 2020 às 2:29:53 Hora de Verão da Europa Ocidental\now(short)- 22/07/20, 02:30\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 calcular - Predefinidosum,add,total- uma lista de valores separados por vírgulas a somarcount- uma lista de valores separados por vírgulas a contarmin,minimum- uma lista de valores separados por vírgulas da qual escolher o valor mínimomax,maximum- uma lista de valores separados por vírgulas da qual escolher o valor máximoaverage,avg- uma lista de valores separados por vírgulas dos quais calcular a médiamedian,med- uma lista de valores separados por vírgulas dos quais calcular a medianastddev,standard-deviation,stdev- uma lista de valores separados por vírgulas dos quais calcular o desvio-padrãosqrt,square-root- um valor do qual calcular a raiz quadradalog,lg,logarithm- um valor do qual calcular o logaritmoln,natural-logarithm- um valor do qual calcular o logaritmo naturalrandom,rdm- um valor aleatório entre 0 e o número indicado
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 linha horizontal (linha separadora) no texto da nota
- sinónimos:
\rule,\insert-horizontal-rule,\hr
Exemplos
\rule- insere uma linha horizontal
\table
- insere uma tabela no texto da nota
- sinónimos:
\insert-table,\tb
Parâmetros
none- insere uma tabela padrão de 2x2size,dimensions- o tamanho da tabela pretendida no formato colunas x linhas - Predefinidocolumns,c- o número de colunas que a tabela deve terrows,r- o número de linhas que a tabela deve ter
Exemplos
\table- insere uma tabela padrão de 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 uma ligação web ou uma ligação para um projeto ou nota no texto da nota
- sinónimos:
\url,\insert-link,\ref,\href,[[ - abreviaturas:
\project,\note
Parâmetros
url- o endereço web da ligação a inserir Predefinidodescription,dimensions- o texto descritivo da ligação - Segundo predefinidoproject,project-title,to- o nome do projeto para o qual a ligação deve apontarnote,note-title- o título da nota para a qual a ligação deve apontar
Exemplos
\link(apple.com, apple website)- insere o texto apple website com uma ligação para apple.com\link(url: http://microsoft.com, description: microsoft)- insere o texto microsoft com uma ligação para microsoft.com\link(project: Developing Yak App, description: YakApp)- insere o texto YakApp com uma ligação para o projeto chamado Developing Yak App\link(note-title: Meeting the developers)- insere uma ligação para a nota com o título Meeting the developers
Dica: Em vez de usares
\link, podes também usar o atalho[[para inserir uma ligação para outro projeto ou nota. Podes até escrever[[recentpara veres uma lista de todas as notas editadas recentemente para as quais podes criar ligações.
\summary
- insere um resumo no texto da nota, na localização da seleção ou do cursor
- sinónimos:
\summarize,\insert-summary
Parâmetros
none- insere um resumo de todos os itens de lista não assinaladoslist- insere um resumo dos itens de lista com base num dos seguintes critérios: - Predefinidochecked- todos os itens assinaladosunchecked- todos os itens de lista não assinaladosstarred- todos os parágrafos marcados com uma estrelatagged- todos os parágrafos que contêm uma etiquetaassigned- todos os parágrafos que contêm uma etiqueta de pessoa
tag- o nome da etiqueta a resumirperson- o nome da pessoa a resumir
Exemplos
\summary- insere um resumo de todos os itens de lista não assinalados na nota\summary(list: checked)- insere um resumo de todos os itens de lista assinalados na nota\summary(starred)- insere um resumo de todos os parágrafos marcados com uma estrela\summary(tag: urgent)- insere um resumo de todos os parágrafos que têm a etiqueta chamadaurgent\summary(tag: priority[1])- insere um resumo de todos os parágrafos que têm a etiqueta chamadaprioritycom o valor1(repara no uso de parênteses retos em vez de parênteses curvos)\summary(person: tom)- insere um resumo de todos os parágrafos que têm a pessoa chamadatom
\attachment
- insere um anexo no texto da nota, abrindo a caixa de diálogo de abertura de ficheiros para escolher o ficheiro a anexar
- sinónimos:
\attach,\file,\insert-attachment
Parâmetros
none- abre o seletor de ficheiros para escolher um anexo a inserirdescription,title,name- o texto a usar como descrição do ficheiro a importar como anexo - Predefinido
Exemplos
\attach- abre o seletor de ficheiros\attach(My File)- abre o seletor de ficheiros 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 desenhodescription,title,name- o texto a usar como descrição do desenho - Predefinido
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 usar - Predefinido, Obrigatórioinput- o texto a usar para substituir o marcador 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\inputpelo texto The title of this book.
Estilo de parágrafo
\body
- repõe o estilo de parágrafo em texto de corpo simples
- sinónimos:
\p
Exemplos
\body- repõe toda a formatação, de modo que, ao escrever, o estilo de parágrafo fica definido como texto de corpo
\heading
- define o estilo de parágrafo como título
- abreviaturas:
\heading1,\h1,\heading2,\h2,subheading,\heading3,\h3,\heading4,\h4
Parâmetros
level- o nível de título a usar - Predefinido
Exemplos
\heading- muda o estilo para Título, equivalente a\heading1e\h1\heading(level: 2)- muda o estilo para subtítulo, equivalente a\heading2,\h2e\subheading\h3- muda o estilo para título menor
\preformatted
- repõe o estilo de parágrafo em 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 uma lista não ordenada com travessões ou marcas (consoante a tua preferência)
- sinónimos:
\ul,\dashed,\bulleted
Exemplos
\list- muda o estilo para uma lista com travessões, equivalente a\ul, ou a escrever um travessão, asterisco ou marca seguido de um espaço
\numbered
- define o estilo de parágrafo como uma lista numerada (ordenada)
- sinónimos:
\ol
Parâmetros
none- define o estilo como uma lista numerada a começar em 1start,from- o número inicial da lista
Exemplos
\numbered- muda o estilo para uma lista numerada a começar em 1, equivalente a escrever1.seguido de um espaço\numbered(start: 5)- muda o estilo para uma lista numerada a começar em 5, equivalente a escrever5.seguido de um espaço
\checklist
- define o estilo de parágrafo como uma lista de verificação
- sinónimos:
\cl
Exemplos
\checklist- muda o estilo para uma lista de verificação, equivalente a\cl
Ações de lista
\check
- assinala o item de lista de verificação da linha atual
Parâmetros
none- assinala o item de lista de verificação da linha atualall- assinala todos os itens da lista de verificação de que a linha atual faz parte
Exemplos
\check- assinala o item de lista de verificação da linha atual\check(all)- assinala todos os itens da lista de verificação
\check-all
- assinala todos os itens da lista de verificação de que a linha atual faz parte
- sinónimos:
\all
Exemplos
\all- assinala todos os itens da lista de verificação atual
\uncheck
- desassinala o item de lista de verificação da linha atual
Parâmetros
none- desassinala o item de lista de verificação da linha atualall- desassinala todos os itens da lista de verificação de que a linha atual faz parte
Exemplos
\uncheck- desassinala o item de lista de verificação da linha atual\uncheck(all)- desassinala todos os itens da lista de verificação
\reset
- desassinala todos os itens da lista de verificação de que a linha atual faz parte
Exemplos
\reset- desassinala todos os itens da lista de verificação atual
\sort
- ordena a lista de verificação de que a linha atual faz parte, de modo que os itens assinalados sejam movidos para o fundo
Exemplos
\sort- move os itens assinalados da lista atual para o fundo
Formatação
\bold
- alterna a formatação a negrito
- sinónimos:
\b
Exemplos
\b- alterna a formatação a 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 em expoente
- sinónimos:
\sup
Exemplos
\sup- alterna a formatação em expoente, equivalente a\superscript
\subscript
- alterna a formatação em índice
- sinónimos:
\sub
Exemplos
\sub- alterna a formatação em índice, equivalente a\subscript
\color
- alterna a formatação da cor do texto
- sinónimos:
\text-color
Parâmetros
color- o nome da cor a usar - Predefinido, 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 usar - Predefinido, 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, repondo texto simples
- sinónimos:
\c
Exemplos
\clear- repõe toda a formatação de estilo incorporado
Ações de nota
\on-the-agenda
- marca a nota como “Na Agenda”, ou desmarca-a se estiver atualmente marcada como tal
- 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
- afixa a nota na parte superior do projeto
Exemplos
\pin- afixa a nota
\footnote
- transforma a nota numa nota de rodapé afixada no fundo do projeto
Exemplos
\footnote- transforma a nota numa nota de rodapé
\unpin
- faz com que a nota afixada ou a nota de rodapé volte a ser uma nota normal
Exemplos
\unpin- transforma a nota afixada ou a nota de rodapé novamente numa nota normal
\assign-date
- atribui a data indicada à nota atual
- sinónimos:
\assign - abreviaturas:
\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 atribuir - Predefinidodate,at- uma representação em linguagem natural da data a atribuir
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 contar 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 se aproxima
\link-event
- associa o evento indicado à nota atual
- sinónimos:
\event
Parâmetros
day,on,after,before,until,from,in- uma representação em linguagem natural do dia em que procurar eventos - Predefinidodate,at- uma representação em linguagem natural da data em que procurar eventoscalendar- o calendário ao qual a pesquisa deve ser limitada
Exemplos
\event(17 oct 2022)- mostra os eventos do calendário no dia 17 de outubro aos quais a nota pode ser associada\event(calendar: Work, 17 oct 2022)- mostra os eventos do calendário Work no dia 17 de outubro aos quais a nota pode ser associada
\new
Adicionada na Agenda 15
- adiciona uma nova nota a seguir à nota atual
Parâmetros
none- adiciona uma nova nota a seguir à nota atualtitle- o título da nota que será criada - Predefinidotemplate- o modelo a usar na nova nota
Exemplos
\new- cria uma nova nota a seguir à nota em que estás atualmente\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 - Predefinidotitle- 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 - Predefinidotitle- 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 um duplicado 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 ser movida - Predefinido, 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
Escapar caracteres
Ações
Se não quiseres que uma ação seja executada e prefiras que fique como texto, podes preceder a ação com uma barra invertida adicional, assim: \\tag(name: Alex). A ação não resultará então na criação da etiqueta Alex, mas manter-se-á como \tag(name: Alex). Em alternativa, podes mudar o estilo de parágrafo para Pré-formatado, ou o estilo incorporado para largura fixa, para 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 de conter um destes caracteres, podes escapá-lo com uma barra invertida.
Por exemplo, sem escapar, \date(format: YYYY, dd-MM) é interpretado incorretamente e mostra apenas o ano 2022; em vez disso, podes usar \date(format: YYYY\, dd-MM) para mostrar 2022, 07-04
Do mesmo modo, sem escapar, \split(Newsflash: ABC) não seria interpretado corretamente, enquanto \split(Newsflash\: ABC) é.
Localização
Repara que todas as ações e parâmetros devem estar devidamente localizados de acordo com o idioma da aplicação. Nesse caso, podes usar tanto a variante inglesa acima como as variantes traduzidas. Repara que, embora as ações possam conter acentos e/ou maiúsculas, não é necessário escrevê-los; por exemplo, na versão francesa da Agenda, podes obter uma lista numerada escrevendo qualquer uma das seguintes:
\numérotée\numerotee\Numérotée\numbered