文書から貼り付けてページに公開する: エディターは何を保つべきか
貼り付け、プレビュー、下書きの再読み込みを通して構造、リンク、意味のあるリストを保つ編集画面を設計します。
記事の言語: 日本語

目次
イベントのプログラムは文書では完璧に見えた。サイトに貼り付けると、書体が3種類になり、演奏会の合間ほど広い余白ができ、番号は毎回1から始まる。1つの操作で直せる問題もある。残すべき情報と一緒に消さなければなくならない問題もある。
コンテンツエディターを設計するには、何を移すかを決めなければならない。言葉か、構造か、見た目か。通常は言葉とその配置の意味が必要で、見た目はサイトのルールに従うべきだ。「書式なしで貼り付け」は役立つこともあるが、見出し、リンク、リストを保つ万能な方法ではない。きれいな段落も、乱れた書体と同じくらい不適切な場合がある。
見た目が変わっても残るべき内容から始める
小さな祭りの架空のプログラムを考えよう。文書にはタイトル、会場への行き方、持ち物リスト、予約リンクがある。編集者はこれをCMSに移す。ページの読者が各セクションを見分け、案内の順序を読み、正しいアドレスを開けることを、正しい結果とする。印刷した紙のレイアウトをスマートフォン画面に再現する必要はない。
見出しは構造上の役割であり、単に大きく太い文字ではない。エディターでは、文字サイズを手動で選ばなくてもその役割を与えられるようにする。セクションのタイトルの大きさを変えたことで、構造上の役割が誤って消えてはいけない。逆に、装飾のために大きくした通常の段落が、自動的に文章の新しい区分レベルになるべきではない。
W3Cの技法H42は、見出しマークアップが支援技術に役割とレベルを伝え、構造に沿った移動を可能にすることを説明している。2つの画面で文字が似ているか以上のことを確かめる理由だ。見た目がよいだけでは、内容の整理に関する同じ情報が移されたとは確認できない。
ツールバーの名前は、編集者が正しい役割を選ぶ助けになるべきだ。「セクション見出し」は、その入力欄の実際のレベルに対応していれば、名前のないサイズ一覧より分かりやすいことがある。ページタイトル欄と本文欄が同じ機能を提供する必要はない。両方の内容が最終的な構造でどう組み合わさるかは、設計で決める。
リストもリストとして残る必要がある。各段落の前に点を打てば、自動的に同じ結果になるわけではない。番号付きの手順では、番号の継続と再開を確認しよう。「3」は3番目の手順かもしれず、数字を含む通常の文章かもしれない。エディターは、この違いを作者が意識して区別する機会を奪ってはならない。
祭りのプログラムでは、作業場所を準備する順番が重要だ。貼り付け後にすべての手順が1から始まるなら、「テキストは合っている」という説明だけでは足りない。持ち物リストが空白で区切られた1つの文になると、読者は一覧しやすさを失う。変換による異なる影響なので、受け入れ資料には別々のケースが必要だ。
リンクには表示名とアドレスがある。「予約」という名前が正しく見えても、編集者は両方を確認できるべきだ。貼り付けた文章が正しい機能に見える一方、前回のイベントの古いアドレスを保っていてはならない。文の一部をすべて再入力させるのではなく、リンクの設定を簡単に開けて編集の終了が分かるように設計しよう。
サイトのタイポグラフィ (ポーランド語)は、これらの役割がどう見えるかを決める。エディターは文書ごとの書体を自由に混ぜる方向ではなく、定められた組み合わせへ導くべきだ。引用や運営上の注意を強調する必要があるなら、色と余白を編集者に覚えてもらうより、名前のある種類を用意するほうがよい。
だからといってボタンを1つだけ残す必要はない。機能を絞ることは、内容に合っている場合に意味がある。手順を公開する会社の管理画面からリスト作成機能を削っても、仕事は簡単にならない。後から見つけて直す必要がある手作業の回避策に移るだけだ。
エディターに入るものと、見慣れているだけのもの
貼り付けは2つの保存形式の間の変換だ。元のアプリケーション、クリップボード、ブラウザ、エディターの設定が、ページに届く内容に影響する。操作のたびに編集者へ全過程を説明する必要はない。一方、「書式を保持する」と約束する前に、実際に確認した範囲は把握しておく必要がある。
CKEditor 5のPaste from Office文書は、構造と書式の保持が、そのエディターの設定で有効になっている機能に依存すると説明している。この制限には実用上の意味がある。見出しへの対応が、文書のすべての要素への対応を自動的に証明するわけではない。提供元の例は、依頼した会社の資料を使った試験の代わりにはならない。
一方、Tiptapのスキーマの文書は、許可されたモデルの外にある要素や属性は保持されないことを示し、対応する拡張機能がない太字を例にしている。ここでのスキーマとは、許されるコンテンツ構造の規則だ。作者が最初にエディターのコードを学ぶべきだという指示ではなく、動作を定めるための情報である。
Aeneia Designのエディターとコンテンツ部品の設計では、こうした制限をツール名、プレビュー、メッセージに落とし込める。会社が実際に使うプログラム、手順書、サービス説明を出発点にしよう。選んだライブラリと設定が技術上の境界を定め、設計がそれを編集者に分かる形にする。
両方が作業に合うなら、通常の貼り付けとプレーンテキストとしての貼り付けという2つのモードを定める。選んだ仕組みがそう動くなら、後者の説明には強調とリンクが失われることを含めるべきだ。必要な意味を消すこともあるので、「書式を修復」と呼んではいけない。編集者は、なぜその操作の後にリストを作り直す必要があるか分からなければならない。
すでに貼り付けた部分の書式を削除する場合も、範囲を決める。色と書体だけが消えるのか、見出し、リスト、リンクのアドレスも消えるのか。ボタン名、選択範囲の表示、結果は同じ内容を伝えるべきだ。1つの操作が場所によって違うものを説明なく削除すると、結果を予測しにくい。

