Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[ru] add translation rules for external links #24791

Merged
merged 3 commits into from
Dec 4, 2024
Merged

[ru] add translation rules for external links #24791

merged 3 commits into from
Dec 4, 2024

Conversation

leon-win
Copy link
Member

@leon-win leon-win commented Nov 26, 2024 •
edited
Loading

Description

This PR adds translation rules for external links for ru locale.

Добавил правила перевода ссылок на сторонние ресурсы, а также исправил и привёл к одному виду часть ссылок на Википедию.

Motivation

Для того, чтобы упорядочить, унифицировать и со временем привести к одному виду все ссылки на сторониие ресурсы.

При отстуствии локализованной версии документа переводить его название с языка оригинала на русский я считаю бессмысленным, так как:

  1. Это не поможет пользователю получить перевод этого документ (ему нужно будет сделать это самостоятельно).
  2. Мы самовольно изменяем название документа за его автора.
  3. При переводе неэлектронной литературы принято указывать оргиниальные названия документов, на которые есть ссылки. Это делается для того, чтобы читатель мог находить эти документы (поиск по переведённому названию будет сложнее или вообще невозможен). Обратная ситуция при переводе с русского языка на английский -- тогда наоборот принято делать перевод (+ добавлять транскрипцию оргиниального русского названия), такие правил существуют для международных научных журналов, так как они публикуются на английском языке.

Немного ссылок по теме (из того, что удалось найти):

@leon-win leon-win requested a review from a team as a code owner November 26, 2024 17:47
@leon-win leon-win requested review from lex111 and removed request for a team November 26, 2024 17:47
@github-actions github-actions bot added the l10n-ru Issues related to Russian content. label Nov 26, 2024
@github-actions GitHub Actions
Copy link
Contributor

github-actions bot commented Nov 26, 2024 •
edited
Loading

Preview URLs (28 pages)
Flaws (299)

Note! 11 documents with no flaws that don't need to be listed. 🎉

URL: /ru/docs/Glossary/Crawler
Title: Crawler
Flaw count: 1

  • macros:
    • /ru/docs/Glossary/Search_engine does not exist but fell back to /en-US/docs/Glossary/Search_engine

URL: /ru/docs/Glossary/Blink
Title: Blink
Flaw count: 2

  • broken_links:
    • Is currently http:// but can become https://
    • Is currently http:// but can become https://

URL: /ru/docs/Glossary/Class
Title: Класс
Flaw count: 1

  • broken_links:
    • Can't resolve /ru/docs/Web/JavaScript/Guide/Details_of_the_Object_Model

URL: /ru/docs/Glossary/AJAX
Title: AJAX
Flaw count: 3

  • macros:
    • /ru/docs/Glossary/SPA does not exist but fell back to /en-US/docs/Glossary/SPA
    • /ru/docs/Web/API/Fetch redirects to /ru/docs/Web/API/Window/fetch
    • /ru/docs/Glossary/SPA does not exist but fell back to /en-US/docs/Glossary/SPA

URL: /ru/docs/Glossary/ATAG
Title: ATAG
Flaw count: 2

  • broken_links:
    • Is currently http:// but can become https://
    • Is currently http:// but can become https://

URL: /ru/docs/Glossary/User_agent
Title: Агент пользователя
Flaw count: 1

  • broken_links:
    • Is currently http:// but can become https://

URL: /ru/docs/Glossary/TLS
Title: TLS
Flaw count: 3

  • macros:
    • /ru/docs/Glossary/SSL does not exist but fell back to /en-US/docs/Glossary/SSL
    • /ru/docs/Glossary/Digital_certificate does not exist but fell back to /en-US/docs/Glossary/Digital_certificate
    • /ru/docs/Glossary/SSL does not exist but fell back to /en-US/docs/Glossary/SSL

