Skip to content

Commit

Permalink
convert to markdown for some sections
Browse files Browse the repository at this point in the history
  • Loading branch information
@yin1999
yin1999 committed Aug 11, 2022
1 parent baffb98 commit 96118b1
Show file tree
Hide file tree
Showing 83 changed files with 5,766 additions and 7,201 deletions.
2 changes: 1 addition & 1 deletion files/zh-tw/web/api/formdata/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ translation_of: Web/API/FormData

實作 `FormData` 的物件可以直接利用 {{jsxref("Statements/for...of", "for...of")}} 語法結構來替代 {{domxref('FormData.entries()', 'entries()')}}：`for (var p of myFormData)` 等同於 `for (var p of myFormData.entries())`。

> **備註：**此特性適用於 [Web Workers](/zh-TW/docs/Web/API/Web_Workers_API)。
> **備註：** 此特性適用於 [Web Workers](/zh-TW/docs/Web/API/Web_Workers_API)。
## 建構式

Expand Down
4 changes: 2 additions & 2 deletions files/zh-tw/web/css/ime-mode/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -55,11 +55,11 @@ input[type=password] {
}
```

> **備註：**一般說來，公開的網站不該自行調整輸入法模式的行為。這個特性主要是給網際應用程式使用的。
> **備註：** 一般說來，公開的網站不該自行調整輸入法模式的行為。這個特性主要是給網際應用程式使用的。
Mac 版的 Gecko 1.9 中，若某欄位設定停用輸入法，則自該欄位移開輸入焦點時並無法自行恢復輸入法狀態，所以若使用 `disabled` 值，Mac 的使用者可能會碰上麻煩。

> **備註：**別僅僅仰賴停用輸入法的招術來避免使用者輸入擴充字元，因為即使輸入法被停用，使用者依然可自他處剪下擴充字元後貼到表單欄位中。
> **備註：** 別僅僅仰賴停用輸入法的招術來避免使用者輸入擴充字元，因為即使輸入法被停用，使用者依然可自他處剪下擴充字元後貼到表單欄位中。
### 規格出處

Expand Down
139 changes: 69 additions & 70 deletions files/zh-tw/web/http/authentication/index.md
View file

Large diffs are not rendered by default.

345 changes: 149 additions & 196 deletions files/zh-tw/web/http/basics_of_http/mime_types/index.md
View file

Large diffs are not rendered by default.

508 changes: 189 additions & 319 deletions files/zh-tw/web/http/browser_detection_using_the_user_agent/index.md
View file

Large diffs are not rendered by default.

195 changes: 102 additions & 93 deletions files/zh-tw/web/http/caching/index.md
View file

Large diffs are not rendered by default.

217 changes: 103 additions & 114 deletions files/zh-tw/web/http/cookies/index.md
View file

Large diffs are not rendered by default.

511 changes: 255 additions & 256 deletions files/zh-tw/web/http/cors/index.md
View file

Large diffs are not rendered by default.

84 changes: 35 additions & 49 deletions files/zh-tw/web/http/headers/accept/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,53 +3,41 @@ title: Accept
slug: Web/HTTP/Headers/Accept
translation_of: Web/HTTP/Headers/Accept
---
<div>{{HTTPSidebar}}</div>

<p><strong><code>Accept</code></strong> HTTP 請求標頭（以 <a href="/zh-TW/docs/Web/HTTP/Basics_of_HTTP/MIME_types">MIME type</a> 標示）會對伺服器告知用戶端可解讀的內容類型。伺服器可以透過 <a href="/zh-TW/docs/Web/HTTP/Content_negotiation">content negotiation</a> 來選用可行的協定，並以 {{HTTPHeader("Content-Type")}} 標頭告知用戶端。針對本標頭，瀏覽器可以根據完成請求的脈絡，來決定適合的數值：像是擷取 CSS 時，給予的值就會和圖片、影像、腳本不一樣。</p>

<table class="properties">
<tbody>
<tr>
<th scope="row">標頭類型</th>
<td>{{Glossary("Request header")}}</td>
</tr>
<tr>
<th scope="row">{{Glossary("Forbidden header name")}}</th>
<td>no</td>
</tr>
<tr>
<th scope="row">{{Glossary("CORS-safelisted request header")}}</th>
<td>yes, with the additional restriction that values can't contain a <em>CORS-unsafe request header byte</em>: <code>"():&lt;&gt;?@[\]{}</code>, Delete, Tab and control characters: 0x00 to 0x19.</td>
</tr>
</tbody>
</table>

<h2 id="語法">語法</h2>

<pre class="syntaxbox">Accept: &lt;MIME_type&gt;/&lt;MIME_subtype&gt;
Accept: &lt;MIME_type&gt;/*
{{HTTPSidebar}}

**`Accept`** HTTP 請求標頭（以 [MIME type](/zh-TW/docs/Web/HTTP/Basics_of_HTTP/MIME_types) 標示）會對伺服器告知用戶端可解讀的內容類型。伺服器可以透過 [content negotiation](/zh-TW/docs/Web/HTTP/Content_negotiation) 來選用可行的協定，並以 {{HTTPHeader("Content-Type")}} 標頭告知用戶端。針對本標頭，瀏覽器可以根據完成請求的脈絡，來決定適合的數值：像是擷取 CSS 時，給予的值就會和圖片、影像、腳本不一樣。

| 標頭類型 | {{Glossary("Request header")}} |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| {{Glossary("Forbidden header name")}} | no |
| {{Glossary("CORS-safelisted request header")}} | yes, with the additional restriction that values can't contain a _CORS-unsafe request header byte_: `"():<>?@[\]{}`, Delete, Tab and control characters: 0x00 to 0x19. |

## 語法

```plain
Accept: <MIME_type>/<MIME_subtype>
Accept: <MIME_type>/*
Accept: */*
// Multiple types, weighted with the {{glossary("quality values", "quality value")}} syntax:
Accept: text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, */*;q=0.8
</pre>
```

<h2 id="指令">指令</h2>
## 指令

<dl>
<dt><code>&lt;MIME_type&gt;/&lt;MIME_subtype&gt;</code></dt>
<dd>一個精確的 <a href="/zh-TW/docs/Web/HTTP/Basics_of_HTTP/MIME_types">MIME type</a>，例如<code>text/html</code>。</dd>
<dt><code>&lt;MIME_type&gt;/*</code></dt>
<dd>一個不指定子類的 MIME type。<code>image/*</code> 會配對到 <code>image/png</code>, <code>image/svg</code>, <code>image/gif</code> 和等圖片類型。</dd>
<dt><code>*/*</code></dt>
<dd>所有 MIME type</dd>
<dt><code>;q=</code> (q-factor weighting)</dt>
<dd>Any value used is placed in an order of preference expressed using relative <a href="/en-US/docs/Glossary/Quality_values">quality value</a> called the <em>weight</em>.</dd>
</dl>
- `<MIME_type>/<MIME_subtype>`
- : 一個精確的 [MIME type](/zh-TW/docs/Web/HTTP/Basics_of_HTTP/MIME_types)，例如`text/html`。
- `<MIME_type>/*`
- : 一個不指定子類的 MIME type。`image/*` 會配對到 `image/png`, `image/svg`, `image/gif` 和等圖片類型。
- `*/*`
- : 所有 MIME type
- `;q=` (q-factor weighting)
- : Any value used is placed in an order of preference expressed using relative [quality value](/zh-TW/docs/Glossary/Quality_values) called the _weight_.

<h2 id="示例">示例</h2>
## 示例

<pre>Accept: text/html
```plain
Accept: text/html
Accept: image/*
Expand All @@ -58,20 +46,18 @@ Accept: */*
// Default for navigation requests
Accept: text/html, application/xhtml+xml, application/xml;q=0.9, */*;q=0.8
</pre>
```

<h2 id="規範">規範</h2>
## 規範

{{Specifications}}

<h2 id="瀏覽器相容性">瀏覽器相容性</h2>
## 瀏覽器相容性

<p>{{Compat("http.headers.Accept")}}</p>
{{Compat("http.headers.Accept")}}

<h2 id="參見">參見</h2>
## 參見

