Agenda O guia do utilizador
Nesta página
Descarregar em PDF

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ório
  • color - o nome ou o valor hexadecimal da cor da etiqueta - Premium
  • value, text, string - um valor de texto opcional - Segundo predefinido
  • 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 decimal opcional

Exemplos

  • \tag(name: important) - cria a etiqueta #important, equivalente a \tag(important)
  • \tag(important, color: blue) - cria a etiqueta #important com a cor azul
  • \tag(important, color: #333) - cria a etiqueta #important com 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 é agendado
  • due-date - uma expressão em linguagem natural que representa uma data no futuro - Predefinido
  • title - o título do lembrete a agendar
  • list - a lista da aplicação 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 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 predefinido
  • full, long, medium, short - um formato de data padrão na forma indicada - Predefinido
  • format - uma data com formato personalizado, ver dica e nota abaixo
  • locale - a região a usar para formatar a data
  • timezone - o fuso horário a usar para formatar a data
  • in, for, offset - uma data diferente de hoje
  • default-format - define o formato predefinido de \date como 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 predefinido
  • full, long, medium, short - um formato de hora padrão na forma indicada - Predefinido
  • format - uma hora com formato personalizado, ver dica e nota acima
  • locale - a região a usar para formatar a hora
  • timezone - o fuso horário a usar para formatar a hora
  • default-format - define o formato predefinido de \time como 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 predefinido
  • full, long, medium, short - um formato de hora padrão na forma indicada - Predefinido
  • format - uma hora com formato personalizado, ver dica e nota acima
  • locale - a região a usar para formatar a data e a hora
  • timezone - o fuso horário a usar para formatar a data e a hora
  • default-format - define o formato predefinido de \now como 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 - Predefinido
  • sum, add, total - uma lista de valores separados por vírgulas a somar
  • count - uma lista de valores separados por vírgulas a contar
  • min, minimum - uma lista de valores separados por vírgulas da qual escolher o valor mínimo
  • max, maximum - uma lista de valores separados por vírgulas da qual escolher o valor máximo
  • average, avg - uma lista de valores separados por vírgulas dos quais calcular a média
  • median, med - uma lista de valores separados por vírgulas dos quais calcular a mediana
  • stddev, standard-deviation, stdev - uma lista de valores separados por vírgulas dos quais calcular o desvio-padrão
  • sqrt, square-root - um valor do qual calcular a raiz quadrada
  • log, lg, logarithm - um valor do qual calcular o logaritmo
  • ln, natural-logarithm - um valor do qual calcular o logaritmo natural
  • random, 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 2x2
  • size, dimensions - o tamanho da tabela pretendida no formato colunas x linhas - Predefinido
  • 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 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
  • 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 Predefinido
  • description, dimensions - o texto descritivo da ligação - Segundo predefinido
  • project, project-title, to - o nome do projeto para o qual a ligação deve apontar
  • note, 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 [[recent para 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 assinalados
  • list - insere um resumo dos itens de lista com base num dos seguintes critérios: - Predefinido
    • checked - todos os itens assinalados
    • unchecked - todos os itens de lista não assinalados
    • starred - todos os parágrafos marcados com uma estrela
    • tagged - todos os parágrafos que contêm uma etiqueta
    • assigned - todos os parágrafos que contêm uma etiqueta de pessoa
  • tag - o nome da etiqueta a resumir
  • person - 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 chamada urgent
  • \summary(tag: priority[1]) - insere um resumo de todos os parágrafos que têm a etiqueta chamada priority com o valor 1 (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 chamada tom

\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 inserir
  • description, 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 desenho
  • description, 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ório
  • input - 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 \input pelo 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 \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

  • 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 1
  • start, from - o número inicial da lista

Exemplos

  • \numbered - muda o estilo para uma lista numerada a começar em 1, equivalente a escrever 1. seguido de um espaço
  • \numbered(start: 5) - muda o estilo para uma lista numerada a começar em 5, equivalente a escrever 5. 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 atual
  • all - 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 atual
  • all - 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 - Predefinido
  • date, 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
  • 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 - Predefinido
  • date, at - uma representação em linguagem natural da data em que procurar eventos
  • calendar - 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 atual
  • title - o título da nota que será criada - Predefinido
  • template- 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 - Predefinido
  • 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 - Predefinido
  • 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 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