URL: /ru/docs/MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_glossary
Title: Как создавать записи в глоссарии и как на них ссылаться
Flaw count: 38

  • macros:
    • /ru/docs/MDN/Community/Contributing/Our_repositories does not exist but fell back to /en-US/docs/MDN/Community/Contributing/Our_repositories
    • /ru/docs/MDN/Community/Contributing/Security_vulnerability_response does not exist but fell back to /en-US/docs/MDN/Community/Contributing/Security_vulnerability_response
    • /ru/docs/MDN/Community/Communication_channels does not exist but fell back to /en-US/docs/MDN/Community/Communication_channels
    • /ru/docs/MDN/Community/Discussions does not exist but fell back to /en-US/docs/MDN/Community/Discussions
    • /ru/docs/MDN/Community/Learn_forum does not exist but fell back to /en-US/docs/MDN/Community/Learn_forum
    • and 28 more flaws omitted
  • broken_links:
    • Anchor not lowercase
    • Anchor not lowercase
    • Anchor not lowercase
    • Can't resolve /ru/docs/MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary#How_to_use_the_Glossary_macro
    • Can't resolve /ru/docs/Glossary/Signature/Email

URL: /ru/docs/Web/Accessibility
Title: Доступность
Flaw count: 20

  • macros:
    • /ru/docs/Web/Accessibility/Information_for_Web_authors does not exist but fell back to /en-US/docs/Web/Accessibility/Information_for_Web_authors
    • /ru/docs/Web/Accessibility/Accessibility:_What_users_can_to_to_browse_safely does not exist but fell back to /en-US/docs/Web/Accessibility/Accessibility:_What_users_can_to_to_browse_safely
    • /ru/docs/Web/Accessibility/An_overview_of_accessible_web_applications_and_widgets does not exist but fell back to /en-US/docs/Web/Accessibility/An_overview_of_accessible_web_applications_and_widgets
    • /ru/docs/Web/Accessibility/Understanding_WCAG does not exist but fell back to /en-US/docs/Web/Accessibility/Understanding_WCAG
    • /ru/docs/Web/Accessibility/Cognitive_accessibility does not exist but fell back to /en-US/docs/Web/Accessibility/Cognitive_accessibility
    • and 11 more flaws omitted
  • broken_links:
    • Is currently http:// but can become https://
    • Can't resolve /ru/docs/Accessibility/Web_Development
    • Can't resolve /ru/docs/Accessibility/ARIA
    • Can't resolve /ru/docs/Accessibility/AT_Development

URL: /ru/docs/Web/JavaScript/Reference/Lexical_grammar
Title: Лексический синтаксис
Flaw count: 8

  • macros:
    • /ru/docs/Web/JavaScript/Guide/Using_classes does not exist but fell back to /en-US/docs/Web/JavaScript/Guide/Using_classes
    • /ru/docs/Web/JavaScript/Reference/Global_Objects/null redirects to /ru/docs/Web/JavaScript/Reference/Operators/null
    • /ru/docs/Web/JavaScript/Reference/template_strings redirects to /ru/docs/Web/JavaScript/Reference/Template_literals
    • /ru/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators does not exist but fell back to /en-US/docs/Web/JavaScript/Reference/Operators
  • broken_links:
    • Anchor not lowercase
    • Can't resolve /ru/docs/Web/JavaScript/Guide/Regular_Expressions
    • Is currently http:// but can become https://
    • Is currently http:// but can become https://

URL: /ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean
Title: Boolean
Flaw count: 4

  • macros:
    • /ru/docs/Web/JavaScript/Reference/Global_Objects/null redirects to /ru/docs/Web/JavaScript/Reference/Operators/null
    • /ru/docs/Web/JavaScript/Reference/Global_Objects/null redirects to /ru/docs/Web/JavaScript/Reference/Operators/null
    • /ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean/Boolean does not exist but fell back to /en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean/Boolean
    • /ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean/Boolean does not exist but fell back to /en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean/Boolean

URL: /ru/docs/Web/API/CanvasRenderingContext2D/bezierCurveTo
Title: CanvasRenderingContext2D.bezierCurveTo()
Flaw count: 1

  • translation_differences:
    • Differences in the important macros (3 in common of 7 possible)

