Skip to content

Commit

Permalink
[ru] add translation rules for external links (#24791)
Browse files Browse the repository at this point in the history
* [ru] add translation rules for external links

* [ru] add external links translation rule
  • Loading branch information
leon-win authored Dec 4, 2024
1 parent 5303e07 commit 7d6ce9f
Show file tree
Hide file tree
Showing 29 changed files with 64 additions and 40 deletions.
28 changes: 27 additions & 1 deletion docs/ru/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,9 @@

## Использование ссылок

При переводе документов не забывайте изменять язык (`en-US` на `ru`) во внутренних ссылках на сайт MDN так, чтобы они вели на соответствующие локализованные страницы. Также для внутренних ссылок необходимо сохранять только путь в URL-адресе (без схемы и имени домена).
### Внутренние ссылки

Во внутренних ссылках на сайт MDN необходимо изменять язык (`en-US` на `ru`) и сохранять только путь в URL-адресе (без схемы и имени домена) так, чтобы они вели на соответствующие локализованные страницы.

Рассмотрим пример:

Expand All @@ -18,6 +20,30 @@ If you are new to HTML, CSS, JavaScript, etc., try our [Learn web development](/
Если вы только начинаете изучение HTML, CSS и JavaScript, попробуйте наши руководства по [Изучению веб-разработки](/ru/docs/Learn).
```

### Внешние ссылки

При переводе ссылок на сторонние сайты следует придерживаться следующих правил:

- Если у документа есть локализованная версия, то заменять ссылку на неё, включая название документа и URL-адрес (это применительно к таким ресурсам как [Википедия](https://ru.wikipedia.org/)). В случаях, когда локализованная версия статьи уступает англоязычной (по объёму или дате обновления) до потери ценности, можно оставить оригинальную ссылку.
- Если у документа нет локализованной версии, то оставлять оригинальное название документа, и переводить только окружающий текст. Также можно добавлять информацию о языке документа (например, `(англ.)`).
- В некоторых случаях в тексте ссылки вместо названия ресурса лучше указывать его описание на русском языке. Например, если в заголовке статьи есть «игра слов» или аббревиатура, понятная только на языке оригинала.

Примеры ссылок на сторонние сайты:

```md
- [Global variable](https://en.wikipedia.org/wiki/Global_variable) on Wikipedia
- [Class-based programming](https://en.wikipedia.org/wiki/Class-based_programming) on Wikipedia
- [FAQ](https://www.chromium.org/blink/developer-faq/) on Blink
```

На русский язык следует перевести таким образом:

```md
- [Глобальная переменная](https://ru.wikipedia.org/wiki/Глобальная_переменная) в Википедии
- [Class-based programming](https://en.wikipedia.org/wiki/Class-based_programming) в Википедии (англ.)
- [Часто задаваемые вопросы](https://www.chromium.org/blink/developer-faq/) на сайте Blink (англ.)
```

## Общие рекомендации по переводу на русский язык

- «_Вы_» и его производные пишите с маленькой буквы.
Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/ajax/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,4 +21,4 @@ Ajax можно использовать для создания {{Glossary("SPA
- {{DOMxRef("Fetch API")}}
- {{Glossary("SPA", "Single-page application")}}
- {{DOMxRef("XMLHttpRequest")}}
- [AJAX](https://en.wikipedia.org/wiki/AJAX) на Википедии
- [AJAX](https://ru.wikipedia.org/wiki/AJAX) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/atag/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ ATAG (Authoring Tool {{glossary("Accessibility")}} Guidelines) - это {{Glossa

### Общие сведения

- [ATAG как часть Web Accessibility Initiative](http://en.wikipedia.org/wiki/Web_Accessibility_Initiative#Authoring_Tools_Accessibility_Guidelines_.28ATAG.29) на Википедии
- [Authoring Tool Accessibility Guidelines (ATAG)](<https://en.wikipedia.org/wiki/Web_Accessibility_Initiative#Authoring_Tool_Accessibility_Guidelines_(ATAG)>) в Википедии (англ.)

### Технические ссылки

Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/blink/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,5 @@ Blink - это браузерный движок с открытым исход
### Основная информация

- [Домашняя страница](http://www.chromium.org/blink) проекта Blink
- [Blink](http://en.wikipedia.org/wiki/Blink_%28layout_engine%29) на Википедии
- [Blink](<https://ru.wikipedia.org/wiki/Blink_(движок)>) в Википедии
- [FAQ](http://www.chromium.org/blink/developer-faq) по Blink
2 changes: 1 addition & 1 deletion files/ru/glossary/card_sorting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ slug: Glossary/Card_sorting

### Общие знания

- [Card sorting](https://en.wikipedia.org/wiki/Card_sorting) на Википедии (англ.)
- [Card sorting](https://en.wikipedia.org/wiki/Card_sorting) в Википедии (англ.)
6 changes: 3 additions & 3 deletions files/ru/glossary/class/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ slug: Glossary/Class
### Общие знания

- [Языки, основанные на классах против прототипно-ориентированных](/ru/docs/Web/JavaScript/Guide/Details_of_the_Object_Model)
- [Использование функций как классов в JavaScript](/ru/docs/Learn/JavaScript/%D0%9E%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D1%8B#The_Class)
- [Класс-ориентированное программирование](https://en.wikipedia.org/wiki/Class-based_programming) на Википедии (только английский)
- [Объектно-ориентированное программирование](https://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D0%BD%D0%BE-%D0%BE%D1%80%D0%B8%D0%B5%D0%BD%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%BD%D0%BE%D0%B5_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5) на Википедии
- [Классы в JavaScript](/ru/docs/Learn/JavaScript/Objects/Classes_in_JavaScript)
- [Class-based programming](https://en.wikipedia.org/wiki/Class-based_programming) в Википедии (англ.)
- [Объектно-ориентированное программирование](https://ru.wikipedia.org/wiki/Объектно-ориентированное_программирование) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/cookie/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ Cookie - это небольшой фрагмент информации, сох

### Общие знания

- [HTTP cookie](https://en.wikipedia.org/wiki/HTTP_cookie) в Википедии
- [Cookie](https://ru.wikipedia.org/wiki/Cookie) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/crawler/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: Glossary/Crawler

## Узнать больше

- [Поисковый робот](https://ru.wikipedia.org/wiki/%D0%9F%D0%BE%D0%B8%D1%81%D0%BA%D0%BE%D0%B2%D1%8B%D0%B9_%D1%80%D0%BE%D0%B1%D0%BE%D1%82) на Википедии
- [Поисковый робот](https://ru.wikipedia.org/wiki/Поисковый_робот) в Википедии

1. [MDN Web Docs Glossary](/ru/docs/Glossary)

Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/first-class_function/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ sayHello()(); // Выведет в консоль строку "Привет!"
## Смотрите также

- [Функции первого класса](https://ru.wikipedia.org/wiki/Функции_первого_класса) на Википедии
- [Функции первого класса](https://ru.wikipedia.org/wiki/Функции_первого_класса) в Википедии
- [Глоссарий](/ru/docs/Glossary)
- {{glossary("Variable", "Переменная")}}
- {{glossary("Function", "Функция")}}
Expand Down
4 changes: 2 additions & 2 deletions files/ru/glossary/ftp/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,5 +11,5 @@ slug: Glossary/FTP

### Общие сведения

- [Руководство по загрузке файлов через FTP для новичка (англ.)](/en-US/Learn/Upload_files_to_a_web_server).
- [FTP в Википедии](http://ru.wikipedia.org/wiki/FTP).
- [Руководство по загрузке файлов через FTP для новичков](/ru/docs/Learn/Common_questions/Tools_and_setup/Upload_files_to_a_web_server)
- [FTP](https://ru.wikipedia.org/wiki/FTP) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/json/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ JSON может представлять числа, булевы значени

### Общие знания

- [JSON](https://ru.wikipedia.org/wiki/JSON) на Википедии
- [JSON](https://ru.wikipedia.org/wiki/JSON) в Википедии

### Техническая информация

Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/percent-encoding/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,6 @@ l10n:

## Смотрите также

- Определение [процентного кодирования](https://en.wikipedia.org/wiki/Percent-encoding) в Википедии.
- [Percent-encoding](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-адресов
2 changes: 1 addition & 1 deletion files/ru/glossary/polymorphism/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ slug: Glossary/Polymorphism

### Общие знания

- [Polymorphism](https://en.wikipedia.org/wiki/Polymorphism_%28computer_science%29) на Википедии (англ.)
- [Полиморфизм](<https://ru.wikipedia.org/wiki/Полиморфизм_(информатика)>) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/proxy_server/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,4 +15,4 @@ slug: Glossary/Proxy_server
## Узнать подробнее

- [Прокси сервера и туннелирование](/ru/docs/Web/HTTP/Proxy_servers_and_tunneling)
- [Прокси сервер](https://en.wikipedia.org/wiki/Proxy_server) на Википедии
- [Прокси-сервер](https://ru.wikipedia.org/wiki/Прокси-сервер) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/seo/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ slug: Glossary/SEO

### Основной источник

- [Поисковая оптимизация](https://ru.wikipedia.org/wiki/%D0%9F%D0%BE%D0%B8%D1%81%D0%BA%D0%BE%D0%B2%D0%B0%D1%8F_%D0%BE%D0%BF%D1%82%D0%B8%D0%BC%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F) На Википедии
- [Поисковая оптимизация](https://ru.wikipedia.org/wiki/Поисковая_оптимизация) в Википедии

### Learn SEO

Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/tls/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ l10n:
## Смотрите также

- [TLS](https://ru.wikipedia.org/wiki/TLS) (Википедия)
- [TLS](https://ru.wikipedia.org/wiki/TLS) в Википедии
- [RFC 8446](https://datatracker.ietf.org/doc/html/rfc8446) (The Transport Layer Security Protocol, Version 1.3)
- [RFC 5246](https://datatracker.ietf.org/doc/html/rfc5246) (The Transport Layer Security Protocol, Version 1.2)
- [Transport Layer Security](/ru/docs/Web/Security/Transport_Layer_Security)
Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/user_agent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ slug: Glossary/User_agent

### Общие сведения

- [User agent](https://ru.wikipedia.org/wiki/User_agent) на Википедии
- [User agent](https://ru.wikipedia.org/wiki/User_agent) в Википедии

### Техническая справка

Expand Down
2 changes: 1 addition & 1 deletion files/ru/glossary/ux/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ slug: Glossary/UX

## Узнайте больше

- [Опыт взаимодействия](https://ru.wikipedia.org/wiki/%D0%9E%D0%BF%D1%8B%D1%82_%D0%B2%D0%B7%D0%B0%D0%B8%D0%BC%D0%BE%D0%B4%D0%B5%D0%B9%D1%81%D1%82%D0%B2%D0%B8%D1%8F) на Википедии.
- [Опыт взаимодействия](https://ru.wikipedia.org/wiki/Опыт_взаимодействия) в Википедии
2 changes: 1 addition & 1 deletion files/ru/glossary/variable/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,4 +9,4 @@ slug: Glossary/Variable

## Подробнее

- [Переменная (программирование)](<https://ru.wikipedia.org/wiki/%D0%9F%D0%B5%D1%80%D0%B5%D0%BC%D0%B5%D0%BD%D0%BD%D0%B0%D1%8F_(%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)>) на Википедии
- [Переменная (программирование)](<https://ru.wikipedia.org/wiki/Переменная_(программирование)>) в Википедии
Original file line number Diff line number Diff line change
Expand Up @@ -699,7 +699,7 @@ textarea.onkeyup = function () {
{{ EmbedLiveSample('Entity_references_Including_special_characters_in_HTML', 700, 200, "", "", "hide-codepen-jsfiddle") }}

> [!NOTE]
> Таблица всех доступных в HTML символов-мнемоников в Википедии: [List of XML and HTML character entity references](http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references).
> Таблица доступных в HTML символов-мнемоников в Википедии: [Мнемоники в HTML](https://ru.wikipedia.org/wiki/Мнемоники_в_HTML).
## HTML комментарии

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ node hello.js
## Откуда это все взялось?

Node первоначально был выпущен только под Linux в 2009. Менеджер пакетов NPM был выпущен в 2010, а поддержка Windows была добавлена в 2012. Текущая LTS-версия Node v12.16.1 , в то время как последний выпуск Node версии 13.11.0. Это короткий экскурс в историю; обратитесь к [Википедии](https://en.wikipedia.org/wiki/Node.js#History), если вы хотите узнать больше).
Node первоначально был выпущен только под Linux в 2009. Менеджер пакетов NPM был выпущен в 2010, а поддержка Windows была добавлена в 2012. Текущая LTS-версия Node v12.16.1 , в то время как последний выпуск Node версии 13.11.0. Это короткий экскурс в историю; обратитесь к [Википедии](https://ru.wikipedia.org/wiki/Node.js#История), если вы хотите узнать больше.

Express первоначально был выпущен в ноябре 2010 и текущая версия API 4.17.1 вы можете отследить [изменения](https://expressjs.com/en/changelog/4x.html) и текущий релиз, и [GitHub](https://github.com/expressjs/express/blob/master/History.md) для более детальной информации о релизах.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ MDN [глоссарий](/ru/docs/Glossary) (глоссарий) — это ме
Мы рекомендуем сортировать ссылки по трём группам:

_**Общие знания**_
Ссылки, которые предоставляют информацию более общего характера, например, ссылка на [Википедию](https://wikipedia.org/) – это хорошая отправная точка.
Ссылки, которые предоставляют информацию более общего характера, например, ссылка на [Википедию](https://ru.wikipedia.org) – это хорошая отправная точка.

**_Технический справочник_**
Ссылки на более подробную техническую информацию, на MDN или в другом месте.
Expand Down
2 changes: 0 additions & 2 deletions files/ru/web/accessibility/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,6 @@ slug: Web/Accessibility

Технологии облегчают жизнь многим людям. А людям с ограниченными возможностями технологии дают такие возможности, которые ранее им были недоступны. Доступность в контексте разработки подразумевает создание такого контента, пользоваться которым мог бы каждый, несмотря на индивидуальные физические или когнитивные способности и вне зависимости от того, как они получают доступ в сеть.

«Термин "специальные возможности" часто применяется для описания возможности использования или удобства использования системы людьми с ограниченными возможностями, например, инвалидами на креслах-колясках. Это понятие следует понимать более широко, например, оно охватывает шрифт Брайля, пандусы для инвалидов на креслах-колясках, аудио-сигналы на пешеходных переходах, оборудованные рифлёной тактильной плиткой пешеходные дорожки, разработку веб-сайтов и так далее." [Статья Accessibility в английской Википедии](http://en.wikipedia.org/wiki/Accessibility)

"**Интернет принципиально создан для всех людей на Земле,** независимо от их аппаратных, программных, языковых, культурных, территориальных, физических или умственных способностей." [W3C - Accessibility](http://www.w3.org/standards/webdesign/accessibility)

## Документация
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ ctx.putImageData(myImageData, 0, 0);

### Оттенки серого цвета и инвертирование цветов

В этом примере мы перебираем все пиксели для изменения их значений, а затем помещаем модифицированный массив пикселей обратно в canvas с помощью [putImageData()](/ru/docs/Web/API/CanvasRenderingContext2D/putImageData). Функция инвертирования просто вычитает каждый цвет из максимального значения 255. Функция оттенков серого просто использует среднее значение красного, зелёного и синего. Вы также можете использовать средневзвешенное значение, заданное формулой `x = 0.299r + 0.587g + 0.114b`, например. Для дополнительной информации см. [Grayscale](http://en.wikipedia.org/wiki/Grayscale) в Википедии.
В этом примере мы перебираем все пиксели для изменения их значений, а затем помещаем модифицированный массив пикселей обратно в canvas с помощью [putImageData()](/ru/docs/Web/API/CanvasRenderingContext2D/putImageData). Функция инвертирования просто вычитает каждый цвет из максимального значения 255. Функция оттенков серого просто использует среднее значение красного, зелёного и синего. Вы также можете использовать средневзвешенное значение, заданное формулой `x = 0.299r + 0.587g + 0.114b`, например. Для дополнительной информации смотрите [Оттенки серого](https://ru.wikipedia.org/wiki/Оттенки_серого) в Википедии.

```html hidden
<canvas id="canvas" width="300" height="227"></canvas>
Expand Down
Loading

0 comments on commit 7d6ce9f

Please sign in to comment.