Merge pull request #337 from SergeiKuznetsov/master

Опечатки, кавычки, проблемы с форматированием

.gitignore

@@ -1,11 +1,13 @@
 output
 .DS_Store
+.vscode
 
 # build artifacts
+Gemfile.lock
 progit.html
 progit.pdf
 progit.pdfmarks
 progit.epub
 progit-kf8.epub
 progit.mobi
-
+contributors.txt

.mailmap

@@ -0,0 +1,3 @@
+Jean-Noël Avila <[email protected]>
+Scott Chacon <[email protected]>
+Sanders Kleinfeld <[email protected]>

B-embedding-git.asc → B-embedding-git-in-your-applications.asc

@@ -1,4 +1,4 @@
-[#B-embedding-git]
+[[B-embedding-git-in-your-applications]]
 [appendix]
 == Встраивание Git в ваши приложения
 

README.asc

@@ -64,5 +64,5 @@ Converting to PDF...
 Добавление иллюстрации:
 
 . Добавьте страницу в sketchbook; по-возможности старайтесь использовать встроенные символы.
-. Добавьте ``slice'' на свою страницу; назовите её так же, как PNG файл, относительно root раздела исходного кода книги.
+. Добавьте «slice» на свою страницу; назовите её так же, как PNG файл, относительно корневого раздела исходного кода книги.
 . Убедитесь, что в настройках экспорта выставлен трехкратный размер.

TRANSLATION_NOTES.asc

@@ -49,6 +49,6 @@
 
 === Кавычки
 В тексте книги следует использовать кавычки «ёлочки» во всех случаях, за исключением ситуации, когда слово или фраза в кавычках входит в состав другой фразы заключённой в кавычки. 
-Например: «Фраза с "выделенным" словом­­».
+Например: «Фраза с „выделенным“ словом­­».
 
 В примерах кода или команд, взятых из оригинала, заменять кавычки не допускается.

book/01-introduction/sections/what-is-git.asc

@@ -74,7 +74,7 @@ SHA-1 хеш выглядит примерно так:
 Как и в любой другой СКВ, вы можете потерять или испортить свои изменения, пока они не зафиксированы, но после того, как вы зафиксируете снимок в Git, будет очень сложно что-либо потерять, особенно, если вы регулярно синхронизируете свою базу с другим репозиторием.
 
 Всё это превращает использование Git в одно удовольствие, потому что мы знаем, что можем экспериментировать, не боясь серьёзных проблем.
-Для более глубокого понимания того, как Git хранит свои данные и как вы можете восстановить данные, которые кажутся утерянными, см. <<ch02-git-basics#r_undoing>>.
+Для более глубокого понимания того, как Git хранит свои данные и как вы можете восстановить данные, которые кажутся утерянными, см. <<ch02-git-basics-chapter#r_undoing>>.
 
 ==== Три состояния
 
@@ -98,7 +98,7 @@ Git-директория -- это то место, где Git хранит ме
 Файлы распаковываются из сжатой базы данных в Git-директории и располагаются на диске, для того чтобы их можно было изменять и использовать.
 
 Область подготовленных файлов -- это файл, обычно располагающийся в вашей Git-директории, в нём содержится информация о том, какие изменения попадут в следующий коммит.
-Эту область ещё называют ``индекс'', однако называть её stage-область также общепринято.
+Эту область ещё называют «индекс», однако называть её «stage-область» также общепринято.
 
 Базовый подход в работе с Git выглядит так:
 
@@ -109,4 +109,4 @@ Git-директория -- это то место, где Git хранит ме
 Если определённая версия файла есть в Git-директории, эта версия считается _зафиксированной_.
 Если версия файла изменена и добавлена в индекс, значит, она _подготовлена_.
 И если файл был изменён с момента последнего распаковывания из репозитория, но не был добавлен в индекс, он считается _изменённым_.
-В главе <<ch02-git-basics#ch02-git-basics>> вы узнаете больше об этих состояниях и какую пользу вы можете извлечь из них или как полностью пропустить часть с индексом.
+В главе <<ch02-git-basics-chapter#ch02-git-basics-chapter>> вы узнаете больше об этих состояниях и какую пользу вы можете извлечь из них или как полностью пропустить часть с индексом.

book/02-git-basics/sections/getting-a-repository.asc

@@ -56,7 +56,7 @@ $ git commit -m 'initial project version'
 ==== Клонирование существующего репозитория
 
 Для получения копии существующего Git-репозитория, например, проекта, в который вы хотите внести свой вклад, необходимо использовать команду `git clone`.
-Если вы знакомы с другими системами контроля версий, такими как Subversion, то заметите, что команда называется "clone", а не "checkout".
+Если вы знакомы с другими системами контроля версий, такими как Subversion, то заметите, что команда называется «clone», а не «checkout».
 Это важное различие – вместо того, чтобы просто получить рабочую копию, Git получает копию практически всех данных, которые есть на сервере.
 При выполнении `git clone` с сервера забирается (pulled) каждая версия каждого файла из истории проекта.
 Фактически, если серверный диск выйдет из строя, вы можете использовать любой из клонов на любом из клиентов, для того, чтобы вернуть сервер в то состояние, в котором он находился в момент клонирования (вы можете потерять часть серверных хуков (server-side hooks) и т.п., но все данные, помещённые под версионный контроль, будут сохранены, подробнее об этом смотрите в главе <<ch04-git-on-the-server#r_git_on_the_server>>).

book/02-git-basics/sections/recording-changes.asc

@@ -1,7 +1,7 @@
 === Запись изменений в репозиторий
 
 Итак, у вас имеется настоящий Git-репозиторий и рабочая копия файлов для некоторого проекта.
-Вам нужно делать некоторые изменения и фиксировать “снимки” состояния (snapshots) этих изменений в вашем репозитории каждый раз, когда проект достигает состояния, которое вам хотелось бы сохранить.
+Вам нужно делать некоторые изменения и фиксировать «снимки» состояния (snapshots) этих изменений в вашем репозитории каждый раз, когда проект достигает состояния, которое вам хотелось бы сохранить.
 
 Запомните, каждый файл в вашем рабочем каталоге может находиться в одном из двух состояний: под версионным контролем (отслеживаемые) и нет (неотслеживаемые).
 Отслеживаемые файлы -- это те файлы, которые были в последнем снимке состояния проекта; они могут быть неизменёнными, изменёнными или подготовленными к коммиту.
@@ -53,7 +53,7 @@ Untracked files:
 nothing added to commit but untracked files present (use "git add" to track)
 ----
 
-Понять, что новый файл `README` неотслеживаемый можно по тому, что он находится в секции ``Untracked files'' в выводе команды `status`.
+Понять, что новый файл `README` неотслеживаемый можно по тому, что он находится в секции «Untracked files» в выводе команды `status`.
 Статус `Untracked` означает, что Git видит файл, которого не было в предыдущем снимке состояния (коммите); Git не станет добавлять его в ваши коммиты, пока вы его явно об этом не попросите.
 Это предохранит вас от случайного добавления в репозиторий сгенерированных бинарных файлов или каких-либо других, которые вы и не думали добавлять.
 Мы хотели добавить README, так давайте сделаем это.
@@ -83,7 +83,7 @@ Changes to be committed:
 
 ----
 
-Вы можете видеть, что файл проиндексирован, так как он находится в секции ``Changes to be committed''.
+Вы можете видеть, что файл проиндексирован, так как он находится в секции «Changes to be committed».
 Если вы выполните коммит в этот момент, то версия файла, существовавшая на момент выполнения вами команды `git add`, будет добавлена в историю снимков состояния.
 Как вы помните, когда вы ранее выполнили `git init`, затем вы выполнили `git add (файлы)` -- это было сделано для того, чтобы добавить файлы в вашем каталоге под версионный контроль.(((git commands, init)))(((git commands, add)))
 Команда `git add` принимает параметром путь к файлу или каталогу, если это каталог, команда рекурсивно добавляет все файлы из указанного каталога в индекс.
@@ -111,10 +111,10 @@ Changes not staged for commit:
 
 ----
 
-Файл `CONTRIBUTING.md` находится в секции ``Changes not staged for commit'' -- это означает, что отслеживаемый файл был изменён в рабочем каталоге, но пока не проиндексирован.
+Файл `CONTRIBUTING.md` находится в секции «Changes not staged for commit» -- это означает, что отслеживаемый файл был изменён в рабочем каталоге, но пока не проиндексирован.
 Чтобы проиндексировать его, необходимо выполнить команду `git add`.
 Это многофункциональная команда, она используется для добавления под версионный контроль новых файлов, для индексации изменений, а также для других целей, например для указания файлов с исправленным конфликтом слияния.
-Вам может быть понятнее, если вы будете думать об этом как ``добавить этот контент в следующий коммит'', а не как ``добавить этот файл в проект''.(((git commands, add)))
+Вам может быть понятнее, если вы будете думать об этом как «добавить этот контент в следующий коммит», а не как «добавить этот файл в проект».(((git commands, add)))
 Выполним `git add`, чтобы проиндексировать `CONTRIBUTING.md`, а затем снова выполним `git status`:
 
 [source,console]
@@ -212,7 +212,7 @@ $ cat .gitignore
 *~
 ----
 
-Первая строка предписывает Git игнорировать любые файлы заканчивающиеся на ``.o'' или ``.a'' -- объектные и архивные файлы, которые могут появиться во время сборки кода.
+Первая строка предписывает Git игнорировать любые файлы заканчивающиеся на «.o» или «.a» -- объектные и архивные файлы, которые могут появиться во время сборки кода.
 Вторая строка предписывает игнорировать все файлы заканчивающиеся на тильду (`~`), которая используется во многих текстовых редакторах, например Emacs, для обозначения временных файлов.
 Вы можете также включить каталоги log, tmp или pid; автоматически создаваемую документацию; и т.д. и т.п.
 Хорошая практика заключается в настройке файла `.gitignore` до того, как начать серьёзно работать, это защитит вас от случайного добавления в репозиторий файлов, которых вы там видеть не хотите.
@@ -226,7 +226,7 @@ $ cat .gitignore
 *  Можно инвертировать шаблон, использовав восклицательный знак (!) в качестве первого символа.
 
 Glob-шаблоны представляют собой упрощённые регулярные выражения, используемые командными интерпретаторами.
-Символ (`*`) соответствует 0 или более символам; последовательность `[abc]` -- любому символу из указанных в скобках (в данном примере a, b или c); знак вопроса (`?`) соответствует одному символу; и квадратные скобки, в которые заключены символы, разделённые дефисом (`[0-9]`), соответствуют любому символу из интервала (в данном случае от 0 до 9).
+Символ (`+*+`) соответствует 0 или более символам; последовательность `[abc]` -- любому символу из указанных в скобках (в данном примере a, b или c); знак вопроса (`?`) соответствует одному символу; и квадратные скобки, в которые заключены символы, разделённые дефисом (`[0-9]`), соответствуют любому символу из интервала (в данном случае от 0 до 9).
 Вы также можете использовать две звёздочки, чтобы указать на вложенные директории: `a/**/z` соответствует `a/z`, `a/b/z`, `a/b/c/z`, и так далее.
 
 Вот ещё один пример файла `.gitignore`:
@@ -422,7 +422,7 @@ $ git commit
 
 [NOTE]
 ====
-Редактор устанавливается переменной окружения `EDITOR` -- обычно это vim или emacs, хотя вы можете установить любой другой с помощью команды `git config --global core.editor`, как было показано в главе <<ch01-getting-started#what_is_git_section>>).(((editor, changing default)))(((git commands, config)))
+Редактор устанавливается переменной окружения `EDITOR` -- обычно это vim или emacs, хотя вы можете установить любой другой с помощью команды `git config --global core.editor`, как было показано в главе <<ch01-getting-started#r_editor>>).(((editor, changing default)))(((git commands, config)))
 ====
 
 В редакторе будет отображён следующий текст (это пример окна Vim'а):
@@ -505,9 +505,9 @@ $ git commit -a -m 'added new benchmarks'
 
 (((files, removing)))
 Для того чтобы удалить файл из Git, вам необходимо удалить его из отслеживаемых файлов (точнее, удалить его из вашего индекса) а затем выполнить коммит.
-Это позволяет сделать команда `git rm`, которая также удаляет файл из вашего рабочего каталога, так что в следующий раз вы не увидите его как “неотслеживаемый”.
+Это позволяет сделать команда `git rm`, которая также удаляет файл из вашего рабочего каталога, так что в следующий раз вы не увидите его как «неотслеживаемый».
 
-Если вы просто удалите файл из своего рабочего каталога, он будет показан в секции ``Changes not staged for commit'' (измененные, но не проиндексированные) вывода команды `git status`:
+Если вы просто удалите файл из своего рабочего каталога, он будет показан в секции «Changes not staged for commit» (измененные, но не проиндексированные) вывода команды `git status`:
 
 [source,console]
 ----