URL: /ru/docs/Web/API/Canvas_API/Tutorial/Pixel_manipulation_with_canvas
Title: Пиксельная манипуляция с холстом
Flaw count: 5

  • macros:
    • /ru/docs/Web/API/CanvasRenderingContext2D/createImageData does not exist but fell back to /en-US/docs/Web/API/CanvasRenderingContext2D/createImageData
    • /ru/docs/Web/API/CanvasRenderingContext2D/imageSmoothingEnabled does not exist but fell back to /en-US/docs/Web/API/CanvasRenderingContext2D/imageSmoothingEnabled
    • /ru/docs/Web/HTML/Element/image redirects to /ru/docs/Web/HTML/Element/img
  • broken_links:
    • Can't resolve /ru/docs/Web/HTTP/data_URIs
  • translation_differences:
    • Differences in the important macros (1 in common of 7 possible)

URL: /ru/docs/Web/API/WebGL_API/Tutorial/Lighting_in_WebGL
Title: Lighting in WebGL
Flaw count: 1

  • macros:
    • /ru/docs/Glossary/texel does not exist but fell back to /en-US/docs/Glossary/Texel

URL: /ru/docs/Web/HTTP/Status
Title: Коды состояния ответа HTTP
Flaw count: 17

  • macros:
    • /ru/docs/Web/HTTP/Compression does not exist but fell back to /en-US/docs/Web/HTTP/Compression
    • /ru/docs/Web/HTTP/Range_requests does not exist but fell back to /en-US/docs/Web/HTTP/Range_requests
    • /ru/docs/Web/HTTP/Evolution_of_HTTP does not exist but fell back to /en-US/docs/Web/HTTP/Evolution_of_HTTP
    • /ru/docs/Web/HTTP/Protocol_upgrade_mechanism does not exist but fell back to /en-US/docs/Web/HTTP/Protocol_upgrade_mechanism
    • /ru/docs/Web/HTTP/Proxy_servers_and_tunneling does not exist but fell back to /en-US/docs/Web/HTTP/Proxy_servers_and_tunneling
    • and 12 more flaws omitted

URL: /ru/docs/Learn/HTML/Introduction_to_HTML/Getting_started
Title: Начало работы с HTML
Flaw count: 102

  • macros:
    • /ru/docs/Learn/CSS/Building_blocks/Cascade_layers does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Cascade_layers
    • /ru/docs/Learn/CSS/Building_blocks/Organizing does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Organizing
    • /ru/docs/Learn/CSS/Building_blocks/Creating_fancy_letterheaded_paper does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Creating_fancy_letterheaded_paper
    • /ru/docs/Learn/CSS/Building_blocks/A_cool_looking_box does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/A_cool_looking_box
    • /ru/docs/Learn/CSS/CSS_layout/Media_queries does not exist but fell back to /en-US/docs/Learn/CSS/CSS_layout/Media_queries
    • and 92 more flaws omitted
  • broken_links:
    • No need for the pathname in anchor links if it's the same page
    • No need for the pathname in anchor links if it's the same page
    • No need for the pathname in anchor links if it's the same page
    • Can't resolve /ru/docs/Web/HTML/Applying_color
  • translation_differences:
    • Differences in the important macros (1 in common of 19 possible)

URL: /ru/docs/Learn/Server-side/Express_Nodejs/Introduction
Title: Express/Node introduction
Flaw count: 90

  • macros:
    • /ru/docs/Learn/CSS/Building_blocks/Cascade_layers does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Cascade_layers
    • /ru/docs/Learn/CSS/Building_blocks/Organizing does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Organizing
    • /ru/docs/Learn/CSS/Building_blocks/Creating_fancy_letterheaded_paper does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/Creating_fancy_letterheaded_paper
    • /ru/docs/Learn/CSS/Building_blocks/A_cool_looking_box does not exist but fell back to /en-US/docs/Learn/CSS/Building_blocks/A_cool_looking_box
    • /ru/docs/Learn/CSS/CSS_layout/Media_queries does not exist but fell back to /en-US/docs/Learn/CSS/CSS_layout/Media_queries
    • and 84 more flaws omitted
  • broken_links:
    • Can't resolve /ru/docs/Web/Apps/Fundamentals/Modern_web_app_architecture/MVC_architecture
