docs(10_Wiki): Dev 폴더 누락분 반영 — Topic_Programming으로 통합
이전 재구성 작업에서 Dev/ 폴더가 누락되었던 것을 반영. - Dev/Topic_Programming(중첩 폴더, 78개)은 Dev 자체 최상위 폴더들 (Architecture/Conventions/Engineering_Intelligence 등)과 완전 중복이라 제거. - Dev 최상위 엔지니어링 지식 폴더(Architecture/Conventions/Engineering_Intelligence/ Failure_Library/Generalized_Principles/Language/Pattern_Catalog/Platform_Guides/ Subsystems, 77개)는 이미 Topic_Programming/Topic_Programming에 더 최신 버전이 존재해 중복 제거(고유 콘텐츠 1개는 예외 처리하여 이동 보존). - Dev의 W3Schools 언어 튜토리얼 폴더(Topic_C/CPP/CSS/CSharp/HOWTO/HTML/Java/ JavaScript/PHP/Python/SQL/W3CSS, 1201개)는 전부 Topic_Programming 하위로 이동. - 에이전트 운영 상태(.astra/docs)는 그대로 유지, 콘텐츠 폴더만 정리. - Topic_Programming 최종 문서 수: 2784 → 3985.
This commit is contained in:
@@ -0,0 +1,124 @@
|
||||
---
|
||||
id: html-comments
|
||||
title: "HTML Comments"
|
||||
category: "Frontend"
|
||||
status: "draft"
|
||||
verification_status: "conceptual"
|
||||
canonical_id: ""
|
||||
aliases: ["HTML comment syntax", "comment tag", "comment out HTML", "hide HTML content", "HTML annotations"]
|
||||
duplicate_of: ""
|
||||
source_trust_level: "B"
|
||||
confidence_score: 0.90
|
||||
created_at: 2026-06-23
|
||||
updated_at: 2026-06-23
|
||||
review_reason: ""
|
||||
merge_history: []
|
||||
tags: ["html", "web", "frontend", "w3schools", "comments", "debugging"]
|
||||
raw_sources: ["https://www.w3schools.com/html/html_comments.asp"]
|
||||
applied_in: []
|
||||
github_commit: ""
|
||||
---
|
||||
|
||||
# [[HTML Comments]]
|
||||
|
||||
## 🎯 한 줄 통찰 (One-line insight)
|
||||
HTML comments are written between `<!--` and `-->`, are not displayed in the browser, and help document source code, hide content temporarily, and debug pages. [S1]
|
||||
|
||||
## 🧠 핵심 개념 (Core concepts)
|
||||
- **Comments are invisible** — HTML comments are not displayed in the browser, but they can help document your HTML source code. [S1]
|
||||
- **Comment syntax** — written as `<!-- Write your comments here -->`. The exclamation point (`!`) appears in the opening tag but not the closing tag. [S1]
|
||||
- **Documentation use** — comments can hold notes and reminders for the author. [S1]
|
||||
- **Hiding content** — comments can temporarily conceal content (a block, multiple lines, or a mid-line/inline section). [S1]
|
||||
- **Debugging aid** — comment out HTML lines individually to locate errors. [S1]
|
||||
|
||||
## 🧩 추출된 패턴 (Extracted patterns)
|
||||
- **Note/reminder pattern** — drop `<!-- reminder -->` markers near relevant markup. [S1]
|
||||
- **Block-hide pattern** — wrap one or many lines in `<!-- … -->` to remove them from rendering without deleting them. [S1]
|
||||
- **Inline-hide pattern** — `<!-- … -->` placed mid-line hides just that fragment. [S1]
|
||||
- **Debug-by-elimination pattern** — comment out lines one at a time to isolate the source of an error. [S1]
|
||||
|
||||
## 📖 세부 내용 (Details)
|
||||
HTML comments are not displayed in the browser, but they can help document your HTML source code. [S1]
|
||||
|
||||
**Comment syntax**
|
||||
The basic syntax for an HTML comment is the text written between `<!--` and `-->`. Note that the exclamation point (`!`) appears in the opening tag but not the closing tag. [S1]
|
||||
```html
|
||||
<!-- Write your comments here -->
|
||||
```
|
||||
|
||||
**Adding comments**
|
||||
Comments can include notifications and reminders. [S1]
|
||||
```html
|
||||
<!-- This is a comment -->
|
||||
|
||||
<p>This is a paragraph.</p>
|
||||
|
||||
<!-- Remember to add more information here -->
|
||||
```
|
||||
|
||||
**Hiding content**
|
||||
Comments can conceal content temporarily. [S1]
|
||||
```html
|
||||
<p>This is a paragraph.</p>
|
||||
|
||||
<!-- <p>This is another paragraph </p> -->
|
||||
|
||||
<p>This is a paragraph too.</p>
|
||||
```
|
||||
|
||||
Multiple lines can be hidden between the opening and closing comment delimiters. Comments are useful for debugging — comment out HTML lines individually to locate errors. [S1]
|
||||
```html
|
||||
<p>This is a paragraph.</p>
|
||||
<!--
|
||||
<p>Look at this cool image:</p>
|
||||
<img border="0" src="pic_trulli.jpg" alt="Trulli">
|
||||
-->
|
||||
<p>This is a paragraph too.</p>
|
||||
```
|
||||
|
||||
**Hiding inline content**
|
||||
Comments can obscure mid-code (inline) sections. [S1]
|
||||
```html
|
||||
<p>This <!-- great text --> is a paragraph.</p>
|
||||
```
|
||||
|
||||
## 🛠️ 적용 사례 (Applied in summary)
|
||||
The reminder note, the block-hidden paragraph/image, and the inline-hidden fragment above are the canonical applied examples from the source. No external project/commit applications found in the source.
|
||||
|
||||
## 💻 코드 패턴 (Code patterns)
|
||||
Basic comment (HTML):
|
||||
```html
|
||||
<!-- Write your comments here -->
|
||||
```
|
||||
Comment out a block of markup:
|
||||
```html
|
||||
<!--
|
||||
<p>Look at this cool image:</p>
|
||||
<img border="0" src="pic_trulli.jpg" alt="Trulli">
|
||||
-->
|
||||
```
|
||||
Hide an inline fragment:
|
||||
```html
|
||||
<p>This <!-- great text --> is a paragraph.</p>
|
||||
```
|
||||
|
||||
## ⚖️ 모순 및 업데이트 (Contradictions & updates)
|
||||
No contradictions found in the source.
|
||||
|
||||
## ✅ 검증 상태 및 신뢰도
|
||||
- **상태:** draft
|
||||
- **검증 단계:** conceptual (실제 적용 사례 발견 시 applied/validated로 승격 가능)
|
||||
- **출처 신뢰도:** B (W3Schools — widely used educational reference, not a primary standards body)
|
||||
- **신뢰 점수:** 0.90
|
||||
- **중복 검사 결과:** 신규 생성 (New discovery)
|
||||
|
||||
## 🔗 지식 그래프 (Knowledge Graph)
|
||||
- **상위/루트:** [[HTML Tutorial]]
|
||||
- **관련 개념:** [[HTML Introduction]], [[HTML Elements]], [[HTML Attributes]], [[HTML Quotations]]
|
||||
- **참조 맥락:** Referenced when documenting markup, hiding content during development, or debugging by elimination.
|
||||
|
||||
## 📚 출처 (Sources)
|
||||
- [S1] W3Schools — HTML Comments — https://www.w3schools.com/html/html_comments.asp
|
||||
|
||||
## 📝 변경 이력 (Change history)
|
||||
- 2026-06-23: Initial draft synthesized from the W3Schools "HTML Comments" page (Astra wiki-curation, P-Reinforce v3.1 format).
|
||||
Reference in New Issue
Block a user