パソコンに道具を入れて、練習する場所を作る

Node.jsとコードエディターを用意し、コマンドを1行入力するところまで進めます。MacとWindowsで違う操作も分けて説明します。

目次

このページでは、EmDashを動かす道具と、作業用のフォルダーを用意します。 対象はMacまたはWindowsのパソコンです。アプリをダウンロードするので、インターネット接続も使います。

この準備が必要なのは、自分のパソコンでサイトを作る人です。用意されたサイトで記事を書く担当なら、通常、これらのソフトを入れる必要はありません。ブラウザーから管理画面へ入れるので、管理画面の見方から始めてください。

すでにNode.jsとコードエディターを使っている人は、Node.jsのバージョン番号と作業フォルダーを確認してサイトの起動へ進めます。道具の役割を知りたいときは始める前の説明を読んでください。

1. Node.jsとnpmを用意する

Node.jsはサイトのプログラムを動かすソフト、npmは必要な部品をそろえる道具です。初めて用意する場合は、Node.js公式のインストーラーで両方を入れられます。npm公式の導入案内(別タブで開く)

  1. ブラウザーでNode.jsのダウンロードページ(別タブで開く)を開きます。
  2. 自分のOSを選びます。MacはmacOS、WindowsはWindowsです。
  3. LTSと書かれた版を選び、番号がEmDashの条件である22.23.4以上か確認します。LTSは、長く保守される版を示す表示です。このガイドが参照したEmDashの導入資料は22.23.4を基準にしています。
  4. インストーラーをダウンロードします。Macは .pkg、Windowsは .msi が目印です。
  5. ダウンロードしたファイルを開き、画面の案内に沿ってインストールを完了します。

ダウンロードページには、コマンドを入力して導入する方法も載っています。この手順では、インストーラーのファイルを開く方法を使います。すでにバージョン管理ツールでNode.jsを入れている場合は、そのツールで使用する版を選びます。

2. Visual Studio Codeを用意する

ここからは、ファイルを編集するアプリとして**Visual Studio Code(VS Code)**を使います。

Macでは公式案内からダウンロードし、開いた画面でアプリを「アプリケーション」フォルダーへ移します。そこからVS Codeを起動します。Macの公式手順(別タブで開く)

Windowsでは公式案内のインストーラーを実行し、案内に沿って完了させます。スタートメニューからVS Codeを起動できます。Windowsの公式手順(別タブで開く)

次の説明では英語メニューの名前も添えます。表示言語によって文字が違っていても、同じ役割のメニューを探してください。

3. 練習する場所を作る

MacのFinder、またはWindowsのエクスプローラーで「書類」や「ドキュメント」を開き、emdash-practice という新しいフォルダーを作ります。

VS Codeの File → Open Folder(ファイル → フォルダーを開く)で、今作ったフォルダーを選びます。自分で作ったフォルダーに対する信頼確認が出たら、開いている場所を確かめて進めます。

左側のファイル一覧に emdash-practice が見えれば、作業場所を開けています。ここは複数の練習サイトを入れられる親フォルダーです。次のガイドで、その中に weekend-note というサイト用フォルダーを作ります。

ドキュメント/
└── emdash-practice/     ← 今、開くフォルダー
    └── weekend-note/   ← 次のガイドで作られる

この図の文字を入力する操作はありません。フォルダー同士の位置関係を表しています。

4. コマンドを入力する画面を開く

これから入力するのは、パソコンへの文字の指示です。Windowsでは「コマンドプロンプト」、Macではターミナルの画面を使います。 このガイドでは、どちらもVS Codeの中に開きます。以降、この場所を「コマンド入力画面」と呼びます。

VS Codeのメニュー名は、MacでもWindowsでも Terminal(ターミナル) です。「Windowsなのにターミナルと書いてある」と迷わなくて大丈夫です。

Windowsの場合:コマンドプロンプトを選ぶ

  1. VS Code上部の Terminal → New Terminal(ターミナル → 新しいターミナル)を選びます。
  2. 開いたパネルの +の隣の下向き矢印を押します。
  3. Select Default Profile(既定のプロファイルの選択)を選び、一覧から Command Prompt(コマンドプロンプト) を選びます。これは、次から何を開くかを決める設定です。
  4. もう一度 + を押します。今開いた画面の名前が cmd またはCommand Promptになっているか確認します。先に開いたPowerShellの画面は、そのままでは切り替わりません。
  5. 新しい画面に cd と入力し、Enterを押します。表示された場所の末尾が emdash-practice なら、作業場所は合っています。

最初に PowerShell が開いていても、操作ミスではありません。VS CodeのWindows向け初期設定ではPowerShellが選ばれています。このガイドのWindows用コマンドはコマンドプロンプトに合わせているので、上の手順で選びます。VS Codeの公式説明(別タブで開く)

Windows Terminalという別のアプリを、今回のために入れる必要はありません。 Windows Terminalは、コマンドプロンプトやPowerShellを中に開けるアプリです。コマンドプロンプト・PowerShell・Windows Terminalは、同じものの別名ではありません。Microsoftの説明(別タブで開く)

Macの場合:VS Codeのターミナルを開く

  1. VS Code上部の Terminal → New Terminal(ターミナル → 新しいターミナル)を選びます。
  2. 開いた画面に pwd と入力し、Enterを押します。
  3. 表示された場所の末尾が emdash-practice かを確認します。

Macには「ターミナル」という独立したアプリもありますが、今回はVS Codeの中の画面で進められます。

場所と、入力する位置を確かめる

違うフォルダーが表示されたら、VS Code左側のファイル一覧にある emdash-practice を右クリックし、Open in Integrated Terminal(統合ターミナルで開く)を選びます。Windowsでは、先にコマンドプロンプトを既定にしておきます。

%、$、> などは、入力待ちを示す目印です。その後ろに指示を入力します。この目印や、その前のフォルダー名をコピーする必要はありません。 VS Codeのターミナルの説明(別タブで開く)

5. コマンドを1行ずつ入力する

次の囲みの中だけをコピーして、今開いたコマンド入力画面へ貼り付け、Enterを押します。MacとWindowsのコマンドプロンプトで、同じ指示を使えます。

node --version

v22.23.4 のような番号が返れば、Node.jsを呼び出せています。これより新しい番号なら表示も変わります。次にnpmを確認します。

npm --version

こちらも番号が返れば使えます。入力する命令と、返ってきた結果は別です。返ってきた番号を、もう一度命令として入力する必要はありません。

コードの囲みの上にある言語名や、説明文、入力待ちの目印はコピーしません。複数行の手順は、1行実行して結果を確認してから次へ進みます。

ここで止まったら

起きたこと次に確かめること
command not found、または「認識されません」インストールが完了したか。VS Codeを終了して開き直し、番号を再確認する
Node.jsの番号が古い利用中の導入方法で版を更新し、新しく開いたコマンド入力画面で確認する
Windowsで npm.ps1 の実行が禁止されるPowerShellが開いていないか確認し、上の手順でコマンドプロンプトを新しく開く。今回の練習のために実行ポリシーを変更する必要はない
場所が emdash-practice ではない開いたフォルダーとコマンド入力画面の場所を確認し直す

Node.jsとnpmの番号が確認でき、コマンド入力画面の場所が emdash-practice なら準備完了です。そのままEmDashをローカルで起動するへ進みましょう。

公式の参照元

関連ガイド

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

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