Public 記事をタグで補助的に整理する

esaでは階層を持った「カテゴリ」の他に「タグ」で記事を整理することができます。

## タグの使い方

### 記事にタグを付ける

タグは、記事編集ページのタイトル入力欄に `#タグ名` のように入力することで付与することができます。

※  `#タグ名`の直前に半角スペースが必要です

![image.png (729.4 kB)](https://img.esa.io/uploads/production/attachments/105/2019/12/12/2/752b0075-6053-45c5-8174-c334e061165a.png)


付与されたタグは記事タイトルの末尾に表示され、タグ名をクリックすると同様のタグがついた記事一覧を見ることができます。

![image.png (260.4 kB)](https://img.esa.io/uploads/production/attachments/105/2019/12/12/2/a4ac3bcd-336a-4d9d-a380-8580a7f4a636.png)


### 利用中のタグの一覧

これまでつけたタグの一覧は、左側ナビゲーションの「TAGS」メニューから、タグ一覧ページで見ることができます。
タグ名をクリックすると、そのタグがついた記事一覧を見ることができます。
タグは右側の <i class="fa fa-trash"></i> アイコンから一括削除することも可能です。

![image.png (191.1 kB)](https://img.esa.io/uploads/production/attachments/105/2019/12/12/2/34c40a5b-82de-45e4-85ef-8674032990ad.png)

![image.png (288.1 kB)](https://img.esa.io/uploads/production/attachments/105/2019/12/12/2/c9ff3153-0012-41d1-a45c-2a7e16f1224e.png)

## 記事はカテゴリを中心に整理し、タグは補助的に用いる

esaの記事の整理は主に階層を持ったカテゴリを中心に用いて行い、カテゴリでもカバーしきれない場合に用途に応じてあくまで補助的にタグを使うのがおすすめです。

- 参考: [#354:  help/記事をカテゴリに分けて整理する](/posts/354) 

### タグの用途例

参考までに、タグの用途の代表的な例をいくつか紹介します。

- __記事を複数以上の角度から分類したい場合にタグを利用する__
    - 例えば、このチーム内の [#markdown](https://docs.esa.io/posts?q=%23markdown+) というタグでは、ReleaseNoteやHelpのうちのMarkdownに関するリリースのみを探しやすくしています。
    - カテゴリは体系的に整理するのは便利ですが、1つの記事につき1つしか付与できないので、このように補助的にタグを用いることで、様々な角度からの分類が可能になります。
- __検索の補助としてタグを用いる__
    - タグをつけておくことで、タグを用いた検索が可能になり、目的の記事をより探しやすくなります。
    - `tag: keyword` と検索欄に入力することで、つけられたタグ名でも検索できます。
- __タスクの進行状況をタグで表現する__
    - 例えば、「#進行中」「#リリース済み」 等のタグをつけることで、esaのWIPでは表現しきれないステータス管理をすることができます。
    - 原稿執筆やプロジェクト管理にも便利です。

## 特殊な機能を持つタグ

esaには、特殊な機能を持つタグが存在します。記事につけることで、下記のような機能を記事に持たせることができます。

### `#stock`

記事をStock記事に分類します。
- 参考: [#298:  ProTip/2018/12/13/記事のStock・Flowの分類と検索](/posts/298) 

### `#flow`

記事をFlow記事に分類します。
- 参考: [#298:  ProTip/2018/12/13/記事のStock・Flowの分類と検索](/posts/298) 

### `#math`

MathJaxのInlineMath機能を強制的に有効にします。
- 参考: [ReleaseNotes/2015/04/18/TeX記法で数式が書けるようになりました - docs.esa.io](https://docs.esa.io/posts/92)
- 現在はこのタグをつけなくても、 `$...$` を自動認識してMathJaxのInlineMath機能が有効になります

### `#noexpand`

Slack通知の際に、記事本文を展開しません。
更新頻度が高い記事等に、活用ください。

## 補足: 記事タイトルに`#` を用いたい場合

`C#勉強会` のように、タグではなく記事タイトルの一部として `#` を使うことができます。`#` の直前に半角スペースがあるとタグとして認識されてしまいますのでご注意ください。

- 参考: [#263:  ReleaseNotes/2018/04/25/記事タイトルに#を含めることが出来るようになり/も表示出来るようになりました](/posts/263) 


## タグ名の制限

- 制御文字全般は使用できません。
- `/`(スラッシュ)は使用できません。（カテゴリの区切りとして使用されるためです）