From c2e9b1051ae079e730c0f10aecfeeef1c7ab8520 Mon Sep 17 00:00:00 2001 From: Hoarfroster Date: Sat, 27 Jul 2024 21:48:44 +0800 Subject: [PATCH 001/699] zh-CN: update Glossary/ASCII (#22592) Co-authored-by: A1lo --- files/zh-cn/glossary/ascii/index.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/files/zh-cn/glossary/ascii/index.md b/files/zh-cn/glossary/ascii/index.md index f25be0a7fbcad5..0baab93329e684 100644 --- a/files/zh-cn/glossary/ascii/index.md +++ b/files/zh-cn/glossary/ascii/index.md @@ -2,18 +2,21 @@ title: ASCII slug: Glossary/ASCII l10n: - sourceCommit: 7c444c3e6849c0bac7f065ad1dd66c2bf072b819 + sourceCommit: 50e5e8a9b8a6b7d0dd9877610c9639d8b90f329f --- {{GlossarySidebar}} -**ASCII**（_American Standard Code for Information Interchange，美国信息交换标准码_）是一种由计算机使用的，使用 7 位来表示 128 个字符的字符编码标准，用于将字母、数字、标点符号和控制码转换为数字形式。 +**ASCII**（_American Standard Code for Information Interchange，美国信息交换标准码_）是一种由计算机使用的，使用 7 位来表示 128 个{{glossary("character", "字符")}}的{{glossary("character encoding", "字符编码")}}标准，用于将字母、数字、标点符号和控制码转换为数字形式。 -前 33 个 ASCII 码点是非打印的控制码，包括回车、换行、制表符以及一些源自电报码的过时的非打印码。其他 95 个是可打印字符，包括数字（0-9）、小写字母（a-z）和大写字母（A-Z）以及标点符号。 +前 33 个 ASCII {{glossary("code point", "码位")}}是非打印的控制码，包括回车、换行、制表符以及一些源自电报码的过时的非打印码。其他 95 个是可打印字符，包括数字（0-9）、小写字母（a-z）和大写字母（A-Z）以及标点符号。 -许多计算机系统则使用 {{glossary("Unicode")}}，一个拥有数百万个码点，但前 128 个与 ASCII 集相同的编码。{{Glossary("UTF-8")}} 于 2007 年在 Web 上取代了 ASCII。 +现在，大多数的计算机系统都使用 ASCII 的拓展——支持数百万个码位的 {{glossary("Unicode")}}。在 Web 上，{{Glossary("UTF-8")}} 在 2007 年取代了 ASCII。 ## 参见 - 维基百科上的 [ASCII](https://zh.wikipedia.org/wiki/ASCII) -- IETF 上的 [RFC 20](https://datatracker.ietf.org/doc/rfc20) +- {{rfc("20")}} +- 相关术语： + - {{glossary("Unicode")}} + - {{glossary("UTF-8")}} From 8908922782528774454b052d743fd20c843910a4 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:54:23 +0300 Subject: [PATCH 002/699] [ru] add `Glossary/Percent-encoding` translation (#22477) [ru] add 'Glossary/Percent-encoding' translation --- files/ru/glossary/percent-encoding/index.md | 43 +++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 files/ru/glossary/percent-encoding/index.md diff --git a/files/ru/glossary/percent-encoding/index.md b/files/ru/glossary/percent-encoding/index.md new file mode 100644 index 00000000000000..951bdab46d5134 --- /dev/null +++ b/files/ru/glossary/percent-encoding/index.md @@ -0,0 +1,43 @@ +--- +title: Процентное кодирование +slug: Glossary/Percent-encoding +l10n: + sourceCommit: 6c7cb932f7a0735ec2ac64732c9a947510fd1303 +--- + +{{GlossarySidebar}} + +**Процентное кодирование** — это механизм кодирования 8-битных символов, имеющих определённое значение в контексте {{Glossary("URL", "URL-адресов")}}. Иногда его называют кодированием URL. Кодирование заключается в замене символа на последовательность, состоящую из знака «%», за которым следует шестнадцатеричное представление значения ASCII заменяемого символа. + +Специальные символы, требующие кодирования: `':'`, `'/'`, `'?'`, `'#'`, `'['`, `']'`, `'@'`, `'!'`, `'$'`, `'&'`, `"'"`, `'('`, `')'`, `'*'`, `'+'`, `','`, `';'`, `'='`, а также сам символ`'%'`. Другие символы не нуждаются в кодировании, хотя она возможна. + +| Символ | Кодировка | +| ------ | ------------- | +| `':'` | `%3A` | +| `'/'` | `%2F` | +| `'?'` | `%3F` | +| `'#'` | `%23` | +| `'['` | `%5B` | +| `']'` | `%5D` | +| `'@'` | `%40` | +| `'!'` | `%21` | +| `'$'` | `%24` | +| `'&'` | `%26` | +| `"'"` | `%27` | +| `'('` | `%28` | +| `')'` | `%29` | +| `'*'` | `%2A` | +| `'+'` | `%2B` | +| `','` | `%2C` | +| `';'` | `%3B` | +| `'='` | `%3D` | +| `'%'` | `%25` | +| `' '` | `%20` или `+` | + +В зависимости от контекста символ `' '` преобразуется в `'+'` (в версии процентного кодирования, используемой в сообщении `application/x-www-form-urlencoded`) или в `'%20'` (в URL-адресах). + +## Смотрите также + +- Определение [процентного кодирования](https://en.wikipedia.org/wiki/Percent-encoding) в Википедии. +- {{RFC(3986)}}, раздел 2.1, в котором определено это кодирование. +- [`encodeURI()`](/ru/docs/Web/JavaScript/Reference/Global_Objects/encodeURI) и [`encodeURIComponent()`](/ru/docs/Web/JavaScript/Reference/Global_Objects/encodeURIComponent) — функции для процентного кодирования URL-адресов From fea016158bcf5690f110e025b915b4f3f8d43595 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:54:40 +0300 Subject: [PATCH 003/699] [ru] update `Glossary/URL` translation (#22478) * [ru] update 'Glossary/URL' translation * [ru] improve wording --- files/ru/glossary/url/index.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/files/ru/glossary/url/index.md b/files/ru/glossary/url/index.md index 15846254cea4c4..f440bd06310dd1 100644 --- a/files/ru/glossary/url/index.md +++ b/files/ru/glossary/url/index.md @@ -1,18 +1,20 @@ --- -title: URL (Единый указатель ресурса) +title: URL slug: Glossary/URL +l10n: + sourceCommit: 731e5ba6630a220c24b22288b58af70495063555 --- {{GlossarySidebar}} -_Единый указатель ресурса (Uniform Resource Locator,_ **URL**) — строка, однозначно определяющая, где в интернете находится ресурс. +**URL** (англ. _Uniform Resource Locator_) — это строка, определяющая расположение ресурса (например, веб-страницы, изображения или видео) в Интернете. -В контексте {{Glossary("HTTP")}}, URL называют "адрес" (web address)" или "ссылку" (link). В браузере URL отображается в адресной строке , например, `https://developer.mozilla.org`. +В контексте протокола {{Glossary("HTTP")}}, URL называют «веб-адресом» или «ссылкой». {{glossary("browser", "Браузер")}} отображает URL в адресной строке, например: `https://developer.mozilla.org`. Некоторые браузеры отображают только часть URL, которая находится после «//», то есть {{Glossary("Domain name", "доменное имя")}}. -Кроме того, URL используют при передаче файлов через {{Glossary("FTP")}} , в электронной почте через ({{Glossary("SMTP")}}) и других местах. +URL также могут быть использованы при передаче файлов ({{Glossary("FTP")}}), в электронной почте ({{Glossary("SMTP")}}) и в других протоколах. ## Смотрите также -### Узнайте об этом - -- [Понимание структуры URL](/ru/docs/Learn/Understanding_URLs) на сайте MDN +- [Что такое URL-адрес?](/ru/docs/Learn/Common_questions/Web_mechanics/What_is_a_URL) на сайте MDN +- Синтаксис URL-адресов определён в [URL Living Standard](https://url.spec.whatwg.org/) +- [URL](https://ru.wikipedia.org/wiki/URL) в Википедии From 2b2cf09c09898281b57414bb4134bf4a23c293d2 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:55:00 +0300 Subject: [PATCH 004/699] [ru] add `Glossary/URI` translation (#22479) [ru] add 'Glossary/URI' translation --- files/ru/glossary/uri/index.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) create mode 100644 files/ru/glossary/uri/index.md diff --git a/files/ru/glossary/uri/index.md b/files/ru/glossary/uri/index.md new file mode 100644 index 00000000000000..7e887870c8a347 --- /dev/null +++ b/files/ru/glossary/uri/index.md @@ -0,0 +1,17 @@ +--- +title: URI +slug: Glossary/URI +l10n: + sourceCommit: ada5fa5ef15eadd44b549ecf906423b4a2092f34 +--- + +{{GlossarySidebar}} + +**URI** (англ. _Uniform Resource Identifier_) — это строка, ссылающаяся на ресурс. + +Наиболее распространёнными являются {{Glossary("URL")}}, которые идентифицируют ресурс, указывая его местоположение в Интернете. {{Glossary("URN")}}, напротив, ссылается на ресурс по имени в заданном пространстве имён, например ISBN книги. + +## Смотрите также + +- [URI](https://ru.wikipedia.org/wiki/URI) в Википедии +- Стандарт [RFC 3986](https://datatracker.ietf.org/doc/html/rfc3986) From f4625f889dec3f8b041b003acb38af3f8a68f203 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:55:14 +0300 Subject: [PATCH 005/699] [ru] add `Glossary/URN` translation (#22480) [ru] add 'Glossary/URN' translation --- files/ru/glossary/urn/index.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) create mode 100644 files/ru/glossary/urn/index.md diff --git a/files/ru/glossary/urn/index.md b/files/ru/glossary/urn/index.md new file mode 100644 index 00000000000000..58edb95a010d29 --- /dev/null +++ b/files/ru/glossary/urn/index.md @@ -0,0 +1,14 @@ +--- +title: URN +slug: Glossary/URN +l10n: + sourceCommit: fbc9980c0718c3ead40863b20a74fc8535ebcc85 +--- + +{{GlossarySidebar}} + +**URN** (англ. _Uniform Resource Name_) — это {{Glossary("URI")}} в стандартном формате, ссылающийся на ресурс без указания его местоположения. Пример из стандарта [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986): `urn:oasis:names:specification:docbook:dtd:xml:4.1.2` + +## Смотрите также + +- [URN](https://ru.wikipedia.org/wiki/URN) в Википедии From 9ae082eb27576d7860c37f75ffb0ca342f53dd0c Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:55:24 +0300 Subject: [PATCH 006/699] [ru] update `Glossary/Abstraction` translation (#22541) [ru] update 'Glossary/Abstraction' translation --- files/ru/glossary/abstraction/index.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/files/ru/glossary/abstraction/index.md b/files/ru/glossary/abstraction/index.md index 7b972b87b55572..e5e877b4a00724 100644 --- a/files/ru/glossary/abstraction/index.md +++ b/files/ru/glossary/abstraction/index.md @@ -1,18 +1,20 @@ --- title: Абстракция slug: Glossary/Abstraction +l10n: + sourceCommit: 7a551aaa034fbada3eb99e6fc924a0313b78307f --- {{GlossarySidebar}} -Абстракция в {{Glossary("computer programming", "программировании")}} — это способ снизить сложность и повысить эффективность проектирования и реализации программного обеспечения за счёт сокрытия технической сложности за более простым {{Glossary("API")}}. +Абстракция в {{Glossary("computer programming", "программировании")}} — это способ снизить сложность и обеспечить эффективное проектирование и реализацию сложных программных систем. Техническая сложность систем скрывается за более простыми {{Glossary("API")}}. ## Преимущества абстракции -- Помогает избежать написания низкоуровневого кода. -- Упрощает повторное использование кода и позволяет избежать дублирования. -- Даёт возможность изменять внутреннюю реализацию программы, не затрагивая пользователей. -- Помогает повысить безопасность приложения или программы, поскольку пользователям доступны только нужные детали. +- Помогает пользователю избежать написания низкоуровневого кода. +- Позволяет избежать дублирования кода и повышает возможность повторного использования. +- Даёт возможность изменять внутреннюю реализацию программы, не затрагивая пользователя. +- Помогает повысить безопасность приложения или программы, поскольку пользователям доступны только необходимые данные. ## Пример @@ -25,8 +27,8 @@ class ImplementAbstraction { } display() { - console.log("a = " + this.a); - console.log("b = " + this.b); + console.log(`a = ${this.a}`); + console.log(`b = ${this.b}`); } } @@ -36,3 +38,7 @@ obj.display(); // a = 10 // b = 20 ``` + +## Смотрите также + +- [Абстракция]() в Википедии From 1be1f75ff0abb42933a1ec889403436cdebe5698 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:55:37 +0300 Subject: [PATCH 007/699] [ru] remove outdated `conflicting/Glossary/CORS-safelisted_request_header` (#22542) [ru] remove outdated 'conflicting/Glossary/CORS-safelisted_request_header' --- files/ru/_wikihistory.json | 4 ---- .../glossary/cors-safelisted_request_header/index.md | 9 --------- 2 files changed, 13 deletions(-) delete mode 100644 files/ru/conflicting/glossary/cors-safelisted_request_header/index.md diff --git a/files/ru/_wikihistory.json b/files/ru/_wikihistory.json index 2e1cb455101f50..e0afd1af57d207 100644 --- a/files/ru/_wikihistory.json +++ b/files/ru/_wikihistory.json @@ -15946,10 +15946,6 @@ "modified": "2019-06-12T07:08:20.267Z", "contributors": ["deadblackclover", "vkorniiko"] }, - "conflicting/Glossary/CORS-safelisted_request_header": { - "modified": "2019-03-18T21:32:57.580Z", - "contributors": ["Skinny-Hunter"] - }, "conflicting/Web/API/Fetch_API/Using_Fetch": { "modified": "2019-03-18T21:00:16.677Z", "contributors": ["Akh-rman", "qqwweeaassdd"] diff --git a/files/ru/conflicting/glossary/cors-safelisted_request_header/index.md b/files/ru/conflicting/glossary/cors-safelisted_request_header/index.md deleted file mode 100644 index 89e75b2f708839..00000000000000 --- a/files/ru/conflicting/glossary/cors-safelisted_request_header/index.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Простой заголовок -slug: conflicting/Glossary/CORS-safelisted_request_header -original_slug: Glossary/Simple_header ---- - -{{GlossarySidebar}} - -Старое название {{Glossary("CORS-safelisted request header", "CORS-безопасного заголовка запроса")}}. From 1c7cceae27a4e97ee9eee8cd4a2d4e6a6212eddb Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:55:49 +0300 Subject: [PATCH 008/699] [ru] remove outdated `conflicting/Glossary/CORS-safelisted_response_header` (#22543) [ru] remove outdated 'conflicting/Glossary/CORS-safelisted_response_header' --- .../glossary/cors-safelisted_response_header/index.md | 9 --------- 1 file changed, 9 deletions(-) delete mode 100644 files/ru/conflicting/glossary/cors-safelisted_response_header/index.md diff --git a/files/ru/conflicting/glossary/cors-safelisted_response_header/index.md b/files/ru/conflicting/glossary/cors-safelisted_response_header/index.md deleted file mode 100644 index 72c771e90d13c1..00000000000000 --- a/files/ru/conflicting/glossary/cors-safelisted_response_header/index.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Простой заголовок ответа -slug: conflicting/Glossary/CORS-safelisted_response_header -original_slug: Glossary/Simple_response_header ---- - -{{GlossarySidebar}} - -Старое название {{Glossary("CORS-safelisted response header", "CORS-безопасного заголовка ответа")}}. From 9254fd50f439181724af0f9158729f80b0959cf9 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:56:25 +0300 Subject: [PATCH 009/699] [ru] remove outdated `conflicting/Web/SVG/Attribute` (#22547) --- files/ru/_redirects.txt | 2 +- files/ru/_wikihistory.json | 4 -- .../ru/conflicting/web/svg/attribute/index.md | 53 ------------------- 3 files changed, 1 insertion(+), 58 deletions(-) delete mode 100644 files/ru/conflicting/web/svg/attribute/index.md diff --git a/files/ru/_redirects.txt b/files/ru/_redirects.txt index 3ec2918d23aa2e..9ae79c4455b33b 100644 --- a/files/ru/_redirects.txt +++ b/files/ru/_redirects.txt @@ -847,7 +847,7 @@ /ru/docs/Web/Performance/Основы /ru/docs/Web/Performance/Fundamentals /ru/docs/Web/Performance/Производительность_анимации /ru/docs/Web/Performance/Animation_performance_and_frame_rate /ru/docs/Web/Progressive_web_apps/Installable_PWAs /ru/docs/Web/Progressive_web_apps/Tutorials/js13kGames/Installable_PWAs -/ru/docs/Web/SVG/Attribute/Core /ru/docs/conflicting/Web/SVG/Attribute +/ru/docs/Web/SVG/Attribute/Core /ru/docs/Web/SVG/Attribute /ru/docs/Web/SVG/Tutorial/Базовые_Преобразования /ru/docs/Web/SVG/Tutorial/Basic_Transformations /ru/docs/Web/SVG/Tutorial/Введение /ru/docs/Web/SVG/Tutorial/Introduction /ru/docs/Web/SVG/Tutorial/Основные_Фигуры /ru/docs/Web/SVG/Tutorial/Basic_Shapes diff --git a/files/ru/_wikihistory.json b/files/ru/_wikihistory.json index e0afd1af57d207..a989818feb33a8 100644 --- a/files/ru/_wikihistory.json +++ b/files/ru/_wikihistory.json @@ -15957,9 +15957,5 @@ "conflicting/Web/JavaScript/Reference/Errors/Unexpected_token": { "modified": "2020-03-12T19:46:03.538Z", "contributors": ["KTatyana", "SedovDP", "Sparks"] - }, - "conflicting/Web/SVG/Attribute": { - "modified": "2020-10-15T22:34:58.576Z", - "contributors": ["osipov_s"] } } diff --git a/files/ru/conflicting/web/svg/attribute/index.md b/files/ru/conflicting/web/svg/attribute/index.md deleted file mode 100644 index a62ad543019a01..00000000000000 --- a/files/ru/conflicting/web/svg/attribute/index.md +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Основные атрибуты SVG -slug: conflicting/Web/SVG/Attribute -original_slug: Web/SVG/Attribute/Core ---- - -Основные атрибуты SVG — это все общие атрибуты, которые могут быть указаны в SVG элементах. - -- `id` -- [`lang`](#attr-lang) -- [`tabindex`](#attr-tabindex) -- [`xml:base`](#attr-xml:base) -- [`xml:lang`](#attr-xml:lang) -- [`xml:space`](#attr-xml:space) - -## Атрибуты - -- {{SVGAttr('id')}} - - : Определяет идентификатор (ID), который должен быть уникальным во всем документе. Его цель — идентификация элемента при связывании (с использованием фрагмента идентификатора), написании скрипта или стилизации (с помощью CSS). - _Значение_: Любое строковое значение ID; _Анимируемый_: **Нет** -- {{SVGAttr('lang')}} - - - : Участвует в определении языка элемента, языка, на котором написаны нередактируемые элементы, или языка, на котором должны быть написаны редактируемые элементы. Тэг содержит одно единственное значение записи в формате, определённом в [документе IETF "Tags for Identifying Languages (BCP47)"](https://www.ietf.org/rfc/bcp/bcp47.txt). - - > **Примечание:** SVG2 предоставляет новые `lang` атрибуты. Если атрибуты `lang` и `xml:lang` используются вместе, то `xml:lang` имеет приоритет над `lang`. - - _Значение_: Любой валидный язык ID; _Анимируемый_: **Нет** - -- {{SVGAttr('tabindex')}} - - : Атрибут SVG `tabindex` позволяет контролировать, является ли элемент фокусируемым, и определять относительный порядок элемента для целей последовательной навигации фокуса. - _Тип значения_: [\](/docs/Web/SVG/Content_type#Integer); _Анимируемый_: **Нет** -- {{SVGAttr('xml:base')}} - - : Указывает базовый IRI, отличный от базового IRI текущего документа. - _Тип_: [\](/docs/Web/SVG/Content_type#IRI); _Анимируемый_: **Нет** -- {{SVGAttr('xml:lang')}} - - - : Это универсальный атрибут, разрешённый во всех XML диалектах для разметки естественного человеческого языка, который содержит элемент. Он почти идентичен по использованию атрибута [lang](/ru/docs/Web/HTML/Global_attributes/lang) в HTML, но в соответствии с документацией XML 1.0, данный атрибут не позволяет использовать нулевое (`null`) значение атрибута (`xml:lang=""`) для указания неизвестного языка. Вместо этого, используйте `xml:lang="und"`. - - > **Примечание:** SVG2 предоставляет новые `lang` атрибуты. Если атрибуты `lang` и `xml:lang` используются вместе, то `xml:lang` имеет приоритет над `lang`. - - _Значение_: Любой валидный язык ID; _Анимируемый_: **Нет** - -- {{SVGAttr('xml:space')}} {{deprecated_inline}} - - - : SVG поддерживает стандартный XML-атрибут `xml:space` для указания обработки символов пробела в пределах заданных {{ SVGElement("text") }} символов текущего элемента. - - > **Примечание:** Вместо атрибута `xml:space` следует использовать CSS-свойство {{cssxref('white-space')}}. - - _Значение_: **`default`** | `preserve`; _Анимируемый_: **Нет** - -## Совместимость с браузерами - -{{Compat}} From 9d4ed3cffc73ced8eeccc6114ac8aebf8f28e429 Mon Sep 17 00:00:00 2001 From: Leonid Vinogradov Date: Sat, 27 Jul 2024 16:56:57 +0300 Subject: [PATCH 010/699] [ru] update `Glossary/CORS-safelisted_request_header` and `Glossary/CORS-safelisted_response_header` translations (#22550) [ru] update 'Glossary/CORS-safelisted_request_header' and 'Glossary/CORS-safelisted_response_header' translations --- .../ru/glossary/cors-safelisted_request_header/index.md | 9 +++++---- .../ru/glossary/cors-safelisted_response_header/index.md | 5 ++--- 2 files changed, 7 insertions(+), 7 deletions(-) diff --git a/files/ru/glossary/cors-safelisted_request_header/index.md b/files/ru/glossary/cors-safelisted_request_header/index.md index ea15913ced65fc..0db80bf26f8f98 100644 --- a/files/ru/glossary/cors-safelisted_request_header/index.md +++ b/files/ru/glossary/cors-safelisted_request_header/index.md @@ -2,7 +2,7 @@ title: CORS-безопасный заголовок запроса slug: Glossary/CORS-safelisted_request_header l10n: - sourceCommit: fea9eb7420e6d70772144854242c30e421898415 + sourceCommit: 50e5e8a9b8a6b7d0dd9877610c9639d8b90f329f --- {{GlossarySidebar}} @@ -31,6 +31,7 @@ CORS-безопасные заголовки запроса должны соо ## Смотрите также -- {{Glossary("CORS-safelisted response header", "CORS-безопасный заголовок ответа")}} -- {{Glossary("Forbidden header name", "Запрещённое имя заголовка")}} -- {{Glossary("Request header", "Заголовок запроса")}} +- Связанные термины глоссария: + - {{Glossary("CORS-safelisted response header", "CORS-безопасный заголовок ответа")}} + - {{Glossary("Forbidden header name", "Запрещённое имя заголовка")}} + - {{Glossary("Request header", "Заголовок запроса")}} diff --git a/files/ru/glossary/cors-safelisted_response_header/index.md b/files/ru/glossary/cors-safelisted_response_header/index.md index 64646d4cb6d6c5..a9257f8abdb016 100644 --- a/files/ru/glossary/cors-safelisted_response_header/index.md +++ b/files/ru/glossary/cors-safelisted_response_header/index.md @@ -2,7 +2,7 @@ title: CORS-безопасный заголовок ответа slug: Glossary/CORS-safelisted_response_header l10n: - sourceCommit: fea9eb7420e6d70772144854242c30e421898415 + sourceCommit: 50e5e8a9b8a6b7d0dd9877610c9639d8b90f329f --- {{GlossarySidebar}} @@ -38,8 +38,7 @@ Access-Control-Expose-Headers: X-Custom-Header, Content-Encoding - [HTTP](/ru/docs/Web/HTTP) - [Заголовки HTTP](/ru/docs/Web/HTTP/Headers) - {{HTTPHeader("Access-Control-Expose-Headers")}} -- [Глоссарий](/ru/docs/Glossary) - +- Связанные термины глоссария: - {{Glossary("CORS")}} - {{Glossary("CORS-safelisted_request_header", "CORS-безопасный заголовок запроса")}} - {{Glossary("Forbidden header name", "Запрещённое имя заголовка")}} From c1309659a87930e56b9442aeffeaa353c5037dbd Mon Sep 17 00:00:00 2001 From: A1lo Date: Sun, 28 Jul 2024 02:25:04 +0800 Subject: [PATCH 011/699] zh-tw: convert noteblocks in `/learn` to GFM syntax (#22651) * zh-tw: convert noteblocks in `/learn` to GFM syntax --- files/zh-tw/learn/accessibility/index.md | 3 +- .../accessibility/wai-aria_basics/index.md | 27 ++++++---- .../what_is_accessibility/index.md | 9 ++-- files/zh-tw/learn/css/css_layout/index.md | 3 +- .../css/first_steps/getting_started/index.md | 9 ++-- files/zh-tw/learn/css/first_steps/index.md | 3 +- .../css/first_steps/what_is_css/index.md | 6 ++- files/zh-tw/learn/css/howto/index.md | 3 +- files/zh-tw/learn/css/styling_text/index.md | 3 +- .../how_to_structure_a_web_form/index.md | 15 ++++-- files/zh-tw/learn/forms/index.md | 3 +- .../css_basics/index.md | 6 ++- .../dealing_with_files/index.md | 6 ++- .../html_basics/index.md | 3 +- .../installing_basic_software/index.md | 3 +- .../javascript_basics/index.md | 24 ++++++--- .../publishing_your_website/index.md | 6 ++- .../what_will_your_website_look_like/index.md | 9 ++-- .../creating_hyperlinks/index.md | 18 ++++--- .../document_and_website_structure/index.md | 9 ++-- .../getting_started/index.md | 24 ++++++--- .../html_text_fundamentals/index.md | 3 +- .../learn/html/introduction_to_html/index.md | 3 +- .../the_head_metadata_in_html/index.md | 9 ++-- .../images_in_html/index.md | 24 ++++++--- .../html/multimedia_and_embedding/index.md | 3 +- .../index.md | 3 +- files/zh-tw/learn/html/tables/basics/index.md | 15 ++++-- files/zh-tw/learn/html/tables/index.md | 3 +- files/zh-tw/learn/index.md | 6 ++- .../learn/javascript/asynchronous/index.md | 5 +- .../asynchronous/introducing/index.md | 15 ++++-- .../building_blocks/conditionals/index.md | 18 ++++--- .../building_blocks/functions/index.md | 18 ++++--- .../building_blocks/image_gallery/index.md | 3 +- .../learn/javascript/building_blocks/index.md | 3 +- .../building_blocks/looping_code/index.md | 33 ++++++++---- .../fetching_data/index.md | 12 +++-- .../javascript/client-side_web_apis/index.md | 3 +- .../first_steps/a_first_splash/index.md | 9 ++-- .../javascript/first_steps/arrays/index.md | 9 ++-- .../learn/javascript/first_steps/index.md | 3 +- .../javascript/first_steps/math/index.md | 27 ++++++---- .../silly_story_generator/index.md | 3 +- .../javascript/first_steps/strings/index.md | 6 ++- .../useful_string_methods/index.md | 6 ++- .../javascript/first_steps/variables/index.md | 18 ++++--- .../first_steps/what_is_javascript/index.md | 30 +++++++---- .../first_steps/what_went_wrong/index.md | 21 +++++--- .../adding_bouncing_balls_features/index.md | 3 +- .../learn/javascript/objects/basics/index.md | 6 ++- .../objects/classes_in_javascript/index.md | 12 +++-- files/zh-tw/learn/javascript/objects/index.md | 3 +- .../learn/javascript/objects/json/index.md | 9 ++-- .../objects/object_building_practice/index.md | 3 +- .../objects/object_prototypes/index.md | 12 +++-- .../learn/performance/multimedia/index.md | 3 +- .../server-side/django/admin_site/index.md | 18 ++++--- .../django/authentication/index.md | 45 ++++++++++------ .../django/development_environment/index.md | 33 ++++++++---- .../django/django_assessment_blog/index.md | 3 +- .../learn/server-side/django/forms/index.md | 30 +++++++---- .../server-side/django/generic_views/index.md | 38 +++++++++----- .../server-side/django/home_page/index.md | 30 +++++++---- files/zh-tw/learn/server-side/django/index.md | 3 +- .../server-side/django/introduction/index.md | 12 +++-- .../learn/server-side/django/models/index.md | 18 ++++--- .../server-side/django/sessions/index.md | 9 ++-- .../django/skeleton_website/index.md | 30 +++++++---- .../express_nodejs/deployment/index.md | 39 +++++++++----- .../development_environment/index.md | 35 ++++++++----- .../author_detail_page/index.md | 3 +- .../displaying_data/book_detail_page/index.md | 6 ++- .../displaying_data/book_list_page/index.md | 3 +- .../index.md | 3 +- .../date_formatting_using_moment/index.md | 6 ++- .../server-side/express_nodejs/forms/index.md | 12 +++-- .../learn/server-side/express_nodejs/index.md | 3 +- .../express_nodejs/introduction/index.md | 39 +++++++++----- .../express_nodejs/mongoose/index.md | 51 ++++++++++++------- .../express_nodejs/routes/index.md | 24 ++++++--- .../express_nodejs/skeleton_website/index.md | 30 +++++++---- .../tutorial_local_library_website/index.md | 3 +- .../first_steps/introduction/index.md | 18 ++++--- .../index.md | 15 ++++-- .../introduction/index.md | 9 ++-- .../react_getting_started/index.md | 9 ++-- .../react_todo_list_beginning/index.md | 3 +- .../svelte_getting_started/index.md | 21 +++++--- .../svelte_todo_list_beginning/index.md | 9 ++-- .../svelte_variables_props/index.md | 21 +++++--- .../vue_first_component/index.md | 12 +++-- .../vue_getting_started/index.md | 21 +++++--- .../automated_testing/index.md | 12 +++-- .../learn/tools_and_testing/github/index.md | 11 ++-- files/zh-tw/learn/tools_and_testing/index.md | 3 +- 96 files changed, 828 insertions(+), 416 deletions(-) diff --git a/files/zh-tw/learn/accessibility/index.md b/files/zh-tw/learn/accessibility/index.md index 74ff648d09a26c..e586a2a40a5cc9 100644 --- a/files/zh-tw/learn/accessibility/index.md +++ b/files/zh-tw/learn/accessibility/index.md @@ -21,7 +21,8 @@ When someone describes a site as "accessible," they mean that any user can use a 要理解本模塊的概念，最少理解 [HTML](/zh-TW/docs/Learn/HTML)、[CSS](/zh-TW/docs/Learn/CSS)、[JavaScript](/zh-TW/docs/Learn/JavaScript) 是個好主意。如果在學習相關技術時學習會更好。 -> **備註：** 如果使用的設備無法讓你建立自己的文件，可以試著在 [JSBin](https://jsbin.com/) 或 [Glitch](https://glitch.com/) 這種程式撰寫網站，執行大多數範例。 +> [!NOTE] +> 如果使用的設備無法讓你建立自己的文件，可以試著在 [JSBin](https://jsbin.com/) 或 [Glitch](https://glitch.com/) 這種程式撰寫網站，執行大多數範例。 ## 教學 diff --git a/files/zh-tw/learn/accessibility/wai-aria_basics/index.md b/files/zh-tw/learn/accessibility/wai-aria_basics/index.md index 091e378eefa16f..d50549e9006fe4 100644 --- a/files/zh-tw/learn/accessibility/wai-aria_basics/index.md +++ b/files/zh-tw/learn/accessibility/wai-aria_basics/index.md @@ -60,7 +60,8 @@ slug: Learn/Accessibility/WAI-ARIA_basics 有關 WAI-ARIA 屬性的重要觀點是他們不會影響網頁的任何內容，除了透過瀏覽器無障礙 API 揭露資訊之外(螢幕報讀器即從中獲得資訊)。儘管 WAI-ARIA 屬性對 CSS 選擇元素很有用，但不會影響網頁結構、DOM 等。 -> **備註：** 你可以在 WAI-ARIA 規格中找到所有 ARIA 的角色及其用法的很有用清單，請參見 [Definition of Roles](https://www.w3.org/TR/wai-aria-1.1/#role_definitions)連結以獲得更進一步的資訊。 +> [!NOTE] +> 你可以在 WAI-ARIA 規格中找到所有 ARIA 的角色及其用法的很有用清單，請參見 [Definition of Roles](https://www.w3.org/TR/wai-aria-1.1/#role_definitions)連結以獲得更進一步的資訊。 > > 本規格也涵括所有屬性與狀態的清單，請參見 [Definitions of States and Properties (all aria-\* attributes)](https://www.w3.org/TR/wai-aria-1.1/#state_prop_def)連結以獲得更進一步的資訊。 @@ -80,7 +81,8 @@ slug: Learn/Accessibility/WAI-ARIA_basics 在本文中，我們未試圖涵蓋每一個 WAI-ARIA 特徵及其確切的支援細節。相反地，我們將涵蓋最關鍵的 WAI-ARIA 特徵讓你知道；如果我們沒有提到任何支援細節，你可認定該特徵得到很好的支援。我們會明確地提到這個例外情況。 -> **備註：** 某些 JavaScript 儲存庫支援 WAI-ARIA，亦即當他們產生 UI 特徵如複雜的表單控制措施，他們添加 ARIA 屬性來增進這些特徵的無障礙。如果你在尋找第三方的 JavaScript 解決方案來快速的開發 UI，你應該謹慎地考量其 UI 插件的無障礙作為你決定使用的重要因素。jQuery UI(參見[About jQuery UI: Deep accessibility support](https://jqueryui.com/about/#deep-accessibility-support))、 [ExtJS](https://www.sencha.com/products/extjs/)與 [Dojo/Dijit](https://dojotoolkit.org/reference-guide/1.10/dijit/a11y/statement.html)是良好範例。 +> [!NOTE] +> 某些 JavaScript 儲存庫支援 WAI-ARIA，亦即當他們產生 UI 特徵如複雜的表單控制措施，他們添加 ARIA 屬性來增進這些特徵的無障礙。如果你在尋找第三方的 JavaScript 解決方案來快速的開發 UI，你應該謹慎地考量其 UI 插件的無障礙作為你決定使用的重要因素。jQuery UI(參見[About jQuery UI: Deep accessibility support](https://jqueryui.com/about/#deep-accessibility-support))、 [ExtJS](https://www.sencha.com/products/extjs/)與 [Dojo/Dijit](https://dojotoolkit.org/reference-guide/1.10/dijit/a11y/statement.html)是良好範例。 ### 何時應該使用 WAI-ARIA? @@ -95,7 +97,8 @@ slug: Learn/Accessibility/WAI-ARIA_basics 再說一次，只有需要的時候才使用它！ -> **備註：** 請確保有各類實際的使用者來測試你的網站 — 非身障者、使用螢幕報讀器者、使用鍵盤導覽者等。他們將比你更能了解它運作的效果。 +> [!NOTE] +> 請確保有各類實際的使用者來測試你的網站 — 非身障者、使用螢幕報讀器者、使用鍵盤導覽者等。他們將比你更能了解它運作的效果。 ## 實作 WAI-ARIA 開發 @@ -227,7 +230,8 @@ var intervalID = window.setInterval(showQuote, 10000); 這將使螢幕報讀器在內容更新時讀出更新的內容。 -> **備註：** 如果你嘗試從 `XMLHttpRequest` 執行 `file://` URL`，`大部分的瀏覽器會拋出安全異常，例如你直接上傳該檔案到瀏覽器(透過雙擊滑鼠鍵等)。為了這項可以執行，你需要將檔案上傳到一個網站伺服器如 [GitHub](/zh-TW/docs/Learn/Common_questions/Tools_and_setup/Using_GitHub_pages)，或本機網站伺服器如 [Python's SimpleHTTPServer](http://www.pythonforbeginners.com/modules-in-python/how-to-use-simplehttpserver/)。 +> [!NOTE] +> 如果你嘗試從 `XMLHttpRequest` 執行 `file://` URL`，`大部分的瀏覽器會拋出安全異常，例如你直接上傳該檔案到瀏覽器(透過雙擊滑鼠鍵等)。為了這項可以執行，你需要將檔案上傳到一個網站伺服器如 [GitHub](/zh-TW/docs/Learn/Common_questions/Tools_and_setup/Using_GitHub_pages)，或本機網站伺服器如 [Python's SimpleHTTPServer](http://www.pythonforbeginners.com/modules-in-python/how-to-use-simplehttpserver/)。 這裡有一項額外的考量—只有文字更新才讀出。如果我們也總是讀出標題，那將很好，以讓使用者記住讀出的內容。為做到這樣，我們可以添加 [`aria-atomic`](https://www.w3.org/TR/wai-aria-1.1/#aria-atomic) 屬性到這個部分，再次更新你的 `
` 標籤如下所示： @@ -237,7 +241,8 @@ var intervalID = window.setInterval(showQuote, 10000); `aria-atomic="true"`屬性告訴螢幕報讀器以一個原子單位方式讀出完整的元素內容，而不僅只讀出更新的部分。 -> **備註：** 你可以查看完成的範例 [aria-live.html](https://github.com/mdn/learning-area/blob/master/accessibility/aria/aria-live.html) ([看實際頁面](https://mdn.github.io/learning-area/accessibility/aria/aria-live.html))。 +> [!NOTE] +> 你可以查看完成的範例 [aria-live.html](https://github.com/mdn/learning-area/blob/master/accessibility/aria/aria-live.html) ([看實際頁面](https://mdn.github.io/learning-area/accessibility/aria/aria-live.html))。 > **備註：** [`aria-relevant`](https://www.w3.org/TR/wai-aria-1.1/#aria-relevant) 屬性在即時區塊更新時對於控制讀出甚麼內容也相當有用，例如你可以僅獲得讀出新增或移除的內容。 @@ -301,7 +306,8 @@ var intervalID = window.setInterval(showQuote, 10000); aria-required="true" /> ``` -> **備註：** 你可以查看完成的範例 [form-validation-updated.html](https://mdn.github.io/learning-area/accessibility/aria/form-validation-updated.html)。 +> [!NOTE] +> 你可以查看完成的範例 [form-validation-updated.html](https://mdn.github.io/learning-area/accessibility/aria/form-validation-updated.html)。 除了傳統的 {{htmlelement("label")}} 元素之外，WAI-ARIA 也能賦予一些進階的表單標籤技術。我們已經談論過使用 [`aria-label`](https://www.w3.org/TR/wai-aria-1.1/#aria-label) 屬性在我們不希望標籤讓有視覺的使用者看見的地方來提供標籤(參見上述 [路標/地標](#路標地標) 章節。如果你想要指定一個非`