ストーリー
Day 1の朝。計画に従って、まずは環境構築から始める。
キーボードに手を置く。9ヶ月前の自分なら、ターミナルを開くことすら怖かったかもしれない。
でも今は違う。
必要なツールの確認
作業を始める前に、必要なツールが使えるか確認します。
ツール一覧
| ツール | 用途 | 確認コマンド |
|---|---|---|
| ターミナル | コマンド操作 | (起動するだけ) |
| Git | バージョン管理 | git --version |
| SQLite3 | データベース操作 | sqlite3 --version |
| ブラウザ | Webページの表示確認 | (起動するだけ) |
| テキストエディタ | ファイルの編集 | (VSCodeなど) |
確認手順
ターミナルを開いて、以下のコマンドを実行してください。
# Gitのバージョン確認
git --version
# SQLite3のバージョン確認
sqlite3 --version
両方ともバージョン番号が表示されればOKです。
ヒント: ツールがインストールされていない場合
Git がない場合:
# macOS
xcode-select --install
# Ubuntu/Debian
sudo apt install git
SQLite3 がない場合:
# macOS(デフォルトで入っている場合が多い)
sqlite3 --version
# Ubuntu/Debian
sudo apt install sqlite3
プロジェクトフォルダの作成(月1の復習)
ディレクトリ構成
今回のプロジェクトのフォルダ構成を考えます。
graph TD
Root["~/projects/"] --> Project["internal-tools-page/\nプロジェクトルート"]
Project --> F1["index.html\nメインページ"]
Project --> F2["style.css\nスタイルシート"]
Project --> D1["data/\nデータ関連"]
D1 --> F3["tools.db\nSQLiteデータベース"]
Project --> D2["docs/\nドキュメント"]
D2 --> D3["daily/\n日報"]
D2 --> D4["report/\n報告書"]
Project --> F4[".gitignore\nGit除外ファイル"]
Project --> F5["README.md\nプロジェクト説明"]
style Root fill:#f3f4f6,stroke:#9ca3af,color:#6b7280
style Project fill:#dbeafe,stroke:#2563eb,stroke-width:2px,color:#1e40af
style D1 fill:#fef3c7,stroke:#d97706,color:#92400e
style D2 fill:#fef3c7,stroke:#d97706,color:#92400e
style D3 fill:#fef3c7,stroke:#d97706,color:#92400e
style D4 fill:#fef3c7,stroke:#d97706,color:#92400e
style F1 fill:#d1fae5,stroke:#059669,color:#065f46
style F2 fill:#d1fae5,stroke:#059669,color:#065f46
style F3 fill:#d1fae5,stroke:#059669,color:#065f46
style F4 fill:#d1fae5,stroke:#059669,color:#065f46
style F5 fill:#d1fae5,stroke:#059669,color:#065f46
フォルダ作成の実行
# ホームディレクトリに移動
cd ~
# projectsフォルダがなければ作成
mkdir -p projects
# プロジェクトフォルダを作成
mkdir -p projects/internal-tools-page
# プロジェクトフォルダに移動
cd projects/internal-tools-page
# サブフォルダを作成
mkdir -p data
mkdir -p docs/daily
mkdir -p docs/report
# 構成を確認
ls -la
確認
# ディレクトリ構造を確認
find . -type d
期待される出力:
.
./data
./docs
./docs/daily
./docs/report
.gitignore の作成
Gitで管理しないファイルを指定する .gitignore ファイルを作成します。
何を除外するか
| 除外対象 | 理由 |
|---|---|
*.db | データベースファイルはローカルで生成する |
.DS_Store | macOSのシステムファイル |
Thumbs.db | Windowsのシステムファイル |
*.swp | Vimの一時ファイル |
.gitignore の作成
以下の内容で .gitignore を作成してください。
cat > .gitignore << 'EOF'
# Database files
*.db
# OS generated files
.DS_Store
Thumbs.db
# Editor files
*.swp
*.swo
*~
# IDE
.vscode/
.idea/
EOF
確認
cat .gitignore
ヒント: なぜDBファイルを除外するのか
データベースファイル(*.db)はバイナリファイルです。Gitはテキストファイルの差分管理が得意ですが、バイナリファイルは差分が取れず、リポジトリサイズが大きくなります。
今回はSQLのCREATE TABLE文とINSERT文をファイルとして保存し、誰でもデータベースを再現できるようにします。
初期ファイルの作成
プロジェクトの骨格となるファイルを作成します。
index.html(空のテンプレート)
cat > index.html << 'EOF'
<!DOCTYPE html>
<html lang="ja">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>社内ツール紹介</title>
<link rel="stylesheet" href="style.css">
</head>
<body>
<!-- TODO: コンテンツを追加する -->
</body>
</html>
EOF
style.css(空のテンプレート)
cat > style.css << 'EOF'
/* 社内ツール紹介ページ スタイルシート */
/* TODO: スタイルを追加する */
EOF
確認
ls -la
期待される出力(一部):
.gitignore
index.html
style.css
data/
docs/
環境構築チェックリスト
すべての項目を確認してください。
| # | チェック項目 | 状態 |
|---|---|---|
| 1 | Gitが使える | [ ] |
| 2 | SQLite3が使える | [ ] |
| 3 | プロジェクトフォルダが作成された | [ ] |
| 4 | サブフォルダ(data, docs)が作成された | [ ] |
| 5 | .gitignore が作成された | [ ] |
| 6 | index.html のテンプレートが作成された | [ ] |
| 7 | style.css のテンプレートが作成された | [ ] |
まとめ
| ポイント | 内容 |
|---|---|
| ツール確認 | Git, SQLite3, ブラウザ, エディタ |
| フォルダ構成 | 用途ごとにサブフォルダを分ける |
| .gitignore | 管理不要なファイルを事前に除外 |
| テンプレート | 空のHTML/CSSファイルを準備 |
- 必要なツールがすべて使えることを確認した
- プロジェクトフォルダを作成した
- .gitignore を作成した
- 初期ファイルを作成した
次のステップへ
環境が整いました。
次のセクションでは、このプロジェクトフォルダをGitリポジトリとして初期化し、最初のコミットを行います。
推定読了時間: 45分