検索構文チートシート

Agendaの検索はシンプルで高速です。検索語をいくつか入力するだけで、すべてのノートを瞬時に検索できます。現在選択中の概要やプロジェクトにあるヒットは結果リストの上部に表示され、アーカイブされたプロジェクトやゴミ箱にあるものは最後に表示されます。

ただし、はるかに複雑なクエリを作成することもできます。スペースバーやReturnキーを押したときに検索フィールドに作られる検索トークンをクリック/タップする方法でも、テキストアクション(テキストアクションチートシートの章をご覧ください)と非常によく似た仕組みと強力な自動補完の組み合わせによる方法でも可能です。

検索プロパティの前にはバックスラッシュ文字(\)を付けます。これにより自動補完メニューが呼び出され、検索できるプロパティが表示されます。使いたいアクションの最初の数文字を入力すれば、さらに絞り込めます。

ヒント: ハードウェアキーボードのないiPhoneやiPadでは、バックスラッシュ文字を入力するのは少し面倒です。代わりに、検索フィールドのルーペアイコンをタップするだけで済みます。便利です!

同様に、中国語や日本語のキーボードなど一部のキーボードではバックスラッシュ文字を入力しにくいため、バックスラッシュ文字が示されている場所ではどこでも、2つのバッククォート(``)または2つの中黒文字(··)も使えます。

これらのプロパティの多くは、かっこの中にいわゆるパラメータを取ることができ(タグに値のパラメータを追加できるのと似ています。タグ、人物、テキストアクション、リンクの章をご覧ください)、アクションの動作をさらに細かく指定できます。たとえば、\title(starts-with: yak)は、ノートのタイトルの先頭にあるyakという語を検索します。

Defaultと記されているパラメータは、何も指定されなかった場合のデフォルトのパラメータと見なされます。たとえば、\tag(important)は\tag(name: important)と同じと見なされます。

以下に、Agendaが現在サポートしている検索プロパティの完全な一覧を示します。

ノートのプロパティ

\all

• ノートのすべてのフィールドを横断して検索します(デフォルト)
• 同義語: everything

\on-the-agenda

• ノートの議題ステータスで検索します
• 同義語: ontheagenda、ota、agenda

\title

• ノートのタイトルで検索します
• 同義語: ti

\assigned-date

• ノートに割り当てられた日付、つまり単一の日付が割り当てられたノートで検索します
• 同義語:
• 短縮形: \today、\tomorrow、\yesterday、\monday、\tuesday、\wednesday、\thursday、\friday、\saturday、\sunday

\start-date

• ノートの開始日、つまり日付の範囲が割り当てられたノートの最初の日で検索します
• 同義語:

\end-date

• ノートの終了日、つまり日付の範囲が割り当てられたノートの最後の日で検索します
• 同義語:

割り当てられた日付と開始日/終了日: \assigned-dateは単一の日付が与えられたノートのためのもので、\start-dateと\end-dateは日付の範囲が与えられたノートのためのものです。ノートに単一の日付しかない場合、\assigned-dateと\start-dateは同じノートに一致するので、結果が重なります。違いが見えてくるのは、ノートに日付の範囲がある場合だけです。

\linked-event

• ノートにリンクされたイベントで検索します
• 同義語:

\calendar

• ノートにリンクされたイベントのカレンダーで検索します
• 同義語:

\due-date

• ノート内にあるリマインダーの期限日で検索します
• 同義語:

\color

• ノートの背景色で検索します
• 同義語:

\pinned

• ノートのピン留めステータスで検索します
• 同義語:

\footnote

• ノートの脚注ステータスで検索します
• 同義語:

\done

• ノートの完了ステータスで検索します
• 同義語:

\locked

• ノートのロックステータスで検索します
• 同義語:

\shared

• ノートの共有ステータスで検索します
• 同義語:

\edited-date

• ノートの編集日で検索します
• 同義語:

\creation-date

• ノートの作成日で検索します
• 同義語:

\template

• ノートの作成に使われたテンプレートで検索します
• 同義語:

ノートの内容

\tag

• ノートの内容に含まれるタグで検索します
• 同義語: #

パラメータ

• name - タグの名前 - デフォルト、必須
• color - タグの色の名前または16進数の値 - プレミアム
• value、text、string - 任意のテキストの値 - 第2のデフォルト
• 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) - 16進数カラー#333の#importantタグを作成します
• \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

• ノートの内容に含まれる人物で検索します
• 同義語: @、contact

パラメータ

• name、alias、nickname - 人物の名前 - デフォルト、必須

例

• \person(name: Tom G) - @(Tom G)という人物を作成します。\person(Tom G)と同じです

\reminder

• ノートの内容に含まれるリマインダーで検索します
• 同義語: \remind、

パラメータ

• 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)` - 2020年12月25日の8時にリマインダーを設定します
• \reminder(today at 6pm, list: important) - 「important」というリマインダーリストに、今日の6時のリマインダーを設定します
• \reminder(all-day: tomorrow) - 明日の終日リマインダーを設定します

\table

• ノートの内容に含まれる表で検索します
• 同義語:

\link

• ノートの内容に含まれるリンクで検索します
• 同義語:

\attachment

• ノートの内容に含まれるアタッチメントで検索します
• 同義語:

\drawing

• ノートの内容に含まれる描画で検索します
• 同義語:

\starred

• ノートの内容に含まれるスターのステータスで検索します
• 同義語:

\has-todo

• ノートの内容にToDo項目があるかどうかで検索します
• 同義語:

\has-checklist

• ノートの内容にチェックリストがあるかどうかで検索します
• 同義語:

\has-list

• ノートの内容に番号付きリスト、順序付きリスト、またはチェックリストがあるかどうかで検索します
• 同義語:

\has-code

• ノートの内容にコードスニペットがあるかどうかで検索します
• 同義語:

\has-quote

• ノートの内容に引用があるかどうかで検索します
• 同義語:

プロジェクトとカテゴリー

\category

• ノートを含むカテゴリーで検索します
• 同義語:

\project

• ノートを含むプロジェクトで検索します
• 同義語:

\archived

• ノートがアーカイブされたプロジェクトの一部かどうかで検索します
• 同義語:

プリセット

\recently-edited

• 最近編集されたノートで検索します
• 同義語:

\now

• 現在進行中のノートで検索します
• 同義語:

\upcoming

• これから予定されているノートで検索します
• 同義語:

\earlier

• ちょうど終わったばかりのノートで検索します
• 同義語:

\on-this-day

• 過去のノートのうち、過去の年の同じ日に割り当てられたもので検索します。
• 同義語:

\random

• 指定した数のノートをランダムに選んで返します
• 同義語:

演算子

AND

• 両方の語が存在する必要があります
• 同義語: &&

OR

• いずれかの語が存在する必要があります
• 同義語: ||

NOT

• その語が存在してはいけません
• 同義語: !

文字どおりの一致

() と ""

グループ化

ローカライズ

すべてのアクションとパラメータは、アプリの言語に応じて適切にローカライズされていることにご注意ください。その場合、上記の英語版でも翻訳された版でも使用できます。アクションにはアクセント記号や大文字が含まれることがありますが、それらを入力する必要はありません。たとえばフランス語版のAgendaでは、次のいずれを入力しても番号付きリストが得られます:

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