[HTML] Explain that http-equiv has nothing to do with HTTP headers whatwg/html@b6dd913

Author: triple-underscore

HTML-metadata-ja.html

@@ -163,8 +163,8 @@
 
 ●●options
 
-spec_date:2025-07-24
-trans_update:2025-07-25
+spec_date:2025-07-29
+trans_update:2025-07-30
 source_checked:240712
 page_state_key:HTML
 spec_status:LS
@@ -918,6 +918,13 @@
 尊重-:respect:~
 能性:potential:~
 打切られ:discontinueされ:打ち切られ
+企てて:contemplateして:~
+不一致:mismatch:~
+用心深く:cautiousに:~
+切替n:switch:切り替え
+事故:accident:~
+定着-:perpetuate:~
+劇的:dramatic:~
 
 	かまわない:free to
 	help
@@ -970,6 +977,26 @@
 	素早く:quickに
 	促す:encourage
 	より後に現れてはナラナイ:must come before
+	とは逆に:as opposed
+	誰か:someone
+	全くではないが，:almost, but not quite
+	まるっきり異なる:entirely unlike
+	まるっきり:entirely
+	指定-:present
+	2 種類:Two categories
+	兼ね合いを図る:balance the likelihood of
+	他のものに加えて:as with anything
+	あてになるかどうか疑わしい:there is insufficient confidence in the reliability
+	誰もが:anyone
+	前述した／:aforementioned
+	いずれにせよ:nonetheless
+	越したことはない:best off
+	にもかかわらず:despite
+	~~考える:think
+	書く者:writer
+	方が良くなる:the better choice
+	適用されない::un-applied
+	方へ進む:will go
 
 	●未分類
 供与-:contribute:~
@@ -984,7 +1011,6 @@
 ranking::::ランキング
 処理命令:processing instruction:~
 	処理命令:PI
-
 disk::::ディスク
 email::::メール
 iframe-srcdoc:iframe srcdoc
@@ -996,7 +1022,6 @@
 	最も近過去に:most-recently-
 manifest::::マニフェスト
 
-	指定-:present
 	deployment
 	暗くした:darker
 	-:leaving
@@ -1008,7 +1033,6 @@
 	選ぶ:choose
 	取り出され:take out
 	とされ:mark
-
 	American:米国
 	British:英国
 	Latin
@@ -1028,15 +1052,13 @@
 	閉じら:close さ
 	現れ:come
 	数えられ:count
-
 	扉:front
 	ような:labeled
 	大規模:large-scale
 	-:moment
 	時点で:moment
 	高速道路:motorway
 	news-organization:news organization:::ニュース配信組織
-
 	〜以上〜ままにある:period
 	:~point
 	:potential
@@ -1053,16 +1075,11 @@
 	明るい:bright
 	短い:short
 	近く:closely
-	2 種類:Two categories
 	に代えて:in preference to
 	終わるまで何もしない:doing nothing while waiting for 〜 to finish
-	兼ね合いを図る:balance the likelihood of
-	他のものに加えて:as with anything
 	~rankingを不当に操ろうと:game its ranking mechanism
 	近いうち:soon will be
 	挙げる:list
-	あてになるかどうか疑わしい:there is insufficient confidence in the reliability
-
 	秒数:time
 	後に生じた方の時点:as soon as the later of
 	ニュース配信サイトの第一面:A news organization's front page
@@ -1084,11 +1101,6 @@
 	-:certain
 	最終的:eventual
 	:against
-	とは逆に:as opposed
-	誰か:someone
-	全くではないが，:almost, but not quite
-	まるっきり異なる:entirely unlike
-	誰もが:anyone
 	先頭近く:the top of
 	1 ヶ月:a month
 	一方で:whereas
@@ -1099,8 +1111,6 @@
 	早々に:prematurely
 	各種／異なる:different
 	する際に:upon
-	前述した／:aforementioned
-	いずれにせよ:nonetheless
 	部位:part
 	一連の:sequence
 	~link先:in question
@@ -6066,6 +6076,80 @@ <h5 title="Pragma directives">4.2.5.3. ~pragma指令</h5>
 When the http-equiv attribute is specified on a meta element, the element is a pragma directive.
 </p>
 
+<div class="warning" id="warning-http-equiv-unrelated-to-http-headers">
+<p>
+その名前 `http-equiv$a にもかかわらず、
+~pragma指令は，~HTTP~headerとは ほぼ無関係である。
+［
+実装者／~web開発者
+］は、［
+それらが まるっきり別々なものであり，この名前は歴史的な事故である
+］と~~考えるに越したことはない。
+◎
+Despite the name http-equiv, pragma directives are almost entirely unrelated to HTTP headers. Implementers and web developers are best off thinking of them as entirely separate, and the name as being a historical accident.
+</p>
+
+<p>
+より詳細~には、
+`~refresh$stの処理~modelは，対応する `Refresh$h ~headerと同じだが、
+他の標準~化された~pragma指令の挙動は，
+類似に命名された~headerとは少なくとも少しは異なる
+（通例的には，劇的に異なる）。
+◎
+In more detail, although the refresh keyword has the same processing model as the corresponding `Refresh` header, every other standardized pragma directive has at least slightly different behavior than the similarly-named header. (And usually dramatically-different behavior.)
+</p>
+
+<p>
+［
+新たな文書~levelの~pragma／~HTTP~headerにより制御される切替n
+］を追加するよう企てている［
+実装者, 仕様を書く者
+］どちらも，この不一致について用心深くなるベキであり、
+既存の混同が定着しないよう，［
+~HTTP~headerと `http-equiv$a ~pragma
+］どちらにも同じ
+— あるいは類似な —
+挙動を追加することを避けるベキである。
+代わりに，次を考慮すること：
+◎
+Implementers or specification writers contemplating adding new document-level pragmas or HTTP header-controlled switches should be cautious about this mismatch, and avoid perpetuating the existing confusion by adding the same or similar behavior to both an HTTP header and an http-equiv pragma. Instead, consider＼
+</p>
+<ul>
+	<li>
+~HTTP~headerに限り供する。
+◎
+providing only an HTTP header,＼
+</li>
+	<li>
+<p>
+あるいは，文書~内~pragmaが必要になる場合、
+`meta$e に新たな
+— `charset$a 属性に利用される~modelに類似な —
+属性を追加する。
+◎
+or if an in-document pragma is needed, consider adding a new attribute to meta similar to the model used by the charset attribute.＼
+</p>
+
+<p>
+（~DOMは変異-可能なので、
+文書~内~pragmaは，避けた方が良くなることが多いことに注意。
+開発者が `meta$e 要素を［
+追加-／除去-／変異-
+］しない単純な事例においても、
+当の施策【そのような要素が指示する施策？ そのような要素を取扱うための施策？】は，［
+構文解析の間は適用されない
+］から［
+その間でも適用される
+］方へ進むことになる
+— それは、
+複階的な含意を伴い得る。）
+◎
+(Note that avoiding in-document pragmas is often the better choice, since the DOM is mutable. Thus, even in the simple case where the developer does not add, remove, or mutate meta elements, the policy will go from un-applied to applied during parsing, which can have complex implications.)
+</p>
+	</li>
+</ul>
+</div>
+
 <p>
 `http-equiv$a 属性は，`列挙d属性$であり、
 次に挙げる~keyword, とり得る状態, それらの対応付けが定義される：