From b59c33df81634cfe58962f797fe251016e79a585 Mon Sep 17 00:00:00 2001 From: Rikudo Date: Sat, 25 Jul 2026 11:49:29 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9E=D1=82=D1=80=D0=B5=D0=B4=D0=B0=D0=BA?= =?UTF-8?q?=D1=82=D0=B8=D1=80=D0=BE=D0=B2=D0=B0=D0=BD=D0=BE:=20getting-a-r?= =?UTF-8?q?epository.asc?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * В некоторых местах «Git-репозиторий» заменено на «репозиторий Git» для однородности (к примеру, после названия главы). Возможно, стоит выбрать один способ написания и писать везде одинаково. * В текст внесены мелкие правки. * В Windows разделитель директорий — обратный слэш (`\`), а не обычный (`/`). --- .../sections/getting-a-repository.asc | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/book/02-git-basics/sections/getting-a-repository.asc b/book/02-git-basics/sections/getting-a-repository.asc index 176a1e83..9300d232 100644 --- a/book/02-git-basics/sections/getting-a-repository.asc +++ b/book/02-git-basics/sections/getting-a-repository.asc @@ -1,16 +1,16 @@ [[r_getting_a_repo]] -=== Создание Git-репозитория +=== Создание репозитория Git -Обычно вы получаете репозиторий Git одним из двух способов: +Обычно вы получаете репозиторий Git одним из двух способов. -1. Вы можете взять локальный каталог, который в настоящее время не находится под версионным контролем, и превратить его в репозиторий Git, либо -2. Вы можете _клонировать_ существующий репозиторий Git из любого места. +1. Можно взять локальный каталог, который в настоящее время не находится в системе контроля версий, и превратить его в репозиторий Git. +2. Либо можно _клонировать_ существующий репозиторий Git из любого места. -В обоих случаях вы получите готовый к работе Git репозиторий на вашем компьютере. +В обоих случаях вы получите готовый к работе репозиторий Git на вашем компьютере. ==== Создание репозитория в существующем каталоге -Если у вас уже есть проект в каталоге, который не находится под версионным контролем Git, то для начала нужно перейти в него. +Если у вас уже есть проект в каталоге, который не находится под контролем версий Git, то для начала нужно перейти в него. Если вы не делали этого раньше, то для разных операционных систем это выглядит по-разному: для Linux: @@ -26,7 +26,7 @@ $ cd /Users/user/my_project для Windows: [source,console] ---- -$ cd C:/Users/user/my_project +$ cd C:\Users\user\my_project ---- а затем выполните команду: @@ -36,12 +36,12 @@ $ cd C:/Users/user/my_project $ git init ---- -Эта команда создаёт в текущем каталоге новый подкаталог с именем `.git`, содержащий все необходимые файлы репозитория -- структуру Git репозитория. -На этом этапе ваш проект ещё не находится под версионным контролем. +Эта команда создаёт в текущем каталоге новый подкаталог с именем `.git`, содержащий все необходимые файлы репозитория -- структуру Git-репозитория. +На этом этапе ваш проект ещё не находится в системе управления версиями. Подробное описание файлов, содержащихся в только что созданном вами каталоге `.git`, приведено в главе <>(((команды git, init))) -Если вы хотите добавить под версионный контроль существующие файлы (в отличие от пустого каталога), вам стоит добавить их в индекс и осуществить первый коммит изменений. -Добиться этого вы сможете запустив команду `git add` несколько раз, указав индексируемые файлы, а затем выполнив `git commit`: +Если вы хотите добавить в систему контроля версий существующие файлы (в отличие от пустого каталога), вам стоит добавить их в индекс и осуществить первый коммит изменений. +Добиться этого вы сможете, запустив команду `git add` несколько раз, указав индексируемые файлы, а затем выполнив `git commit`: [source,console] ---- @@ -50,20 +50,20 @@ $ git add LICENSE $ git commit -m 'Initial project version' ---- -Мы разберём, что делают эти команды чуть позже. +Мы разберём, что делают эти команды, чуть позже. Теперь у вас есть Git-репозиторий с отслеживаемыми файлами и начальным коммитом. [[r_git_cloning]] ==== Клонирование существующего репозитория -Для получения копии существующего Git-репозитория, например, проекта, в который вы хотите внести свой вклад, необходимо использовать команду `git clone`. +Для получения копии существующего Git-репозитория, например проекта, в который вы хотите внести свой вклад, необходимо использовать команду `git clone`. Если вы знакомы с другими системами контроля версий, такими как Subversion, то заметите, что команда называется «clone», а не «checkout». Это важное различие -- вместо того, чтобы просто получить рабочую копию, Git получает копию практически всех данных, которые есть на сервере. -При выполнении `git clone` с сервера забирается (pulled) каждая версия каждого файла из истории проекта. -Фактически, если серверный диск выйдет из строя, вы можете использовать любой из клонов на любом из клиентов, для того, чтобы вернуть сервер в то состояние, в котором он находился в момент клонирования (вы можете потерять часть серверных хуков (server-side hooks) и т. п., но все данные, помещённые под версионный контроль, будут сохранены, подробнее об этом смотрите в разделе <> главы 4). +При выполнении `git clone` с сервера забирается (_pulled_) каждая версия каждого файла из истории проекта. +Фактически, если серверный диск выйдет из строя, вы можете использовать любой из клонов на любом из клиентов для того, чтобы вернуть сервер в то состояние, в котором он находился в момент клонирования. (Вы можете потерять часть серверных хуков (_server-side hooks_) и т. п., но все данные, помещённые в систему контроля версий, будут сохранены; подробнее об этом смотрите в разделе <> главы 4.) Клонирование репозитория осуществляется командой `git clone `.(((команды git, clone))) -Например, если вы хотите клонировать библиотеку `libgit2`, вы можете сделать это следующим образом: +Например, если вы хотите клонировать библиотеку `libgit2`, это можно сделать следующим образом: [source,console] ---- @@ -72,7 +72,7 @@ $ git clone https://github.com/libgit2/libgit2 Эта команда создаёт каталог `libgit2`, инициализирует в нём подкаталог `.git`, скачивает все данные для этого репозитория и извлекает рабочую копию последней версии. Если вы перейдёте в только что созданный каталог `libgit2`, то увидите в нём файлы проекта, готовые для работы или использования. -Для того, чтобы клонировать репозиторий в каталог с именем, отличающимся от `libgit2`, необходимо указать желаемое имя, как параметр командной строки: +Для того чтобы клонировать репозиторий в каталог с именем, отличающимся от `libgit2`, необходимо указать желаемое имя в качестве параметра командной строки: [source,console] ---- @@ -82,5 +82,5 @@ $ git clone https://github.com/libgit2/libgit2 mylibgit Эта команда делает всё то же самое, что и предыдущая, только результирующий каталог будет назван `mylibgit`. В Git реализовано несколько транспортных протоколов, которые вы можете использовать. -В предыдущем примере использовался протокол `https://`, вы также можете встретить `git://` или `user@server:path/to/repo.git`, использующий протокол передачи SSH. -В разделе <> главы 4 мы познакомимся со всеми доступными вариантами конфигурации сервера для обеспечения доступа к вашему Git репозиторию, а также рассмотрим их достоинства и недостатки. +В предыдущем примере использовался протокол `https://`. Также можно встретить `git://` или `user@server:path/to/repo.git`. Они используют протокол передачи SSH. +В разделе <> главы 4 мы познакомимся со всеми доступными вариантами конфигурации сервера для обеспечения доступа к вашему Git-репозиторию, а также рассмотрим их достоинства и недостатки.