External URLs (18)

URL: /ru/docs/Glossary/JSON
Title: JSON

URL: /ru/docs/Glossary/Class
Title: Класс

URL: /ru/docs/Glossary/AJAX
Title: AJAX

URL: /ru/docs/Glossary/Cookie
Title: Cookie

URL: /ru/docs/Glossary/FTP
Title: FTP

URL: /ru/docs/Glossary/ATAG
Title: ATAG

URL: /ru/docs/Glossary/Percent-encoding
Title: Процентное кодирование

URL: /ru/docs/Glossary/Card_sorting
Title: Card sorting

URL: /ru/docs/Glossary/User_agent
Title: Агент пользователя

URL: /ru/docs/Glossary/TLS
Title: TLS

URL: /ru/docs/MDN/Writing_guidelines/Howto/Write_a_new_entry_in_the_glossary
Title: Как создавать записи в глоссарии и как на них ссылаться

URL: /ru/docs/Web/Accessibility
Title: Доступность

URL: /ru/docs/Web/JavaScript/Reference/Lexical_grammar
Title: Лексический синтаксис

URL: /ru/docs/Web/API/WebGL_API/Tutorial/Lighting_in_WebGL
Title: Lighting in WebGL

URL: /ru/docs/Learn/Server-side/Express_Nodejs/Introduction
Title: Express/Node introduction

(comment last updated: 2024-12-04 17:27:10)

@leon-win leon-win mentioned this pull request Nov 26, 2024
Merged
@leon-win
Copy link
Member Author

@pepelsbey , посмотри, пожалуйста этот PR.
Как ты считаешь, нужно ли переводить в ссылках заголовки документов на иностранных языках?

@pepelsbey
Copy link
Member

Поддерживаю ключевую идею, что перевод названий ресурсов задаёт ложные ожидания, что документ локализован. Так что если используется именно название статьи, то нужен оригинал. Другое дело, что иногда лучше давать описание ресурса, вместо его названия: часто статьи так называются (игра слов, скажем), что неочевидно, о чём она. В таких случаях нужно переводить, конечно же. Ну и уметь отличать одно от другого.

pepelsbey
pepelsbey reviewed Dec 3, 2024
View reviewed changes
Copy link
Member

@pepelsbey pepelsbey left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

В целом отлично, только пара вопросов :)

docs/ru/README.md Show resolved Hide resolved
files/ru/web/accessibility/index.md Show resolved Hide resolved
@leon-win
Copy link
Member Author

leon-win commented Dec 4, 2024

Поддерживаю ключевую идею, что перевод названий ресурсов задаёт ложные ожидания, что документ локализован. Так что если используется именно название статьи, то нужен оригинал. Другое дело, что иногда лучше давать описание ресурса, вместо его названия: часто статьи так называются (игра слов, скажем), что неочевидно, о чём она. В таких случаях нужно переводить, конечно же. Ну и уметь отличать одно от другого.

@pepelsbey, благодарю за ревью и полезные замечания!

Дополнил правила и пример 👌

@leon-win leon-win requested a review from pepelsbey December 4, 2024 17:31
@leon-win leon-win merged commit 7d6ce9f into mdn:main Dec 4, 2024
7 checks passed
@leon-win leon-win deleted the improve/ru-README branch December 4, 2024 21:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@pepelsbey pepelsbey pepelsbey approved these changes

@lex111 lex111 Awaiting requested review from lex111 lex111 is a code owner automatically assigned from mdn/yari-content-ru

Assignees
No one assigned
Labels
l10n-ru Issues related to Russian content.
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.
2 participants
@leon-win @pepelsbey