wordpress-theme-to-emdash

WordPress テーマを EmDash に移植する

テーマの関連するレイアウトとインタラクションを、EmDash をバックエンドとする Astro サイトとして再現します。ユーザーが求めるビジュアルの忠実度と機能範囲を維持してください。すべての WordPress テンプレートやデモ機能が移植対象になるとは限りません。

現在の EmDash のスキーマ、クエリ、レンダリング、キャッシュ、シードのパターンについては、building-emdash-site を読み込んでください。ライブの参照サイトを利用できる場合は、レンダリング結果を比較するために agent-browser CLI を使用してください。コマンドのリファレンスは agent-browser skills get core --full を実行して確認してください。

参考情報を選ぶ

次の順序で、利用できる最適な情報源を使用してください。

1. テーマのソースと theme.json、スタイルシート、テンプレート、functions.php；
2. デスクトップとモバイルの代表的なビューポートで表示したライブデモ；
3. ユーザーから提供されたスクリーンショットやデザインファイル；
4. ソースが曖昧な場合の明示的なデザイン上の判断。

デモコンテンツや画像のライセンスがテーマコードと同じだと推測しないでください。ライセンスまたはユーザーの権利で使用が許可される場合に限り、アセットを再利用してください。それ以外の場合は、寸法や視覚的な重みが近い、ライセンスが明確な代替アセットを使用してください。

移植を計画する

依頼されたサイトに必要なページタイプ、コンポーネント、レスポンシブ状態、インタラクションだけを洗い出します。実装する前に、WordPress の役割を次のように対応付けてください。

• PHP テンプレートは Astro のルート、レイアウト、コンポーネントになります。
• カスタム投稿タイプ、メタデータ、タクソノミーは EmDash のコレクション、フィールド、タクソノミーになります。
• テーマカスタマイザーの値はサイト設定または明示的なプロジェクト設定になります。
• メニューの場所は、テンプレートからクエリする名前付き EmDash メニューになります。
• サイドバーとウィジェットはウィジェット領域または通常の Astro コンポーネントになります。
• ショートコードやプラグインが担う動作には、別途プラグインの移行が必要になる場合があります。

テンプレート階層、functions.php の登録、テンプレートタグ、フック、ウィジェット、再利用可能なブロックを変換する場合は、WordPress テーマの概念マッピングを読んでください。

EmDash の動的コンテンツを扱うルートは、サーバーレンダリングのままにしてください。EmDash のメディアフィールドには EmDash の Image コンポーネントを使用します。通常のテーマアセットには Astro のアセット処理を使用できます。

範囲を絞ったフェーズで作業する

該当するフェーズのファイルだけを読んでください。

• 調査と参照情報の取得
• デザインの抽出
• テンプレートの変換
• EmDash の動的機能
• スキーマとシードデータ
• レンダリング結果の検証

独立したテーマプロジェクトを作成する場合は、リポジトリの現在のサイトテンプレートまたはユーザーの既存プロジェクトを起点にしてください。書き込みを始める前に保存先を確認し、明示的な指示がない限り既存のサイト構成を置き換えないでください。

結果を検証する

サイトをビルドし、対象範囲に含まれる各ページとインタラクションをテストします。レスポンシブナビゲーション、値が長いコンテンツや欠落しているコンテンツ、管理画面やテーマの動作が文字方向に依存する場合の RTL、関連する空状態やエラー状態を含め、同じビューポートで参照と比較してください。

ビジュアルの忠実度が受け入れ条件に含まれる場合は、変更前後または参照と結果のスクリーンショットを撮影してください。意図的な相違点、参照情報の不足、未対応の WordPress の動作、アセットの代替について報告してください。

ライセンスと帰属表示

ソーステーマの実際のライセンスと告知を確認してください。必要な著作権表示と帰属表示を維持し、再利用するコードには該当するライセンス文を含め、サードパーティのアセットは個別に明記してください。ソースが WordPress テーマであるというだけで、移植物を GPL-2.0-or-later と表示しないでください。