ラベルの付け方とラベルページ
ラベルの付け方とラベルページ
ページにラベルを付けて分類し、同じラベルのページを横断的に一覧表示する機能です。
ラベルとは
ラベルはページに付ける 分類タグ です。フォルダ階層とは独立して、横断的にページを探せます。
例: api、onboarding、deprecated、security
ラベルを付ける
方法 A: スラッシュメニュー
- エディタで
/→ Label を選択 - 既存ラベルを選ぶか、新しいラベル名を入力
- ページ内にラベルチップが表示されます
方法 B: ページ詳細パネル
- ページ右側の詳細パネル（Details）を開く
- Labels セクションでラベルを追加・削除
Writer 以上 の編集権限が必要です。
ラベルページを開く
ラベルチップをクリックするか、次の URL に直接アクセスします。
/labels/:labelName
同じラベルが付いたページが一覧表示されます。複数ラベルが付いたページは、各ラベルページに表示されます。
ラベルと検索の組み合わせ
| 手段 | 用途 |
|---|---|
| ラベルページ | 特定カテゴリのページ一覧 |
| グローバル検索（Cmd+K） | キーワード・タイトルでの横断検索（No.7.3） |
| ページ階層 | Space 内の論理構造 |
ラベルは ステータス（draft、review-needed）や 横断トピック（security）の整理に向いています。
設計のヒント
| 原則 | 説明 |
|---|---|
| 少数の共通ラベル | 乱立させず、チームで一覧を決める |
| 命名規則 | 小文字・ハイフン（getting-started）で統一 |
| 廃止ラベル | deprecated で旧版ページを明示 |
→ ページ設計全般: 「ページの設計と書き方」（No.4.10）
権限
- ラベルの追加・削除: ページ編集権限（Writer 以上）
- ラベルページの閲覧: 各ページへのアクセス権に準じる
関連ナレッジ
- 検索: 「グローバル検索とページ内検索」（No.7.3）
- ページ設計: 「ページの設計と書き方」（No.4.10）
- スラッシュメニュー: 「スラッシュメニュー完全ガイド — 基本ブロック」（No.4.3）
- 運用: 「ドキュメント運用サイクル」（No.6.5）