02
コンテンツの編集
Formモードでのセクション編集に加え、文書情報エリアとサブセクション目次の自動生成もご案内します。
新しいセクションの追加
新しいセクションファイルを作成する方法をご案内します。
- +ボタンをクリックサイドバー上部の「+」ボタンをクリックします。
- セクション情報を入力モーダルウィンドウで次の情報を入力します:
- 順序: 数字のみ (例: "3" → 番号は03に自動生成)
- 文書情報(番号なし): リリースノート・法的通知などはチェック
- Slug: 英小文字、数字、ハイフン(-)のみ (例: "new-feature")
- タイトル: 多言語タイトルを入力
- 作成完了✅ボタンをクリックすると、新しいセクションファイルが作成され、自動的に選択されます。
サブセクションの追加
セクション内にサブセクションを追加する方法をご案内します。
- +サブセクション追加ボタンをクリックFormモードで「+サブセクション追加」ボタンをクリックします。
- サブセクション情報を入力サブセクションの次の情報を入力します:
- ID: 一意の識別子 (例: "feature-overview")
- タイトル: 多言語タイトル
- 説明: 多言語説明 (オプション)
コンテンツの追加
サブセクションにStep Guide、InfoBox、Screenshot、Tableを追加する方法をご案内します。
コンテンツタイプ
Manual Editorは次の4つのコンテンツタイプをサポートします:
1. Step Guide: ステップバイステップガイド (画像を含むことが可能)
2. InfoBox: 情報ボックス (info, warning, tip, danger)
3. Screenshot: スクリーンショット画像
4. Table: 表 (manualTable)
- サブセクションを展開コンテンツを追加するサブセクションをクリックして展開します。
- コンテンツタイプを選択「+コンテンツ追加」ボタンをクリックし、希望するコンテンツタイプを選択します。
- コンテンツを編集選択したコンテンツタイプに合わせてフィールドを入力します。
ドラッグアンドドロップで順序変更
サブセクションとコンテンツの順序をドラッグアンドドロップで変更できます。
- 項目をドラッグ移動したいサブセクションまたはコンテンツ項目をクリックしてドラッグします。
- 目標位置にドロップ希望する位置にドラッグした後、マウスを離すと順序が変更されます。
文書情報エリア
リリースノート、法的通知、オープンソースライセンスなどは文書情報エリアを使います。製品表紙の目次の下に、セクション番号なしで表示されます。
- セクションファイルを開く(_product.yamlではない)文書情報は
_product.yamlでは設定しません。 セクション YAML ファイルを作成または開きます(例:90-release-notes.yaml、08-reference.yaml)。 - 文書情報(番号なし)を有効化Formモードで セクション情報 を開き、文書情報(番号なし) にチェックします。 またはYAMLモードで次を設定します: ``
yaml section: number: "" slug: release-notes order: 90 unnumbered: true title: ko: 릴리즈 노트 en: Release Notes`` - 製品表紙プレビューを確認保存してSanity同期後、製品表紙の 文書情報(目次の下)に番号なしで表示されます。 番号付き章は 目次 に残り、番号なしセクションは文書情報に移ります。
ヒント
- サイドバーで
_product.yamlを選ぶと表紙(目次+文書情報)をプレビューできます。 - 「参考・法的通知」などの既存セクションも、そのファイルで 文書情報(番号なし) を有効にすれば移動できます。
- 並び順は order で制御され、番号表示のみ非表示になります。
サブセクション目次の自動生成
セクションにサブセクションが3つ以上あると、ページ上部にタイトルリンクの目次が自動生成されます。
動作の仕組み
動作
- サブセクションが 3つ以上 のときだけ表示
- サブセクションタイトルをページ内リンクとして一覧表示
- クリックで該当サブセクション(
#id)へ移動 - 目次の手動編集は不要 — 各サブセクションのタイトルを使用
feature-overview)を入れてください。リンクのアンカーになります。注意
サブセクションが3つ未満のときは目次を出さず、短いセクションをすっきり保ちます。