<ul>
<li>HTTP <a href="/zh-TW/docs/Web/HTTP/Content_negotiation">content negotiation</a></li>
<li>Header with the result of the content negotiation: {{HTTPHeader("Content-Type")}}</li>
<li>類似標頭：{{HTTPHeader("TE")}}, {{HTTPHeader("Accept-Encoding")}}, {{HTTPHeader("Accept-Charset")}}, {{HTTPHeader("Accept-Language")}}</li>
</ul>
- HTTP [content negotiation](/zh-TW/docs/Web/HTTP/Content_negotiation)
- Header with the result of the content negotiation: {{HTTPHeader("Content-Type")}}
- 類似標頭：{{HTTPHeader("TE")}}, {{HTTPHeader("Accept-Encoding")}}, {{HTTPHeader("Accept-Charset")}}, {{HTTPHeader("Accept-Language")}}
68 changes: 28 additions & 40 deletions files/zh-tw/web/http/headers/age/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,60 +2,48 @@
title: Age
slug: Web/HTTP/Headers/Age
tags:
- Caching
- HTTP
- Response
- header
- Caching
- HTTP
- Response
- header
---
<div>{{HTTPSidebar}}</div>
{{HTTPSidebar}}

<p><code><strong>Age</strong></code> 標頭代表資源進到代理快取後，經過了幾秒。</p>
**`Age`** 標頭代表資源進到代理快取後，經過了幾秒。

<p><code>Age</code> 標頭通常接近 0。如果你拿到 <code>Age: 0</code> 代表資源剛剛才從後端伺服器抓進來；
不然通常會是快取當下與回應中 {{HTTPHeader("Date")}} 標頭的時間差。</p>
`Age` 標頭通常接近 0。如果你拿到 `Age: 0` 代表資源剛剛才從後端伺服器抓進來；
不然通常會是快取當下與回應中 {{HTTPHeader("Date")}} 標頭的時間差。

<table class="properties">
<tbody>
<tr>
<th scope="row">Header type</th>
<td>{{Glossary("Response header")}}</td>
</tr>
<tr>
<th scope="row">{{Glossary("Forbidden header name")}}</th>
<td>no</td>
</tr>
</tbody>
</table>
| Header type | {{Glossary("Response header")}} |
| ------------------------------------------------ | ---------------------------------------- |
| {{Glossary("Forbidden header name")}} | no |

<h2 id="Syntax">語法</h2>
## 語法

<pre class="brush: html">Age: &lt;秒數差&gt;
</pre>
```html
Age: <秒數差>
```

<h2 id="Directives">指令</h2>
## 指令

<dl>
<dt>&lt;秒數差&gt;</dt>
<dd>
<p>正整數，代表資源在代理快取放幾秒了。</p>
</dd>
</dl>
- <秒數差>
- : 正整數，代表資源在代理快取放幾秒了。

<h2 id="Examples">範例</h2>
## 範例

<pre>Age: 24</pre>
```plain
Age: 24
```

<h2 id="Specifications">Specifications</h2>
## Specifications

{{Specifications}}

<h2 id="Browser_compatibility">Browser compatibility</h2>
## Browser compatibility

<p>{{Compat("http.headers.Age")}}</p>
{{Compat("http.headers.Age")}}

<h2 id="See_also">See also</h2>
## See also

<ul>
<li>{{HTTPHeader("Cache-Control")}}</li>
<li>{{HTTPHeader("Expires")}}</li>
</ul>
- {{HTTPHeader("Cache-Control")}}
- {{HTTPHeader("Expires")}}
122 changes: 48 additions & 74 deletions files/zh-tw/web/http/headers/authorization/index.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,84 +8,58 @@ tags:
- Request header
- header
---
<div>{{HTTPSidebar}}</div>

<p>HTTP 請求中的 <strong><code>Authorization</code></strong> 是 user agent 用來向伺服器做身份認證（authentication）的憑證（credentials），
通常是在伺服器回應 {{HTTPStatus("401")}}
<code>Unauthorized</code> 狀態及 {{HTTPHeader("WWW-Authenticate")}} 標頭後才會在後續請求使用這個標頭。</p>

<table class="properties">
<tbody>
<tr>
<th scope="row">Header type</th>
<td>{{Glossary("Request header")}}</td>
</tr>
<tr>
<th scope="row">{{Glossary("Forbidden header name")}}</th>
<td>no</td>
</tr>
</tbody>
</table>

<h2 id="Syntax">語法</h2>

<pre class="brush: html">Authorization: &lt;type&gt; &lt;credentials&gt;</pre>

<h2 id="Directives">指令</h2>

