From fabb7a4bd11fe3f5c6a9c11c84fa4de85e453675 Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Sun, 10 Feb 2019 00:14:37 -0800 Subject: [PATCH 1/9] Add style-guide.md --- STYLE-GUIDE.md | 99 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 STYLE-GUIDE.md diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md new file mode 100644 index 000000000..335e2adb0 --- /dev/null +++ b/STYLE-GUIDE.md @@ -0,0 +1,99 @@ +# Universal Style Guide + +This repo describes rules that should be applied to **all** languages. + +NOTE TO MAINTAINERS: You may want to translate this guide so that it can be more accessible to your translators. + +## Heading IDs + +All headings have explicit IDs like this: + +```md +## Try React {#try-react} +``` + +Do **not** translate these IDs! They are used for navigation and will break if the document is referred to externally, i.e.: + +```md +See the [beginning section](/getting-started#try-react) for more information. +``` + +✅ DO: + +```md +## Prueba React {#try-react} +``` + +❌ DON'T: + +```md +## Prueba React {#prueba-react} +``` + +This will break the link above. + +## Text in Code Blocks + +Leave text in code blocks untranslated except for comments. You may optionally translate text in strings, but be careful not to translate strings that refer to code! + +Example: +```js +// Example +const element =

Hello, world

; +ReactDOM.render(element, document.getElementById('root')); +``` + +✅ DO: + +```js +// Ejemplo +const element =

Hello, world

; +ReactDOM.render(element, document.getElementById('root')); +``` + +✅ ALSO OKAY: + +```js +// Ejemplo +const element =

Hola mundo

; +ReactDOM.render(element, document.getElementById('root')); +``` + +❌ DON'T: + +```js +// Ejemplo +const element =

Hola mundo

; +// "root" refers to an element ID. +// DO NOT TRANSLATE +ReactDOM.render(element, document.getElementById('raíz')); +``` + +❌ DEFINITELY DON'T: + +```js +// Ejemplo +const elemento =

Hola mundo

