Правила перевода

Цель данного руководства — научить вас практическому процессу перевода перед тем как вы начнете работу. Перед началом перевода прочтите процесс получения задачи.

Подготовка

Перед началом перевода вам следует подготовить следующие вещи:

• Редактор Markdown: Typora
• Клиент Git: *nix: terminal, Windows: git cmd
• Аккаунт GitHub

Получение задачи на перевод

1. На главной странице в разделе со списком статусов найдите непереведенные статьи и сообщите об этом администратору через @. Вскоре ваш запрос будет рассмотрен. После того как администратор отметит вашу заявку, это означает, что она принята.

2. Найдите репозиторий с исходниками (https://github.com/SpringForAll/spring-guides-translation).

3. Нажмите кнопку Fork:

   

4. Выберите статью, которую хотите перевести:

   

5. Процесс получения статьи для перевода:

   а. Найдите непереведенную статью на главной странице в таблице статусов и сообщите об этом администратору в группе перевода. Они изменят статус в таблице, указывая, что статья была взята в работу.

   б. Найдите статью в папке source, имя файла совпадает с названием статьи.

   в. Вернитесь к Readme и найдите путь к оригинальному тексту (в виде гиперссылки, которая открывается при клике). г. Выделите основной текст статьи и скопируйте его в Typora, проверьте, нет ли пропущенных разделов.

   д. Добавьте необходимую информацию согласно договоренностям команды перевода, затем замените содержание файла в репозитории.

   е. Отправьте Pull Request (PR), ждите слияния. Команда перевода обязуется максимально быстро принимать и объединять Pull Requests.

   

Перевод

После того как ваш Pull Request был принят, вы можете приступить к переводу. Вы можете выбрать клонирование репозитория на локальную машину для перевода (рекомендовано), конечно же, можно также перевести прямо на веб-странице.

Перевод на локальной машине

Сначала вам нужно клонировать репозиторий и обеспечить его актуальность:

Клонирование репозитория

Выберите локальный каталог, если используете систему *nix, вы можете использовать команду типа: mkdir -p /home/translate. Если используете Windows, создайте каталог translate.

Перейдите в этот каталог и клонируйте наш репозиторий:

## Замените адрес ниже своим адресом репозитория
git clone https://github.com/chenzhijun319/spring-guides-translation.git

Сохранение синхронизации с удалённым репозиторием

Часто в репозиторий команды перевода поступает множество обновлений, поэтому вам следует поддерживать синхронизацию вашего локального репозитория с удалённым.```shell

Сохранение синхронизации с удалённым репозиторием, то есть с репозиторием SpringForAll/spring-guides-translation

git remote add upstream https://github.com/SpringForAll/spring-guides-translation.git

git fetch upstream

git merge upstream/master

> Если вы не хотите выполнять команды, вы можете просто удалить свой репозиторий и заново форкнуть его (https://github.com/SpringForAll/spring-guides-translation).

#### Начало перевода

После того как вы синхронизируете ваш репозиторий, вы можете приступить к переводу. Откройте статью, которую вы взяли на перевод, с помощью `Typora`, затем начните перевод. **Обратите внимание, что после завершения перевода ваша статья будет проверена и опубликована на сайте spring4all.com. Пожалуйста, стремитесь к точности перевода, за что мы благодарим вас от всего сердца**.

#### Завершение перевода

После завершения перевода вы можете отправить статью в ваш репозиторий:

```shell
## Сохранение
git add .
git commit -m "Переведена xx статья, ждет проверки"

## Отправка на GitHub своего удаленного репозитория
git push origin master

После выполнения команды push, вам нужно создать новый Pull Request.

Веб-перевод

Из-за множества одновременно выполняемых запросов PR, пожалуйста, поддерживайте синхронизацию вашего репозитория с удалённым (https://github.com/SpringForAll/spring-guides-translation), чтобы избежать конфликтов при работе над своими статьями.Для перевода через веб-интерфейс выберите статью, которую вы взяли на перевод, нажмите кнопку «Редактировать», завершите перевод и нажмите кнопку «Сохранить». После этого действуйте так же, как если бы вы работали с локальным репозиторием, создавая Pull Request. Обратите внимание, что после завершения перевода ваша статья будет проверена и опубликована на сайте spring4all.com. Пожалуйста, стремитесь к точности перевода, за что мы благодарим вас от всего сердца.## Заключение

Команда перевода SpringForAll существует недолго, и у нас мало опыта работы, но мы постоянно совершенствуемся, чтобы лучше обслуживать сообщество и любителей технологий. Мы также рады видеть вашу активность и участие в наших проектах, чтобы сделать это дело еще лучше. Если у вас есть какие-либо предложения или замечания, вы можете связаться с нами в группе: