タイトル: HTMLファイルの作成
SEOタイトル: HTML ファイル作成手順完全ガイド(雛形 / VS Code / Live Server / フォルダ構造)
| この記事の要点 |
|
必要なもの
- テキストエディタ: VS Code(無料・推奨) / Sublime Text / Notepad++ / Atom 等
- ブラウザ: Chrome / Edge / Firefox / Safari(動作確認用、複数あると望ましい)
- あれば便利: Git(バージョン管理)/ Node.js(ビルドツール)
手順1: フォルダを作る
# 任意の場所にプロジェクト用フォルダを作成
mkdir my-site
cd my-site
# 推奨フォルダ構成
mkdir -p assets/css assets/js assets/images
# 結果
# my-site/
# ├── index.html
# └── assets/
# ├── css/
# │ └── style.css
# ├── js/
# │ └── main.js
# └── images/
手順2: index.html を作る
エディタで新規ファイル → index.html で保存(UTF-8 / 改行 LF 推奨)。
My First Page
Hello, world!
これは私の最初の HTML ページです。
必須要素の解説
| 要素 | 役割 | 省略すると |
|---|---|---|
| HTML5 宣言、Standards Mode 切替 | Quirks Mode で CSS 崩れ |
lang="ja" | 言語指定(読み上げ / 翻訳) | スクリーンリーダーが英語読み上げ |
| 文字コード宣言 | 日本語が文字化け |
| モバイル表示倍率 | スマホで小さく表示 |
| タブ名 / 検索結果タイトル | "Untitled" 表示、SEO 0 点 |
| 検索結果の説明文 | 検索エンジンが本文から抽出 |
VS Code で爆速作成: Emmet
VS Code は Emmet という省略記法を標準搭載。空の .html ファイルで ! + Tab を押すだけで雛形展開:
# 空ファイルで「!」と打ち Tab を押す
! → [Tab]
# ↓ 一気に展開される
Document
VS Code 設定で lang="ja" にする
// .vscode/settings.json または ユーザ設定
{
"emmet.variables": {
"lang": "ja"
},
"emmet.includeLanguages": {
"blade": "html"
}
}
Emmet の便利スニペット
# よく使う Emmet 略記
ul>li*3 →
nav>ul>li*5>a → ナビゲーション 5 リンク雛形
.container>.row>.col*3 → Bootstrap 風グリッド
header+main+footer → セクション 3 つ並列
# 入力テキストや属性も
a[href="/about"]{About} → About
img[src="logo.png" alt="ロゴ"]
Live Server で自動リロード
HTML を保存するたびに手動でブラウザリロードするのは非効率。Live Server 拡張がおすすめ:
- VS Code 拡張機能から「Live Server」(Ritwick Dey 作)をインストール
index.htmlを右クリック → Open with Live Serverhttp://127.0.0.1:5500でブラウザが開く- ファイル保存 → 自動でブラウザリロード
Node.js が入っているなら
# npx で http-server を起動
npx http-server -p 8080
# または Live Server CLI
npx live-server
# Python が入っているなら
python3 -m http.server 8080
# → http://localhost:8080 で確認
画像 / CSS / JS の相対参照
ファイル構造に応じて相対パスで参照します:
推奨フォルダ構成(中規模まで)
my-site/
├── index.html ← トップ
├── about.html ← サブページ
├── contact.html
├── assets/
│ ├── css/
│ │ ├── reset.css
│ │ ├── style.css
│ │ └── responsive.css
│ ├── js/
│ │ ├── main.js
│ │ └── vendor/
│ │ └── jquery.min.js
│ ├── images/
│ │ ├── logo.svg
│ │ ├── hero.jpg
│ │ └── icons/
│ └── fonts/
│ └── noto-sans.woff2
├── pages/ ← 詳細ページ群
│ └── product-detail.html
├── .gitignore
├── README.md
└── package.json ← Node.js 使う場合
ファイル名の慣習
- 全て小文字:
index.html/about.html(大文字小文字を区別する OS 対策) - ハイフン区切り:
product-list.html(アンダースコアより SEO 上推奨) - スペース禁止:
my page.html→my-page.html - 日本語ファイル名禁止:
会社案内.html→about.html(URL エンコードで読みにくくなる) - トップは index.html: ほとんどの Web サーバが
/アクセスで自動配信
公開前のチェック: Lighthouse
Chrome DevTools 標準搭載の品質チェッカー:
- Chrome で対象ページを開く
- F12 で DevTools を開く
- Lighthouse タブを選択
- 「Analyze page load」をクリック
- Performance / Accessibility / Best Practices / SEO の点数(0〜100)が出る
最低限クリアしたい項目
alt属性がない画像 → 必ず追加labelがない form 要素 → 必ず追加- テキストのコントラスト不足 → 色を調整
meta descriptionがない → 追加titleが空 → 必ず設定- HTTPS でない → Let's Encrypt 等で対応
FAQ
Q: メモ帳で書けばいい?
A: 書けますが、シンタックスハイライト / 補完が無いのでミスが増えます。VS Code 等の無料エディタ推奨。
Q: 拡張子は .htm と .html どちら?
A: 現代は .html 一択。.htm は DOS 8.3 ファイル名制限時代の名残です。
Q: 1 ファイルに全部書いていい?
A: 学習用なら OK。実用では CSS / JS は別ファイル化、保守性 / キャッシュ効率で有利です。
Q: スマホで確認したい
A: Live Server なら同一 LAN のスマホから http:// でアクセス可。または ngrok で公開 URL 化。