; +ReactDOM.hacer(elemento, documento.obtenerElementoPorId('raíz')); +``` + +## External Links + +If an external link is to an article in a reference like [MDN] or [Wikipedia], and a version of that article exists in your language that is of decent quality, consider linking to that version instead. + +[MDN]: https://developer.mozilla.org/en-US/ +[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page + +Example: + +```md +React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). +``` + +✅ OK: + +```md +Los elementos de React son [inmutables](https://es.wikipedia.org/wiki/Objeto_inmutable). +``` + +For links that have no equivalent (Stack Overflow, YouTube videos, etc.), just use the English link. \ No newline at end of file From c2d65112941b2dca633a575005bd3b825008f770 Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Sun, 10 Feb 2019 00:39:03 -0800 Subject: [PATCH 2/9] Translate "style-guide.md" --- STYLE-GUIDE.md | 73 ++++++++++++++++++++++++++------------------------ 1 file changed, 38 insertions(+), 35 deletions(-) diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md index 335e2adb0..ebf16dccb 100644 --- a/STYLE-GUIDE.md +++ b/STYLE-GUIDE.md @@ -1,90 +1,91 @@ -# Universal Style Guide +# Универсальное руководство по стилю -This repo describes rules that should be applied to **all** languages. +Описанные ниже правила пришли [из репозитория](https://github.com/reactjs/reactjs.org-translation/blob/2b830171e78a17be112d677c29f4cdb2537af626/style-guide.md), предписывающего стиль общий для **всех** языков, на которые переводится документация. -NOTE TO MAINTAINERS: You may want to translate this guide so that it can be more accessible to your translators. +В замечании мэйнтэйнерам советуется перевести этот документ, чтобы сделать его понятнее для переводчиков. -## Heading IDs +## Идентификаторы заголовков + +Каждый заголовок имеет явный идентификатор. Это выглядит так: -All headings have explicit IDs like this: ```md ## Try React {#try-react} ``` -Do **not** translate these IDs! They are used for navigation and will break if the document is referred to externally, i.e.: +**НЕ** переводите такие идентификаторы! Они используются для навигации. Изменение идентификатора неизбежно приведёт к поломке, если на документ ссылкаются извне, например так: ```md -See the [beginning section](/getting-started#try-react) for more information. +Прочтите [главу для начинающих](/getting-started#try-react), чтобы узнать больше. ``` -✅ DO: +✅ Можно: ```md -## Prueba React {#try-react} +## Попробуйте React {#try-react} ``` -❌ DON'T: +❌ НЕЛЬЗЯ: ```md -## Prueba React {#prueba-react} +## Попробуйте React {#попробуйте-react} ``` -This will break the link above. +Это сломает ссылку, приведённую в примере выше. -## Text in Code Blocks +## Текст в блоках кода -Leave text in code blocks untranslated except for comments. You may optionally translate text in strings, but be careful not to translate strings that refer to code! +Не переводите текст в блоках кода за исключением комментариев. Вы можете по желанию перевести текст в строках, но избегайте перевода строк, относящихся к коду. -Example: +Пример: ```js // Example const element =

Hello, world

; ReactDOM.render(element, document.getElementById('root')); ``` -✅ DO: +✅ МОЖНО: ```js -// Ejemplo +// Пример const element =

Hello, world

; ReactDOM.render(element, document.getElementById('root')); ``` -✅ ALSO OKAY: +✅ ТОЖЕ МОЖНО: ```js -// Ejemplo -const element =

Hola mundo

; +// Пример +const element =

Здравствуй, мир!

; ReactDOM.render(element, document.getElementById('root')); ``` -❌ DON'T: +❌ НЕЛЬЗЯ: ```js -// Ejemplo -const element =

Hola mundo

; -// "root" refers to an element ID. -// DO NOT TRANSLATE -ReactDOM.render(element, document.getElementById('raíz')); +// Пример +const element =

Здравствуй, мир!

; +// "root" ссылается на идентификатор элемента. +// Не переводите его! +ReactDOM.render(element, document.getElementById('корень')); ``` -❌ DEFINITELY DON'T: +❌ СОВСЕМ НЕЛЬЗЯ: ```js -// Ejemplo -const elemento =

Hola mundo

; -ReactDOM.hacer(elemento, documento.obtenerElementoPorId('raíz')); +// Пример +const elemento =

Здравствуй, мир!

; +ReactDOM.отрендери(elemento, documento.obtenerElementoPorId('корень')); ``` -## External Links +## Внешние ссылки -If an external link is to an article in a reference like [MDN] or [Wikipedia], and a version of that article exists in your language that is of decent quality, consider linking to that version instead. +Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia] и там существует статья на русском языке с приемлемым качеством, подумайте, не лучше ли переделать ссылку, чтобы она указывала на русский вариант. [MDN]: https://developer.mozilla.org/en-US/ [Wikipedia]: https://en.wikipedia.org/wiki/Main_Page -Example: +Пример: ```md React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). @@ -93,7 +94,9 @@ React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). ✅ OK: ```md -Los elementos de React son [inmutables](https://es.wikipedia.org/wiki/Objeto_inmutable). +Элементы React [неизменяемы](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). ``` -For links that have no equivalent (Stack Overflow, YouTube videos, etc.), just use the English link. \ No newline at end of file +**Комментарий переводчика:** к сожалению, этот пример плох в русском варианте, так как русская статья про immutable objects на Википедии довольно низкого качества. + +Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть. \ No newline at end of file From 594a872bfa8200ac7a52d1e1e1c896ab22ee8ff0 Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Sun, 10 Feb 2019 12:33:46 -0800 Subject: [PATCH 3/9] =?UTF-8?q?=D0=98=D1=81=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?= =?UTF-8?q?=D0=BB=20=D1=87=D0=B0=D1=81=D1=82=D1=8C=20=D0=B7=D0=B0=D0=BC?= =?UTF-8?q?=D0=B5=D1=87=D0=B0=D0=BD=D0=B8=D0=B9=20=D0=BF=D1=80=D0=BE=20STY?= =?UTF-8?q?LE-GUIDE.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- STYLE-GUIDE.md | 102 ------------------------------------------- TRANSLATION.md | 116 ++++++++++++++++++++++++++++++++++++++++++++++++- 2 files changed, 114 insertions(+), 104 deletions(-) delete mode 100644 STYLE-GUIDE.md diff --git a/STYLE-GUIDE.md b/STYLE-GUIDE.md deleted file mode 100644 index ebf16dccb..000000000 --- a/STYLE-GUIDE.md +++ /dev/null @@ -1,102 +0,0 @@ -# Универсальное руководство по стилю - -Описанные ниже правила пришли [из репозитория](https://github.com/reactjs/reactjs.org-translation/blob/2b830171e78a17be112d677c29f4cdb2537af626/style-guide.md), предписывающего стиль общий для **всех** языков, на которые переводится документация. - -В замечании мэйнтэйнерам советуется перевести этот документ, чтобы сделать его понятнее для переводчиков. - -## Идентификаторы заголовков - -Каждый заголовок имеет явный идентификатор. Это выглядит так: - - -```md -## Try React {#try-react} -``` - -**НЕ** переводите такие идентификаторы! Они используются для навигации. Изменение идентификатора неизбежно приведёт к поломке, если на документ ссылкаются извне, например так: - -```md -Прочтите [главу для начинающих](/getting-started#try-react), чтобы узнать больше. -``` - -✅ Можно: - -```md -## Попробуйте React {#try-react} -``` - -❌ НЕЛЬЗЯ: - -```md -## Попробуйте React {#попробуйте-react} -``` - -Это сломает ссылку, приведённую в примере выше. - -## Текст в блоках кода - -Не переводите текст в блоках кода за исключением комментариев. Вы можете по желанию перевести текст в строках, но избегайте перевода строк, относящихся к коду. - -Пример: -```js -// Example -const element =

Hello, world

; -ReactDOM.render(element, document.getElementById('root')); -``` - -✅ МОЖНО: - -```js -// Пример -const element =

Hello, world

; -ReactDOM.render(element, document.getElementById('root')); -``` - -✅ ТОЖЕ МОЖНО: - -```js -// Пример -const element =

Здравствуй, мир!

; -ReactDOM.render(element, document.getElementById('root')); -``` - -❌ НЕЛЬЗЯ: - -```js -// Пример -const element =

Здравствуй, мир!

; -// "root" ссылается на идентификатор элемента. -// Не переводите его! -ReactDOM.render(element, document.getElementById('корень')); -``` - -❌ СОВСЕМ НЕЛЬЗЯ: - -```js -// Пример -const elemento =

Здравствуй, мир!

; -ReactDOM.отрендери(elemento, documento.obtenerElementoPorId('корень')); -``` - -## Внешние ссылки - -Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia] и там существует статья на русском языке с приемлемым качеством, подумайте, не лучше ли переделать ссылку, чтобы она указывала на русский вариант. - -[MDN]: https://developer.mozilla.org/en-US/ -[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page - -Пример: - -```md -React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). -``` - -✅ OK: - -```md -Элементы React [неизменяемы](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). -``` - -**Комментарий переводчика:** к сожалению, этот пример плох в русском варианте, так как русская статья про immutable objects на Википедии довольно низкого качества. - -Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть. \ No newline at end of file diff --git a/TRANSLATION.md b/TRANSLATION.md index 869751970..314d1e4a8 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -1,9 +1,19 @@ -# Перевод на русский язык сайта reactjs.org +# Перевод на русский язык сайта reactjs.org ## Оглавление Текущий прогресс: https://github.com/reactjs/ru.reactjs.org/issues/1 Пожалуйста, используйте этот ишью, если вы хотите что-то перевести и узнать. +## Оглавление + +* [Общие правила](#Общие-правила) + * [Слово живое и мёртвое](#Слово-живое-и-мёртвое) +* [Универсальное руководство по стилю](#Универсальное-руководство-по-стилю) + * [Идентификаторы заголовков](#Идентификаторы-заголовков) + * [Текст в блоках кода](#Текст-в-блоках-кода) + * [Внешние ссылки](#Внешние-ссылки) +* [Соглашение по переводу](#Соглашение-по-переводу) + ## Общие правила - _Вы_ и его производные пишите с маленькой буквы @@ -17,7 +27,7 @@ - Исключайте отсылки на пол читателя (см. секцию 3 на [этой странице](http://www.un.org/ru/gender-inclusive-language/guidelines.shtml)) - Названия статей и заголовки пишутся с одной заглавной буквы («Компоненты и пропсы», не «Компоненты и Пропсы»). -## Слово живое и мёртвое +### Слово живое и мёртвое Прежде чем переводить, почитайте пару страниц из «Слова живого и мёртвого» Норы Галь. Хотя бы эти две: @@ -49,6 +59,108 @@ Небольшие вольности в переводе допускаются, но только если они помогают передать смысл. Перевод не должен быть ни деревянным, ни фамильярным. Истина где-то посередине. +## Универсальное руководство по стилю + +Описанные ниже правила пришли [из репозитория](https://github.com/reactjs/reactjs.org-translation/blob/2b830171e78a17be112d677c29f4cdb2537af626/style-guide.md), предписывающего стиль общий для **всех** языков, на которые переводится документация. + +В замечании мейнтейнерам советуется перевести этот документ, чтобы сделать его понятнее для переводчиков. + +### Идентификаторы заголовков + +Каждый заголовок имеет явный идентификатор: + +```md +## Try React {#try-react} +``` + +**НЕ** переводите такие идентификаторы! Они используются для навигации. Изменение идентификатора неизбежно приведёт к поломке, если на документ ссылкаются извне, например так: + +```md +Прочтите [главу для начинающих](/getting-started#try-react), чтобы узнать больше. +``` + +✅ Можно: + +```md +## Попробуйте React {#try-react} +``` + +❌ НЕЛЬЗЯ: + +```md +## Попробуйте React {#попробуйте-react} +``` + +Это сломает ссылку, приведённую в примере выше. + +### Текст в блоках кода + +Не переводите текст в блоках кода, кроме комментариев. Вы можете по желанию перевести текст в строках, но избегайте перевода строк, относящихся к коду. + +Пример: +```js +// Example +const element =

