Skip to content

Commit

Permalink
Merge branch 'main' into update/ru-web-api-server-sent-events
Browse files Browse the repository at this point in the history
  • Loading branch information
leon-win authored Nov 29, 2024
2 parents f950a5d + cca56ae commit d1ed867
Show file tree
Hide file tree
Showing 757 changed files with 23,385 additions and 7,823 deletions.
6 changes: 3 additions & 3 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,12 +4,12 @@ This document describes the general guidelines for translating MDN content, whic

For guidelines relating to specific locales, we have locale-specific docs in subdirectories:

- [Russian translation guide / Участие в переводе](ru/translation-guide.md)
- [Simplified Chinese Guide / 简体中文翻译指南](zh-cn/translation-guide.md)
- [Traditional Chinese Guide / 正體中文翻譯指南](zh-tw/translation-guide.md)
- [Spanish guide / Guía en español](es/README.md)
- [Japanese translation guide / 日本語翻訳ガイド](ja/README.md)
- [Korean translation guide / 한국 번역 지침](ko/README.md)
- [Russian translation guide / Руководство по переводу на русский язык](ru/README.md)
- [Simplified Chinese Guide / 简体中文翻译指南](zh-cn/translation-guide.md)
- [Traditional Chinese Guide / 正體中文翻譯指南](zh-tw/translation-guide.md)

> [!NOTE]
> If you want to add a guide to document some specific guidelines for your locale and it does not already appear here, you are welcome to add one, or [talk to the locale teams](https://github.com/mdn/translated-content/blob/main/PEERS_GUIDELINES.md#review-teams) about it.
Expand Down
25 changes: 18 additions & 7 deletions docs/ru/translation-guide.md → docs/ru/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,24 @@
# Участие в переводе

Для начала ознакомьтесь с [общими правилами][], в частности, со страницей ["Writing style guide"][].
Для начала ознакомьтесь с [правилами внесения изменений в MDN][https://github.com/mdn/translated-content/blob/main/CONTRIBUTING.md], [информацией о переводе документов MDN](https://github.com/mdn/translated-content/blob/main/docs/README.md) и [Руководством по составлению документации](/ru/docs/MDN/Guidelines).

Основная тема — [Перевод MDN на русский язык](https://github.com/mdn/translated-content/issues/276)
## Использование ссылок

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

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

```md
If you are new to HTML, CSS, JavaScript, etc., try our [Learn web development](/en-US/docs/Learn) tutorials.
```

При переводе на русский язык следует заменить `en-US` на `ru`:

```md
Если вы только начинаете изучение HTML, CSS и JavaScript, попробуйте наши руководства по [Изучению веб-разработки](/ru/docs/Learn).
```

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

- «_Вы_» и его производные пишите с маленькой буквы.
- Всегда используйте букву «`ё`».
Expand All @@ -15,7 +29,7 @@
- При переводе зарубежных имён пользуйтесь [правилами практической транскрипции](https://ru.wikipedia.org/wiki/Категория:Практическая_транскрипция_с_русским_языком).
- Не переводите названия компаний, библиотек и т.д.
- Не переводите аббревиатуры (API, DOM, UI).
- Не склоняйте через апостроф иностранные слова. Если это требуется, попробуйте русифицировать слово (URL'ы -> URL-адреса).
- Не склоняйте через апостроф иностранные слова. Если это требуется, попробуйте русифицировать слово (например, вместо `URL'ы` следует использовать `URL-адреса`).
- Названия статей и заголовки пишите с одной заглавной буквы.

## Глоссарий
Expand All @@ -37,6 +51,3 @@
| technical reference | технические материалы (при использовании в качестве заголовка) |

\* — по возможности лучше избежать прямого перевода, используя синонимы или лучше раскрывая смысл.

[общими правилами]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines
["Writing style guide"]: https://developer.mozilla.org/en-US/docs/MDN/Guidelines/Writing_style_guide
3 changes: 2 additions & 1 deletion files/es/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1710,7 +1710,7 @@
/es/docs/Web/API/PositionOptions /es/docs/Web/API/Geolocation/getCurrentPosition
/es/docs/Web/API/PushManager/supportedContentEncodings /es/docs/Web/API/PushManager/supportedContentEncodings_static
/es/docs/Web/API/RandomSource/Obtenervaloresaleatorios /es/docs/Web/API/Crypto/getRandomValues
/es/docs/Web/API/SubtleCrypto/encrypt /es/docs/Web/HTTP/Headers/Digest
/es/docs/Web/API/SubtleCrypto/encrypt /es/docs/Web/HTTP/Headers/Content-Digest
/es/docs/Web/API/UIEvent/pageX /es/docs/Web/API/MouseEvent/pageX
/es/docs/Web/API/URL/createObjectURL /es/docs/Web/API/URL/createObjectURL_static
/es/docs/Web/API/WebGL_API/Getting_started_with_WebGL /es/docs/Web/API/WebGL_API/Tutorial/Getting_started_with_WebGL
Expand Down Expand Up @@ -2216,6 +2216,7 @@
/es/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types /es/docs/Web/HTTP/MIME_types/Common_types
/es/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Lista_completa_de_tipos_MIME /es/docs/Web/HTTP/MIME_types/Common_types
/es/docs/Web/HTTP/Gestion_de_la_conexion_en_HTTP_1.x /es/docs/Web/HTTP/Connection_management_in_HTTP_1.x
/es/docs/Web/HTTP/Headers/Digest /es/docs/Web/HTTP/Headers/Content-Digest
/es/docs/Web/HTTP/Peticiones_condicionales /es/docs/Web/HTTP/Conditional_requests
/es/docs/Web/HTTP/Sesión /es/docs/Web/HTTP/Session
/es/docs/Web/HTTP/Status/8080 /es/docs/Web/HTTP/Status/413
Expand Down
8 changes: 4 additions & 4 deletions files/es/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -9562,6 +9562,10 @@
"modified": "2020-10-28T14:39:35.644Z",
"contributors": ["noksenberg", "IsraelFloresDGA", "ervin_santos"]
},
"Web/HTTP/Headers/Content-Digest": {
"modified": "2020-10-15T22:27:29.781Z",
"contributors": ["joseluisq"]
},
"Web/HTTP/Headers/Content-Disposition": {
"modified": "2020-10-15T21:58:39.489Z",
"contributors": ["kbono", "lagwy"]
Expand Down Expand Up @@ -9594,10 +9598,6 @@
"modified": "2020-10-15T22:29:00.325Z",
"contributors": ["IsraelFloresDGA"]
},
"Web/HTTP/Headers/Digest": {
"modified": "2020-10-15T22:27:29.781Z",
"contributors": ["joseluisq"]
},
"Web/HTTP/Headers/ETag": {
"modified": "2020-10-15T21:57:09.273Z",
"contributors": ["zechworld", "evalenzuela", "stwilberth", "edgarrod71"]
Expand Down
Loading

0 comments on commit d1ed867

Please sign in to comment.