From 95401568890e8b4f7aab38ffd361ca204a71ef19 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Mon, 14 Oct 2024 10:41:03 +0900
Subject: [PATCH 1/2] =?UTF-8?q?2024/07/26=20=E6=99=82=E7=82=B9=E3=81=AE?=
 =?UTF-8?q?=E8=8B=B1=E8=AA=9E=E7=89=88=E3=81=AB=E5=9F=BA=E3=81=A5=E3=81=8D?=
 =?UTF-8?q?=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 files/ja/web/html/comments/index.md | 69 +++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 files/ja/web/html/comments/index.md

diff --git a/files/ja/web/html/comments/index.md b/files/ja/web/html/comments/index.md
new file mode 100644
index 00000000000000..cc2bbceba60ded
--- /dev/null
+++ b/files/ja/web/html/comments/index.md
@@ -0,0 +1,69 @@
+---
+title: コメント
+slug: Web/HTML/Comments
+l10n:
+  sourceCommit: e4ec417e0f84b2fbd23fb37b236047fbdd215b68
+---
+
+{{CSSRef}}
+
+HTML の**コメント**は、マークアップに説明メモを追加したり、文書内の特定の箇所をブラウザーに解釈させないようにしたりするために使用します。
+
+コメントは文字列 `<!--` で始まり、文字列 `-->` で終わります。通常、その間にはテキストが含まれます。このテキストは文字列 `>` または `->` で始めることはできません。また、文字列 `-->` または `--!>` を含むことも、文字列 `<!-` で終わることもできません。ただし、`<!` は許可されています。
+
+ブラウザーはコードをレンダリングする際にコメントを無視します。言い換えれば、コメントはページ上には表示されず、コード上にのみ表示されます。HTML コメントは、コードやロジックについて役立つメモを書く方法です。
+
+上記のことは、[XML](/ja/docs/Web/XML) コメントにも当てはまります。さらに XML、例えば [SVG](/ja/docs/Web/SVG) や [MathML](/ja/docs/Web/MathML) マークアップなどでは、コメントに文字列 `--` を格納することはできません。
+
+コメントは単一の行で使用することも、複数行にわたって使用することもできます。コメントは以下の場所で使用することができます。
+
+- {{Glossary("doctype")}} の前後
+- {{HTMLElement("html")}} 要素の前後
+- ほとんどの要素コンテンツ。ただし、{{HTMLElement("script")}}, {{HTMLElement("style")}}, {{HTMLElement("title")}}, {{HTMLElement("textarea")}} は、コンテンツを生のテキストとして解釈するため不可。
+
+> [!NOTE]
+> `<script>` 要素は HTML コメントを持たず、[JavaScript コメント](/ja/docs/Web/JavaScript/Reference/Lexical_grammar#コメント)を使用すべきですが、JavaScript に対応していない古いブラウザーではコンテンツがテキストとして表示されないように、スクリプトコンテンツ全体を HTML コメントで囲むという慣習が残っていました。これは現在では [JavaScript 自体の古い機能](/ja/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#html_コメント)であり、これに頼るべきではありません。
+
+## 構文
+
+```html
+<!-- コメント -->
+```
+
+## 例
+
+```html
+<!-- 1 行コメント -->
+
+<!--
+複数行に
+展開された
+コメント
+-->
+
+<!-- 下記のコメントは、内部の
+   HTML を無効にしている -->
+<!--
+<p>
+   このコンテンツは表示されません。
+</p>
+-->
+```
+
+## メモ
+
+HTML コメントはコンテンツとしてのみ許可されています。タグ内、例えば [HTML 属性](/ja/docs/Glossary/Attribute)の前に使用することはできません。
+
+`<!-- -->` コメント構文を使用するほとんどのプログラミング言語と同様に、コメントはネスト（入れ子）にすることができません。言い換えれば、`<!--` の後に出現した最初の `-->` が、コメントが閉じられたことを意味します。
+
+コメントは `<` で始まり `>` で終わりますが、コメントは HTML 要素ではありません。
+
+## 仕様書
+
+{{Specifications}}
+
+## 関連情報
+
+- [JavaScript のコメント](/ja/docs/Web/JavaScript/Reference/Lexical_grammar#コメント)
+- [CSS のコメント](/ja/docs/Web/CSS/Comments)
+- {{domxref("Comment")}} API（`Comment` は {{domxref("Node")}} を継承）

From 328f64924f7fa243631751a2782e99f75b0ad812 Mon Sep 17 00:00:00 2001
From: Masahiro FUJIMOTO <mfujimot@gmail.com>
Date: Mon, 14 Oct 2024 12:08:45 +0900
Subject: [PATCH 2/2] Update index.md

---
 files/ja/web/html/comments/index.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/files/ja/web/html/comments/index.md b/files/ja/web/html/comments/index.md
index cc2bbceba60ded..6908207e654296 100644
--- a/files/ja/web/html/comments/index.md
+++ b/files/ja/web/html/comments/index.md
@@ -21,8 +21,7 @@ HTML の**コメント**は、マークアップに説明メモを追加した
 - {{HTMLElement("html")}} 要素の前後
 - ほとんどの要素コンテンツ。ただし、{{HTMLElement("script")}}, {{HTMLElement("style")}}, {{HTMLElement("title")}}, {{HTMLElement("textarea")}} は、コンテンツを生のテキストとして解釈するため不可。
 
-> [!NOTE]
-> `<script>` 要素は HTML コメントを持たず、[JavaScript コメント](/ja/docs/Web/JavaScript/Reference/Lexical_grammar#コメント)を使用すべきですが、JavaScript に対応していない古いブラウザーではコンテンツがテキストとして表示されないように、スクリプトコンテンツ全体を HTML コメントで囲むという慣習が残っていました。これは現在では [JavaScript 自体の古い機能](/ja/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#html_コメント)であり、これに頼るべきではありません。
+> **メモ:** `<script>` 要素は HTML コメントを持たず、[JavaScript コメント](/ja/docs/Web/JavaScript/Reference/Lexical_grammar#コメント)を使用すべきですが、JavaScript に対応していない古いブラウザーではコンテンツがテキストとして表示されないように、スクリプトコンテンツ全体を HTML コメントで囲むという慣習が残っていました。これは現在では [JavaScript 自体の古い機能](/ja/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#html_コメント)であり、これに頼るべきではありません。
 
 ## 構文