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

# 検索フォーム

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

![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 |
| `sharing:true` または `sharing:false` | 記事の外部公開状態 |
| `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以降に更新された記事 |
| `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