Public 記事をカテゴリに分けて整理する

esaでは、記事をカテゴリに分けて整理することができます。
記事を分野や部署ごとに整理したり、また日付をつけて整理することができます。

## 記事にカテゴリをつける

記事のカテゴリ分けは、新規投稿画面 または 記事編集画面内にある、記事タイトル入力欄からできます。

![image.png (1.7 MB)](https://img.esa.io/uploads/production/attachments/105/2019/11/25/2/c542bf42-1b6c-4a64-b9b3-6f679a7c18b1.png)


記事タイトル入力欄に、半角の `/` (スラッシュ) 区切りでカテゴリを作ることができます。

- 例えば、下記のように記事タイトル入力欄に入力すると、`/` 以前の部分がカテゴリとして、最後の`/` 以降の部分が記事タイトルとして入力されます。
 - カテゴリは複数作ることができ、階層にすることができます。
 - 記事タイトルに`/`を利用したい場合は、`/`の数値文字参照である`/`と入力することで、タイトルに`/`を表示することができます。

![image.png (918.8 kB)](https://img.esa.io/uploads/production/attachments/105/2019/11/25/2/61aab906-28ae-4d74-8851-98af7b90e3b2.png)





## Homeでカテゴリ分けされた記事を閲覧する

- カテゴリ分けされた記事は、下図の様にHomeの左側のカテゴリメニューの中に整理されます。
- 記事の多いカテゴリの順で、Homeのカテゴリメニューにカテゴリが並びます。
- Homeの画面から、新規に空のカテゴリを作ることはできません。上記のように記事タイトル内にカテゴリを作成することで、新しいカテゴリが作られます。


<img width="1315" alt="image.png (652.9 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/09/11/2/3776b908-14bb-4343-920f-6090826cc8a9.png">



## Home画面から特定のカテゴリに記事を作成する

Home画面でカテゴリを開いた時に、カテゴリ名の右側にある __「Create a new post here」__ というボタンをクリックすると、そのカテゴリ名がセットされた新規投稿画面が開き、そのカテゴリ以下に記事を書くことができます。

<img width="1318" alt="image.png (583.9 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/09/11/2/0e643646-2770-4cfa-a542-e1a5e8b840fe.png">

<img width="1551" alt="image.png (724.6 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/09/11/2/5174a331-4a48-456d-a6e4-94b1171c33c8.png">


## カテゴリ名を編集する

Home画面でカテゴリを開いた時に、カテゴリ名の右側にある __「<i class="fa-solid fa-pen"></i> 鉛筆マーク」__ をクリックすると、カテゴリ名が編集できます。


<img width="1314" alt="image.png (437.1 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/09/11/2/a066222b-8d30-467d-b628-426ded98704b.png">

<img width="1317" alt="image.png (516.0 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/09/11/2/8f0c676d-e3ae-4ed8-8e10-6dfd238d3329.png">


- ここからカテゴリを編集したときの更新は、記事の個別の更新履歴に反映されません。（最新の記事一覧にも反映されません）
- カテゴリ名の変更は、画面上に即座に反映されないことがあります。ブラウザを更新する等して、しばらくお待ちください。

## カテゴリに日付をつけて順番に整理する

カテゴリに日付をつけて、日付順に整理することができます。


![image.png (2.6 MB)](https://img.esa.io/uploads/production/attachments/105/2019/11/25/2/ef76dcb6-b079-4c38-b904-abe5f11a2a6f.png)

![image.png (1.5 MB)](https://img.esa.io/uploads/production/attachments/105/2019/11/25/2/c5089f7d-1a0f-44e9-9eb6-8d94903b3f7d.png)

- 上図のように `年/月/日/` というカテゴリにすることによって、日付順に記事を整理することができます。
    - 一桁の月や日の場合は、 `2019/01/02` のように記述する必要があります
- 日付のついたカテゴリは、日付順に降順でカテゴリメニューに表示されます（最新の日付順に並べることができます）
- 日報や議事録等、特定の日時に行われた物事を記録する用途に使うと便利です。
- 日付のついたカテゴリは "Flow" 情報として扱われ、検索での絞り込みに利用することができます。
    - 参考: [ProTip/2018/12/13/記事のStock・Flowの分類と検索 ](https://docs.esa.io/posts/298)

## カテゴリに README を設定する

カテゴリについてのまとめや解説を書く欄として、 __「README」__ を設定することができます。


![image.png (697.4 kB)](https://img.esa.io/uploads/production/attachments/105/2019/11/25/2/492b560d-55fd-4513-b1ff-5c1ea00ed06c.png)

- 上図のように、特定のカテゴリの下に __「README」__ というタイトルの記事を作ることで設定できます。

<img width="1169" alt="ss_2024-02-28_12_11_57.png (322.6 kB)" src="https://img.esa.io/uploads/production/attachments/105/2024/02/28/1/281672b9-923b-4e20-93f2-7064fc9a3737.png">


- カテゴリに README が作られると、カテゴリ選択時に記事リストの上部に README の内容が表示されます

## 特定のカテゴリの記事を一括削除する

特定のカテゴリ以下の記事を一括削除することができます。
この操作は、Owner 権限を持つメンバーのみが可能です。また操作は取り消しができませんのでご注意の上行ってください。
詳しい方法は下記を参照ください。
- 参考: [help/特定のカテゴリの記事を一括削除する](/posts/330) 

## 特定のカテゴリのみをWebhookで通知する

Slackなどの外部ツールにWebhookを用いてesaの更新情報を通知する際に、特定のカテゴリのみを設定して通知することができます。

- Webhook 設定の __「Filter」__ の欄から、正規表現でカテゴリをフィルタして通知することができます。
- 例えば 「日報」カテゴリのみを通知したい場合は、下図のように Filter の欄に `^/日報/` と入れることで、 「日報」カテゴリ以下の記事の更新通知のみがWebhookで受け取れます

![image.png (945.1 kB)](https://img.esa.io/uploads/production/attachments/105/2019/11/25/2/4df905d1-191d-4b39-a60e-e0b61ee2957c.png)

- 参考: [#10:  help/チャットやメールとの連携・Webhook・Mailhook](/posts/10) 


## 特殊なカテゴリ名

esa には特殊な機能を持つカテゴリ名が存在します。

### "Templates/"

__「Templates」__ という名前のカテゴリ以下に作られた記事は、記事の新規作成時のテンプレートとして利用されます。
- 参考: [#7:  help/投稿テンプレート](/posts/7) 

### "Archived/"

__「Archived」__ という名前のカテゴリ以下に作られた記事は、アーカイブされた記事として扱われます。
記事右上の「Clean Up」メニューからもアーカイブすることができます。
アーカイブすると、削除はされませんが検索結果で下位になる等、アクティブな記事と区別して扱うことができます。詳しくは下記リンクを参照ください。

- 参考: [#107:  help/記事の削除・アーカイブ](/posts/107) 

### "Users/[スクリーンネーム]/"

- タイトルをつけずに新規投稿を保存した場合、"Users/[スクリーンネーム]/Untitled" というタイトルが自動的に付きます。
- 分類が難しい個人的なメモ等に、このカテゴリ名を利用するのもおすすめです。

- 参考: [#294:  ProTip/2018/12/06/タイトルなしでの保存で「Users/screen_name/Untitled」で保存される](/posts/294) 


## カテゴリの並び順

カテゴリは、自動的に記事の多い順に並びます。

順序を固定したい場合は、`1. カテゴリ名` のような 「数字 + . (ドット・半角)」 で始まるカテゴリ名をつけた場合のみ、記事の多い順のカテゴリよりも上に昇順で表示 されます。

参考: [ReleaseNotes/2023/11/08/「数字 + . 」でカテゴリの並び順を固定できるようになりました - docs.esa.io](https://docs.esa.io/posts/502)

まとめると、カテゴリは以下の順で並びます。

1. README
    - ルート(`/`)のみ
1. `数字` + `.` で始まるカテゴリ
    - 同じ数字の場合辞書順
1. 記事の多い順のカテゴリ
    - ただし、日付のようなカテゴリは、最新の日付順
1. `Templates` カテゴリ
1. `Archived` カテゴリ
1. `(no category)`
    - カテゴリなしの記事