Skip to content

Commit

Permalink
Move URL related docs to the new area
Browse files Browse the repository at this point in the history
  • Loading branch information
yin1999 committed Aug 27, 2024
1 parent 739ca14 commit f7fe0fb
Show file tree
Hide file tree
Showing 23 changed files with 47 additions and 196 deletions.
3 changes: 1 addition & 2 deletions files/zh-cn/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2426,7 +2426,6 @@
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Choosing_between_www_and_non-www_URLs /zh-CN/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URIs /zh-CN/docs/Web/URI/Schemes/data
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs /zh-CN/docs/Web/URI/Schemes/data
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web /zh-CN/docs/orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Complete_list_of_MIME_types /zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types
/zh-CN/docs/Web/HTTP/Basics_of_HTTP/选择_www_或非_www_URL_作为域名 /zh-CN/docs/Web/URI/Authority/Choosing_between_www_and_non-www_URLs
/zh-CN/docs/Web/HTTP/CORS/Errors/CORS错误允许凭证 /zh-CN/docs/Web/HTTP/CORS/Errors/CORSMIssingAllowCredentials
Expand Down Expand Up @@ -2463,7 +2462,7 @@
/zh-CN/docs/Web/HTTP/Link_prefetching_FAQ /zh-CN/docs/Glossary/Prefetch
/zh-CN/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_(PAC)_file /zh-CN/docs/Web/HTTP/Proxy_servers_and_tunneling/Proxy_Auto-Configuration_PAC_file
/zh-CN/docs/Web/HTTP/Public_Key_Pinning /zh-CN/docs/Web/Security/Certificate_Transparency
/zh-CN/docs/Web/HTTP/Resources_and_URIs /zh-CN/docs/conflicting/Web/HTTP/Basics_of_HTTP/MIME_types
/zh-CN/docs/Web/HTTP/Resources_and_URIs /zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types
/zh-CN/docs/Web/HTTP/Response_codes /zh-CN/docs/Web/HTTP/Status
/zh-CN/docs/Web/HTTP/Response_codes/100 /zh-CN/docs/Web/HTTP/Status/100
/zh-CN/docs/Web/HTTP/Response_codes/204 /zh-CN/docs/Web/HTTP/Status/204
Expand Down
16 changes: 0 additions & 16 deletions files/zh-cn/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -32546,21 +32546,5 @@
"skyfore",
"xgqfrms-GitHub"
]
},
"conflicting/Web/HTTP/Basics_of_HTTP/MIME_types": {
"modified": "2019-09-05T00:27:21.660Z",
"contributors": ["ran"]
},
"orphaned/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web": {
"modified": "2019-05-06T05:35:10.899Z",
"contributors": [
"wolfzZ",
"heyv5",
"springapple",
"Wendy_Love",
"yuankunzhang",
"little-tomorrow",
"DreamerKing"
]
}
}

This file was deleted.

