チーム内の記事を検索する方法について説明します。

# 検索フォーム

ヘッダーの検索フォームからチーム内の記事を検索することができます。

![docs_esa_io.png (105.5 kB)](https://img.esa.io/uploads/production/attachments/105/2015/05/13/1/9871be8b-aa9c-4639-bc6e-20ad00329c38.png)

# 検索オプション

検索に下記のオプションを使うことで、様々な角度から絞り込み検索をすることができます。

使用例:

 ```
category:日報
 ```
 ```
created:>2023-07-05 @taea wip:false
 ```

| 記法 | 説明 |
| --- | --- |
| keyword | 記事名 or カテゴリ or 本文にkeywordを含むもの |
| name:keyword または  title:keyword | 記事名にkeywordを含むもの |
| full_name:keyword | "[カテゴリ名]/[記事名]" にkeywordを含むもの |
| number | 記事ID（URL末尾の番号） |
| wip:true または wip:false | 記事の WIP or Shipped 状態 |
| kind:stock または kind:flow | 記事のStock or Flow 状態 <br> [#31:  release_note/2014/12/13/検索結果の絞り込み(Stock or Flow)](/posts/31) |
| category:keyword | カテゴリ名にkeywordを含むもの(部分一致) |
| in:keyword | カテゴリ名がkeywordから始まるもの(前方一致) |
| on:keyword | カテゴリ名がkeywordであるもの(完全一致) |
| body:keyword | 記事本文にkeywordを含むもの |
| #tag1 または tag:tag1 | tag1 タグが付いているもの |
| @screen_name または user:screen_name | 記事作成者のscreen_name|
| updated_by:screen_name | 記事の最終更新者のscreen_name|
| comment:keyword | コメント本文に keyword が含まれる記事 |
| starred:true または starred:false | 自分がStarしている記事 |
| watched:true または watched:false | 自分がWatchしている記事 |
| watched_by:screen_name | 記事をwatchしているメンバーのscreen_name |
| stars:>3 | Star数が3より大きい記事 |
| watches:>4 | Watch数が4より大きい記事 |
| comments:>5 | コメント数が5より大きい記事 |
| done:>=6 | 完了したタスクが6以上の記事 |
| undone:>0 | 未完了のタスクが0より大きい記事 |
| created:>2015-07-05 | 2015-07-05以降に作成された記事 |
| updated:>2015-07 | 2015-07-01以降に更新された記事 |
| sharing:true または sharing:false | 記事の外部公開状態 |
| keyword1 keyword2 | AND検索(スペース区切り) |
| keyword1 OR keyword2 | OR検索 |
| keyword1 \| keyword2 | OR検索 |
| -keyword | 否定検索 |

## 語句の結合の優先順位

通常検索内容は左から順番に処理されますが、`()` を使って優先順位を調整することができます。特に、OR検索と組み合わせると便利です。

例:

- `in:日報 えさ OR 餌` => (`in:日報` AND `えさ`) OR (`餌`) として処理
- `in:日報 (えさ OR 餌)` => (`in:日報`) AND ( `えさ` OR `餌`) として処理

## 数値や日付で絞り込む

`stars`、 `watches`、`comments`、`number`、`done`、`undone` 、`created`、`updated` は 以下のような書き方ができます。

| 記法 | 説明 |
| --- | --- |
| `stars:3` | starが3つ |
| `stars:>3` | starが3より大きい |
| `stars:<3` | starが3未満 |
| `stars:>=3` | starが3以上 |
| `stars:<=3` | starが3以下 |


# 検索例
- `help`
    - 記事名もしくはカテゴリもしくは記事本文に `help` が含まれる記事を検索
    - https://docs.esa.io/posts?q=help
- `-in:help user:fukayatsu`
    - カテゴリに `help` が含まれず、`fukayatsu` が作成した記事を検索
    - https://docs.esa.io/posts?q=-in%3Ahelp+user%3Afukayatsu
- `name:テーブル #markdown`
    - 記事名に `テーブル` が含まれ、 `markdown` タグが付いている記事を検索
    - https://docs.esa.io/posts?q=name%3A%E3%83%86%E3%83%BC%E3%83%96%E3%83%AB+%23markdown&tag=markdown