Перевод "introducing-jsx.md" на русский #17

another-guy · 2019-02-09T06:18:19Z

Глядя на PR №2, предвижу море полезного фидбэка.

another-guy · 2019-02-09T07:14:12Z

@gaearon @lex111 Следует ли мне изменить "дочерние элементы" на "потомки" (как в #11)? Решение тоже надо бы в глоссарий добавить.

another-guy · 2019-02-09T07:35:39Z

content/docs/introducing-jsx.md


 ```js{12}
 function formatName(user) {
  return user.firstName + ' ' + user.lastName;
 }

 const user = {
-  firstName: 'Harper',
-  lastName: 'Perez'
+  firstName: 'Марья',


Мне кажется, что это хороший вариант, т.к. 1) культурно близок; 2) не "Василий Пупкин" с негативной армейской коннотацией; 3) более гендерно корректен, чем Иванов-Петров-Сидоров. Any thoughts on that?

Мне нра.

gaearon

Хорошее начало! Есть пара придирок которые надо бы поправить перед мёржем но в целом 👍

gaearon · 2019-02-09T12:23:51Z

content/docs/introducing-jsx.md


 ```js
 const element = <h1>Hello, world!</h1>;
 ```

-This funny tag syntax is neither a string nor HTML.
+Этот странный синтаксис с тэгом не является ни строкой, ни фрагментом HTML.


Хочу убрать «является». Слово-паразит в документации.

Может быть:

Этот странный тэг — это ни строка, ни фрагмент HTML.

И тэг пишется в буквой е

О, интересно. ок

Это не придирки, а замечания по делу. Спасибо вас обоим за внимательный ревью!

gaearon · 2019-02-09T12:27:29Z

content/docs/introducing-jsx.md


-It is called JSX, and it is a syntax extension to JavaScript. We recommend using it with React to describe what the UI should look like. JSX may remind you of a template language, but it comes with the full power of JavaScript.
+Это JSX — расширение языка JavaScript. Мы рекомендуем использовать его, когда требуется объяснить React, как должен выглядеть пользовательский интерфейс. JSX напоминает язык шаблонов, наделённый силой JavaScript.


«Когда требуется объяснить» немного деревянно. Предлагаю

Мы рекомендуем его использовать в React для описания UI.

(И предлагаю UI не переводить)

(И предлагаю UI не переводить)

Либо просто интерфейс?

Ага, давай интерфейс

Эм, я исправил на UI согласно глоссарию.

gaearon · 2019-02-09T12:28:02Z

content/docs/introducing-jsx.md


-JSX produces React "elements". We will explore rendering them to the DOM in the [next section](/docs/rendering-elements.html). Below, you can find the basics of JSX necessary to get you started.
+JSX производит "элементы" React. То как элементы рендерятся в DOM, мы изучим в [следующем разделе](/docs/rendering-elements.html), а ниже вы найдёте основы JSX, необходимые для начала работы.


Сайт вставит кавычки-ёлочки? Надо проверить.

«основы, необходимые для начала работы» немножко деревянно

Можно:

Ниже мы рассмотрим основы JSX, которые нужно знать начинающему.

Сайт вставит кавычки-ёлочки? Надо проверить.

А как он может вставить их автоматически? Хотя лучше их в исходниках сразу указывать.

В английской версии у нас "" меняются на “” форматтером. Но я проверил, что кириллицу он не понимает.

Может его можно расширить? Хотя нетрудно проставить кавычки-ёлочки потом, где упустили.

Да, в идеале надо бы сделать. Создам issue

gaearon · 2019-02-09T12:32:24Z

content/docs/introducing-jsx.md


-React embraces the fact that rendering logic is inherently coupled with other UI logic: how events are handled, how the state changes over time, and how the data is prepared for display.
+React исходит из того факта, что логика рендеринга неразрывно связана с прочей логикой интерфейса: с тем, как обрабатываются события, как состояние изменяется во времени и как данные подготавливаются к отображению.


«Подготавливаются» => «готовятся»

Может быть «исходит из принципа»

Так перевёл, потому что мне "готовятся" слышится как "готовят сами себя", а "подготавливаются" -- неопределённо, кем именно. Но, я думаю, это не принципиально, поэтому исправлю.

gaearon · 2019-02-09T12:34:46Z

content/docs/introducing-jsx.md


-React [doesn't require](/docs/react-without-jsx.html) using JSX, but most people find it helpful as a visual aid when working with UI inside the JavaScript code. It also allows React to show more useful error and warning messages.
+React [не принуждает вас](/docs/react-without-jsx.html) использовать JSX, но большинство людей ценит его за наглядность при работе с интерфейсом, живущем в JavaScript коде. Помимо этого, JSX помогает React делать сообщения об ошибках и предупреждениях более осмысленными.



Более понятными

«Не принуждает» как-то жестко, может

React можно использовать и без JSX

gaearon · 2019-02-09T12:35:29Z

content/docs/introducing-jsx.md


 ```js{12}
 function formatName(user) {
  return user.firstName + ' ' + user.lastName;
 }

 const user = {
-  firstName: 'Harper',
-  lastName: 'Perez'
+  firstName: 'Марья',


Мне нра.

gaearon · 2019-02-09T12:39:16Z

content/docs/introducing-jsx.md

 const element = <h1>{title}</h1>;
 ```

-By default, React DOM [escapes](http://stackoverflow.com/questions/7381974/which-characters-need-to-be-escaped-on-html) any values embedded in JSX before rendering them. Thus it ensures that you can never inject anything that's not explicitly written in your application. Everything is converted to a string before being rendered. This helps prevent [XSS (cross-site-scripting)](https://en.wikipedia.org/wiki/Cross-site_scripting) attacks.
+По умолчанию, React DOM [экранирует](http://stackoverflow.com/questions/7381974/which-characters-need-to-be-escaped-on-html) все значения, включённые в JSX до того как отрендерить их. Это гарантирует, что вы никогда не внедрите чего-либо, что не было явно написано в вашем приложении. Всё преобразуется в строчки, перед тем как быть отрендеренным. Это помогает предотвращать атаки [межсайтовым скриптингом (XSS)](https://ru.wikipedia.org/wiki/%D0%9C%D0%B5%D0%B6%D1%81%D0%B0%D0%B9%D1%82%D0%BE%D0%B2%D1%8B%D0%B9_%D1%81%D0%BA%D1%80%D0%B8%D0%BF%D1%82%D0%B8%D0%BD%D0%B3).


«Всё... быть отререндеренным»

Как-то не читается. Может быть «перед рендерингом»

gaearon · 2019-02-09T12:41:35Z

content/docs/introducing-jsx.md

@@ -175,10 +175,10 @@ const element = {
 };
 ```

-These objects are called "React elements". You can think of them as descriptions of what you want to see on the screen. React reads these objects and uses them to construct the DOM and keep it up to date.
+Эти объекты называются React элементами. Вы можете воспринимать их как описание того, что бы вы хотели увидеть на экране. React читает эти объекты и искользует их, чтобы конструировать и поддерживать DOM. 


«можете воспринимать» как-то очень царски, может быть:

Можно сказать, что они описывают результат, который мы хотим увидеть на экране.

another-guy · 2019-02-09T21:49:26Z

Все озвученные замечания исправил. Когда обнаружим пропущенные шероховатости — исправим в отдельном PR.

Translate "introducing-jsx.md" into Russian

3c90f2c

tesseralis mentioned this pull request Feb 9, 2019

Russian Translation Progress #1

Closed

88 tasks

Igor Soloydenko added 3 commits February 8, 2019 22:31

Add missing "style" word

ab30fbd

Use "примечание" instead of "обратите внимание"

99307df

Update page title

b3b4943

another-guy requested a review from gaearon February 9, 2019 07:17

another-guy commented Feb 9, 2019

View reviewed changes

Предупреждение instead of Осторожно.

a50c157

gaearon approved these changes Feb 9, 2019

View reviewed changes

Igor Soloydenko added 2 commits February 9, 2019 13:34

Resolve translation issues in introducing-jsx.md from PR #17

b492548

Тэг -> тег

9d68d80

another-guy merged commit 7697e89 into master Feb 9, 2019

another-guy pushed a commit that referenced this pull request Feb 9, 2019

Resolve translation issues in introducing-jsx.md from PR #17

6fa0238

another-guy deleted the another-guy/introducing-jsx branch February 9, 2019 21:49

gaearon mentioned this pull request Feb 12, 2019

Reviewer availability #102

Closed

another-guy added the needs proofread A read-through is still needed to release the document label Feb 13, 2019

vvscode mentioned this pull request Mar 19, 2019

Перевод блога #273

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Перевод "introducing-jsx.md" на русский #17

Перевод "introducing-jsx.md" на русский #17

another-guy commented Feb 9, 2019 •

edited

Loading

another-guy commented Feb 9, 2019

another-guy Feb 9, 2019

gaearon Feb 9, 2019

gaearon left a comment

gaearon Feb 9, 2019

gaearon Feb 9, 2019

lex111 Feb 9, 2019

gaearon Feb 9, 2019

another-guy Feb 9, 2019

gaearon Feb 9, 2019

lex111 Feb 9, 2019

gaearon Feb 9, 2019

another-guy Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

lex111 Feb 9, 2019

gaearon Feb 9, 2019

lex111 Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

another-guy Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

gaearon Feb 9, 2019

another-guy commented Feb 9, 2019


		It is called JSX, and it is a syntax extension to JavaScript. We recommend using it with React to describe what the UI should look like. JSX may remind you of a template language, but it comes with the full power of JavaScript.
		Это JSX — расширение языка JavaScript. Мы рекомендуем использовать его, когда требуется объяснить React, как должен выглядеть пользовательский интерфейс. JSX напоминает язык шаблонов, наделённый силой JavaScript.


		JSX produces React "elements". We will explore rendering them to the DOM in the [next section](/docs/rendering-elements.html). Below, you can find the basics of JSX necessary to get you started.
		JSX производит "элементы" React. То как элементы рендерятся в DOM, мы изучим в [следующем разделе](/docs/rendering-elements.html), а ниже вы найдёте основы JSX, необходимые для начала работы.


		React embraces the fact that rendering logic is inherently coupled with other UI logic: how events are handled, how the state changes over time, and how the data is prepared for display.
		React исходит из того факта, что логика рендеринга неразрывно связана с прочей логикой интерфейса: с тем, как обрабатываются события, как состояние изменяется во времени и как данные подготавливаются к отображению.


		React [doesn't require](/docs/react-without-jsx.html) using JSX, but most people find it helpful as a visual aid when working with UI inside the JavaScript code. It also allows React to show more useful error and warning messages.
		React [не принуждает вас](/docs/react-without-jsx.html) использовать JSX, но большинство людей ценит его за наглядность при работе с интерфейсом, живущем в JavaScript коде. Помимо этого, JSX помогает React делать сообщения об ошибках и предупреждениях более осмысленными.

Перевод "introducing-jsx.md" на русский #17

Перевод "introducing-jsx.md" на русский #17

Conversation

another-guy commented Feb 9, 2019 • edited Loading

another-guy commented Feb 9, 2019

Choose a reason for hiding this comment

Choose a reason for hiding this comment

gaearon left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

another-guy commented Feb 9, 2019

another-guy commented Feb 9, 2019 •

edited

Loading