Guia rápido de sintaxe de pesquisa

A pesquisa na Agenda é simples e rápida: basta escreveres alguns termos de pesquisa e pesquisas instantaneamente em todas as tuas notas. Os resultados presentes na visão geral ou no projeto atualmente selecionado são mostrados no topo da lista de resultados, e os que estão em projetos arquivados ou no lixo são mostrados no fim.

No entanto, também podes criar consultas muito mais complexas, tanto clicando/tocando nos símbolos de pesquisa no campo de pesquisa que são criados ao premires a barra de espaços ou a tecla Enter, como através de um sistema muito semelhante ao das ações de texto (consulta o capítulo Guia rápido de ações de texto), em combinação com um poderoso preenchimento automático.

As propriedades de pesquisa são precedidas por um caráter de barra invertida (\) que invoca um menu de preenchimento automático que mostra as propriedades disponíveis para pesquisar 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 o caráter de barra invertida pode ser um pouco incómodo. Em vez disso, podes simplesmente tocar no ícone da lupa no campo de pesquisa. Prático!

Do mesmo modo, em alguns teclados, como os chineses ou japoneses, é difícil escrever um caráter de barra invertida; por isso, sempre que for apresentado um caráter de barra invertida, também podes usar duas plicas invertidas (``) ou dois pontos médios (··).

Muitas destas propriedades podem receber os chamados parâmetros entre parêntesis (à semelhança do que acontece com os parâmetros de valor nas etiquetas, consulta o capítulo Etiquetas, pessoas, ações de texto e ligações), para refinar ainda mais o comportamento destas ações. Por exemplo, \title(starts-with: yak) pesquisa a palavra yak no início do título da nota.

Os parâmetros assinalados como Predefinido são considerados o parâmetro predefinido caso nenhum seja fornecido. Por exemplo, \tag(important) é considerado o mesmo que \tag(name: important).

Em baixo encontras uma visão geral completa das propriedades de pesquisa que a Agenda suporta atualmente.

Propriedades da nota

\all

• pesquisa em todos os campos de uma nota (Predefinido)
• sinónimos: everything

\on-the-agenda

• pesquisa no estado Na Agenda de uma nota
• sinónimos: ontheagenda, ota, agenda

\title

• pesquisa no título de uma nota
• sinónimos: ti

\assigned-date

• pesquisa na data atribuída de uma nota, ou seja, uma nota à qual foi atribuída uma única data
• sinónimos:
• abreviaturas: \today, \tomorrow, \yesterday, \monday, \tuesday, \wednesday, \thursday, \friday, \saturday, \sunday

\start-date

• pesquisa na data de início de uma nota, ou seja, o primeiro dia de uma nota à qual foi atribuído um intervalo de datas
• sinónimos:

\end-date

• pesquisa na data de fim de uma nota, ou seja, o último dia de uma nota à qual foi atribuído um intervalo de datas
• sinónimos:

Data atribuída vs. data de início/fim: \assigned-date destina-se a notas às quais foi dada uma única data, ao passo que \start-date e \end-date se destinam a notas às quais foi dado um intervalo de datas. Se uma nota tiver apenas uma única data, \assigned-date e \start-date corresponderão às mesmas notas, pelo que os resultados se sobrepõem. A diferença só se torna visível quando as notas têm intervalos de datas.

\linked-event

• pesquisa no evento ligado a uma nota
• sinónimos:

\calendar

• pesquisa no calendário do evento ligado a uma nota
• sinónimos:

\due-date

• pesquisa na data limite dos lembretes presentes numa nota
• sinónimos:

\color

• pesquisa na cor de fundo de uma nota
• sinónimos:

\pinned

• pesquisa no estado de afixação de uma nota
• sinónimos:

\footnote

• pesquisa no estado de nota de rodapé de uma nota
• sinónimos:

\done

• pesquisa no estado de conclusão de uma nota
• sinónimos:

\locked

• pesquisa no estado de proteção de uma nota
• sinónimos:

\shared

• pesquisa no estado de partilha de uma nota
• sinónimos:

\edited-date

• pesquisa na data de edição de uma nota
• sinónimos:

\creation-date

• pesquisa na data de criação de uma nota
• sinónimos:

\template

• pesquisa no modelo usado para criar uma nota
• sinónimos:

Conteúdo da nota

\tag

• pesquisa na etiqueta presente no conteúdo de uma nota
• sinónimos: #

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, igual 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), igual 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

• pesquisa na pessoa presente no conteúdo de uma nota
• sinónimos: @, contact

Parâmetros

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

Exemplos

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

\reminder

• pesquisa no lembrete presente no conteúdo de uma nota
• sinónimos: \remind,

Parâmetros

• none - insere um lembrete de marcador de posição que não está 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 na app 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 6 horas
• \reminder(tomorrow evening) - agenda um lembrete para amanhã às 6 horas
• \reminder(in 3 weeks) - agenda um lembrete para daqui a 21 dias
• \reminder(25 dec 2020, at 8pm)` - agenda um lembrete para 25 dez 2020 às 8 horas
• \reminder(today at 6pm, list: important) - agenda um lembrete para hoje às 6 horas na lista de lembretes “important”
• \reminder(all-day: tomorrow) - agenda um lembrete de dia inteiro para amanhã

\table

• pesquisa na tabela presente no conteúdo de uma nota
• sinónimos:

\link

• pesquisa na ligação presente no conteúdo de uma nota
• sinónimos:

\attachment

• pesquisa no anexo presente no conteúdo de uma nota
• sinónimos:

\drawing

• pesquisa no desenho presente no conteúdo de uma nota
• sinónimos:

\starred

• pesquisa no estado de estrela presente no conteúdo de uma nota
• sinónimos:

\has-todo

• pesquisa se existem itens de tarefa no conteúdo de uma nota
• sinónimos:

\has-checklist

• pesquisa se existe uma lista de verificação no conteúdo de uma nota
• sinónimos:

\has-list

• pesquisa se existe uma lista numerada ou ordenada, ou uma lista de verificação, no conteúdo de uma nota
• sinónimos:

\has-code

• pesquisa se existe um excerto de código no conteúdo de uma nota
• sinónimos:

\has-quote

• pesquisa se existe uma citação no conteúdo de uma nota
• sinónimos:

Projetos e categorias

\category

• pesquisa na categoria que contém uma nota
• sinónimos:

\project

• pesquisa no projeto que contém uma nota
• sinónimos:

\archived

• pesquisa se uma nota faz parte de um projeto arquivado
• sinónimos:

Predefinições

\recently-edited

• pesquisa notas editadas recentemente
• sinónimos:

\now

• pesquisa notas atualmente em curso
• sinónimos:

\upcoming

• pesquisa notas futuras
• sinónimos:

\earlier

• pesquisa notas que acabaram de terminar
• sinónimos:

\on-this-day

• pesquisa notas do passado que foram atribuídas ao mesmo dia de um ano anterior.
• sinónimos:

\random

• devolve um dado número de notas selecionadas aleatoriamente
• sinónimos:

Operadores

AND

• ambos os termos devem estar presentes
• sinónimos: &&

OR

• um dos termos deve estar presente
• sinónimos: ||

NOT

• o termo não deve estar presente
• sinónimos: !

Correspondências literais

() e ""

Agrupamento

Localização

Nota que todas as ações e parâmetros devem estar devidamente localizados de acordo com o idioma da app. Nesse caso podes usar a variante inglesa acima ou as variantes traduzidas. Nota 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