コンテンツ要素：すべてのページを構成するブロック
定義、回答、ステップ、比較、エビデンス、通知、ナビゲーション、コンバージョンブロックの管理されたライブラリを使用して、作成者、ページ、機械、CMS間で各セクションがその機能を維持できるようにします。
要素とはコンテンツ契約です
名前、型、パラメータを持つブロックは、何が内部に属し、どれだけ含めることができ、どこに配置でき、システムがそれをどう処理できるかを定義します。
- ✓目的で命名 — 定義、警告、比較、ソース、CTAは、視覚スタイルではなく役割を説明します。
- ✓パラメータで制限 — ラベル、項目、引用、バリアント、制限により、即興の構造が逸脱するのを防ぎます。
- ✓ルールで配置 — 冒頭の回答、本文内の警告、末尾のソースブロック、次のステップのCTAは、ドキュメント内の異なる位置を占めます。
- ✓チャネルでレンダリング — 一つの要素が、HugoのセマンティックHTML、WordPressのネイティブブロック、構造化データ、フィードレコードになります。
コンテンツ要素とは
自由テキストは文を保存します。コンテンツ要素は文に加えて、それらの文が何をするのかという明示的な説明を保存します。
作成者が「チャーンとは？」というH2を追加し、その後に段落を続け、最初の文に太字スタイルを適用するかもしれません。読者はそれが定義であると推測できます。コンテンツシステムは見出しと散文しか認識しません。
その定義が正規のものか、冒頭付近に置く必要があるか、どの用語を定義しているか、どのくらいの長さでよいか、他のチャネルで再利用できるかはどこにも記録されません。
作成者はdefinition要素を挿入し、term（用語）、簡潔なbody（本文）、オプションの修飾子を指定します。要素契約が配置、アクセシブルなマークアップ、長さ、表示を制御します。
テンプレートはそれをレンダリングでき、監査はそれを見つけられ、移行はそれをマッピングでき、回答システムは定義を周囲の説明から区別できます。
要素とは、名前、型、パラメータを持つコンテンツブロックです。「名前」は安定したIDを与えます。「型」は動作に結び付けます。「パラメータ」とは、その意味のある部分が未分化の塊ではなくフィールドであることを意味します。また、配置ルール、コンテンツ制限、バリアント、アクセシビリティ要件、スキーママッピング、QAチェックも持ちます。
これは散文を排除するものではありません。定義、警告、ソースノートには依然として正確な文章が必要です。それは散文の役割に関する曖昧さを排除します。異なるレコードが一つのスキーマを共有しながら異なるデータを含むのと同じように、言語は契約を尊重しつつ変化することができます。
要素がコンテンツブリーフに勝る理由
散文ブリーフは望ましいページを記述できます。型付き要素は、ブリーフが編集者の画面を離れた後も、その重要な決定を維持します。
目標はすべてのページを同一に見せることではありません。繰り返される機能が予測可能に動作することです。ケーススタディと用語集のページは異なるトーンとレイアウトを持ちながら、ソースはクエリ可能で、関連コンテンツブロックは管理されたままです。
要素優先順位ルール
要素の目的がセクションの機能と一致する場合、その要素は必須です。たとえ見出しと段落で同じ言葉を表示できたとしてもです。自由テキストはデフォルトではなく、フォールバックです。
アウトラインのラベルだけを検索しないでください。「臨床的考慮事項」には警告が隠れているかもしれません。「一目で」はキーテイクアウェイを意味するかもしれません。読者のタスクを明確にしてください：定義する、要約する、警告する、比較する、指示する、証明する、ナビゲートする、変換する。
次に目的ステートメントを確認してください。一致する目的はカスタム見出しよりも優先されます。なぜなら、型は表示可能なページの外でも機能を保持するからです。
自由テキストは分析、遷移、例、再利用可能な契約のない説明に適しています。要素を接続し、議論を展開するために使うべきであり、既存のコンポーネントを装うために使うべきではありません。
自由テキストのパターンが繰り返される場合は、ライブラリレビューのために記録してください。繰り返しは不足している要素を示唆するかもしれませんが、作成者がページごとに非公式のコンポーネントを作成すべきではありません。
| アウトラインの表現 | 目的 | 必要な選択 | 散文で失うもの |
|---|---|---|---|
| 「Xとは？」 | 一つの限定された意味を与える | 定義ボックス | 定義を文脈から確実に分離できません。 |
| 「助けを求めるタイミング」または「禁忌」 | リスク、結果、安全な行動を明記する | 警告ボックス | 停止条件に警告のセマンティクスがありません。 |
| 実用的な補足 | オプションの実行アドバイスを提供する | ヒントボックス | 補足が必須ステップと競合するか、その中に埋もれます。 |
| 上部の要約 | 裏付けのある結論を表示する | キーテイクアウェイ | 単なるリストには配置、制限、要約としての意味がありません。 |
| チェックするリスト | 完了状態を追跡する | チェックリスト要素 | 箇条書きはアクションと観察やステータスを区別しません。 |
チェックリストの例はリンクされていません。その詳細仕様は後のライブラリウェーブに属するためです。優先順位の判断は依然として適用されます。CMSが提供する場合は承認されたチェックリスト実装を使用し、完了状態を装飾的な箇条書きとして偽装しないでください。
型付きブロック vs プレーンテキスト
表示される文は同一です。型付きバージョンは、ダウンストリームシステムが推測せずに使用できるIDとフィールドを保持します。
カスタマーチャーンとは、測定期間中に顧客または購読者を失うことです。
保存形式
{ "heading": "カスタマーチャーンとは？",
"html": "<p>カスタマーチャーンとは…</p>" }機械出力： 見出しと汎用HTML。定義ステータス、用語、配置、再利用可能性は不明です。
カスタマーチャーンとは、測定期間中に顧客または購読者を失うことです。
保存形式
{ "type": "definition",
"term": "customer churn",
"body": "カスタマーチャーンとは…",
"position": "opening" }機械出力： アドレス可能なフィールド、バリデーション、セマンティックレンダリング、スキーママッピング、フィード適格性を持つ既知の定義。
違いは機能的であり、表面的なものではありません。コンポーネントを見出しと段落に置き換えると、読者は何も気づかないかもしれませんが、システムはバリデーション、分析、スキーママッピング、移行ロジック、ポートフォリオクエリを失います。型付き要素を自由テキストに置き換えることは、機能の喪失です。
11の要素グループ
各ライブカードは子ページのplaybookFamilyメタデータを反映しています。カウントは公開された要素ライブラリを説明し、後のウェーブで計画されています。
最初にお読みください — 他のすべての要素を管理する優先順位ルールです。
ID、発見、スキーマを管理するレコードです。
最初の画面：回答、要約、定義、方向づけ。
定義ボックス · ダイレクトアンサーブロック · 鮮度スタンプ · イントロフック · キーテイクアウェイボックス · 目次 · 対象者ブロックルール
画像、動画、図表とそのテキスト代替です。
注釈付きスクリーンショット · 音声・ポッドキャスト埋め込み · 図とイラスト · 画像ギャラリー · インライン画像 · インライン動画 · 動画埋め込み
商品、価格、在庫、構成。
在庫ブロック · 構成ブロック · オファーボックス · プロダクトカード · プロダクトスライダー
著者情報、レビュー、引用、社会的証明。
著者経歴ブロック · 免責事項ブロック · プルクオートと専門家引用 · レビュー済みブロック · レビューブロック · ソースと参考文献 · お客様の声 · 信頼バッジと認定 · 更新ログ
リンク、アンカー、次のアクション。
アンカーリンク · パンくずリスト · CTAブロック · 用語集リンクとツールチップ · インラインCTAボタン · 内部リンクモジュール · ミニバナー · ニュースレター登録 · 関連コンテンツブロック
営業時間、住所、地図、予約。
予約ブロック · 営業時間・連絡先ブロック · 地図ブロック · NAPブロック
ページの終わり方と、次に何を問うか。
一つの要素、3つの形式
すべての要素には一つの概念的な契約があり、ポータブルMarkdown、Hugo、WordPress用のアダプターがあります。
タイトルとオプションのアドバイス本文を持つヒントを考えてみてください。その目的、許可されるコンテンツ、アクセシビリティロール、配置、QAルールは一定です。表記法のみが変わります。
:::tip{title="クエリを安定に保つ"}
一度に一つの変数を変更してください。
:::ソースで読みやすく、サイトテーマに依存しません。
{{< callout type="tip" title="クエリを安定に保つ" >}}
一度に一つの変数を変更してください。
{{< /callout >}}アダプターが名前付きフィールドを承認されたコンポーネントにマッピングします。
<!-- wp:amicited/tip
{"title":"クエリを安定に保つ"} -->
<p>一度に一つの変数を変更してください。</p>
<!-- /wp:amicited/tip -->ネイティブエディターコントロールが同じ型とフィールドを保持します。
ポータビリティとはレンダリングされたHTMLをコピーすることではありません。各アダプターは同じ意味のある入力を受け入れ、同等の制約を適用し、チャネルに適した出力を生成します。フィールドを安全にマッピングできない場合、アダプターは可視的に失敗するか、管理されたフォールバックを文書化しなければならず、黙って意味を破棄してはいけません。
各要素ページの内容
各詳細ページは公開ガイダンスであり、プロダクション仕様です。これにより、それ以外では実装ごとに発生する推測が排除されます。
| 領域 | 回答される質問 | 防止される失敗 |
|---|---|---|
| 目的と非目的 | どのような役割を果たし、どの類似の役割は別の場所に属するか？ | 必須ステップを含むヒント、またはミニ記事になる定義。 |
| パラメータ表 | どのフィールドが必須、オプション、型付き、反復可能、制限付きか？ | 異なるデータを受け入れるアダプター、または一つのフィールドに隠れた複数のアイデア。 |
| 配置ルール | どこに、どのくらいの頻度で、何の隣に表示できるか？ | ページ途中に埋もれるテイクアウェイや、主張から切り離されたソース。 |
| バリアントギャラリー | どの名前付きバリエーションが存在し、それぞれいつ適切か？ | 公式バリアントを装ったビジュアルの一回限りの使用。 |
| 良い例と悪い例 | 準拠した例は、もっともらしい失敗例と何が違うか？ | 構文をコピーしながら目的を見逃すチーム。 |
| スキーママッピング | フィールドはHTML、アクセシビリティ、スキーマ、API、フィードにどのようにマッピングされるか？ | 表示コンテンツと機械出力の不一致。 |
| QA | 自動化で強制できることと、判断が必要なことは何か？ | 曖昧、誤り、古い、または誤配置されたコンテンツでのブロック公開。 |
自動化は必須フィールド、数、長さ、配置、識別子、URL、アダプターサポートをチェックできます。編集QAは正確さ、有用性、エビデンスの質、比例した強調、要素が読者のタスクに適しているかをチェックしなければなりません。
どの要素が必須か
必須とは、システムが基本的にすべての完全な投稿タイプでその機能を期待することを意味します。すべてのブロックが大きくまたは同一でなければならないわけではありません。
- フロントマター はID、所有権、発見、結合を確立します。
- イントロダクション は範囲と読者の適合性を確認します。
- キーテイクアウェイ は実質的なページで裏付けのある結論を表示します。
- FAQ は実際の残存質問を解決します。
- ソース は事実のサポートを追跡可能にします。
- 関連コンテンツ は次の学習経路を提供します。
- CTA は一つの比例したアクションを提供します。
- 用語が限定された意味を必要とする場合は定義を使用します。
- 明確な主要質問がある場合はダイレクトアンサーを使用します。
- 順序立った手順と検証可能な結果にはステップを使用します。
- 読者が一貫した基準で代替案を評価する場合は比較を使用します。
- オプションの改善にはヒント、重大なリスクには警告を使用します。
- ビジュアルが散文ほど効率的に伝えない場合は注釈付きメディアを使用します。
例外は重要です。短い用語集の定義に別途テイクアウェイは必要ないかもしれません。外部からサポートされた事実的主張のないページに可視的な参考文献は必要ないかもしれません。捏造された質問があるFAQはないより悪いです。投稿タイプの仕様がデフォルトを設定し、作成者は機械的にスロットを埋めるのではなく、正当な省略を文書化します。
まず該当する投稿タイプの仕様から始めてください。これにより、読者のタスクに対する通常の要素が順序付けられます。次にセクションごとに優先順位を適用してください。結果は白紙でも rigid なフォームでもありません。オリジナルの議論、エビデンス、例、トーンを許容する管理されたアセンブリです。
型付き要素によりエージェントは発明ではなく組み立てができる
要素ライブラリは、コンテンツシステムがドキュメントであることをやめ、機械が実行できるものになる場所です。宣言されたフィールドを持つブロックは、必要なものを持っているか、持っていないことが明確にわかります。
比較表には、比較可能なオプション、行ごとに明示されたディメンション、検証日が必要です。これらの入力のいずれかが存在しない場合、型付きブロックはエージェントに明確に失敗する場所を与えます。
自由散文にはそのような特性はありません。背後にデータのない表を依頼された場合、エージェントはとにかく表を生成し、発明されたセルは調査されたセルとまったく同じように見えます。
見出しを書く前に、目的別にライブラリをチェックしてください。この指示は、締切に追われる人間よりもエージェントの方がはるかに確実に従います。なぜならエージェントは毎回ライブラリ全体を本当に再読するからです。
これはエージェントの方が優れたオペレーターであるケースです。ルールは機械的であり、機械的なことはエージェントの得意分野です。
各要素は一度定義され、ポータブルMarkdownディレクティブ、Hugoショートコード、WordPressブロックとして表現されます。エージェントはポータブル形式に対して作業し、出力がどのCMSに届くかを知る必要はありません。
つまり、CMSを変更してもコンテンツシステムが無効にならず、エージェントを再教育する必要もありません。
要素は型付きであるため、コーパスに対してクエリを実行できます。どのページにソースブロックがないか。どの比較表に検証日がないか。どのダイレクトアンサーが制限を超えているか。
その監査は名前付きブロックから組み立てられたコンテンツに対してのみ実行できます。散文はクエリ不可であるため、散文ベースの品質管理は人間が読めるページ数を超えてスケールしません。
すべての要素ページには、必須フィールド、最小値と最大値、配置ルール、QAチェックリストを備えたパラメータ表が含まれています。それがエージェントが推測せずに構築するために必要な精度であり、同じ精度により人間が数分の一の時間で出力をレビュー可能にします。
コンテンツ要素 FAQ
コンテンツ要素とは、名前、型、パラメータを持つブロックであり、定義された目的、許可されるフィールド、配置ルール、長さ制限、レンダリング動作、品質チェックを備えています。コンテンツと機能を保存します。
ライブラリ要素が目的に合致しない場合に自由テキストを使用してください。分析、ナラティブ、遷移、独自の説明は多くの場合散文のまま残ります。確立された定義、警告、比較、ソース、CTAはそうではありません。
いいえ。契約は構造と機能を標準化するものであり、結論やトーンを標準化するものではありません。作成者は依然として議論、エビデンス、例、表現を選択します。
はい。ポータブルな契約はプレゼンテーションから独立しています。アダプターはバリデーションとセマンティクスを保持しながら、同じフィールドをネイティブ構文とマークアップにマッピングします。
スケール管理可能なブロックから1ページを構築する
無料チェック · 7日間お試し · クレジットカードが必要