パソコンに道具を入れて、練習する場所を作る
Node.jsとコードエディターを用意し、コマンドを1行入力するところまで進めます。MacとWindowsで違う操作も分けて説明します。
目次
このページでは、EmDashを動かす道具と、作業用のフォルダーを用意します。 対象はMacまたはWindowsのパソコンです。アプリをダウンロードするので、インターネット接続も使います。
この準備が必要なのは、自分のパソコンでサイトを作る人です。用意されたサイトで記事を書く担当なら、通常、これらのソフトを入れる必要はありません。ブラウザーから管理画面へ入れるので、管理画面の見方から始めてください。
すでにNode.jsとコードエディターを使っている人は、Node.jsのバージョン番号と作業フォルダーを確認してサイトの起動へ進めます。道具の役割を知りたいときは始める前の説明を読んでください。
1. Node.jsとnpmを用意する
Node.jsはサイトのプログラムを動かすソフト、npmは必要な部品をそろえる道具です。初めて用意する場合は、Node.js公式のインストーラーで両方を入れられます。npm公式の導入案内(別タブで開く)
- ブラウザーでNode.jsのダウンロードページ(別タブで開く)を開きます。
- 自分のOSを選びます。MacはmacOS、WindowsはWindowsです。
- LTSと書かれた版を選び、番号がEmDashの条件である22.23.4以上か確認します。LTSは、長く保守される版を示す表示です。このガイドが参照したEmDashの導入資料は22.23.4を基準にしています。
- インストーラーをダウンロードします。Macは
.pkg、Windowsは.msiが目印です。 - ダウンロードしたファイルを開き、画面の案内に沿ってインストールを完了します。
ダウンロードページには、コマンドを入力して導入する方法も載っています。この手順では、インストーラーのファイルを開く方法を使います。すでにバージョン管理ツールで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の場合:コマンドプロンプトを選ぶ
- VS Code上部の Terminal → New Terminal(ターミナル → 新しいターミナル)を選びます。
- 開いたパネルの +の隣の下向き矢印を押します。
- Select Default Profile(既定のプロファイルの選択)を選び、一覧から Command Prompt(コマンドプロンプト) を選びます。これは、次から何を開くかを決める設定です。
- もう一度 + を押します。今開いた画面の名前が
cmdまたはCommand Promptになっているか確認します。先に開いたPowerShellの画面は、そのままでは切り替わりません。 - 新しい画面に
cdと入力し、Enterを押します。表示された場所の末尾がemdash-practiceなら、作業場所は合っています。
最初に PowerShell が開いていても、操作ミスではありません。VS CodeのWindows向け初期設定ではPowerShellが選ばれています。このガイドのWindows用コマンドはコマンドプロンプトに合わせているので、上の手順で選びます。VS Codeの公式説明(別タブで開く)
Windows Terminalという別のアプリを、今回のために入れる必要はありません。 Windows Terminalは、コマンドプロンプトやPowerShellを中に開けるアプリです。コマンドプロンプト・PowerShell・Windows Terminalは、同じものの別名ではありません。Microsoftの説明(別タブで開く)
Macの場合:VS Codeのターミナルを開く
- VS Code上部の Terminal → New Terminal(ターミナル → 新しいターミナル)を選びます。
- 開いた画面に
pwdと入力し、Enterを押します。 - 表示された場所の末尾が
emdash-practiceかを確認します。
Macには「ターミナル」という独立したアプリもありますが、今回はVS Codeの中の画面で進められます。
場所と、入力する位置を確かめる
違うフォルダーが表示されたら、VS Code左側のファイル一覧にある emdash-practice を右クリックし、Open in Integrated Terminal(統合ターミナルで開く)を選びます。Windowsでは、先にコマンドプロンプトを既定にしておきます。
%、$、> などは、入力待ちを示す目印です。その後ろに指示を入力します。この目印や、その前のフォルダー名をコピーする必要はありません。 VS Codeのターミナルの説明(別タブで開く)
5. コマンドを1行ずつ入力する
次の囲みの中だけをコピーして、今開いたコマンド入力画面へ貼り付け、Enterを押します。MacとWindowsのコマンドプロンプトで、同じ指示を使えます。
node --versionv22.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をローカルで起動するへ進みましょう。
公式の参照元
- EmDash — Getting started (別タブで開く)
- Node.js — Download (別タブで開く)
- npm — Downloading and installing Node.js and npm (別タブで開く)
- Visual Studio Code — macOS setup (別タブで開く)
- Visual Studio Code — Windows setup (別タブで開く)
- Visual Studio Code — Terminal basics (別タブで開く)
- Visual Studio Code — Terminal profiles (別タブで開く)
- Microsoft — Windows Terminal (別タブで開く)