Skip to content

Commit

Permalink
Merge pull request #359 from Morganov/update/directory-to-catalog
Browse files Browse the repository at this point in the history
Директория заменена на каталог
  • Loading branch information
Morganov authored Feb 13, 2021
2 parents c507718 + 4fcfe12 commit c3c7f19
Show file tree
Hide file tree
Showing 49 changed files with 243 additions and 243 deletions.
28 changes: 14 additions & 14 deletions C-git-commands.asc
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@

В главе <<ch07-git-tools#r_credential_caching>> мы использовали её для задания хранилища ваших HTTP паролей.

В главе <<ch08-customizing-git#r_keyword_expansion>> мы показали как настроить фильтры содержимого для данных, перемещаемых между индексом и рабочей директорией.
В главе <<ch08-customizing-git#r_keyword_expansion>> мы показали как настроить фильтры содержимого для данных, перемещаемых между индексом и рабочей копией.

Ну и практически вся глава <<ch08-customizing-git#r_git_config>> посвящена этой команде.

Expand Down Expand Up @@ -88,11 +88,11 @@
=== Клонирование и создание репозиториев

Существует два способа создать Git репозиторий.
Первый -- клонировать его из существующего репозитория (например, по сети); второй -- создать репозиторий в существующей директории.
Первый -- клонировать его из существующего репозитория (например, по сети); второй -- создать репозиторий в существующем каталоге.

==== git init

Чтобы превратить обычную директорию в Git репозиторий и начать версионировать файлы в ней, просто запустите `git init`.
Чтобы превратить обычный каталог в Git репозиторий и начать версионировать файлы в нём, просто запустите `git init`.

Впервые мы продемонстрировали эту команду в главе <<ch02-git-basics-chapter#r_getting_a_repo>> на примере создания нового репозитория для последующей работы с ним.

Expand All @@ -105,13 +105,13 @@
==== git clone

На самом деле `git clone` работает как обёртка над некоторыми другими командами.
Она создаёт новую директорию, переходит внутрь и выполняет `git init` для создания пустого репозитория, затем она добавляет новый удалённый репозиторий (`git remote add`) для указанного URL (по умолчанию он получит имя `origin`), выполняет `git fetch` для этого репозитория и, наконец, обновляет вашу рабочую директорию до последнего коммита, используя `git checkout`.
Она создаёт новый каталог, переходит внутрь и выполняет `git init` для создания пустого репозитория, затем она добавляет новый удалённый репозиторий (`git remote add`) для указанного URL (по умолчанию он получит имя `origin`), выполняет `git fetch` для этого репозитория и, наконец, извлекает последний коммит в ваш рабочий каталог, используя `git checkout`.

Команда `git clone` используется в десятке различных мест в этой книге, но мы перечислим наиболее интересные упоминания.

Первоначальное знакомство происходит в главе <<ch02-git-basics-chapter#r_git_cloning>>, где мы даём немного объяснений и приводим несколько примеров.

В главе <<ch04-git-on-the-server#r_git_on_the_server>> мы рассмотрели как использовать опцию `--bare`, чтобы создать копию Git репозитория без рабочей директории.
В главе <<ch04-git-on-the-server#r_git_on_the_server>> мы рассмотрели как использовать опцию `--bare`, чтобы создать копию Git репозитория без рабочей копии.

В главе <<ch07-git-tools#r_bundling>> мы использовали `git clone` для распаковки упакованного с помощью `git bundle` репозитория.

Expand All @@ -126,7 +126,7 @@

==== git add

Команда `git add` добавляет содержимое рабочей директории в индекс (staging area) для последующего коммита.
Команда `git add` добавляет содержимое рабочего каталога в индекс (staging area) для последующего коммита.
По умолчанию `git commit` использует лишь этот индекс, так что вы можете использовать `git add` для сборки слепка вашего следующего коммита.

Это одна из ключевых команд Git, мы упоминали о ней десятки раз на страницах книги.
Expand All @@ -142,7 +142,7 @@

==== git status

Команда `git status` показывает состояния файлов в рабочей директории и индексе: какие файлы изменены, но не добавлены в индекс; какие ожидают коммита в индексе.
Команда `git status` показывает состояния файлов в рабочем каталоге и индексе: какие файлы изменены, но не добавлены в индекс; какие ожидают коммита в индексе.
Вдобавок к этому выводятся подсказки о том, как изменить состояние файлов.