<dl>
<dt>&lt;type&gt;</dt>
<dd><a href="/en-US/docs/Web/HTTP/Authentication#authentication_schemes">認證方式</a>，通常是 <a
href="/en-US/docs/Web/HTTP/Authentication#basic_authentication_scheme">"Basic"</a>。
其他方式可以參考：
<ul>
<li><a
href="http://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml">IANA
registry of Authentication schemes</a></li>
<li><a
href="http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html">Authentification
for AWS servers (<code>AWS4-HMAC-SHA256</code>)</a></li>
</ul>
</dd>
<dt>&lt;credentials&gt;</dt>
<dd>如果使用「Basic」方式，則憑證的格式會長的像這樣：
<ul>
<li>帳號、密碼會用冒號（:）串起來
（<code>aladdin:opensesame</code>）。</li>
<li>然後在以 <a
href="/en-US/docs/Glossary/Base64">base64</a>
編碼 (<code>YWxhZGRpbjpvcGVuc2VzYW1l</code>)。</li>
</ul>

<div class="note">
<p><strong>Note</strong>: Base64 編碼不是加密也不是雜湊（Hash）！就算用明文直接傳，
安全性也跟用 base64 編碼過一樣（base64 是可以解碼的）。最好用 HTTPS 搭配這種驗證方式。</p>
</div>
</dd>
</dl>

<h2 id="Examples">範例</h2>

<pre>Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
</pre>

<p>可以看看 <a href="/en-US/docs/Web/HTTP/Authentication"> HTTP authentication</a> 中的範例
教你如何在 Apache 或 nginx 上啟用 HTTP basic authentication 來保護你的網站。</p>

<h2 id="Specifications">規範</h2>
{{HTTPSidebar}}

HTTP 請求中的 **`Authorization`** 是 user agent 用來向伺服器做身份認證（authentication）的憑證（credentials），
通常是在伺服器回應 {{HTTPStatus("401")}}
`Unauthorized` 狀態及 {{HTTPHeader("WWW-Authenticate")}} 標頭後才會在後續請求使用這個標頭。

| Header type | {{Glossary("Request header")}} |
| ------------------------------------------------ | ---------------------------------------- |
| {{Glossary("Forbidden header name")}} | no |

## 語法

```html
Authorization: <type> <credentials>
```

## 指令

- \<type>
- : [認證方式](/en-US/docs/Web/HTTP/Authentication#authentication_schemes)，通常是 ["Basic"](/en-US/docs/Web/HTTP/Authentication#basic_authentication_scheme)。其他方式可以參考：

- [IANA registry of Authentication schemes](http://www.iana.org/assignments/http-authschemes/http-authschemes.xhtml)
- [Authentification](http://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html) for AWS servers (`AWS4-HMAC-SHA256`)
- \<credentials>
- : 如果使用「Basic」方式，則憑證的格式會長的像這樣：

- 帳號、密碼會用冒號（:）串起來（`aladdin:opensesame`）。
- 然後在以 [base64](/en-US/docs/Glossary/Base64) 編碼 (`YWxhZGRpbjpvcGVuc2VzYW1l`)。

> **備註：** Base64 編碼不是加密也不是雜湊（Hash）！就算用明文直接傳，安全性也跟用 base64 編碼過一樣（base64 是可以解碼的）。最好用 HTTPS 搭配這種驗證方式。
## 範例

```plain
Authorization: Basic YWxhZGRpbjpvcGVuc2VzYW1l
```

可以看看 [HTTP authentication](/zh-TW/docs/Web/HTTP/Authentication) 中的範例
教你如何在 Apache 或 nginx 上啟用 HTTP basic authentication 來保護你的網站。

## 規範

{{Specifications}}

<h2 id="瀏覽器相容性">瀏覽器相容性</h2>
## 瀏覽器相容性

{{Compat}}

<h2 id="See_also">See also</h2>
## See also

<ul>
<li><a href="/en-US/docs/Web/HTTP/Authentication">HTTP authentication</a></li>
<li>{{HTTPHeader("WWW-Authenticate")}}</li>
<li>{{HTTPHeader("Proxy-Authorization")}}</li>
<li>{{HTTPHeader("Proxy-Authenticate")}}</li>
<li>{{HTTPStatus("401")}}, {{HTTPStatus("403")}}, {{HTTPStatus("407")}}</li>
</ul>
- [HTTP authentication](/zh-TW/docs/Web/HTTP/Authentication)
- {{HTTPHeader("WWW-Authenticate")}}
- {{HTTPHeader("Proxy-Authorization")}}
- {{HTTPHeader("Proxy-Authenticate")}}
- {{HTTPStatus("401")}}, {{HTTPStatus("403")}}, {{HTTPStatus("407")}}
Loading

0 comments on commit 96118b1

Please sign in to comment.