-
Notifications
You must be signed in to change notification settings - Fork 1
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
05 developing translation #5
base: master
Are you sure you want to change the base?
Conversation
0a517e9
to
5413ebe
Compare
-# Developing | ||
-# Разработка | ||
|
||
В этой части книги, вы настроите webpack и начнете работу с ним. Так-же, вы научитесь настраивать webpack-dev-server. И наконец, вы создадите файл конфигурации, который можно будет расширить в последующих частях книги. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Так-же
Пишется слитно, без дефиса.
|
||
Before getting started, make sure you are using a recent version of [Node](http://nodejs.org/). You should use at least the most current LTS (long-term support) version. The configuration of the book has been written with the LTS Node features in mind. You should have `node` and `npm` commands available at your terminal. [Yarn](https://yarnpkg.com/) is a good alternative to npm and works for the tutorial as well. | ||
Перед началом работы, удостоверьтесь что вы используете актуальную версию [Node](http://nodejs.org/). Вам следует использовать как минимум последнюю LTS (long-term support) версию. В книге, конфигурация webpack ориентирована на функции именно LTS Node. Так-же, в вашем терминале должны быть доступны команды `node` и `npm`. [Yarn](https://yarnpkg.com/) хорошая альтернатива npm, и тоже подходит для этого руководства. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
long-term support
Перевести - "с долгосрочной поддержкой"
|
||
T> The completed configuration is available at [GitHub](https://github.com/survivejs-demos/webpack-demo). | ||
T> Завершенная конфигурация доступна на [GitHub](https://github.com/survivejs-demos/webpack-demo). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Может лучше "готовая"?
|
||
To get a starting point, you should create a directory for the project and set up a *package.json* there. npm uses that to manage project dependencies. Here are the basic commands: | ||
Для начала, вам следует создать для проекта папку с файлом *package.json* внутри. npm использует этот файл для управления зависимостями проекта. Вот базовые команды для этого: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Для начала, вам
Лишняя запятая
|
||
T> [webpack-cli](https://www.npmjs.com/package/webpack-cli) comes with additional functionality including `init` and `migrate` commands that allow you to create new webpack configuration fast and update from an older version to a newer one. | ||
T> [webpack-cli](https://www.npmjs.com/package/webpack-cli) поставляется с дополнительным функционалом, включая команды `init` и `migrate` которые позволяют быстрее создавать новые конфигурации webpack и мигрировать со старых версий на более новые. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Запятая нужна перед "которые"
* You should choose a method to compose configuration that makes the most sense to you. [webpack-merge](https://www.npmjs.com/package/webpack-merge) was developed to provide a light approach for composition, but you can find many other options in the wild. | ||
* Webpack's `--env` parameter allows you to control configuration target through terminal. You receive the passed `env` through a function interface. | ||
* Composition can enable configuration sharing. Instead of having to maintain a custom configuration per repository, you can share it across repositories this way. Using npm packages allows this. Developing configuration is close to developing any other code. This time, however, you codify your practices as packages. | ||
* Поскольку конфигурация webpack это чистый JavaScript-код, существует много способов управления ею. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Перед это - тире.
* Composition can enable configuration sharing. Instead of having to maintain a custom configuration per repository, you can share it across repositories this way. Using npm packages allows this. Developing configuration is close to developing any other code. This time, however, you codify your practices as packages. | ||
* Поскольку конфигурация webpack это чистый JavaScript-код, существует много способов управления ею. | ||
* Вам следует выбрать метод составления конфигурации, который имеет для вас наибольший смысл. [webpack-merge](https://www.npmjs.com/package/webpack-merge) был разработан для того, чтобы предоставить легкий подход к написанию составной конфигурации, но вы можете найти множество других вариантов. | ||
* Параметр `--env` позволяет вам задавать целевое окружение в терминале. Вы можете получить значение параметра `env` через интерфейс функций (??????). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
через интерфейс функций (??????)
А если проще - "через функции"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Тогда "с помощью функций"
|
||
T> Enable `devServer.historyApiFallback` if you are using HTML5 History API based routing. | ||
T> Включите `devServer.historyApiFallback` если вы используете роутинг(???), на основании HTML5 History API. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
роутинг(???)
роутинг -> маршрутизация
|
||
```bash | ||
npm install webpack-dev-server --save-dev | ||
``` | ||
|
||
As before, this command generates a command below the `npm bin` directory, and you could run *webpack-dev-server* from there. After running the WDS, you have a development server running at `http://localhost:8080`. Automatic browser refresh is in place now, although at a fundamental level. | ||
Как и прежде, даная команда сгенерирует для нас исполняемый файл в папке `npm bin`, и вы сможете запустить *webpack-dev-server* из нее. После запуска WDS, в вашем распоряжении окажется сервер разработки по адресу `http://localhost:8080`. Автоматическое обновление браузера тоже будет включено, хоть и на фундаментальном уровне(???). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
хоть и на фундаментальном уровне(???)
хотя на на (самом?) базовом уровне
* `index.html 181 bytes [emitted]` - Another generated asset that was emitted by the process. | ||
* `[0] ./src/index.js + 1 modules 219 bytes {0} [built]` - The ID of the entry asset, name, size, entry chunk ID, the way it was generated. | ||
* `Child html-webpack-plugin for "index.html":` - This is plugin-related output. In this case *html-webpack-plugin* is creating this output on its own. | ||
* `Hash: aafe36ba210b0fbb7073` - хэш нашей сборки. Вы можете использовать его, что бы сделать недействительными ресурсы, используя заполнитель((???)) `[hash]`. Хэширование рассматривается детально в главе *Добавление хэшей к именам файлов*. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
заполнитель((???))
Давай пока так и оставим
ОК. |
Перевод главы.
Возникло несколько моментов, которые я не смог перевести корректно, они прямо в тексте помечены вот так -
(???)
для проблемного слова, и(??????)
для фразы/предложения.Так-же
configuration target
наверное следует переводить, какцелевое окружение (конфигурации)
, наверное стоит добавить в словарь и заново пересмотреть мой перевод на предмет неправильного перевода данного термина. Возможно, подобным образом следует переводить и Build Targets, хотя я в этом не уверен. Вообщем обсуждение открыто)