Мы познакомили вас с этой командой в главе <<ch02-git-basics-chapter#r_checking_status>>, разобрали стандартный и упрощённый формат вывода.
Expand All @@ -151,7 +151,7 @@
==== git diff

Команда `git diff` используется для вычисления разницы между любыми двумя Git деревьями.
Это может быть разница между вашей рабочей директорией и индексом (собственно `git diff`), разница между индексом и последним коммитом (`git diff --staged`), или между любыми двумя коммитами (`git diff master branchB`).
Это может быть разница между вашей рабочей копией и индексом (собственно `git diff`), разница между индексом и последним коммитом (`git diff --staged`), или между любыми двумя коммитами (`git diff master branchB`).

Мы познакомили вас с основами этой команды в главе <<ch02-git-basics-chapter#r_git_diff_staged>>, где показали как посмотреть какие изменения уже добавлены в индекс, а какие -- ещё нет.

Expand Down Expand Up @@ -188,7 +188,7 @@

Команда `git reset`, как можно догадаться из названия, используется в основном для отмены изменений.
Она изменяет указатель `HEAD` и, опционально, состояние индекса.
Также эта команда может изменить файлы в рабочей директории при использовании параметра `--hard`, что может привести к потере наработок при неправильном использовании, так что убедитесь в серьёзности своих намерений прежде чем использовать его.
Также эта команда может изменить файлы в рабочем каталоге при использовании параметра `--hard`, что может привести к потере наработок при неправильном использовании, так что убедитесь в серьёзности своих намерений прежде чем использовать его.

Мы рассказали об основах использования `git reset` в главе <<ch02-git-basics-chapter#r_unstaging>>, где эта команда использовалась для удаления файла из индекса, добавленного туда с помощью `git add`.

Expand All @@ -198,10 +198,10 @@

==== git rm

Команда `git rm` используется в Git для удаления файлов из индекса и рабочей директории.
Команда `git rm` используется в Git для удаления файлов из индекса и рабочей копии.
Она похожа на `git add` с тем лишь исключением, что она удаляет, а не добавляет файлы для следующего коммита.

Мы немного разобрались с этой командой в главе <<ch02-git-basics-chapter#r_removing_files>>, показали как удалять файлы из рабочей директории и индекса и только из индекса, используя флаг `--cached`.
Мы немного разобрались с этой командой в главе <<ch02-git-basics-chapter#r_removing_files>>, показали как удалять файлы из рабочего каталога и индекса и только из индекса, используя флаг `--cached`.

Ещё один вариант использования `git rm` приведён в главе <<ch10-git-internals#r_removing_objects>>, где мы вкратце объяснили как использовать опцию `--ignore-unmatch` при выполнении `git filter-branch`, которая подавляет ошибки удаления несуществующих файлов.
Это может быть полезно для автоматически выполняемых скриптов.
Expand All @@ -214,7 +214,7 @@

==== git clean

Команда `git clean` используется для удаления мусора из рабочей директории.
Команда `git clean` используется для удаления мусора из рабочего каталога.
Это могут быть результаты сборки проекта или файлы конфликтов слияний.

Мы рассмотрели множество опций и сценариев использования этой команды в главе <<ch07-git-tools#r_git_clean>>.
Expand All @@ -237,7 +237,7 @@

==== git checkout

Команда `git checkout` используется для переключения веток и выгрузки их содержимого в рабочую директорию.
Команда `git checkout` используется для переключения веток и выгрузки их содержимого в рабочий каталог.

Мы познакомились с этой командой в главе <<ch03-git-branching#r_switching_branches>> вместе с `git branch`.

Expand Down Expand Up @@ -298,7 +298,7 @@

==== git stash

Команда `git stash` используется для временного сохранения всех незакоммиченных изменений для очистки рабочей директории без необходимости коммитить незавершённую работу в новую ветку.
Команда `git stash` используется для временного сохранения всех незафиксированных изменений с целью очистки рабочего каталога без необходимости фиксировать незавершённую работу в текущей ветке.

Эта команда практически целиком раскрыта в главе <<ch07-git-tools#r_git_stashing>>.

Expand Down
4 changes: 2 additions & 2 deletions book/01-introduction/sections/about-version-control.asc
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@
==== Локальные системы контроля версий

(((version control,local)))
Многие люди в качестве метода контроля версий применяют копирование файлов в отдельную директорию (возможно даже, директорию с отметкой по времени, если они достаточно сообразительны).
Многие люди в качестве метода контроля версий применяют копирование файлов в отдельный каталог (возможно даже, каталог с отметкой по времени, если они достаточно сообразительны).
Данный подход очень распространён из-за его простоты, однако он невероятно сильно подвержен появлению ошибок.
Можно легко забыть, в какой директории вы находитесь, и случайно изменить не тот файл или скопировать не те файлы, которые вы хотели.
Можно легко забыть в каком каталоге вы находитесь и случайно изменить не тот файл или скопировать не те файлы, которые вы хотели.

Для того, чтобы решить эту проблему, программисты давным-давно разработали локальные СКВ с простой базой данных, которая хранит записи о всех изменениях в файлах, осуществляя тем самым контроль ревизий.

Expand Down
2 changes: 1 addition & 1 deletion book/01-introduction/sections/what-is-git.asc
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Git переосмысливает практически все аспекты

В Git для всего вычисляется хеш-сумма, и только потом происходит сохранение.
В дальнейшем обращение к сохранённым объектам происходит по этой хеш-сумме.
Это значит, что невозможно изменить содержимое файла или директории так, чтобы Git не узнал об этом.
Это значит, что невозможно изменить содержимое файла или каталога так, чтобы Git не узнал об этом.
Данная функциональность встроена в Git на низком уровне и является неотъемлемой частью его философии.
Вы не потеряете информацию во время её передачи и не получите повреждённый файл без ведома Git.

Expand Down
14 changes: 7 additions & 7 deletions book/02-git-basics/sections/getting-a-repository.asc
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@

В обоих случаях вы получите готовый к работе Git репозиторий на вашем компьютере.

==== Создание репозитория в существующей директории
==== Создание репозитория в существующем каталоге

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

для Linux:
Expand All @@ -36,9 +36,9 @@ $ cd C:/Users/user/my_project
$ git init
----

Эта команда создаёт в текущей директории новую поддиректорию с именем `.git`, содержащую все необходимые файлы репозитория -- структуру Git-репозитория.
Эта команда создаёт в текущем каталоге новый подкаталог с именем `.git`, содержащий все необходимые файлы репозитория -- структуру Git репозитория.
На этом этапе ваш проект ещё не находится под версионным контролем.
(Подробное описание файлов содержащихся в только что созданной вами директории `.git` приведено в главе <<ch10-git-internals#ch10-git-internals>>)(((git commands, init)))
Подробное описание файлов, содержащихся в только что созданном вами каталоге `.git`, приведено в главе <<ch10-git-internals#ch10-git-internals>>(((git commands, init)))

Если вы хотите добавить под версионный контроль существующие файлы (в отличие от пустого каталога), вам стоит добавить их в индекс и осуществить первый коммит изменений.
Добиться этого вы сможете запустив команду `git add` несколько раз, указав индексируемые файлы, а затем выполнив `git commit`:
Expand Down Expand Up @@ -70,9 +70,9 @@ $ git commit -m 'Initial project version'
$ git clone https://github.com/libgit2/libgit2
----

Эта команда создаёт директорию `libgit2`, инициализирует в ней поддиректорию `.git`, скачивает все данные для этого репозитория и извлекает рабочую копию последней версии.
Если вы зайдёте в новую директорию `libgit2`, то увидите в ней файлы проекта, готовые для работы или использования.
Для того, чтобы клонировать репозиторий в директорию с именем, отличающимся от `libgit2`, необходимо указать желаемое имя, как параметр командной строки:
Эта команда создаёт каталог `libgit2`, инициализирует в нём подкаталог `.git`, скачивает все данные для этого репозитория и извлекает рабочую копию последней версии.
Если вы перейдёте в только что созданный каталог `libgit2`, то увидите в нём файлы проекта, готовые для работы или использования.
Для того, чтобы клонировать репозиторий в каталог с именем, отличающимся от `libgit2`, необходимо указать желаемое имя, как параметр командной строки:

[source,console]
----
Expand Down
Loading

0 comments on commit c3c7f19

Please sign in to comment.