Перевод: Build a React App from scratch #1022
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎ 1 Skipped Deployment
|
|
Здравствуйте! Буду признателен(на) за любые замечания и обратную связь. |
There was a problem hiding this comment.
Большое спасибо за качественный и аккуратный перевод! Видно, что вложено много внимания к деталям и стилю.
Я оставил несколько предложений — в основном по терминологии и лёгкому упрощению формулировок, чтобы текст звучал чуть естественнее на русском. Всё по мелочи, общий уровень перевода очень высокий
Спасибо ещё раз за вклад!
|
|
||
| Starting from scratch is an easy way to get started using React, but a major tradeoff to be aware of is that going this route is often the same as building your own adhoc framework. As your requirements evolve, you may need to solve more framework-like problems that our recommended frameworks already have well developed and supported solutions for. | ||
| Начать с нуля — это простой способ познакомиться с React, но важно понимать, что такой подход зачастую сводится к созданию собственного, спонтанно сформированного фреймворка. По мере роста требований вам, скорее всего, придётся решать задачи, характерные для фреймворков, для которых в рекомендованных нами решениях уже есть хорошо проработанные и поддерживаемые решения. |
There was a problem hiding this comment.
Предлагаю немного упростить и облегчить восприятие:
"что такой подход зачастую сводится к созданию собственного, спонтанно сформированного фреймворка" -> "что такой подход зачастую сводится к созданию собственного самодельного фреймворка"
Слово “самодельного” звучит естественнее и передаёт ту же идею, не перегружая фразу.
|
|
||
| Our recommended frameworks also help you build better performing apps. For example, reducing or eliminating waterfalls from network requests makes for a better user experience. This might not be a high priority when you are building a toy project, but if your app gains users you may want to improve its performance. | ||
| Рекомендованные нами фреймворки также помогают создавать более производительные приложения. Например, сокращение или устранение каскадов сетевых запросов улучшает пользовательский опыт. Это может быть не так важно на этапе создания небольшого проекта, но с ростом числа пользователей производительность может стать приоритетом. |
There was a problem hiding this comment.
Вы хорошо перевели данный абзац, но предлагаю его еще немного упростить.
"сокращение или устранение каскадов сетевых запросов" -> "уменьшение количества последовательных сетевых запросов".
Фраза «каскад сетевых запросов» может быть не совсем понятна новичкам.
|
|
||
| <TerminalBlock> | ||
| {`npm install --save-dev parcel`} | ||
| </TerminalBlock> | ||
|
|
||
| Parcel supports fast refresh, JSX, TypeScript, Flow, and styling out of the box. See [Parcel's React recipe](https://parceljs.org/recipes/react/#getting-started) to get started. | ||
| Parcel поддерживает встроенную поддержку fast refresh, JSX, TypeScript, Flow и стилизацию. Ознакомьтесь с [Parcel's React рецептом](https://parceljs.org/recipes/react/#getting-started), чтобы начать. |
There was a problem hiding this comment.
Предлагаю полностью перевести описание ссылки — вместо «Parcel's React рецептом» написать «руководство по использованию React с Parcel» для большей ясности.
|
|
||
| ### Rsbuild {/*rsbuild*/} | ||
|
|
||
| [Rsbuild](https://rsbuild.dev/) is an Rspack-powered build tool that provides a seamless development experience for React applications. It comes with carefully tuned defaults and performance optimizations ready to use. | ||
| [Rsbuild](https://rsbuild.dev/) — это инструмент сборки на базе Rspack, который предлагает безупречную систему для разработки React-приложений. Он включает в себя оптимизированные настройки и улучшения производительности. |
There was a problem hiding this comment.
Вы достаточно точно перевели и передали суть.
Могу только предложить упростить формулировку "Он включает в себя оптимизированные настройки и улучшения производительности" -> "Он содержит оптимизированные настройки и улучшенную производительность".
Так звучит менее перегружено и понятно.
|
|
||
| <TerminalBlock> | ||
| {`npm create vite@latest my-app -- --template react`} | ||
| </TerminalBlock> | ||
|
|
||
| Vite is opinionated and comes with sensible defaults out of the box. Vite has a rich ecosystem of plugins to support fast refresh, JSX, Babel/SWC, and other common features. See Vite's [React plugin](https://vite.dev/plugins/#vitejs-plugin-react) or [React SWC plugin](https://vite.dev/plugins/#vitejs-plugin-react-swc) and [React SSR example project](https://vite.dev/guide/ssr.html#example-projects) to get started. | ||
| Vite следует определённой философии и поставляется с продуманными настройками по умолчанию. У него также есть богатая экосистема плагинов, поддерживающих fast refresh, JSX, Babel/SWC и других функций. Ознакомьтесь с [React-плагином для Vite](https://vite.dev/plugins/#vitejs-plugin-react) или [React SWC-плагином](https://vite.dev/plugins/#vitejs-plugin-react-swc), а также [примером проекта SSR на Vite](https://vite.dev/guide/ssr.html#example-projects), чтобы начать работу. |
There was a problem hiding this comment.
Предлагаю уточнить перевод термина fast refresh — можно рассмотреть такой вариант, как «быстрая перезагрузка». Возможно, стоит выбрать вариант, который лучше передаёт идею без полной перезагрузки страницы при разработке.
|
|
||
| <TerminalBlock> | ||
| {`npx create-rsbuild --template react`} | ||
| </TerminalBlock> | ||
|
|
||
| Rsbuild includes built-in support for React features like fast refresh, JSX, TypeScript, and styling. See [Rsbuild's React guide](https://rsbuild.dev/guide/framework/react) to get started. | ||
| Rsbuild поддерживает встроенную поддержку fast refresh, JSX, TypeScript и стилизацию. Ознакомьтесь с [Rsbuild's React руководство](https://rsbuild.dev/guide/framework/react), чтобы начать. |
There was a problem hiding this comment.
Предлагаю уточнить перевод термина Fast Refresh — можно рассмотреть такие варианты, как «быстрая перезагрузка», «мгновенное обновление» или «горячее обновление компонентов». Возможно, стоит выбрать вариант, который лучше передаёт идею без полной перезагрузки страницы при разработке.
|
|
||
| The first step is to install a build tool like `vite`, `parcel`, or `rsbuild`. These build tools provide features to package and run source code, provide a development server for local development and a build command to deploy your app to a production server. | ||
| Первым шагом будет установка инструмента сборки, например, `vite`, `parcel`, или `rsbuild`. Эти инструменты позволяют упаковывать и запускать исходный код, предоставляют локальный сервер разработки и команду сборки для деплоя приложения на продакшн-сервер. |
There was a problem hiding this comment.
Предлагаю заменить «деплой» на «развёртывание» — это более нейтральный и устоявшийся вариант в русскоязычной технической документации.
Переведена статья "Build a React App from scratch" (из раздела Learn):
Оригинал: https://react.dev/learn/build-a-react-app-from-scratch