目次 — BLOCS ナレッジの歩き方

目次 — BLOCS ナレッジの歩き方

このエージェントには、Laravel 向けテンプレートエンジン blocs/blocs と管理画面パッケージ blocs/admin、ドキュメント生成 blocs/docs を体系的に学べるナレッジが登録されています。本ページはその地図です。

前提条件 / 編集方針

• 対象読者: Laravel（PHP）で Web アプリを開発するエンジニア。MVC・Composer・Blade の基礎知識があることを想定
• パッケージ構成: blocs/blocs（テンプレートエンジン）を中核とし、blocs/admin（管理画面自動生成）・blocs/docs（処理機能記述書・Excel）が連携する
• 記事構成: 章番号（no）は「1 = 概要 → 2 = テンプレート → 3〜5 = 管理画面 → 6 = docs → 7 = 逆引き・FAQ」の順で読み進める設計
• 記述の深さ: 各記事は実装に必要なコード例・設定ファイル・手順を含む。リファレンス系（2.1, 2.14, 5.1）は一覧・参照向け
• 情報基準: ナレッジ本文に明記がない場合、リポジトリ blocs / admin / docs のソースを正とする
• 関連ナレッジ: 本文中の他記事への参照は no で記載。双方向リンクはメタデータの link_to で管理

全体構成

ナレッジ一覧

クイックガイド

コースA: 短時間で全体像を掴む

1.1 → 1.2 → 2.1

パッケージの位置づけ、Laravel との処理フロー、テンプレート属性の一覧までを最短で把握する。

コースB: 管理画面を使い始める

1.1 → 3.1 → 3.2 → 3.3

インストール後、定義ファイルで画面を自動生成し、不要機能の整理と権限設定まで進める。

コースC: テンプレート記法を学ぶ

2.1 → 2.2 → 2.3 → 2.4 → 2.5 → 2.6 → 2.12 → 2.15 → 2.16

data-* 属性の基本に加え、バリデーション実行（Validate）と選択肢フォームまでを順に読む。

コースD: 画面をカスタマイズする

1.2 → 3.1 → 4.1 → 4.2 → 4.4 → 5.1

アーキテクチャを理解したうえで、自動生成画面の一覧・編集・レイアウトを手直しする。

コースE: 機能を拡張する

3.1 → 5.3 → 5.4 → 5.5 → 5.6

ボタン・モーダル・アップロード・コピー/並び替えなど、よく使う拡張機能をまとめて参照する。

疑問・エラーから引く

• やりたいことが決まっている → まず 7.1（逆引きレシピ集）
• エラーコードや挙動がおかしい → 7.2（FAQ）→ 必要なら 2.14（エラーコード一覧）
• 特定の data- 属性がわからない* → 2.1 の属性一覧から該当 no へ
• 定数・キャッシュキーの一覧 → 2.17（定数・環境設定リファレンス）
• Laravel なしでテンプレートを使う → 2.18
• ヘルパー関数の名前がわからない → 5.1（ヘルパー関数リファレンス）