6 changes: 3 additions & 3 deletions files/zh-cn/glossary/base64/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,13 @@ l10n:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
```

一种常见的变体是“URL 安全的 Base64”,它省略了填充,并将 `+/` 替换为 `-_`,以避免在 {{glossary("URL")}} 路径段或查询参数中可能引起问题的字符的问题。如果不将数据放在路径段或查询参数中,你就不需要用到这一变体。例如,[data URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs) 既没有路径段也没有查询参数,因此可以使用标准的 Base64 编码。
一种常见的变体是“URL 安全的 Base64”,它省略了填充,并将 `+/` 替换为 `-_`,以避免在 {{glossary("URL")}} 路径段或查询参数中可能引起问题的字符的问题。如果不将数据放在路径段或查询参数中,你就不需要用到这一变体。例如,[data URL](/zh-CN/docs/Web/URI/Schemes/data) 既没有路径段也没有查询参数,因此可以使用标准的 Base64 编码。

Base64 编码方案通常用于对二进制数据进行编码,以便在只能处理 ASCII 文本(或某些 ASCII 的超集,仍不接受任意二进制数据)的媒体上进行存储或传输。这确保了数据在传输过程中保持不变。Base64 的常见应用包括:

- 通过[多用途互联网邮件扩展](https://zh.wikipedia.org/wiki/多用途互聯網郵件擴展)发送电子邮件
-[XML](/zh-CN/docs/Web/XML) 中存储复杂数据
- 编码二进制数据以便包含在 [`data:` URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- 编码二进制数据以便包含在 [`data:` URL](/zh-CN/docs/Web/URI/Schemes/data)

## 编码后大小增加

Expand Down Expand Up @@ -97,6 +97,6 @@ await dataUrlToBytes("data:application/octet-stream;base64,AAEC"); // Uint8Array
- JavaScript API:
- {{domxref("Window.btoa()")}}(也在 {{domxref("WorkerGlobalScope.btoa()", "worker 中可用", "", 1)}})
- {{domxref("Window.atob()")}}(也在 {{domxref("WorkerGlobalScope.atob()", "worker 中可用", "", 1)}})
- [Data URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- [Data URL](/zh-CN/docs/Web/URI/Schemes/data)
- 维基百科上的 [Base64](https://zh.wikipedia.org/wiki/Base64)
- [RFC 4648](https://datatracker.ietf.org/doc/html/rfc4648) 中对 Base64 算法的描述
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ URL 的第一部分是*方案*(scheme),它表示浏览器必须使用的
- 显示其他 HTML 文档,用 {{HTMLElement("iframe")}} 元素。

> [!NOTE]
> 当在页面中加载资源时指定 URL(例如使用 `<script>``<audio>``<img>``<video>` 等),通常应只使用 HTTP 和 HTTPS URL,除了一些例外情况(一个显著的例外是 `data:`;参见[数据 URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs))。例如,使用 FTP 是不安全的,并且不再受现代浏览器的支持。
> 当在页面中加载资源时指定 URL(例如使用 `<script>``<audio>``<img>``<video>` 等),通常应只使用 HTTP 和 HTTPS URL,除了一些例外情况(一个显著的例外是 `data:`;参见[数据 URL](/zh-CN/docs/Web/URI/Schemes/data))。例如,使用 FTP 是不安全的,并且不再受现代浏览器的支持。
其他大量使用 URL 的技术(如 {{Glossary("CSS")}} 或 {{Glossary("JavaScript")}})才是 Web 的中心。

Expand Down Expand Up @@ -147,4 +147,4 @@ URL 的必需部分在很大程度上取决于使用 URL 的上下文。在浏

## 参见

[数据 URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs):以 `data:` 方案为前缀的 URL,允许内容创建者在文档中嵌入小文件。
[数据 URL](/zh-CN/docs/Web/URI/Schemes/data):以 `data:` 方案为前缀的 URL,允许内容创建者在文档中嵌入小文件。

This file was deleted.

2 changes: 1 addition & 1 deletion files/zh-cn/web/api/document/fragmentdirective/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,5 +34,5 @@ document.fragmentDirective;

## 参见

- [文本片段](/zh-CN/docs/Web/Text_fragments)
- [文本片段](/zh-CN/docs/Web/URI/Fragment/Text_fragments)
- {{cssxref("::target-text")}}
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/filereader/readasdataurl/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ l10n:

{{APIRef("File API")}}{{AvailableInWorkers}}

{{domxref("FileReader")}} 接口的 **`readAsDataURL()`** 方法用于读取指定的 {{domxref("Blob")}} 或 {{domxref("File")}} 对象的内容。当读操作完成时,{{domxref("FileReader.readyState","readyState")}} 属性变为 `DONE`,并触发 {{domxref("FileReader/loadend_event", "loadend")}} 事件。此时,{{domxref("FileReader.result","result")}} 属性包含作为 [data: URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs) 的数据,将文件的数据表示为 base64 编码字符串。
{{domxref("FileReader")}} 接口的 **`readAsDataURL()`** 方法用于读取指定的 {{domxref("Blob")}} 或 {{domxref("File")}} 对象的内容。当读操作完成时,{{domxref("FileReader.readyState","readyState")}} 属性变为 `DONE`,并触发 {{domxref("FileReader/loadend_event", "loadend")}} 事件。此时,{{domxref("FileReader.result","result")}} 属性包含作为 [data: URL](/zh-CN/docs/Web/URI/Schemes/data) 的数据,将文件的数据表示为 base64 编码字符串。

> [!NOTE]
> 如果不先删除 Base64 编码数据前面的 Data-URL 声明,则 blob 的 {{domxref("FileReader.result","result")}} 无法直接解码为 Base64。要仅检索 Base64 编码的字符串,请首先从结果中删除 `data:*/*;base64,`
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/fragmentdirective/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,5 +40,5 @@ document.fragmentDirective;

## 参见

- [文本片段](/zh-CN/docs/Web/Text_fragments)
- [文本片段](/zh-CN/docs/Web/URI/Fragment/Text_fragments)
- {{cssxref("::target-text")}}
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/htmlcanvaselement/todataurl/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/API/HTMLCanvasElement/toDataURL

{{APIRef("Canvas API")}}

**`HTMLCanvasElement.toDataURL()`** 方法返回一个包含图片展示的 [data URI](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)。可以使用 `type` 参数指定其类型,默认为 [PNG](https://zh.wikipedia.org/wiki/PNG) 格式。图片的分辨率为 96dpi。
**`HTMLCanvasElement.toDataURL()`** 方法返回一个包含图片展示的 [data URI](/zh-CN/docs/Web/URI/Schemes/data)。可以使用 `type` 参数指定其类型,默认为 [PNG](https://zh.wikipedia.org/wiki/PNG) 格式。图片的分辨率为 96dpi。

- 如果画布的高度或宽度是 0,那么会返回字符串“`data:,`”。
- 如果传入的类型非“`image/png`”,但是返回的值以“`data:image/png`”开头,那么该传入的类型是不支持的。
Expand All @@ -26,7 +26,7 @@ canvas.toDataURL(type, encoderOptions);

### 返回值

包含 [data URI](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs) 的字符串。
包含 [data URI](/zh-CN/docs/Web/URI/Schemes/data) 的字符串。

## 示例

Expand Down Expand Up @@ -128,4 +128,4 @@ function removeColors() {
## 参考

- 定义接口,{{domxref("HTMLCanvasElement")}}
- [HTTP](/zh-CN/docs/Web/HTTP) 参考中的 [Data URI](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- [HTTP](/zh-CN/docs/Web/HTTP) 参考中的 [Data URI](/zh-CN/docs/Web/URI/Schemes/data)
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/window/atob/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,6 @@ const decodedData = window.atob(encodedData); // 解码
## 参见

- [`core-js`](https://github.com/zloirock/core-js) 提供了 [`atob` 的 polyfill](https://github.com/zloirock/core-js#base64-utility-methods)
- [`data` URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- [`data` URL](/zh-CN/docs/Web/URI/Schemes/data)
- {{domxref("WorkerGlobalScope.atob()")}}:相同的,但是是在 worker 作用域内的方法。
- {{domxref("Window.btoa()")}}
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/window/btoa/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ console.log(window.btoa(notOK)); // 错误
## 参见

- [`core-js`](https://github.com/zloirock/core-js) 中有对 [`btoa` 的 polyfill](https://github.com/zloirock/core-js#base64-utility-methods)
- [`data` URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- [`data` URL](/zh-CN/docs/Web/URI/Schemes/data)
- {{domxref("WorkerGlobalScope.btoa()")}}:相同的,但是是在 worker 作用域内的方法。
- {{domxref("Window.atob()")}}
- {{Glossary("Base64")}}
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/workerglobalscope/atob/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,6 @@ const decodedData = self.atob(encodedData); // 解码
## 参见

- [`core-js`](https://github.com/zloirock/core-js) 提供了 [`atob` 的 polyfill](https://github.com/zloirock/core-js#base64-utility-methods)
- [`data` URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- [`data` URL](/zh-CN/docs/Web/URI/Schemes/data)
- {{domxref("Window.atob()")}}:相同的,但是是在窗口作用域内的方法。
- {{domxref("WorkerGlobalScope.btoa()")}}
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/workerglobalscope/btoa/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ console.log(self.btoa(notOK)); // 错误
## 参见

- [`core-js`](https://github.com/zloirock/core-js) 中有对 [`btoa` 的 polyfill](https://github.com/zloirock/core-js#base64-utility-methods)
- [`data` URL](/zh-CN/docs/Web/HTTP/Basics_of_HTTP/Data_URLs)
- [`data` URL](/zh-CN/docs/Web/URI/Schemes/data)
- {{domxref("WorkerGlobalScope.atob()")}}
- {{domxref("Window.atob()")}}:相同的,但是是在窗口作用域内的方法。
- {{Glossary("Base64")}}
4 changes: 2 additions & 2 deletions files/zh-cn/web/css/_doublecolon_target-text/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ slug: Web/CSS/::target-text

{{CSSRef}}{{SeeCompatTable}}

**`::target-text`** [CSS](/zh-CN/docs/Web/CSS) [伪元素](/zh-CN/docs/Web/CSS/Pseudo-elements)代表了浏览器在支持[文本片段](/zh-CN/docs/Web/Text_fragments)技术时所滚动到的文字。它使得作者可以选择高亮一段文字的方式。
**`::target-text`** [CSS](/zh-CN/docs/Web/CSS) [伪元素](/zh-CN/docs/Web/CSS/Pseudo-elements)代表了浏览器在支持[文本片段](/zh-CN/docs/Web/URI/Fragment/Text_fragments)技术时所滚动到的文字。它使得作者可以选择高亮一段文字的方式。

```css
::target-text {
Expand Down Expand Up @@ -44,4 +44,4 @@ slug: Web/CSS/::target-text

## 参见

- [文本片段](/zh-CN/docs/Web/Text_fragments)
- [文本片段](/zh-CN/docs/Web/URI/Fragment/Text_fragments)
Loading

0 comments on commit f7fe0fb

Please sign in to comment.