コンテンツ更新手順
ナレッジコンテンツを追加・更新する際の手順です。
1. コンテンツ管理の基本方針
マスターデータは content/internal/ のみ
content/internal/
{大テーマID}/ 例: ST/
{中テーマID}/ 例: ST-1/
{小テーマID}.md 例: ST-1-a.md- 編集・追加はすべて
content/internal/に対して行う - 各 tier（public / customer-standard / customer-premium）への反映は GitHub Actions が自動処理
公開設定は Excel で一元管理
docs/content-input.xlsx の public / validation / premium 列で公開 tier を指定します。
管理サイトの公開スイッチは廃止済みです（Excel が唯一の設定源）。
2. Excel でのコンテンツ更新
Excelファイルの場所
C:\Users\shu72\Box\50_AI_ENV\knowledge-base\docs\content-input.xlsxBox Drive で同期済み。エクスプローラーから直接開けます。
列構成
| 列 | 内容 |
|---|---|
| 大分類 | 参照用（自動表示・編集不可） |
| 中分類 | 参照用（自動表示・編集不可） |
| ID | 小テーマID（例: ST-1-a） |
| タイトル | ページタイトル |
| 説明文 | サブタイトル・説明 |
| タグ | カンマ区切り |
| public | TRUE/FALSE — 公開サイト掲載 |
| validation | TRUE/FALSE — Validation サイトに掲載 |
| premium | TRUE/FALSE — 顧客プレミアム掲載 |
| Item_1_title 〜 Item_20_notes | コンテンツ本体（最大20アイテム × 4列） |
列 A〜C（大分類・中分類・ID）は フリーズペイン で固定されています。
7,800行のスロットのうち、タイトルを入力した行だけが MD ファイルに変換・表示されます。
アイテム列の構造（1アイテム = 4列）
| 列名 | 内容 |
|---|---|
Item_N_title | アイテムの見出し |
Item_N_type | バッジ種別（下表参照） |
Item_N_body | 本文（Markdown 可） |
Item_N_notes | 補足・注意事項 |
Item_N_type の値
| 値 | バッジ表示 | 用途 |
|---|---|---|
policy | 【Policy】考え方・ポリシー | 方針・背景 |
method | 【Method】手法・理論 | フレームワーク・理論 |
process | 【Process】手順・進め方 | ステップ・フロー |
tool | 【Tool】ツール・テンプレ | 具体ツール・資料 |
data | 【Data】データ・指標 | KPI・数値・分析 |
reference | 【Reference】参考情報 | 外部情報・事例 |
3. 更新の流れ
- Box Drive で content-input.xlsx を開く
- 「テーマ一覧」シートを編集（タイトルを入力した行が有効になります）
- ファイルを保存して閉じる（開いたまま = ファイルロックで失敗します）
- 管理サイト → 「コンテンツ反映」タブ → 「▶ Excel を反映する」 ボタンをクリック
- GitHub Actions が起動し、数分後に全サイトへ自動デプロイ
管理サイトURL
https://knowledge-admin.torinoview.jp/（パスコード: 000000）
4. 画像のアップロード
管理サイトから画像をアップロード
管理サイトの 「画像管理」タブ から shared-public/images/ へ直接アップロードできます。
画像ファイルの命名規則
| 画像の種類 | ファイル名形式 | 例 |
|---|---|---|
| 大テーマ（ST ページ上部） | {大テーマID}.png | ST.png |
| 中テーマ ページのメイン画像 | {中テーマID}-main.png | ST-1-main.png |
| 小テーマ 詳細ページの上部画像 | {小テーマID}up.png | ST-1-aup.png |
ポイント: アンダースコア（
_）はファイル名に使用できません。ハイフン（-）を使用してください。
各ページは画像ファイルが存在する場合のみ表示します（存在しない場合は画像エリア非表示）。
対応フォーマット
.png / .jpg / .jpeg / .svg / .webp
画像のアスペクト比の目安
| 種類 | 推奨サイズ | 比率 |
|---|---|---|
| 大テーマ（DomainPage） | 1280×720px 以上 | 16:9（スライド） |
| 中テーマ メイン画像 | 任意 | 自動フィット |
| 小テーマ 上部画像 | 任意 | 自動フィット |
5. 公開設定の動作
| public | validation | premium | 動作 |
|---|---|---|---|
| true | true | true | 全サイトに全文掲載 |
| true | false | false | 公開サイトのみ |
| false | true | true | 顧客サイトのみ |
| false | false | false | 全サイトで非公開メッセージ |
6. 個別ファイルを直接編集する場合
bash
# content/internal/{大テーマ}/{中テーマ}/{小テーマ}.md を編集後
cd C:\Users\shu72\Box\50_AI_ENV\knowledge-base
git add content/internal/ST/ST-1/ST-1-a.md
git commit -m "コンテンツ更新: ST-1-a 説明文を修正"
git pushCloudflare Pages が自動ビルドします。
sync_tiers.pyは GitHub Actions 経由の場合のみ自動実行。
直接編集した場合、他 tier への反映が必要なら別途 Actions を手動トリガーしてください。
7. トラブルシューティング
| 症状 | 原因 | 対処 |
|---|---|---|
| 反映されない | Excel を閉じ忘れ | Excel を保存して閉じる |
| 反映ボタンが効かない | GitHub PAT 未設定 | 「バージョン管理」タブで PAT を設定 |
| Box Drive locked エラー | ファイルが同期中 | PC 再起動後に再試行 |
| 画像が表示されない | ファイル名ルール違反 | 命名規則（上表）を確認 |
| 検索が古い | ビルドキャッシュ | Cloudflare Pages のキャッシュをクリア（稀） |
