From 7dcee9e2bb914a379096f75c518d0be831f9fc63 Mon Sep 17 00:00:00 2001 From: Allo Date: Sat, 21 Dec 2024 20:58:42 +0800 Subject: [PATCH] zh-cn: use script to fix broken links to learn area --- files/zh-cn/glossary/media/css/index.md | 2 +- files/zh-cn/glossary/metadata/index.md | 2 +- .../accessibility/css_and_javascript/index.md | 10 +- .../core/accessibility/html/index.md | 6 +- .../core/accessibility/mobile/index.md | 2 +- .../core/accessibility/tooling/index.md | 16 +- .../accessibility/wai-aria_basics/index.md | 18 +-- .../what_is_accessibility/index.md | 4 +- .../core/css_layout/introduction/index.md | 2 +- .../css_layout/legacy_layout_methods/index.md | 2 +- .../css_layout/responsive_design/index.md | 4 +- .../main_features/index.md | 4 +- .../react_components/index.md | 2 +- .../vue_getting_started/index.md | 2 +- .../core/scripting/arrays/index.md | 6 +- .../build_your_own_function/index.md | 2 +- .../core/scripting/conditionals/index.md | 6 +- .../scripting/debugging_javascript/index.md | 16 +- .../core/scripting/dom_scripting/index.md | 2 +- .../core/scripting/functions/index.md | 4 +- .../core/scripting/object_basics/index.md | 2 +- .../scripting/what_is_javascript/index.md | 4 +- .../advanced_text_features/index.md | 2 +- .../basic_html_syntax/index.md | 6 +- .../creating_links/index.md | 2 +- .../structuring_content/html_images/index.md | 8 +- .../html_table_basics/index.md | 4 +- .../structuring_documents/index.md | 6 +- .../table_accessibility/index.md | 4 +- .../webpage_metadata/index.md | 4 +- .../styling_basics/cascade_layers/index.md | 2 +- .../core/styling_basics/sizing/index.md | 10 +- .../styling_basics/values_and_units/index.md | 2 +- .../core/styling_basics/what_is_css/index.md | 2 +- .../core/text_styling/fundamentals/index.md | 14 +- .../core/text_styling/styling_links/index.md | 6 +- .../core/text_styling/styling_lists/index.md | 2 +- .../core/text_styling/web_fonts/index.md | 2 +- .../classes_in_javascript/index.md | 2 +- .../async_js/sequencing_animations/index.md | 6 +- .../client-side_storage/index.md | 2 +- .../drawing_graphics/index.md | 2 +- .../third_party_apis/index.md | 4 +- .../introducing_complete_toolchain/index.md | 6 +- .../index.md | 4 +- .../how_to_structure_a_web_form/index.md | 2 +- .../sending_and_retrieving_form_data/index.md | 6 +- .../forms/ui_pseudo-classes/index.md | 4 +- .../extensions/performance/css/index.md | 6 +- .../extensions/performance/html/index.md | 2 +- .../performance/javascript/index.md | 10 +- .../django/django_assessment_blog/index.md | 2 +- .../server-side/django/forms/index.md | 4 +- .../server-side/django/home_page/index.md | 2 +- .../express_nodejs/deployment/index.md | 4 +- .../displaying_data/author_list_page/index.md | 2 +- .../displaying_data/book_list_page/index.md | 2 +- .../genre_detail_page/index.md | 2 +- .../displaying_data/home_page/index.md | 4 +- .../locallibrary_base_template/index.md | 2 +- .../forms/delete_author_form/index.md | 2 +- .../express_nodejs/routes/index.md | 4 +- .../testing/feature_detection/index.md | 4 +- .../extensions/testing/html_and_css/index.md | 4 +- .../extensions/testing/introduction/index.md | 2 +- .../testing/testing_strategies/index.md | 2 +- .../your_own_automation_environment/index.md | 2 +- .../adding_interactivity/index.md | 2 +- .../creating_the_content/index.md | 2 +- .../publishing_your_website/index.md | 2 +- .../styling_the_content/index.md | 6 +- .../howto/solve_css_problems/css_faq/index.md | 8 +- .../howto/solve_css_problems/index.md | 38 ++--- .../add_a_hit_map_on_top_of_an_image/index.md | 2 +- .../howto/solve_html_problems/index.md | 30 ++-- .../howto/solve_javascript_problems/index.md | 148 +++++++++--------- .../upload_files_to_a_web_server/index.md | 2 +- .../what_software_do_i_need/index.md | 2 +- .../what_is_a_web_server/index.md | 2 +- files/zh-cn/learn_web_development/index.md | 2 +- .../zh-cn/mdn/community/learn_forum/index.md | 4 +- .../howto/images_media/index.md | 2 +- .../code_style_guide/css/index.md | 2 +- .../writing_style_guide/index.md | 2 +- .../mozilla/firefox/releases/120/index.md | 2 +- .../mozilla/firefox/releases/125/index.md | 2 +- .../mozilla/firefox/releases/127/index.md | 2 +- .../accessibility/understanding_wcag/index.md | 2 +- .../api/eventtarget/addeventlistener/index.md | 2 +- .../htmlinputelement/invalid_event/index.md | 2 +- .../web/api/htmlmediaelement/load/index.md | 2 +- .../web/api/htmlmetaelement/content/index.md | 2 +- files/zh-cn/web/api/webxr_device_api/index.md | 2 +- files/zh-cn/web/css/@media/index.md | 4 +- files/zh-cn/web/css/_colon_empty/index.md | 2 +- files/zh-cn/web/css/aspect-ratio/index.md | 2 +- .../css/css_colors/applying_color/index.md | 6 +- .../css/css_colors/color_picker_tool/index.md | 2 +- files/zh-cn/web/css/display-box/index.md | 6 +- files/zh-cn/web/css/display/index.md | 6 +- files/zh-cn/web/css/specificity/index.md | 2 +- files/zh-cn/web/css/visibility/index.md | 2 +- .../zh-cn/web/events/event_handlers/index.md | 2 +- .../web/html/attributes/multiple/index.md | 2 +- .../web/html/attributes/pattern/index.md | 2 +- files/zh-cn/web/html/element/a/index.md | 2 +- files/zh-cn/web/html/element/abbr/index.md | 2 +- files/zh-cn/web/html/element/footer/index.md | 2 +- .../web/html/element/input/date/index.md | 2 +- .../element/input/datetime-local/index.md | 2 +- .../web/html/element/input/hidden/index.md | 2 +- files/zh-cn/web/html/element/input/index.md | 2 +- .../web/html/element/input/month/index.md | 2 +- .../web/html/element/input/reset/index.md | 2 +- .../web/html/element/input/search/index.md | 4 +- .../web/html/element/input/submit/index.md | 2 +- .../web/html/element/input/text/index.md | 2 +- .../web/html/element/input/time/index.md | 2 +- files/zh-cn/web/html/element/meta/index.md | 2 +- files/zh-cn/web/html/element/table/index.md | 6 +- .../reference/global_objects/array/index.md | 2 +- .../reference/statements/while/index.md | 2 +- .../reference/template_literals/index.md | 2 +- .../guides/fractions_and_roots/index.md | 2 +- .../zh-cn/web/mathml/guides/scripts/index.md | 6 +- files/zh-cn/web/mathml/guides/tables/index.md | 2 +- .../mathml/guides/text_containers/index.md | 2 +- .../web/media/formats/image_types/index.md | 2 +- files/zh-cn/web/media/images/index.md | 2 +- .../guides/installing/index.md | 2 +- .../cycletracker/html_and_css/index.md | 2 +- .../javascript_functionality/index.md | 2 +- .../cycletracker/manifest_file/index.md | 2 +- .../cycletracker/secure_connection/index.md | 6 +- .../cycletracker/service_workers/index.md | 2 +- 135 files changed, 340 insertions(+), 340 deletions(-) diff --git a/files/zh-cn/glossary/media/css/index.md b/files/zh-cn/glossary/media/css/index.md index c1ae565b6d33a2..cc996c41d230a0 100644 --- a/files/zh-cn/glossary/media/css/index.md +++ b/files/zh-cn/glossary/media/css/index.md @@ -17,5 +17,5 @@ CSS 提供了几个特性，允许你根据查看设备的媒体**类型**（例 - [使用媒体查询](/zh-CN/docs/Web/CSS/CSS_media_queries/Using_media_queries) - [媒体查询](/zh-CN/docs/Web/CSS/CSS_media_queries) -- {{cssxref("@media")}} [at-规则](/zh-CN/docs/Web/CSS/At-rule)：根据媒体查询的结果，有条件地应用[样式表](/zh-CN/docs/Learn/CSS/First_steps/How_CSS_works#应用_css_到_dom)的一部分。 +- {{cssxref("@media")}} [at-规则](/zh-CN/docs/Web/CSS/At-rule)：根据媒体查询的结果，有条件地应用[样式表](/zh-CN/docs/Learn_web_development/Core/Styling_basics/What_is_CSS#应用_css_到_dom)的一部分。 - {{domxref("Window.matchMedia()")}}：测试查看设备是否符合媒体查询条件。 diff --git a/files/zh-cn/glossary/metadata/index.md b/files/zh-cn/glossary/metadata/index.md index e8a204af0695e6..74732828773893 100644 --- a/files/zh-cn/glossary/metadata/index.md +++ b/files/zh-cn/glossary/metadata/index.md @@ -11,6 +11,6 @@ l10n: ## 参见 -- [学习：元数据](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/The_head_metadata_in_HTML#元数据：meta_元素) +- [学习：元数据](/zh-CN/docs/Learn_web_development/Core/Structuring_content/Webpage_metadata#元数据：meta_元素) - 维基百科上的[元数据](https://zh.wikipedia.org/wiki/元数据) - MDN 上的 {{htmlelement("meta")}} 元素 diff --git a/files/zh-cn/learn_web_development/core/accessibility/css_and_javascript/index.md b/files/zh-cn/learn_web_development/core/accessibility/css_and_javascript/index.md index 243cc9aa6db14e..9bea448ebfbbfa 100644 --- a/files/zh-cn/learn_web_development/core/accessibility/css_and_javascript/index.md +++ b/files/zh-cn/learn_web_development/core/accessibility/css_and_javascript/index.md @@ -101,7 +101,7 @@ em { } ``` -但是，你很少需要以任何显著的方式设置强调元素的样式。粗体和斜体文本的标准约定非常容易识别，更改样式可能会导致混淆。有关强调的更多信息，参见[重点强调](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/HTML_text_fundamentals#重点强调)。 +但是，你很少需要以任何显著的方式设置强调元素的样式。粗体和斜体文本的标准约定非常容易识别，更改样式可能会导致混淆。有关强调的更多信息，参见[重点强调](/zh-CN/docs/Learn_web_development/Core/Structuring_content/Headings_and_paragraphs#重点强调)。 #### 缩写 @@ -122,7 +122,7 @@ abbr { } ``` -缩写的公认样式约定是虚线下划线，偏离这一原则明显是不明智的。有关缩写的更多，参见[缩略语](/zh-CN/docs/Learn/HTML/Introduction_to_HTML/Advanced_text_formatting#缩略语)。 +缩写的公认样式约定是虚线下划线，偏离这一原则明显是不明智的。有关缩写的更多，参见[缩略语](/zh-CN/docs/Learn_web_development/Core/Structuring_content/Advanced_text_features#缩略语)。 #### 链接 @@ -228,9 +228,9 @@ JavaScript 还可能会中断无障碍，具体取决于其使用方式。 简单的内容和功能可以说是很容易使访问——例如文本，图像，表格，窗体和按钮，激活功能。正如我们在 [HTML：辅助功能的良好基础](/zh-CN/docs/Learn_web_development/Core/Accessibility/HTML)一文中提到的，主要注意事项包括： - 良好的语义：为正确的工作使用正确的元素。例如，确保你使用标题和段落，以及 {{htmlelement("button")}} 和 {{htmlelement("a")}} 元素 -- 确保内容以文本形式提供，要么直接作为文本内容、表单元素的良好文本标签，也可以确保[替代文本](/zh-CN/docs/Learn/Accessibility/HTML#替代文本)（例如图像的 alt 文本）。 +- 确保内容以文本形式提供，要么直接作为文本内容、表单元素的良好文本标签，也可以确保[替代文本](/zh-CN/docs/Learn_web_development/Core/Accessibility/HTML#替代文本)（例如图像的 alt 文本）。 -我们还查看了如何使用 JavaScript 在缺少功能的地方构建的示例 , 参见[重新建立键盘的无障碍](/zh-CN/docs/Learn/Accessibility/HTML#重新建立键盘的无障碍)。这不是理想的——实际上，你应该只使用正确的元素为正确的作业——但它表明在情况下它是可能的，由于某种原因，你不能控制使用的标记。提高非语义 JavaScript 支持的小部件的无障碍的另一种方法是使用 WAI-ARIA 为屏幕阅读器用户提供额外的语义。下一篇文章还将详细介绍这一点。 +我们还查看了如何使用 JavaScript 在缺少功能的地方构建的示例 , 参见[重新建立键盘的无障碍](/zh-CN/docs/Learn_web_development/Core/Accessibility/HTML#重新建立键盘的无障碍)。这不是理想的——实际上，你应该只使用正确的元素为正确的作业——但它表明在情况下它是可能的，由于某种原因，你不能控制使用的标记。提高非语义 JavaScript 支持的小部件的无障碍的另一种方法是使用 WAI-ARIA 为屏幕阅读器用户提供额外的语义。下一篇文章还将详细介绍这一点。 复杂的功能，如 3D 游戏是不容易提高无障碍的 ––使用 [WebGL](/zh-CN/docs/Web/API/WebGL_API) 创建的复杂 3D 游戏将在 {{htmlelement("canvas")}} 元素上呈现，该元素目前没有提供文本替代或其他信息的功能视障用户使用。可以说，这样的游戏并没有真正有这群人作为它的主要目标观众的一部分，这将是不合理的，期望你使它 100% 访问盲人，但你可以实现键盘控制，所以它可以使用非鼠标用户，并使配色方案的对比度足以让有颜色缺陷的人使用。 @@ -358,7 +358,7 @@ imgThumb.onblur = hideImg; 当鼠标指针在缩略图上悬停或者移开，将分别调用前两行代码。此时不允许我们通过键盘访问缩略图——为了允许这一点，我们调用后两行代码，它们在图像聚焦和失焦时 (聚焦停止) 运行函数。这可以在图像加 tab 键实现，因为我们为图像的属性设置 `tabindex="0"`。 -[Click](/zh-CN/docs/Web/API/Element/click_event) 事件很有趣——听起来它依赖于鼠标，但是大多数的浏览器，在有焦点的链接或者表单元素上，按下 enter/return 之后，或者在触屏设备上点击一个元素，都将会激活 [onclick](/zh-CN/docs/Web/API/Element/click_event) 事件处理程序。但是，当你允许非默认可聚焦事件使用 tabindex 进行焦点处理时，默认情况下不起作用，在这种情况下，你需要在按下确切键时进行专门检测（参见[重新建立键盘的无障碍](/zh-CN/docs/Learn/Accessibility/HTML#重新建立键盘的无障碍)）。 +[Click](/zh-CN/docs/Web/API/Element/click_event) 事件很有趣——听起来它依赖于鼠标，但是大多数的浏览器，在有焦点的链接或者表单元素上，按下 enter/return 之后，或者在触屏设备上点击一个元素，都将会激活 [onclick](/zh-CN/docs/Web/API/Element/click_event) 事件处理程序。但是，当你允许非默认可聚焦事件使用 tabindex 进行焦点处理时，默认情况下不起作用，在这种情况下，你需要在按下确切键时进行专门检测（参见[重新建立键盘的无障碍](/zh-CN/docs/Learn_web_development/Core/Accessibility/HTML#重新建立键盘的无障碍)）。 ## 总结 diff --git a/files/zh-cn/learn_web_development/core/accessibility/html/index.md b/files/zh-cn/learn_web_development/core/accessibility/html/index.md index 9b5ac17168d81e..828f86ca46fcf2 100644 --- a/files/zh-cn/learn_web_development/core/accessibility/html/index.md +++ b/files/zh-cn/learn_web_development/core/accessibility/html/index.md @@ -54,7 +54,7 @@ original_slug: Learn/Accessibility/HTML 让我们来继续学习 HTML 语义化实现细则。 > [!NOTE] -> 在本地计算机上设置屏幕阅读器是一个不错的主意，因此你可以对下面显示的示例进行一些测试。更多内容请查阅 [Screenreaders guide](/zh-CN/docs/Learn/Tools_and_testing/Cross_browser_testing/Accessibility#screenreaders)。 +> 在本地计算机上设置屏幕阅读器是一个不错的主意，因此你可以对下面显示的示例进行一些测试。更多内容请查阅 [Screenreaders guide](/zh-CN/docs/Learn_web_development/Core/Accessibility/Tooling#screenreaders)。 ## 良好的语义 @@ -252,7 +252,7 @@ the last one. > [!NOTE] > 除了你的内容具有良好的语义和有吸引力的布局之外，它的源代码顺序应该是合理的 - 你可以随时将它放在你想要使用 CSS 的位置，但是你应该先从源代码开始，如此这样，屏幕阅读器读取给他们的内容将会非常便于理解。 -### UI 控制 +### UI 控件 通过 UI 控件，我们指的是与用户交互的 Web 文档的主要部分 - 通常是按钮，链接和表单控件。在本节中，我们将介绍创建此类控件时要注意的基本无障碍问题。稍后关于 WAI-ARIA 和多媒体的文章将着眼于 UI 无障碍的其他方面。 @@ -263,7 +263,7 @@ UI 控件无障碍的一个关键方面是，默认情况下，浏览器允许 接着你可以按 Enter / Return 来追踪当前获得焦点的链接，或者按按钮来实现（我们已经使用 JavaScript 使按钮同时显示提示消息），或者开始在文本输入中输入文本（其他表单元素具有不同的控件，例如 {{htmlelement("select")}} 元素拥有自己的显示选项，可以使用向上和向下箭头键进行循环）。 > [!NOTE] -> 不同的浏览器可能有不同的键盘控制选项。请参阅[使用本机键盘辅助功能](/zh-CN/docs/Learn/Tools_and_testing/Cross_browser_testing/Accessibility#使用键盘)获取更多详细信息。 +> 不同的浏览器可能有不同的键盘控制选项。请参阅[使用本机键盘辅助功能](/zh-CN/docs/Learn_web_development/Core/Accessibility/Tooling#使用键盘)获取更多详细信息。 实际上，你只需使用适当的元素即可免费获得此功能，例如， diff --git a/files/zh-cn/learn_web_development/core/accessibility/mobile/index.md b/files/zh-cn/learn_web_development/core/accessibility/mobile/index.md index 8eec05442fd9d9..dba9f41ad8134b 100644 --- a/files/zh-cn/learn_web_development/core/accessibility/mobile/index.md +++ b/files/zh-cn/learn_web_development/core/accessibility/mobile/index.md @@ -184,7 +184,7 @@ iOS 操作系统内置了移动版旁白（VoiceOver）。 ## 控制机制 -在我们的 CSS 和 JavaScript 无障碍文章中，我们研究了特定于某种控制机制的事件的概念（请参阅[特定于鼠标的事件](/zh-CN/docs/Learn/Accessibility/CSS_and_JavaScript#鼠标特定事件)）。回顾一下，因为其他控制机制不能激活相关的功能，将会导致辅助功能的问题。 +在我们的 CSS 和 JavaScript 无障碍文章中，我们研究了特定于某种控制机制的事件的概念（请参阅[特定于鼠标的事件](/zh-CN/docs/Learn_web_development/Core/Accessibility/CSS_and_JavaScript#鼠标特定事件)）。回顾一下，因为其他控制机制不能激活相关的功能，将会导致辅助功能的问题。 举例来说，[点击](/zh-CN/docs/Web/API/Element/click_event)事件在无障碍方面是良好的——通过点击处理器设置的元素，选中它并按下回车或返回，或者在触摸屏设备上点击它，可以调用关联的事件处理程序。试试我们的 [simple-button-example.html](https://github.com/mdn/learning-area/blob/main/accessibility/mobile/simple-button-example.html) 示例（[查看实时示例](https://mdn.github.io/learning-area/accessibility/mobile/simple-button-example.html)）以理解我们的意思。 diff --git a/files/zh-cn/learn_web_development/core/accessibility/tooling/index.md b/files/zh-cn/learn_web_development/core/accessibility/tooling/index.md index 9d3977418225d2..12d517a4c8a8d3 100644 --- a/files/zh-cn/learn_web_development/core/accessibility/tooling/index.md +++ b/files/zh-cn/learn_web_development/core/accessibility/tooling/index.md @@ -49,7 +49,7 @@ l10n: 在某种程度上，本模块都是关于无障碍的——跨浏览器测试可确保你的网站可以被尽可能多的人使用。这篇[无障碍是什么？](/zh-CN/docs/Learn_web_development/Core/Accessibility/What_is_accessibility)更全面透彻地定义了什么是无障碍。 -也就是说，本文将涵盖跨浏览器和有关残疾人的测试问题以及他们如何使用 Web。我们在本模块的其他地方已经讨论过别的领域，例如[响应式设计问题](/zh-CN/docs/Learn/Tools_and_testing/Cross_browser_testing/HTML_and_CSS#响应式设计问题)和[性能](/zh-CN/docs/Learn/Tools_and_testing/Cross_browser_testing/JavaScript#性能问题)。 +也就是说，本文将涵盖跨浏览器和有关残疾人的测试问题以及他们如何使用 Web。我们在本模块的其他地方已经讨论过别的领域，例如[响应式设计问题](/zh-CN/docs/Learn_web_development/Extensions/Testing/HTML_and_CSS#响应式设计问题)和[性能](/zh-CN/docs/Learn_web_development/Core/Scripting/Debugging_JavaScript#性能问题)。 > [!NOTE] > 如同 Web 开发的许多方面一样，无障碍并非可以用 100% 的成功或失败来定义；实际上，对于所有内容来说，要达到完全的无障碍几乎是不可能的，特别是当网站变得越来越复杂。我们所做的，更多是采取防御性编程，并遵守最佳实践，以确保尽可能多的人能够访问到尽可能多的内容。 @@ -59,7 +59,7 @@ l10n: 在本节中，我们将围绕 Web 无障碍，详细介绍与特定技术相关的一些主要问题、要遵循的最佳实践，以及可以进行的一些快速测试，以查看你的网站是否朝着正确的方向发展。 > [!NOTE] -> 无障碍在道德上是正确的事情，对企业也有好处（残疾用户，移动用户等构成了重要的细分市场），并且在世界许多地方，提供出来的网络媒体资源无法为残疾人服务也是违法的。阅读[无障碍指南和法律](/zh-CN/docs/Learn/Accessibility/What_is_accessibility#无障碍指南和法律)获取更多相关信息。 +> 无障碍在道德上是正确的事情，对企业也有好处（残疾用户，移动用户等构成了重要的细分市场），并且在世界许多地方，提供出来的网络媒体资源无法为残疾人服务也是违法的。阅读[无障碍指南和法律](/zh-CN/docs/Learn_web_development/Core/Accessibility/What_is_accessibility#无障碍指南和法律)获取更多相关信息。 ### HTML @@ -176,7 +176,7 @@ select:focus { 替代文本对无障碍性至关重要——对于视觉或听觉障碍者来说，如果无法看到或听到某些内容，这将是一个障碍。最简单且常用的文本替代方法是使用 `alt` 属性，我们应在所有包含关键内容的图像上使用该属性。它应包含能够在页面上成功传达图像意义和内容的描述，并能被屏幕阅读器读取，从而朗读给用户听。 > [!NOTE] -> 更多信息请阅读[替代文本](/zh-CN/docs/Learn/Accessibility/HTML#替代文本)。 +> 更多信息请阅读[替代文本](/zh-CN/docs/Learn_web_development/Core/Accessibility/HTML#替代文本)。 可以通过多种方法来测试缺少的替代文本，例如，使用无障碍[审计工具](#审计工具)。 @@ -191,14 +191,14 @@ select:focus { 接下来是表单中的 {{htmlelement("label")}} 元素，这是确保表单无障碍的关键特性之一。表单的挑战在于，你需要标签来指明每个表单输入应该输入的数据。每个标签都应该包含在 {{htmlelement("label")}} 中，并且与其对应的表单输入明确关联（每个 `