Hello, world

; +ReactDOM.render(element, document.getElementById('root')); +``` + +✅ МОЖНО: + +```js +// Пример +const element =

Hello, world

; +ReactDOM.render(element, document.getElementById('root')); +``` + +✅ ТОЖЕ МОЖНО: + +```js +// Пример +const element =

Здравствуй, мир!

; +ReactDOM.render(element, document.getElementById('root')); +``` + +❌ НЕЛЬЗЯ: + +```js +// Пример +const element =

Здравствуй, мир!

; +// "root" ссылается на идентификатор элемента. +// Не переводите его! +ReactDOM.render(element, document.getElementById('корень')); +``` + +❌ СОВСЕМ НЕЛЬЗЯ: + +```js +// Пример +const elemento =

Здравствуй, мир!

; +ReactDOM.отрендери(elemento, documento.obtenerElementoPorId('корень')); +``` + +### Внешние ссылки + +Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia] и там существует статья на русском языке с приемлемым качеством, подумайте, не лучше ли переделать ссылку, чтобы она указывала на русский вариант. + +[MDN]: https://developer.mozilla.org/en-US/ +[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page + +Пример: + +```md +React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). +``` + +✅ OK: + +```md +Элементы React [иммутабельны](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). +``` + +**Комментарий переводчика:** к сожалению, этот пример плох в русском варианте, так как русская статья про immutable objects на Википедии довольно низкого качества. + +Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть. + ## Соглашение по переводу | Оригинальный термин | Перевод | From a35c8f84cc7aac698e68b0851536f1573afef18e Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Wed, 13 Feb 2019 09:31:24 -0800 Subject: [PATCH 4/9] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B5=D0=B2=D0=BE=D0=B4?= =?UTF-8?q?=D0=B8=D1=82=D0=B5=20=D1=81=D1=82=D1=80=D0=BE=D0=BA=D0=B8=20?= =?UTF-8?q?=D1=82=D0=B5=D0=BA=D1=81=D1=82=D0=B0=20=D0=B8=20=D0=BA=D0=BE?= =?UTF-8?q?=D0=BC=D0=BC=D0=B5=D0=BD=D1=82=D0=B0=D1=80=D0=B8=D0=B8=20=D0=B2?= =?UTF-8?q?=20=D0=BA=D0=BE=D0=B4=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- TRANSLATION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index 314d1e4a8..12b34bc52 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -95,7 +95,7 @@ ### Текст в блоках кода -Не переводите текст в блоках кода, кроме комментариев. Вы можете по желанию перевести текст в строках, но избегайте перевода строк, относящихся к коду. +Не переводите текст в блоках кода, кроме комментариев. А вот комментарии и текст в строках следует переводить, если они не относятся к коду. Пример: ```js From 9e7f585335b5b331e718acd1308d40b955735211 Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Wed, 13 Feb 2019 09:37:22 -0800 Subject: [PATCH 5/9] =?UTF-8?q?=D0=A0=D1=83=D1=81=D1=81=D0=BA=D0=B8=D0=B5?= =?UTF-8?q?=20MDN/Wiki=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- TRANSLATION.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index 12b34bc52..e9742ca3f 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -140,7 +140,7 @@ ReactDOM.отрендери(elemento, documento.obtenerElementoPorId('корен ### Внешние ссылки -Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia] и там существует статья на русском языке с приемлемым качеством, подумайте, не лучше ли переделать ссылку, чтобы она указывала на русский вариант. +Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia] и там существует статья на русском языке, исправьте ссылку, чтобы она указывала на русский вариант даже он неполный или требует улучшения. [MDN]: https://developer.mozilla.org/en-US/ [Wikipedia]: https://en.wikipedia.org/wiki/Main_Page @@ -157,8 +157,6 @@ React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). Элементы React [иммутабельны](https://ru.wikipedia.org/wiki/%D0%9D%D0%B5%D0%B8%D0%B7%D0%BC%D0%B5%D0%BD%D1%8F%D0%B5%D0%BC%D1%8B%D0%B9_%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82). ``` -**Комментарий переводчика:** к сожалению, этот пример плох в русском варианте, так как русская статья про immutable objects на Википедии довольно низкого качества. - Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть. ## Соглашение по переводу From cd461b14d5c2f6b378aa8894fdd5e96904ce019b Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Wed, 13 Feb 2019 09:41:09 -0800 Subject: [PATCH 6/9] Fix header in style-guide.md --- TRANSLATION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index e9742ca3f..8b7ba75ca 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -1,4 +1,4 @@ -# Перевод на русский язык сайта reactjs.org ## Оглавление +# Перевод на русский язык сайта reactjs.org Текущий прогресс: https://github.com/reactjs/ru.reactjs.org/issues/1 From d29c9b01ecfc936249a1d41d327cb68da1a39050 Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Wed, 13 Feb 2019 09:44:44 -0800 Subject: [PATCH 7/9] Keep glossary sorted --- TRANSLATION.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index 8b7ba75ca..76fe4408e 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -12,7 +12,7 @@ * [Идентификаторы заголовков](#Идентификаторы-заголовков) * [Текст в блоках кода](#Текст-в-блоках-кода) * [Внешние ссылки](#Внешние-ссылки) -* [Соглашение по переводу](#Соглашение-по-переводу) +* [Соглашение по переводу (глоссарий)](#Соглашение-по-переводу-глоссарий) ## Общие правила @@ -159,7 +159,9 @@ React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). Для ссылок, у которых нету языковых эквивалентов (Stack Overflow, видео на YouTube, и т. д.), просто оставьте оригинальный вариант как есть. -## Соглашение по переводу +## Соглашение по переводу (глоссарий) + +**Пожалуйста, поддерживайте глоссарий в алфавитном порядке.** | Оригинальный термин | Перевод | | ------------------ | ---------- | @@ -224,18 +226,18 @@ React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object). | props | пропсы *(мн. ч.)* | | production | продакшен | | production mode | продакшен-режим | -| reducer | редюсер | -| reuse | повторное использование, переиспользование | | React | React | | React element | React-элемент, элемент React | | reconciliation | согласование | +| reducer | редюсер | +| ref | реф *(ед. ч.)* | +| refs | рефы *(мн. ч.)* | | render(ing) | рендер, рендерить, отрендерить | | renderer | рендерер (*напр., поверхностный рендерер*) | | re-render(ing) | (по контексту) рендер, повторный рендер, последующий рендер, отрендерить снова | | render prop | рендер-проп *(ед. ч.)* | | render props | рендер-пропсы *(мн. ч.)* | -| ref | реф *(ед. ч.)* | -| refs | рефы *(мн. ч.)* | +| reuse | повторное использование, переиспользование | | (previous/next) section | (предыдущая/следующая) глава *(только в разделе Основные понятия)* | | shallow | поверхностное (сравнение, равенство), поверхностный (рендеринг) | | side effect | побочный эффект | From 87d49497d74c6af950a651d58f44e75ccd10c835 Mon Sep 17 00:00:00 2001 From: Igor Soloydenko Date: Wed, 13 Feb 2019 14:13:13 -0800 Subject: [PATCH 8/9] Remove redundand information from style-guide.md --- TRANSLATION.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index 76fe4408e..4e6d4d556 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -1,18 +1,20 @@ -# Перевод на русский язык сайта reactjs.org +# Перевод на русский язык сайта reactjs.org Текущий прогресс: https://github.com/reactjs/ru.reactjs.org/issues/1 Пожалуйста, используйте этот ишью, если вы хотите что-то перевести и узнать. -## Оглавление +## Оглавление -* [Общие правила](#Общие-правила) - * [Слово живое и мёртвое](#Слово-живое-и-мёртвое) -* [Универсальное руководство по стилю](#Универсальное-руководство-по-стилю) - * [Идентификаторы заголовков](#Идентификаторы-заголовков) - * [Текст в блоках кода](#Текст-в-блоках-кода) - * [Внешние ссылки](#Внешние-ссылки) -* [Соглашение по переводу (глоссарий)](#Соглашение-по-переводу-глоссарий) +* [Перевод на русский язык сайта reactjs.org](#Перевод-на-русский-язык-сайта-reactjsorg) + * [Оглавление](#Оглавление) + * [Общие правила](#Общие-правила) + * [Слово живое и мёртвое](#Слово-живое-и-мёртвое) + * [Универсальное руководство по стилю](#Универсальное-руководство-по-стилю) + * [Идентификаторы заголовков](#Идентификаторы-заголовков) + * [Текст в блоках кода](#Текст-в-блоках-кода) + * [Внешние ссылки](#Внешние-ссылки) + * [Соглашение по переводу (глоссарий)](#Соглашение-по-переводу-глоссарий) ## Общие правила @@ -61,9 +63,7 @@ ## Универсальное руководство по стилю -Описанные ниже правила пришли [из репозитория](https://github.com/reactjs/reactjs.org-translation/blob/2b830171e78a17be112d677c29f4cdb2537af626/style-guide.md), предписывающего стиль общий для **всех** языков, на которые переводится документация. - -В замечании мейнтейнерам советуется перевести этот документ, чтобы сделать его понятнее для переводчиков. +Описанные ниже правила пришли [из репозитория](https://github.com/reactjs/reactjs.org-translation/blob/master/style-guide.md), предписывающего стиль общий для **всех** языков, на которые переводится документация. ### Идентификаторы заголовков From b56f71c6c2657e4490db6d4b5016fc2cd3c9a573 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Wed, 13 Feb 2019 14:21:42 -0800 Subject: [PATCH 9/9] Update TRANSLATION.md Co-Authored-By: another-guy --- TRANSLATION.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/TRANSLATION.md b/TRANSLATION.md index 4e6d4d556..ecdd015da 100644 --- a/TRANSLATION.md +++ b/TRANSLATION.md @@ -140,7 +140,7 @@ ReactDOM.отрендери(elemento, documento.obtenerElementoPorId('корен ### Внешние ссылки -Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia] и там существует статья на русском языке, исправьте ссылку, чтобы она указывала на русский вариант даже он неполный или требует улучшения. +Если внешняя ссылка ведёт к статье на [MDN] или [Wikipedia], и там существует статья на русском языке, исправьте ссылку, чтобы она указывала на русский вариант, даже если он неполный или требует улучшения. [MDN]: https://developer.mozilla.org/en-US/ [Wikipedia]: https://en.wikipedia.org/wiki/Main_Page