From 1ec0e108ad0c82acf71bbe69289f2acb162e8ebd Mon Sep 17 00:00:00 2001 From: mihailgatilov Date: Fri, 1 Mar 2019 10:04:49 +0300 Subject: [PATCH 1/6] Translated react-dom-server page --- content/docs/reference-react-dom-server.md | 43 +++++++++++----------- 1 file changed, 21 insertions(+), 22 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 80c030377..2b69d1386 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -6,30 +6,30 @@ category: Reference permalink: docs/react-dom-server.html --- -The `ReactDOMServer` object enables you to render components to static markup. Typically, it's used on a Node server: +Объект `ReactDOMServer` позволяет вам отрендерить компоненты в статическую разметку. В основном, он используется на Node сервере. ```js -// ES modules +// ES модули import ReactDOMServer from 'react-dom/server'; // CommonJS var ReactDOMServer = require('react-dom/server'); ``` -## Overview {#overview} +## Обзор {#overview} -The following methods can be used in both the server and browser environments: +В окружении сервера и браузера могут использоваться методы: - [`renderToString()`](#rendertostring) - [`renderToStaticMarkup()`](#rendertostaticmarkup) -These additional methods depend on a package (`stream`) that is **only available on the server**, and won't work in the browser. +Следующие методы зависят от пакета (`stream`), поэтому **доступны только на сервере** и не могут выполняться в браузере. - [`renderToNodeStream()`](#rendertonodestream) - [`renderToStaticNodeStream()`](#rendertostaticnodestream) * * * -## Reference {#reference} +## Справочник {#reference} ### `renderToString()` {#rendertostring} @@ -37,9 +37,9 @@ These additional methods depend on a package (`stream`) that is **only available ReactDOMServer.renderToString(element) ``` -Render a React element to its initial HTML. React will return an HTML string. You can use this method to generate HTML on the server and send the markup down on the initial request for faster page loads and to allow search engines to crawl your pages for SEO purposes. +Рендерит React-элемент в исходный HTML. React вернет HTML строку. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. -If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that already has this server-rendered markup, React will preserve it and only attach event handlers, allowing you to have a very performant first-load experience. +Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит ее и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. * * * @@ -48,10 +48,9 @@ If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that ```javascript ReactDOMServer.renderToStaticMarkup(element) ``` +Похож на метод [`renderToString`](#rendertostring), но не создает дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. -Similar to [`renderToString`](#rendertostring), except this doesn't create extra DOM attributes that React uses internally, such as `data-reactroot`. This is useful if you want to use React as a simple static page generator, as stripping away the extra attributes can save some bytes. - -If you plan to use React on the client to make the markup interactive, do not use this method. Instead, use [`renderToString`](#rendertostring) on the server and [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on the client. +Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToString`](#rendertostring) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. * * * @@ -61,15 +60,15 @@ If you plan to use React on the client to make the markup interactive, do not us ReactDOMServer.renderToNodeStream(element) ``` -Render a React element to its initial HTML. Returns a [Readable stream](https://nodejs.org/api/stream.html#stream_readable_streams) that outputs an HTML string. The HTML output by this stream is exactly equal to what [`ReactDOMServer.renderToString`](#rendertostring) would return. You can use this method to generate HTML on the server and send the markup down on the initial request for faster page loads and to allow search engines to crawl your pages for SEO purposes. +Рендерит React элемент в исходный HTML. Возвращает [Поток чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который отдает HTML строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. -If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that already has this server-rendered markup, React will preserve it and only attach event handlers, allowing you to have a very performant first-load experience. +Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит ее и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. -> Note: +> Примечание: > -> Server-only. This API is not available in the browser. +> Метод используется только на сервере. Этот API не доступен в браузере. > -> The stream returned from this method will return a byte stream encoded in utf-8. If you need a stream in another encoding, take a look at a project like [iconv-lite](https://www.npmjs.com/package/iconv-lite), which provides transform streams for transcoding text. +> Метод возвращает поток, который отдает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. * * * @@ -79,14 +78,14 @@ If you call [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on a node that ReactDOMServer.renderToStaticNodeStream(element) ``` -Similar to [`renderToNodeStream`](#rendertonodestream), except this doesn't create extra DOM attributes that React uses internally, such as `data-reactroot`. This is useful if you want to use React as a simple static page generator, as stripping away the extra attributes can save some bytes. +Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создает дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. -The HTML output by this stream is exactly equal to what [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup) would return. +Поток отдает HTML, идентичный тому, что возвращает [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup). -If you plan to use React on the client to make the markup interactive, do not use this method. Instead, use [`renderToNodeStream`](#rendertonodestream) on the server and [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) on the client. +Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToNodeStream`](#rendertonodestream) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. -> Note: +> Примечание: > -> Server-only. This API is not available in the browser. +> Метод используется только на сервере. Этот API не доступен в браузере. > -> The stream returned from this method will return a byte stream encoded in utf-8. If you need a stream in another encoding, take a look at a project like [iconv-lite](https://www.npmjs.com/package/iconv-lite), which provides transform streams for transcoding text. +> Метод возвращает поток, который отдает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. From d7fc6bbda4e4bef7f34786777db991158e282aac Mon Sep 17 00:00:00 2001 From: mihailgatilov Date: Fri, 1 Mar 2019 12:20:45 +0300 Subject: [PATCH 2/6] Replaced e letter according to review --- content/docs/reference-react-dom-server.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 2b69d1386..216c5746f 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -37,9 +37,9 @@ var ReactDOMServer = require('react-dom/server'); ReactDOMServer.renderToString(element) ``` -Рендерит React-элемент в исходный HTML. React вернет HTML строку. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React-элемент в исходный HTML. React вернёт HTML строку. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. -Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит ее и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. +Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. * * * @@ -48,7 +48,7 @@ ReactDOMServer.renderToString(element) ```javascript ReactDOMServer.renderToStaticMarkup(element) ``` -Похож на метод [`renderToString`](#rendertostring), но не создает дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. +Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToString`](#rendertostring) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. @@ -60,15 +60,15 @@ ReactDOMServer.renderToStaticMarkup(element) ReactDOMServer.renderToNodeStream(element) ``` -Рендерит React элемент в исходный HTML. Возвращает [Поток чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который отдает HTML строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React элемент в исходный HTML. Возвращает [Поток для чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который отдаёт HTML строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. -Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит ее и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. +Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. > Примечание: > > Метод используется только на сервере. Этот API не доступен в браузере. > -> Метод возвращает поток, который отдает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. +> Метод возвращает поток, который отдаёт поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. * * * @@ -78,9 +78,9 @@ ReactDOMServer.renderToNodeStream(element) ReactDOMServer.renderToStaticNodeStream(element) ``` -Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создает дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. +Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создаёт дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. -Поток отдает HTML, идентичный тому, что возвращает [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup). +Поток отдаёт HTML, идентичный тому, что возвращает [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup). Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToNodeStream`](#rendertonodestream) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. @@ -88,4 +88,4 @@ ReactDOMServer.renderToStaticNodeStream(element) > > Метод используется только на сервере. Этот API не доступен в браузере. > -> Метод возвращает поток, который отдает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. +> Метод возвращает поток, который отдаёт поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. From 5767a2535206aba2efbf0ae8c98a9f947e9a90d1 Mon Sep 17 00:00:00 2001 From: mihailgatilov Date: Fri, 1 Mar 2019 20:33:03 +0300 Subject: [PATCH 3/6] Fixed mistaked according to review --- content/docs/reference-react-dom-server.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 216c5746f..3145982e4 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -6,10 +6,10 @@ category: Reference permalink: docs/react-dom-server.html --- -Объект `ReactDOMServer` позволяет вам отрендерить компоненты в статическую разметку. В основном, он используется на Node сервере. +Объект `ReactDOMServer` позволяет отрендерить компоненты в статическую разметку. В основном, он используется на Node-сервере. ```js -// ES модули +// ES-модули import ReactDOMServer from 'react-dom/server'; // CommonJS var ReactDOMServer = require('react-dom/server'); @@ -22,7 +22,7 @@ var ReactDOMServer = require('react-dom/server'); - [`renderToString()`](#rendertostring) - [`renderToStaticMarkup()`](#rendertostaticmarkup) -Следующие методы зависят от пакета (`stream`), поэтому **доступны только на сервере** и не могут выполняться в браузере. +Следующие методы зависят от пакета (`stream`), поэтому **доступны только на сервере** и не будут работать в браузере. - [`renderToNodeStream()`](#rendertonodestream) - [`renderToStaticNodeStream()`](#rendertostaticnodestream) @@ -37,7 +37,7 @@ var ReactDOMServer = require('react-dom/server'); ReactDOMServer.renderToString(element) ``` -Рендерит React-элемент в исходный HTML. React вернёт HTML строку. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React-элемент в исходный HTML. React вернёт HTML-строку. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. @@ -48,7 +48,7 @@ ReactDOMServer.renderToString(element) ```javascript ReactDOMServer.renderToStaticMarkup(element) ``` -Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. +Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Этот Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байт. Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToString`](#rendertostring) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. @@ -60,7 +60,7 @@ ReactDOMServer.renderToStaticMarkup(element) ReactDOMServer.renderToNodeStream(element) ``` -Рендерит React элемент в исходный HTML. Возвращает [Поток для чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который отдаёт HTML строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответе на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React-элемент в исходный HTML. Возвращает [поток для чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который отдаёт HTML-строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. @@ -78,7 +78,7 @@ ReactDOMServer.renderToNodeStream(element) ReactDOMServer.renderToStaticNodeStream(element) ``` -Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создаёт дополнительных DOM-аттрибутов, таких как `data-reactroot`, используемых внутри реакта. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных аттрибутов может сохранить несколько байт. +Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байт. Поток отдаёт HTML, идентичный тому, что возвращает [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup). From e8488624449fdf7907a2be67112800c595d3566e Mon Sep 17 00:00:00 2001 From: mihailgatilov Date: Sun, 3 Mar 2019 11:48:16 +0300 Subject: [PATCH 4/6] Imrovements according to review --- content/docs/reference-react-dom-server.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index 3145982e4..e15ba1aa8 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -37,7 +37,7 @@ var ReactDOMServer = require('react-dom/server'); ReactDOMServer.renderToString(element) ``` -Рендерит React-элемент в исходный HTML. React вернёт HTML-строку. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React-элемент и возвращает его в виде HTML-строки. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. @@ -48,7 +48,7 @@ ReactDOMServer.renderToString(element) ```javascript ReactDOMServer.renderToStaticMarkup(element) ``` -Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Этот Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байт. +Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Этот метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байт. Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToString`](#rendertostring) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. @@ -68,7 +68,7 @@ ReactDOMServer.renderToNodeStream(element) > > Метод используется только на сервере. Этот API не доступен в браузере. > -> Метод возвращает поток, который отдаёт поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. +> Метод возвращает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста. * * * @@ -88,4 +88,4 @@ ReactDOMServer.renderToStaticNodeStream(element) > > Метод используется только на сервере. Этот API не доступен в браузере. > -> Метод возвращает поток, который отдаёт поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то взгляните на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать потоки для транскодировки текста. +> Метод возвращает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста. From 7a14604e5c274a3dc23b0e7ca406ee6d9ec5f286 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Sun, 3 Mar 2019 14:44:09 +0300 Subject: [PATCH 5/6] reference-react-dom-server: fix --- content/docs/reference-react-dom-server.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index e15ba1aa8..a05c7b895 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -86,6 +86,6 @@ ReactDOMServer.renderToStaticNodeStream(element) > Примечание: > -> Метод используется только на сервере. Этот API не доступен в браузере. +> Метод используется только на сервере. Этот API недоступен в браузере. > > Метод возвращает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста. From 3046a111827cb3c9c7f455de81126b4374bf13fd Mon Sep 17 00:00:00 2001 From: mihailgatilov Date: Mon, 4 Mar 2019 15:09:44 +0300 Subject: [PATCH 6/6] Improvements after review --- content/docs/reference-react-dom-server.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/docs/reference-react-dom-server.md b/content/docs/reference-react-dom-server.md index a05c7b895..6b59bb930 100644 --- a/content/docs/reference-react-dom-server.md +++ b/content/docs/reference-react-dom-server.md @@ -22,7 +22,7 @@ var ReactDOMServer = require('react-dom/server'); - [`renderToString()`](#rendertostring) - [`renderToStaticMarkup()`](#rendertostaticmarkup) -Следующие методы зависят от пакета (`stream`), поэтому **доступны только на сервере** и не будут работать в браузере. +Следующие методы зависят от пакета `stream`, поэтому **доступны только на сервере** и не будут работать в браузере. - [`renderToNodeStream()`](#rendertonodestream) - [`renderToStaticNodeStream()`](#rendertostaticnodestream) @@ -37,7 +37,7 @@ var ReactDOMServer = require('react-dom/server'); ReactDOMServer.renderToString(element) ``` -Рендерит React-элемент и возвращает его в виде HTML-строки. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React-элемент в исходный HTML и возвращает его в виде строки. Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. @@ -48,7 +48,7 @@ ReactDOMServer.renderToString(element) ```javascript ReactDOMServer.renderToStaticMarkup(element) ``` -Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Этот метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байт. +Похож на метод [`renderToString`](#rendertostring), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Этот метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байтов. Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToString`](#rendertostring) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. @@ -60,7 +60,7 @@ ReactDOMServer.renderToStaticMarkup(element) ReactDOMServer.renderToNodeStream(element) ``` -Рендерит React-элемент в исходный HTML. Возвращает [поток для чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который отдаёт HTML-строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. +Рендерит React-элемент в исходный HTML. Возвращает [поток для чтения](https://nodejs.org/api/stream.html#stream_readable_streams), который выводит HTML-строку. HTML из потока идентичен тому, что возвращает [`ReactDOMServer.renderToString`](#rendertostring). Вы можете использовать этот метод, чтобы сгенерировать HTML на сервере и отправить разметку в ответ на запрос, ускоряя загрузку страницы и позволяя поиcковым движкам обработать ваши страницы для SEO. Если вы вызываете [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на узле, который уже содержит разметку, отрендеренную на сервере, React сохранит её и закрепит только обработчики событий, позволяя вам значительно ускорить первоначальную загрузку страницы. @@ -68,7 +68,7 @@ ReactDOMServer.renderToNodeStream(element) > > Метод используется только на сервере. Этот API не доступен в браузере. > -> Метод возвращает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста. +> Метод возвращает поток байтов, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста. * * * @@ -78,9 +78,9 @@ ReactDOMServer.renderToNodeStream(element) ReactDOMServer.renderToStaticNodeStream(element) ``` -Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байт. +Похож на метод [`renderToNodeStream`](#rendertonodestream), но не создаёт дополнительных DOM-атрибутов, таких как `data-reactroot`, используемых внутри React. Метод полезен, когда вы хотите использовать React для генерации простой статической страницы, где отсутствие дополнительных атрибутов может сохранить несколько байтов. -Поток отдаёт HTML, идентичный тому, что возвращает [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup). +Поток выводит HTML, идентичный тому, что возвращает [`ReactDOMServer.renderToStaticMarkup`](#rendertostaticmarkup). Не пользуйтесь этим методом, если вы планируете использовать React на клиенте для создания интерактивной разметки. Вместо него используйте [`renderToNodeStream`](#rendertonodestream) на сервере и [`ReactDOM.hydrate()`](/docs/react-dom.html#hydrate) на клиенте. @@ -88,4 +88,4 @@ ReactDOMServer.renderToStaticNodeStream(element) > > Метод используется только на сервере. Этот API недоступен в браузере. > -> Метод возвращает поток байт, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста. +> Метод возвращает поток байтов, закодированный в utf-8. Если вам нужен поток с другой кодировкой, то посмотрите на проект [iconv-lite](https://www.npmjs.com/package/iconv-lite). Он позволяет преобразовывать кодировку потоков текста.