コンテンツの操作

EmDash 管理画面を使って、エントリを最初の下書きから公開ページまで進めます。エディタは 下書きの変更を訪問者が見られるバージョンと分けて保持するため、保存と公開は 2 つの 別アクションです。

コレクションを開く

サイトの /_emdash/admin を開き、サインインします。サイドバーで Posts や Pages などの コレクションを選択します。

コレクションページはそのエントリを一覧します。ここから次ができます。

• Add New を選んでエントリを作成する
• エントリのタイトル、スラッグ、searchable とマークされたフィールドで検索する
• 公開状態、著者、バイライン、日付、ロケールでフィルタする
• 一括公開、下書きへの戻し、ゴミ箱への移動のためにエントリを選択する
• Trash を開いてエントリを復元または完全に削除する

エディタで使えるフィールドと公開機能は、コレクションのコンテンツモデルに依存します。 たとえば、コレクションはリビジョン、プレビュー、タクソノミー、検索をサポートできます。

エントリを作成して公開する

エントリには安定したコンテンツ ID と別のスラッグがあります。スラッグが変わっても ID は同じエントリを 識別し続けます。テンプレートは通常、getEmDashCollection() が返す URL 向け識別子を使います。 コンテンツの照会ガイド が両方の値を説明します。

リッチテキストを書く

Portable Text フィールドは、見出し、段落、引用、リスト、リンク、 画像、ギャラリー、コードブロック、表、HTML ブロック、再利用可能なセクション用のブロックエディタを提供します。インストール済みプラグインが ブロックを追加できます。

ツールバーで選択テキストを書式設定します。ブロックを挿入するには、段落の横のブロック追加コントロールを選ぶか、 / を入力して名前でブロックを検索します。画像とギャラリーのブロックは、画像フィールドと同じメディア ピッカーを開きます。

画像ブロックを選ぶと、その設定でその画像の使用を置き換えまたは削除し、 表示サイズ、整列、代替テキスト、キャプション、任意のツールチップを設定できます。Edit asset は 基になるメディアライブラリ項目を開き、アセットの変更や置換はそれを使う他のエントリに 影響し得ます。その区別は メディアライブラリ を参照してください。

下書きの変更を保存する

最初の保存のあと、エディタは入力を止めてから 2 秒後に変更を自動保存します。Save ボタンは Saving… から Saved に変わり、サーバーが下書きを受け入れたことを確認できます。 自動保存は現在の自動保存リビジョンを置き換え、一時停止ごとのチェックポイントで リビジョン履歴を埋めません。

編集シーケンスの一点をリビジョン履歴に残したいときは Save を選択します。保存が 失敗すると、エディタは未保存フィールドを残し、エラーを表示します。ボタンが Saved に戻るか、 未保存の作業を別の場所にコピーするまでページを離れないでください。

公開済みエントリでは、変更の保存は下書きだけを更新します。訪問者は引き続き 以前のライブリビジョンを受け取ります。保留中の版を確認するには Preview draft、公開版を確認するには Live View、下書きで置き換える準備ができたら Publish changes を使います。

公開済みエントリのスラッグ変更も同じ下書きフローに従います。公開 URL は自動保存時ではなく、 下書きを公開したときに変わります。

別の編集者と作業する

エントリを開くとそのエントリとロケールの編集ロックを取得します。別の人がすでに 開いている場合、EmDash はロック保持者を示し、2 つの選択肢を提示します。

• Open read-only は編集を受け付けずにエントリを表示するため、破棄される作業を入力できません。
• Take over はロックをあなたに渡します。相手は入力した内容を保持しますが、2 分以内に 相手のエディタはあなたがエントリを保持していると報告します。相手の次の保存は拒否されます。

ロックはエントリが開いているあいだ更新され、エディタを離れるかタブを閉じると解放されます。 ブラウザやコンピュータが解放せずに閉じた場合、ロックは最後の更新から 7 分後に期限切れになります。

ロックはロケールごとに独立しているため、2 人が同じエントリの異なる翻訳を編集できます。 スクリプトや API クライアントも、別の編集者がロックを保持しているあいだは、文書化された オーバーライドを使わない限り拒否されます。完全な API 動作は エントリ編集ロック を参照してください。

管理者は Content Types、そのコレクション、Edit locking でコレクションのロックをオフにできます。

変更を公開または予約する

公開と予約は別のコントロールを使います。

• Publish now は確認後に新しい下書きをライブにします。
• Publish changes は確認後に公開済みエントリの保留中の変更をライブにします。
• Schedule は新しいエントリまたは保留中の変更がライブになる時刻を設定します。
• Change schedule は既存の予約を更新します。
• Remove schedule は既存の予約を取り消します。
• Unpublish は公開照会からライブリビジョンを除き、予約を取り消し、編集可能な 下書きを保持します。

エントリを予約するには、まず保存し、公開サマリーの下で Schedule を選び、将来の 日時を選びます。エディタは予約に使うタイムゾーンを表示します。その時刻まで、 現在のライブリビジョンは公開のままです。新しいエントリでは、まだ何も公開されません。

Node.js デプロイは予約公開のスイープを自動実行します。Cloudflare Workers には Cron Trigger が必要です。Cloudflare スターターテンプレートには含まれます。既存のデプロイは 予約公開 に従ってトリガーを確認できます。

リビジョンを復元する

リビジョンをサポートするコレクションは、設定パネルに Revisions を表示します。展開して保存済み バージョンと、それらの間で変わったフィールドを見ます。リビジョンを選んで内容を確認し、 その版を再び使いたい場合は Restore を選択します。

復元は選択した内容を含む新しいリビジョンを作成します。それ以前のリビジョンは 消さないため、あとから完全なシーケンスを引き続き確認できます。

エントリを翻訳する

国際化が有効 なとき、Translations パネルは 現在のエントリの設定済みロケールを表示します。

各翻訳には独自のスラッグ、公開状態、予約、リビジョン履歴があります。コレクションページの ロケールセレクターで、一度に 1 つの言語を表示します。

コンテンツをゴミ箱に移す

エントリのアクションを開くか、コレクションページで 1 行以上を選び、Move to Trash を選びます。ゴミ箱のエントリは通常のコンテンツ照会に現れなくなりますが、コレクションの Trash タブでは利用可能です。

Trash から Restore を選んでエントリをコレクションに戻します。復元されたエントリは 予約なしの下書きとして戻ります。公開して公開状態にします。

コンテンツ作業を自動化する

REST API と EmDash CLI は同じ下書きと公開ワークフローをサポートします。コレクションフィールドは リクエストの data オブジェクト内に置きます。更新は下書きリビジョンを保存し、公開は別アクションです。 更新または公開時に最新の _rev 値を渡し、サーバーが新しい作業を置き換える代わりに 古い書き込みを拒否するようにします。

状態遷移、権限、競合、フックは コンテンツライフサイクルリファレンス を使います。 REST API リファレンス はリクエストとレスポンス本体を定義し、 CLI リファレンス は同等のターミナルコマンドを扱います。

Astro サイトで公開済みエントリをレンダーするには コンテンツの照会 へ、 再利用可能なファイルの追加と管理には メディアライブラリ へ進みます。