> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pensiv.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 検索構文

> 検索ボックスで使うフィールド条件と除外、引用符、OR です。原稿が厚くなるほど、一行で範囲を先に絞るほうが速くなります。

検索ボックスは Cmd(Ctrl)+K で開きます。構文を混ぜると、探しに行く範囲をあらかじめ切っておけます。

## フィールドで条件をかける

`フィールド:値` の形で続けて書きます。コロンの前後に空白があると、条件として読まれません。

| フィールド             | はたらき             | 例                    |
| ----------------- | ---------------- | -------------------- |
| `type:` `entity:` | 一つの種類だけ残します      | `type:sheet`         |
| `category:`       | シートのカテゴリで絞ります    | `category:character` |
| `tag:`            | タグで絞ります          | `tag:伏線`             |
| `title:` `name:`  | タイトルに入っている語で絞ります | `title:第1章`          |

`type:` の値は document、sheet、folder、plotboard、canvas、plotcard、partcard、note、memo、task、label、status です。`category:` は character、event、organization、item、location、worldbuilding、other です。画面のキャラクター・イベント・組織・アイテム・場所・世界構築・その他に対応します。

カテゴリはシートにしか付かないので、`category:` をかけるとドキュメントとフォルダが外れます。タグはシートの属性とノート、プロットのパーツカードにあります。値に空白が入っていると、フィールド条件としては使えません。

## 除外する

条件の前に `-` を付けると、その項目を取り除きます。`-category:organization` は組織シートを、`-tag:下書き` はそのタグが付いたものを外します。`category`・`tag`・`title`・`name` にだけ効きます。

## 引用符

`"剣を持つ少女"` のように囲むと、その順序のまま並んでいる場所だけを探します。囲まなければ、二つの語がどこに散らばっていても引っかかります。

## OR

`狼 OR 猟犬` のように間に入れると、どちらか一方に当たるものが残ります。`or` でも通ります。OR が分けるのは検索語だけで、フィールド条件は両側にかかります。`category:character 狼 OR 猟犬` は、キャラクターシートの中だけで二つの語を探します。`category`・`tag`・`type` のように絞り込むだけのフィールドどうしを OR でつなぐと、何も残りません。`title`・`name` は値そのものが検索語なので、`title:第1章 OR title:第2章` のように二方向へ探します。

<div className="app-window block dark:hidden">
  <img src="https://mintcdn.com/raumlabsinc/RpnImTRrZig0qdL9/images/ja/reference/search-syntax--01.png?fit=max&auto=format&n=RpnImTRrZig0qdL9&q=85&s=4bd00bc7a4848868a86055a95db5a718" alt="検索ウィンドウを開き、入力欄に `category:character 狼` と打ったあと結果が届いた状態。結果にはシートだけが残り、ドキュメントやフォルダが混ざっていない画面でなければならない。" width="2880" height="1800" data-path="images/ja/reference/search-syntax--01.png" />
</div>

<div className="app-window hidden dark:block">
  <img src="https://mintcdn.com/raumlabsinc/RpnImTRrZig0qdL9/images/ja/reference/search-syntax--01-dark.png?fit=max&auto=format&n=RpnImTRrZig0qdL9&q=85&s=ce38e4d925500752545268e730750833" alt="検索ウィンドウを開き、入力欄に `category:character 狼` と打ったあと結果が届いた状態。結果にはシートだけが残り、ドキュメントやフォルダが混ざっていない画面でなければならない。" width="2880" height="1800" data-path="images/ja/reference/search-syntax--01-dark.png" />
</div>

<p className="app-caption">フィールド条件をかけると、その種類だけが残ります。</p>

<Note>
  対応していないフィールド名は、そのまま無視されます。結果がやけに広いときは、まずつづりを確認してください。
</Note>
