Skip to content

Commit 8cc2930

Browse files
[http](structured fields) 諸々の編集
• “header” → “field” • 二重否定( unless it is not )の誤訳 • pad の対訳 • 余計に思われる訳注を除去 • 編集時の遺物を削除 • 新たなデータ型に関する訳注を追加 など
1 parent c79f7a0 commit 8cc2930

File tree

1 file changed

+59
-44
lines changed

1 file changed

+59
-44
lines changed

http-structured-fields-ja.html

Lines changed: 59 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -509,8 +509,9 @@
509509
有効桁数:significant digits:~
510510
生産器:producer::~
511511
消費器:consumer::~
512-
pad:
513-
~padするもの:padding
512+
補充-:pad:~
513+
補充:pad:~
514+
補充するもの:padding
514515
合成-:synthesize:~
515516
0 個以上の:optional
516517
等距離:equidistant:~
@@ -1166,14 +1167,16 @@ <h3>【この訳に特有な表記規約】</h3>
11661167

11671168
<p>
11681169
この仕様に定義される,すべての`有構造~data型$は、
1169-
より汎用な~data型(例:`~list$)と区別するため, %~sf型~名 (例: `~sf~list$)の様に表記される(
1170-
"sf" は `Structured Field^en の略語
1170+
より汎用な~data型(例:`~list$)と明瞭に判別-可能にするため
1171+
(例えば,これらの型を参照する他の仕様において),
1172+
%~sf型~名 (例: `~sf~list$)の様に表記される
1173+
( "sf" は `Structured Field^en の略語
11711174
— 原文では、
11721175
これらの型~名は, "`List^en" の様に大文字を用いて区別されている)。
11731176
`有構造~data型$は、
11741177
概念的には
11751178
( 汎用な~data型, とり得る値に対する制約 )
1176-
の組と捉えられる
1179+
の組として捉えれる
11771180
</p>
11781181

11791182
</section>
@@ -1201,7 +1204,7 @@ <h2 title="Defining New Structured Fields">2. 新たな有構造~fieldの定義-
12011204
<li>
12021205
<p>
12031206
当の~fieldは、
1204-
次のどれに該当するか識別すること
1207+
次に挙げる どれに該当するか識別すること
12051208
</p>
12061209
<ul>
12071210
<li>
@@ -1297,8 +1300,9 @@ <h2 title="Defining New Structured Fields">2. 新たな有構造~fieldの定義-
12971300
</p>
12981301

12991302
<p>
1300-
~field定義が この仕様を利用できるのは、
1301-
`~field値$の一部分ではなく,値~全体~用に限られる。
1303+
~field定義は、[
1304+
`~field値$の一部分ではなく,値~全体
1305+
]用に限り,この仕様を利用できる。
13021306
13031307
Field definitions can only use this specification for the entire field value, not a portion thereof.
13041308
</p>
@@ -1320,7 +1324,7 @@ <h2 title="Defining New Structured Fields">2. 新たな有構造~fieldの定義-
13201324
<p>
13211325
この仕様は、
13221326
実装が~supportする様々な構造の長さや個数~用に最小を定義する。
1323-
ほとんどの事例では最大~sizeは指定しないが
1327+
ほとんどの事例では,最大~sizeを指定しないが
13241328
策定者は,[
13251329
~HTTP実装が[
13261330
個々の~fieldの~size/
@@ -1518,11 +1522,10 @@ <h3 title="Preserving Extensibility">2.3. 拡張能の保全-法</h3>
15181522
未知な~keyが在っても
15191523
— および,値やその型が未知な場合も —
15201524
無視するよう要求することにより,前方-互換性も許容できる。
1521-
そうすれば,後続な仕様は
1522-
追加的な~keyを
1525+
そうしておけば
1526+
後続な仕様は,追加的な~keyを
15231527
— 適切な拘束も指定した上で —
15241528
追加できる。
1525-
【場合によっては、一部に限り無視するよう指定することもあろう(未知な型は許容しないなど)。】
15261529
15271530
Specifications that use Dictionaries can also allow for forward compatibility by requiring that the presence of -- as well as value and type associated with -- unknown keys be ignored. Subsequent specifications can then add additional keys, specifying constraints on them as appropriate.
15281531
</p>
@@ -1557,6 +1560,11 @@ <h3 title="Using New Structured Types in Extensions">2.4. 拡張における新
15571560
Because a field definition needs to reference a specific RFC for Structured Fields, the types available for use in its value are limited to those defined in that RFC. For example, a field whose definition references this document can have a value that uses the Date type (Section 3.3.7), whereas a field whose definition references RFC 8941 cannot because it will be treated as invalid (and therefore discarded) by implementations of that specification.
15581561
</p>
15591562

1563+
<p class="trans-note">
1564+
この節は、
1565+
`~sf表示~文字列$にも同様に適用される。
1566+
</p>
1567+
15601568
<p>
15611569
この制限は、
15621570
~fieldに対する将来の拡張にも適用される。
@@ -1867,10 +1875,11 @@ <h4 title="Parameters">3.1.2. ~sf~parameter群</h4>
18671875
]に結付けられる
18681876
`~sf~parameter群@
18691877
( `Parameters^en )は、
1870-
各[
1878+
それを成す各`~entry$map
1879+
18711880
`~sf~parameter@
1872-
( `Parameter^en )と称される`~entry$map
1873-
が次のように制約される`有順序~map$である:
1881+
( `Parameter^en )
1882+
が次のように制約される`有順序~map$である:
18741883
</p>
18751884
<ul>
18761885
<li>
@@ -1989,12 +1998,14 @@ <h4>3.1.2.1. ~sf~key</h4>
19891998
それは、
19901999
次のように制約される`文字列$である:
19912000
</p>
1992-
19932001
<ul>
19942002
<li>
1995-
1 個以上の,次に挙げる
2003+
空でない
2004+
</li>
2005+
<li>
2006+
どの文字も,次に挙げる
19962007
`~key文字@
1997-
のみからなる
2008+
である
19982009
⇒#
19992010
`~ASCII英小文字$,
20002011
`~ASCII数字$,
@@ -2267,6 +2278,10 @@ <h3 title="Items">3.3. ~sf~item</h3>
22672278
]は,どれも`文字列$であるが、
22682279
実装は,型に応じて別々に扱えるよう型~情報を保持する必要がある
22692280
( `B§ )。
2281+
】【
2282+
`~sf日時$, `~sf表示~文字列$は、
2283+
`~RFC 8941$ には無かった型である
2284+
— `2.4§を見よ。
22702285
</p>
22712286
22722287
An Item can be an Integer (Section 3.3.1), a Decimal (Section 3.3.2), a String (Section 3.3.3), a Token (Section 3.3.4), a Byte Sequence (Section 3.3.5), a Boolean (Section 3.3.6), or a Date (Section 3.3.7). It can have associated parameters (Section 3.1.2).
@@ -2423,7 +2438,7 @@ <h4 title="Strings">3.3.3. ~sf文字列</h4>
24232438
( `String^en )は、
24242439
次のように制約される文字列である
24252440
2426-
それを成すどの文字も,`制御~文字$以外の`~ASCII文字$【!`RFC0020$r】(すなわち, ` ^ch 〜 `~^ch )である
2441+
どの文字も,`制御~文字$以外の`~ASCII文字$【!`RFC0020$r】(すなわち, ` ^ch 〜 `~^ch )である
24272442
( `HTAB^P, `LF^P, `CR^P, 等々は除外されることに注意)
24282443
24292444
Strings are zero or more printable ASCII [RFC0020] characters (i.e., the range %x20 to %x7E). Note that this excludes tabs, newlines, carriage returns, etc.
@@ -2500,9 +2515,12 @@ <h4 title="Tokens">3.3.4. ~sf~token</h4>
25002515
</p>
25012516
<ul>
25022517
<li>
2503-
1 個以上の,次に挙げる
2518+
空でない
2519+
</li>
2520+
<li>
2521+
どの文字も,次に挙げる
25042522
`~token文字@
2505-
のみからなる
2523+
である
25062524
⇒#
25072525
`tchar$p に許容される~octet,
25082526
`:^ch,
@@ -2514,7 +2532,6 @@ <h4 title="Tokens">3.3.4. ~sf~token</h4>
25142532
25152533
</li>
25162534
</ul>
2517-
25182535
25192536
Tokens are short textual words that begin with an alphabetic character or "*", followed by zero to many token characters, which are the same as those allowed by the "token" ABNF rule defined in [HTTP] plus the ":" and "/" characters.
25202537
</div>
@@ -2655,7 +2672,6 @@ <h4 title="Dates">3.3.7. ~sf日時</h4>
26552672
`1970-01-01T00:00:00Z^c からの[
26562673
閏秒は除外した(場合によっては負な)秒数
26572674
]を表現する。
2658-
~Aaccordingly
26592675
~textな~HTTP~fieldにおけるそれらの直列化も,それに則って`~sf整数$に類似するが、
26602676
先頭の "`@^c" で判別される。
26612677
@@ -2807,7 +2823,7 @@ <h3 title="Serializing Structured Fields">4.1. 有構造~fieldの直列化-法</
28072823
28082824
28092825
~RET
2810-
— 当の~headerは直列化しない
2826+
— 当の~fieldは直列化しない
28112827
(すなわち, `field-name$p, `field-value$p 両者とも省略する)
28122828
28132829
If the structure is a Dictionary or List and its value is empty (i.e., it has no members), do not serialize the field at all (i.e., omit both the field-name and field-value).
@@ -3607,27 +3623,29 @@ <h4 title="Serializing a Byte Sequence">4.1.8. `~sf~byte列$の直列化-法</h4
36073623

36083624
<p>
36093625
`4648/3.2$rfc に従って、
3610-
符号化された~dataには, `=^ch を~padすることが要求される†
3626+
符号化された~dataには, `=^ch を補充する( `pad^en する)ことが要求される
36113627
36123628
The encoded data is required to be padded with "=", as per [RFC4648], Section 3.2.
36133629
</p>
36143630

3631+
<p class="trans-note">
3632+
すなわち、
3633+
符号化した結果の長さが 4 の倍数にならない場合,そうなるよう補充する。
3634+
</p>
3635+
36153636
<p>
36163637
同様に, `4648/3.5$rfc に従って、
3617-
符号化される~dataにおける~pad~bit††は 0 に設定するベキである
3618-
— 実装の拘束に因り,そうするのはアリでない限り
3638+
符号化される~dataにおける補充~bitを 0 に設定するベキである
3639+
— 実装の拘束に因り,それがアリでない場合を除き
36193640
36203641
Likewise, encoded data SHOULD have pad bits set to zero, as per [RFC4648], Section 3.5, unless it is not possible to do so due to implementation constraints.
36213642
</p>
36223643

3623-
<p class="trans-note">【†
3624-
すなわち、
3625-
符号化した結果の長さが 4 の倍数にならない場合,そうなるよう補充する。
3626-
】【††
3644+
<p class="trans-note">
36273645
~base64単位を成す 6 ~bitと~byte単位を成す 8 ~bitとのずれに因る不足分を(~byte列の末尾に)補充する~bit。
36283646
】【
36293647
構文解析器は、
3630-
~padに関しては,この~algoの出力より~~寛容な形式を受容する
3648+
補充~bitに関しては,この~algoの出力より~~寛容な形式を受容する
36313649
( `4.2.7§ )。
36323650
</p>
36333651

@@ -3723,7 +3741,7 @@ <h4 title="Serializing a Display String">4.1.11. `~sf表示~文字列$の直列
37233741
<ol>
37243742
<li>
37253743
~Assert:
3726-
%入力~文字列 は`~scalar値~文字列$である
3744+
%入力~文字列 は`~scalar値~文字列$である
37273745
37283746
If input_sequence is not a sequence of Unicode code points, fail serialization.
37293747
@@ -4029,11 +4047,8 @@ <h3 title="Parsing Structured Fields">4.2. 有構造~fieldの構文解析-法</h
40294047
</ul>
40304048

40314049
<p class="trans-note">【†
4032-
~algoにおいては、
4050+
~algoにおいては、
40334051
“構文解析を失敗させる” という句で指示される。
4034-
】【
4035-
どちらに従うかは、
4036-
当の~fieldの仕様にて規定されることもあろう。
40374052
</p>
40384053

40394054
<p>
@@ -4047,7 +4062,7 @@ <h3 title="Parsing Structured Fields">4.2. 有構造~fieldの構文解析-法</h
40474062

40484063
<p>
40494064
この要件は、
4050-
~headerを構文解析しない実装には適用されないことに注意
4065+
~fieldを構文解析しない実装には適用されないことに注意
40514066
例えば,`媒介者$には、[
40524067
`~message$を回送する前に,失敗している~fieldを剥取る
40534068
]ことは要求されない。
@@ -4976,7 +4991,7 @@ <h4 title="Parsing a Byte Sequence">4.2.7. ~sf~byte列の構文解析-法</h4>
49764991
</p>
49774992
<ul>
49784993
<li>
4979-
必要yなら~padするものを合成する
4994+
必要yなら補充するものを合成する
49804995
(下に与える`受信者$の挙動についての要件に注意)
49814996
</li>
49824997
<li>
@@ -5002,7 +5017,7 @@ <h4 title="Parsing a Byte Sequence">4.2.7. ~sf~byte列の構文解析-法</h4>
50025017
</p>
50035018
<ul>
50045019
<li>
5005-
`=^ch が適正に~padされていない場合でも
5020+
`=^ch が適正に補充されていない場合でも
50065021
( `4648/3.2$rfc を見よ)、
50075022
失敗するベキでない
50085023
— そうし得ないように環境設定されていない限り。
@@ -5012,7 +5027,7 @@ <h4 title="Parsing a Byte Sequence">4.2.7. ~sf~byte列の構文解析-法</h4>
50125027
Because some implementations of base64 do not allow rejection of encoded data that is not properly "=" padded (see [RFC4648], Section 3.2), parsers SHOULD NOT fail when "=" padding is not present, unless they cannot be configured to do so.
50135028
</li>
50145029
<li>
5015-
0 でない~pad~bitがある場合でも
5030+
0 でない補充~bitがある場合でも
50165031
( `4648/3.5$rfc を見よ)、
50175032
失敗するベキでない
50185033
— そうし得ないように環境設定されていない限り。
@@ -5027,7 +5042,7 @@ <h4 title="Parsing a Byte Sequence">4.2.7. ~sf~byte列の構文解析-法</h4>
50275042
— この仕様は、[
50285043
`4648/3.1$rfc,
50295044
`4648/3.3$rfc
5030-
における要件は緩めない
5045+
における要件を緩めない
50315046
50325047
This specification does not relax the requirements in Sections 3.1 and 3.3 of [RFC4648]; therefore, parsers MUST fail on characters outside the base64 alphabet and on line feeds in encoded data.
50335048
</li>
@@ -5562,7 +5577,7 @@ <h2 title="Implementation Notes">付録 B. 実装~向けの注記</h2>
55625577
汎用な実装は,完全な, かつ~algoに近く従うことが重要になる
55635578
— `1.1§ を見よ。
55645579
これを援助するため、
5565-
~communityは,共通な~test一式を
5580+
~communityは,共通な~test一式を
55665581
`https://github.com/httpwg/structured-field-tests@https://github.com/httpwg/structured-field-tests$
55675582
にて保守している。
55685583
@@ -5624,7 +5639,7 @@ <h2 title="ABNF">付録 C. ~ABNF</h2>
56245639
この節では、
56255640
`RFC5234$r による<abbr title="Augmented Backus-Naur Form">~ABNF</abbr>記法を利用して,有構造~fieldに期待される構文を具体化する。
56265641
しかしながら、
5627-
それは,構文を検証するためとして利用し得ない
5642+
それは,構文を検証するためとしては利用できない
56285643
— それだけでは捕捉されない要件もあるので。
56295644
56305645
This section uses the Augmented Backus-Naur Form (ABNF) notation [RFC5234] to illustrate the expected syntax of Structured Fields. However, it cannot be used to validate their syntax because it does not capture all requirements.

0 commit comments

Comments
 (0)