広い範囲を変更する操作なら、結果を確認し、元に戻す方法が必要だ。特定の変更を元に戻すためのルール (ポーランド語)は、何が戻るかを決める助けになる。エディターではさらに、1回の取り消しが貼り付け全体を消すのか、最後の自動修正だけを消すのかを定める。編集者が後から文を追加していたら、通常の取り消し履歴では、その新しい変更が先に消えることもある。製品が対応していないのに、後の修正をすべて残して昔の貼り付けだけを取り消せると約束してはいけない。受け入れケースには実際の順序と、誤って取り消した変更をやり直す方法を示す。
表は別に判断すべきだ。選んだコンテンツモデルが表を扱えない場合、セルを順番に段落として貼り付けると、時間とイベントの関係が壊れることがある。名前のあるプログラム部品、時間を含む手作りのリスト、公開経路全体で実際に対応する表など、必要な代替を合意する。偶然の変換に判断を任せない。
挿入する場所も重要だ。同じ手順でも、空欄、段落の途中、既存のリストに入ることがある。2つの項目を手順2と3の間に貼り付けるとき、1つのリストを拡張したのか、別のリストを作ったのか編集者に分かるようにする。受け入れ資料には前後の両方を示す必要がある。貼り付けた言葉だけを確認しても、後の手順の番号が間違ったことや、最後の項目に組み込まれたことは分からない。
貼り付け後に見える写真も確認が必要だ。サイトのライブラリにすでに保存されているのか、アップロード待ちなのか、外部の場所を参照しているのかを確認する。設計ではシステムの実際の動作に合う状態を表示する。現在開いているエディターに画像が見えるだけでは、下書きを開き直した後も利用できる証拠にはならない。
これを、どんな内容を貼り付けても安全だという約束につなげてはいけない。許容データとその表示を技術的に制御するには別の実装が必要だ。編集者にとって重要なのは、どの要素を受け入れ、何を直す必要があり、損失なく前の状態に戻れるかという見える境界である。見栄えのよいツールバーは、そのどの情報の代わりにもならない。
対応していない要素がある場合、失われたことをどう伝えるか決める。文書にある参加者向けの注意書きや、参加条件を示す脚注が欠ければ、プログラムの意味が変わるかもしれない。削除した色すべてについて警告を出す必要はない。一方、欠けた要素のうち何を意識して補う必要があり、編集者がどう見つけるかは決めなければならない。仕組みが欠落を検出できないなら、完全な自動確認を装うのではなく、その種類の資料に対する明示的なチェックリストを用意する。
Aeneia Design
実際にサイトへ内容を移す際に使う文書を用意してください。保持された構造と修正が必要な要素を編集者が見分けられるよう、文章の役割、貼り付け規則、プレビューを一緒に設計します。会社のコンテンツに合ったエディターを相談する
プレビューは公開前に違いを見つけるためにある
編集画面は完成したページと同じに見える必要はないが、ページの制約を隠してはならない。編集者は、より広い列や構造を示す追加表示を使って作業できる。それでも実際の表示規則を使ったプレビューに進む方法が必要だ。そうでなければ、読者が決して見ないレイアウトを基に内容を承認することになる。
CMSでのコンテンツ公開プロセス (ポーランド語)は、下書き、承認、公開結果を分けている。ここではその前の問いを確認する。文書からページのモデルへ移した後も意味は保たれたか。試験用の祭りプログラムを公開する必要はない。よいプレビューなら、祭りの来場者に見せる前に結果を評価できる。
受け入れ資料には短くても扱いにくい断片を含めよう。例えば次のものだ。
- 小セクションを始める見出しと、似た見た目の通常文中の太字。
- 手順の間に説明があり、その後も番号が続く番号付きリスト。
- 短い表示名があり、アドレスを別に読まなければならないリンク。
- 時刻、長いイベント名、写真を含むプログラムの1行。
スクリーンショットを比較する前に、各断片の期待結果を説明する。見出しは正しい役割を保ち、番号は合意した順序を保ち、アドレスは表示名に対応し、写真は予定された保存経路を通る必要がある。意図的に削除するものも結果として記録する。外部のフォントがないことは正しい結果かもしれないが、手順の2番目がないことは違う。
チームが実際に文書をコピーするアプリケーションと、実際に使うブラウザで試験する。入力資料の版、エディターの設定、見つけた違いの説明を残す。これがなければ「貼り付けると崩れる」という問題を再現できない。アイコンの並びが似ているからといって、1つの動作をすべてのエディターに当てはめてもいけない。
貼り付け後に文を追加し、リンクを変え、保存して、下書きを開き直す。結果がまだプレビューと一致するか確認する。これにより、画面上の一時的な状態と、システムが実際に保存する内容の違いが分かる。クリップボードが内容を渡した瞬間に受け入れ確認を終えてはいけない。
スマートフォンで長い名前や文章、リスト、プログラムの区分を見る。別の記事ではインターフェースの長い名前と文章の設計 (ポーランド語)を扱う。A4の紙のレイアウトは、内容を変えずに別の見せ方が必要かもしれない。編集者に空白を並べて補わせてはいけない。インデントと余白は、画面幅が変わっても保たれるべき設計上のルールに属する。
エディターがコマンドパレットによる素早い操作を提供するなら、表示されたツールと同じ役割を与えるべきだ。別の記事ではコマンドパレットの設計 (ポーランド語)を扱う。「セクション見出し」へのショートカットが、単に文字を大きくすることを意味してはならない。異なる操作経路は、1つのコンテンツモデルを経て、ページ上の1つの分かりやすい結果につながる。
最後に読者の作業に沿って文書とプレビューを比べる。会場への行き方を見つけ、必要なものを持ち、正しい予約先を選ぶ。これらの情報が残り、見た目がサイトに合っていれば、エディターは役割を果たした。文書内の偶然の文字色を忠実に再現したことに、別のメダルを与える必要はない。











