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 name | weekend-note | サイトを入れるフォルダー名 |
| Where will you deploy? | Node.js | Node.jsで動かす構成を用意する |
| Which template? | Starter | 基本的な記事とページのあるひな型 |
| Which package manager? | npm | 今使っている部品管理の道具 |
| Install dependencies? | Yes | 必要な部品もそろえる |
「dependencies」は、そのサイトを動かすのに必要な部品のことです。取得が終わるまで待ちます。途中で失敗した場合は、画面に出た失敗理由と再実行の案内を確認します。同じ名前で新しいサイトを何個も作り直す前に、作成済みのフォルダーが残っていないか見てください。
3. 作ったフォルダーへ移動して起動する
作成が終わったら、同じコマンド入力画面で次を1行ずつ実行します。
cd weekend-note
npm run devcd は、作業するフォルダーを移動する指示です。npm run dev は、そのサイトで用意された開発用の起動処理を実行します。
コマンド入力画面に http://localhost:4321/ のようなURLが表示されたら、それをブラウザーで開きます。番号は、ほかのプログラムが使っているかどうかで変わる場合があります。自分の画面に表示されたURLを使ってください。
起動中のコマンド入力画面は開いたままにします。文字が流れなくなっても、ブラウザーからサイトへのアクセスを待っている場合があります。
4. 管理画面の初期設定をする
表示されたサイトURLの末尾に /_emdash/admin/ を付け、ブラウザーで開きます。たとえば起動URLが http://localhost:4321/ なら、管理画面は http://localhost:4321/_emdash/admin/ です。
初めてのサイトでは、設定を順番に入力する画面が開きます。
- Site Titleには「週末ノート」と入力します。Taglineは、サイトの短い説明で、任意です。
- Include sample contentは選んだまま進めます。説明用の記事が入り、画面を確かめやすくなります。
- Your Emailに管理用のメールアドレス、必要ならYour Nameに名前を入力します。
- ブラウザーの案内に従い、パスキーを登録します。パスキーは、端末の認証などでログインするための仕組みです。
- 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を使ったか |
| 管理画面で設定が終わらない | ブラウザーの認証案内、画面のエラー、コマンド入力画面の表示 |
| 部品の取得に失敗した | 通信状態と、作成ツールが案内した再実行方法 |