JSONファイルから、記事の下書きを1本作る
コマンドに長文を直接書かず、ファイルを読み込んで下書きを作り、管理画面で確認します。
目次
原稿をファイルに用意すると、コマンドから記事を作れます。この実習では1本を下書きとして登録し、管理画面で内容を確認します。下書きの指定を付け、読者向けの一覧には出ないところまで確かめます。
先に用意するもの
写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。
以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。
起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。
ここからのコマンドはすべて weekend-note で実行します。MacならVS Codeのコマンド入力画面またはターミナル、Windowsならコマンドプロンプトです。npx emdash は、この練習サイトに入れたEmDashの操作用プログラムを呼び出します。--url は操作先で、毎回 http://127.0.0.1:4350 と指定します。
この教材の開発サーバーにだけ接続します。自分の会社のサイトへURLを差し替えて試す必要はありません。
1. 入力用のJSONファイルを開く
JSONは、名前と値を組にしてデータを表す書き方です。VS Codeで exercises/draft.json を開いてください。教材には次が入っています。
{
"title": "コマンドで作った週末ノート",
"excerpt": "まだ公開せず、管理画面で確認する練習です。",
"content": [
{
"_type": "block",
"_key": "p1",
"style": "normal",
"markDefs": [],
"children": [
{
"_type": "span",
"_key": "s1",
"text": "今日は公園を歩きました。",
"marks": []
}
]
}
]
}title がタイトル、excerpt が要約です。本文の content は、段落や見出しなどを分けて保存するPortable Textという形式です。この例では、text の「今日は公園を歩きました。」が本文になります。まずはこの文章だけを変えて試せます。
二重引用符やカンマも必要です。書式を崩さないように、最初は日本語の文字の部分だけを書き換えてください。外側に data という囲みを追加する必要はありません。
2. 下書きとして作成する
npx emdash content create posts --file exercises/draft.json --slug cli-practice --draft --url http://127.0.0.1:4350 --jsoncontent create posts は記事の入れ物 posts に1件作る操作です。--file は読むファイル、--slug はURL用の短い名前、--draft は下書きの指定です。--json は結果をJSONで表示します。
--draftを省くと記事が自動で公開されるため、この指定は残してください。
結果の id が記事の管理用IDです。status が draft になっていることを確認してください。次の実習でも使うので、IDを控えておきます。_rev は保存した版を識別する値です。
同じ名前で再び作成すると重複する場合があります。2本目を作るときは cli-practice-2 のようにslugを変えるか、作成済みの記事を更新します。
3. 管理画面と公開ページで確認する
管理画面の「記事」を開き、「コマンドで作った週末ノート」を探します。タイトル、要約、本文が入り、下書きで保存されていれば成功です。本文を自分で変えた場合は、その内容が表示されます。
次に http://127.0.0.1:4350/cards/ を開きます。新しい下書きが出ないことも確認します。「管理画面にはある」「公開用の一覧にはない」の両方を確かめましょう。
検証では下書きを作成でき、その後の更新でも下書きのまま保存できました。JSONが不正だと表示されたら、引用符やカンマを見直します。接続できない場合は、4350番で練習サイトが起動しているか、--url が合っているかを確認します。
次は古い版での上書きを止める実習で、このIDを使います。
終了するとき・次回続けるとき
npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押して停止します。入力待ちに戻ったあともサイトが動き続けている場合は、weekend-noteでnpx astro dev stopを実行します。次回は同じフォルダーでnpm run devを実行してください。初期データを入れるseedコマンドを繰り返す必要はありません。