EmDashをローカルで起動する

自分のパソコンで練習用サイトを動かし、EmDashの管理画面を開きます。入力する場所、質問の選び方、終了と再開まで順番に説明します。

目次

このページの目標は、自分のパソコンで、記事を書くための管理画面を開くことです。インターネットに公開する作業はまだ行いません。

ここではVS Codeの中でコマンドを入力します。Macではターミナル、Windowsでは**コマンドプロンプト(Command Prompt)**を使い、Node.js用のStarterから始めます。パソコンの準備を済ませておいてください。

作業を始める前に

使うのは、ブラウザー、コマンド入力画面、Node.js、npmです。それぞれの役割は作業に使う道具と画面で説明しています。

Node.jsは、サイトのプログラムを動かす土台です。公式導入ガイド(別タブで開く)の条件は22.23.4以降です。コマンド入力画面を開き、次を1行ずつ入力して、Enterキーを押します。どちらもバージョンを調べるだけなので、作業フォルダーは問いません。

node --version
npm --version

数字が表示されれば、コマンドを呼び出せています。Node.jsの番号が条件に合うことも確かめます。「command not found」や「認識されません」なら、まだその道具を使える状態ではありません。Node.jsとnpmの導入を済ませ、コマンド入力画面を開き直してから確認してください。

1. サイトを入れる親フォルダーを選ぶ

これから作るサイトには、専用のフォルダーを1つ使います。名前は weekend-note にします。すでに同名の大切なフォルダーがある場合は、別の名前にしてください。

前のガイドで作った emdash-practice をVS Codeで開き、Terminal → New Terminal(ターミナル → 新しいターミナル)からコマンド入力画面を開きます。Windowsでは、画面の名前が cmd またはCommand Promptか確認してください。PowerShellならパソコンの準備の手順で選び直します。この親フォルダーの中に、これから weekend-note が作られます。

現在地は、Macでは pwd、Windowsのコマンドプロンプトでは cd で確認できます。表示された場所の末尾が emdash-practice かを確認します。

2. サイトを作る道具を起動する

選んだ親フォルダーのコマンド入力画面で実行します。

npm create emdash@latest

これは「EmDashのサイトを作り始めるための道具を呼び出す」という指示です。@latest は、実行時点で配布されている最新版を指定します。このガイドはEmDash 1.4.0の公式資料をもとにしています。あとから試す場合、質問や生成されるファイルが変わる可能性があります。

パッケージを取得してよいか質問されたら、create-emdash の取得であることを確認して進めます。(y) と出た場合は y を入力してEnterを押します。その後の選択肢は上下の矢印キーで選び、Enterで確定します。名前を聞かれたら文字を入力します。

質問この練習で選ぶもの意味
Project nameweekend-noteサイトを入れるフォルダー名
Where will you deploy?Node.jsNode.jsで動かす構成を用意する
Which template?Starter基本的な記事とページのあるひな型
Which package manager?npm今使っている部品管理の道具
Install dependencies?Yes必要な部品もそろえる

「dependencies」は、そのサイトを動かすのに必要な部品のことです。取得が終わるまで待ちます。途中で失敗した場合は、画面に出た失敗理由と再実行の案内を確認します。同じ名前で新しいサイトを何個も作り直す前に、作成済みのフォルダーが残っていないか見てください。

3. 作ったフォルダーへ移動して起動する

作成が終わったら、同じコマンド入力画面で次を1行ずつ実行します。

cd weekend-note
npm run dev

cd は、作業するフォルダーを移動する指示です。npm run dev は、そのサイトで用意された開発用の起動処理を実行します。

コマンド入力画面に http://localhost:4321/ のようなURLが表示されたら、それをブラウザーで開きます。番号は、ほかのプログラムが使っているかどうかで変わる場合があります。自分の画面に表示されたURLを使ってください。

起動中のコマンド入力画面は開いたままにします。文字が流れなくなっても、ブラウザーからサイトへのアクセスを待っている場合があります。

4. 管理画面の初期設定をする

表示されたサイトURLの末尾に /_emdash/admin/ を付け、ブラウザーで開きます。たとえば起動URLが http://localhost:4321/ なら、管理画面は http://localhost:4321/_emdash/admin/ です。

初めてのサイトでは、設定を順番に入力する画面が開きます。

  1. Site Titleには「週末ノート」と入力します。Taglineは、サイトの短い説明で、任意です。
  2. Include sample contentは選んだまま進めます。説明用の記事が入り、画面を確かめやすくなります。
  3. Your Emailに管理用のメールアドレス、必要ならYour Nameに名前を入力します。
  4. ブラウザーの案内に従い、パスキーを登録します。パスキーは、端末の認証などでログインするための仕組みです。
  5. Open the dashboardから管理画面を開きます。

この流れは公式の初期設定手順(別タブで開く)をもとにしています。パスキーの案内はOSやブラウザーによって変わるため、別の端末でも同じ画面になるとは限りません。

5. ここまでできたか確認する

管理画面で Posts と Pages が見つかり、サンプルの Welcome 記事を開けるか確認します。別タブでは、起動時のサイトURLを開き、読者向けの画面も見られるか確かめます。

片方は記事を書く画面、もう片方は読んでもらう画面です。この2つを開ければ、次のガイドの練習に進めます。

終了するときと、次回再開するとき

終了するときは、起動しているコマンド入力画面を選び、**Ctrl + C(MacでもControl + C)**を押します。Windowsで「バッチ ジョブを終了しますか」と出た場合は、Y を入力してEnterを押します。サイトが停止し、新しいコマンドを入力できる状態へ戻ります。

次回はVS Codeの File → Open Folder(ファイル → フォルダーを開く)で emdash-practice の中の weekend-note を開きます。新しいコマンド入力画面を開き、npm run dev を実行してください。作成済みのデータベースや画像の保存先を使って、前の作業を続けられます。

生成された .env には、設定を暗号化するための鍵が入ります。ファイルを他人に見せたり、公開する場所へ置いたりしないでください。保存先の役割は記事とファイルの保存場所で説明しています。

うまく開かないとき

症状最初に確認すること
package.json がないと言われるコマンド入力画面が weekend-note の中にいるか
ブラウザーで接続できない起動中のコマンド入力画面が残っているか。表示されたURLを使ったか
管理画面で設定が終わらないブラウザーの認証案内、画面のエラー、コマンド入力画面の表示
部品の取得に失敗した通信状態と、作成ツールが案内した再実行方法

次は管理画面の見方で記事を書く場所を確認し、最初の記事へ進みましょう。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。