はじめに

Magic Editor は、コーディング済みの静的 HTML/CSS を受け取り、ブラウザの画面で手で編集して、そのまま持ち出すためのエディタです。HTML や CSS を開かずに、文章を書き換え、画像を差し替え、ブロックを並べ替えられます。AI は使いません。編集するのは人か、API を呼ぶあなたのプログラムです。

受け取ってから持ち出すまで

1. 受け取る。 静的 HTML/CSS を ZIP で開きます。index.html と CSS・画像をまとめただけの ZIP も、プロジェクトフォルダ（magic://schemas/project/v2 の ZIP）も開けます。開いた ZIP は新しいプロジェクトになります。
2. 編集する。 ページを選び、画面の上で直接直します。保存のたびに HTML の検査を通し、通ったものだけを保存します。
3. 持ち出す。 「プロジェクトフォルダ（ZIP）をダウンロード」で、編集したフォルダを同じ形のまま持ち出します。

プロジェクトフォルダ

1 つのプロジェクトは、次のファイルをまとめたフォルダです。ZIP のまま開いて、ZIP のまま持ち出します。

フォルダの仕様は成果物の契約（magic-contract）が決めています。古い形（project/v1）のフォルダも、開くときに今の形に読み替えます。

保存と履歴

• 編集は、まずサーバー上の下書きに積まれます。「保存」を押すと、Nu HTML Checker と成果物の契約で検査し、通ったときだけ保存版にします。
• 保存した変更は履歴に残り、「元に戻す」「やり直す」で行き来できます。
• 同じプロジェクトを同時に編集できるのは、1 つの画面（またはプログラム）だけです。ほかで編集中のときは、その様子を見ることはできますが、変更はできません。

使い始めるには

• アカウントは事務局が発行します（招待制）。受け取ったメールアドレスとパスワードでログインし、「アカウント」で最初のパスワードを変えてください。
• 画面の使い方は サービス画面の使い方、プログラムから使う方法は API を見てください。
• 作ったプロジェクトの一覧・名前の変更・削除は、管理画面で行えます。