-
Notifications
You must be signed in to change notification settings - Fork 14
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
52 additions
and
51 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,71 +1,71 @@ | ||
| [[_first_time]] | ||
| === First-Time Git Setup | ||
| === Першапачатковая настройка Git | ||
|
|
||
| Now that you have Git on your system, you'll want to do a few things to customize your Git environment. | ||
| You should have to do these things only once on any given computer; they'll stick around between upgrades. | ||
| You can also change them at any time by running through the commands again. | ||
| Цяпер, калі Git усталяваны ў вашай сістэме, самы час наладзіць сераду для працы з Git пад сябе. | ||
| Гэта трэба зрабіць толькі адзін раз -- пры абнаўленні версіі Git налады захаваюцца. | ||
| Але, пры неабходнасці, вы можаце памяняць іх у любы момант, выканаўшы тыя ж каманды зноў. | ||
|
|
||
| Git comes with a tool called `git config` that lets you get and set configuration variables that control all aspects of how Git looks and operates.(((git commands, config))) | ||
| These variables can be stored in three different places: | ||
| У склад Git уваходзіць утыліта `git config`, якая дазваляе праглядаць і наладжваць параметры, якія кантралююць усе аспекты працы Git, а таксама яго знешні выгляд. | ||
| (((каманды git, config))) | ||
| Гэтыя параметры могуць быць захаваны ў трох месцах: | ||
|
|
||
| 1. `[path]/etc/gitconfig` file: Contains values applied to every user on the system and all their repositories. | ||
| If you pass the option `--system` to `git config`, it reads and writes from this file specifically. | ||
| Because this is a system configuration file, you would need administrative or superuser privilege to make changes to it. | ||
| 2. `~/.gitconfig` or `~/.config/git/config` file: Values specific personally to you, the user. | ||
| You can make Git read and write to this file specifically by passing the `--global` option, and this affects _all_ of the repositories you work with on your system. | ||
| 3. `config` file in the Git directory (that is, `.git/config`) of whatever repository you're currently using: Specific to that single repository. | ||
| You can force Git to read from and write to this file with the `--local` option, but that is in fact the default. | ||
| Unsurprisingly, you need to be located somewhere in a Git repository for this option to work properly. | ||
| 1. Файл `[path]/etc/gitconfig` змяшчае значэння, агульныя для ўсіх карыстальнікаў сістэмы і для ўсіх іх рэпазітароў. | ||
| Если при запуске `git config` указать параметр `--system`, то параметры будут читаться и сохраняться именно в этот файл. | ||
| Вам спатрэбяцца правы суперкарыстальника для ўнясення змяненняў у яго, бо гэты файл з'яўляецца сістэмным. | ||
| 2. Файл `~/.gitconfig` або `~/.config/git/config` захоўвае налады канкрэтнага карыстальніка. | ||
| Гэты файл выкарыстоўваецца пры ўказанні параметра `--global` і прымяняецца да _ўсіх_ рэпазітароў, з якімі вы працуеце ў бягучай сістэме. | ||
| 3. Файл `config` у каталогу Git (`.git/config`) рэпазітара, які вы выкарыстоўваеце ў дадзены момант, захоўвае налады канкрэтнага рэпазітара. | ||
| Вы можаце прымусіць Git чытаць і пісаць у гэты файл з дапамогай параметру --local, але на самой справе гэта значэнне па змаўчанні. | ||
| Нядзіўна, што вам трэба знаходзіцца дзесьці ў рэпазітары Git, каб гэтая опцыя працавала правільна. | ||
|
|
||
| Each level overrides values in the previous level, so values in `.git/config` trump those in `[path]/etc/gitconfig`. | ||
| Налады на кожным наступным узроўні падмяняюць налады з папярэдніх узроўняў, гэта значыць, што значэння ў `.git/config` перакрываюць адпаведныя значэння ў `[path]/etc/gitconfig`. | ||
|
|
||
| On Windows systems, Git looks for the `.gitconfig` file in the `$HOME` directory (`C:\Users\$USER` for most people). | ||
| It also still looks for `[path]/etc/gitconfig`, although it's relative to the MSys root, which is wherever you decide to install Git on your Windows system when you run the installer. | ||
| If you are using version 2.x or later of Git for Windows, there is also a system-level config file at | ||
| `C:\Documents and Settings\All Users\Application Data\Git\config` on Windows XP, and in `C:\ProgramData\Git\config` on Windows Vista and newer. | ||
| This config file can only be changed by `git config -f <file>` as an admin. | ||
| У сістэмах сямейства Windows Git шукае файл `.gitconfig` ў каталогу `$HOME` ( `C:\Users\$USER` для большасці карыстальнікаў). | ||
| Акрамя таго, Git шукае файл `[path]/etc/gitconfig`, але ўжо адносна каранёвага каталога MSys, які знаходзіцца там, куды вы вырашылі ўсталяваць Git пры запуску ўсталёўніка. | ||
|
|
||
| You can view all of your settings and where they are coming from using: | ||
| Калі вы выкарыстоўваеце Git для Windows версіі 2.х або навей, то гэтак жа апрацоўваецца файл канфігурацыі ўзроўню сістэмы, які мае шлях `C:\Documents and Settings\All Users\Application Data\Git\config` у Windows XP або `C:\ProgramData\Git\config` у Windows Vista і навей. | ||
| Гэты файл можа быць зьменены толькі камандай `git config -f <file>`, запушчанай з правамі адміністратара. | ||
|
|
||
| Каб паглядзець усе ўстаноўленыя налады і даведацца дзе менавіта яны зададзены, выкарыстоўвайце каманду: | ||
|
|
||
| [source,console] | ||
| ---- | ||
| $ git config --list --show-origin | ||
| ---- | ||
|
|
||
| ==== Your Identity | ||
| ==== Ваша Асоба | ||
|
|
||
| The first thing you should do when you install Git is to set your user name and email address. | ||
| This is important because every Git commit uses this information, and it's immutably baked into the commits you start creating: | ||
| Першае, што вам варта зрабіць пасля ўстаноўкі Git -- пазначыць ваша імя і адрас электроннай пошты. | ||
| Гэта важна, таму што кожны каміт у Git змяшчае гэтую інфармацыю, і яна ўключана ў каміты, якія вы перадаяцё, і не можа быць далей зменена: | ||
|
|
||
| [source,console] | ||
| ---- | ||
| $ git config --global user.name "John Doe" | ||
| $ git config --global user.email [email protected] | ||
| ---- | ||
|
|
||
| Again, you need to do this only once if you pass the `--global` option, because then Git will always use that information for anything you do on that system. | ||
| If you want to override this with a different name or email address for specific projects, you can run the command without the `--global` option when you're in that project. | ||
| Зноў жа, калі выкарыстоўваецца опцыя `--global`, то гэтыя налады досыць зрабіць толькі адзін раз, паколькі ў гэтым выпадку Git будзе выкарыстоўваць гэтыя налады для ўсяго, што вы робіце ў гэтай сістэме. | ||
| Калі для нейкіх асобных праектаў вы хочаце вызначыць іншую назву ці электронную пошту, можна выканаць гэтую ж каманду без параметра `--global` у каталогу з патрэбным праектам. | ||
|
|
||
| Many of the GUI tools will help you do this when you first run them. | ||
| Многія GUI-інструменты прапануюць зрабіць гэта пры першым запуску. | ||
|
|
||
| [[_editor]] | ||
| ==== Your Editor | ||
|
|
||
| Now that your identity is set up, you can configure the default text editor that will be used when Git needs you to type in a message. | ||
| If not configured, Git uses your system's default editor. | ||
| ==== Выбар рэактара | ||
|
|
||
| If you want to use a different text editor, such as Emacs, you can do the following: | ||
| Цяпер, калі вы задалі сваё імя, самы час выбраць тэкставы рэдактар, які будзе выкарыстоўвацца калі патрэбна набраць паведамленне ў Git. | ||
| Па змаўчанні, Git выкарыстоўвае стандартны рэдактар вашай сістэмы, якім звычайна з'яўляецца Vim. | ||
| Калі вы хочаце карыстацца іншым тэкставым рэдактарам, напрыклад, Emacs, можна зрабіць наступнае: | ||
|
|
||
| [source,console] | ||
| ---- | ||
| $ git config --global core.editor emacs | ||
| ---- | ||
|
|
||
| On a Windows system, if you want to use a different text editor, you must specify the full path to its executable file. | ||
| This can be different depending on how your editor is packaged. | ||
| У сістэме Windows варта паказваць поўны шлях да выконваемага файла пры ўсталёўцы іншага тэкставага рэдактара па змаўчанні. | ||
| Шляхі могуць адрознівацца ў залежнасці ад таго, як працуе ўсталёўнік. | ||
|
|
||
| In the case of Notepad++, a popular programming editor, you are likely to want to use the 32-bit version, since at the time of writing the 64-bit version doesn't support all plug-ins. | ||
| If you are on a 32-bit Windows system, or you have a 64-bit editor on a 64-bit system, you'll type something like this: | ||
| У выпадку з Notepad++, папулярным рэдактарам, хутчэй за ўсё вы захочаце ўсталяваць 32-бітную версію, так як 64-бітная версія яшчэ не падтрымлівае ўсе ўбудовы. | ||
| Калі ў вас 32-бітная Windows або 64-бітны рэдактар з 64-бітнай сістэмай, то выканайце наступнае: | ||
|
|
||
| [source,console] | ||
| ---- | ||
|
|
@@ -74,31 +74,31 @@ $ git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -m | |
|
|
||
| [NOTE] | ||
| ==== | ||
| Vim, Emacs and Notepad++ are popular text editors often used by developers on Unix-based systems like Linux and macOS or a Windows system. | ||
| If you are using another editor, or a 32-bit version, please find specific instructions for how to set up your favorite editor with Git in <<C-git-commands#ch_core_editor>>. | ||
| Vim, Emacs і Notepad++ -- папулярныя тэкставыя рэдактары, якія часта выкарыстоўваюцца распрацоўшчыкамі як у Unix-падобных сістэмах, такіх як Linux і Mac, так і ў Windows. | ||
| Калі вы карыстаецеся іншым рэдактарам або яго 32-бітнай версіяй, то звярніцеся да падзелу << C-git-commands#r_core_editor >> за дадатковымі інструкцыямі як выкарыстоўваць яго сумесна з Git. | ||
| ==== | ||
|
|
||
| [WARNING] | ||
| ==== | ||
| You may find, if you don't setup your editor like this, you get into a really confusing state when Git attempts to launch it. | ||
| An example on a Windows system may include a prematurely terminated Git operation during a Git initiated edit. | ||
| У выпадку, калі вы не ўсталявалі свой рэдактар і не знаёмы з Vim ці Emacs, вы можаце патрапіць у цяжкае становішча, калі які-небудзь з іх будзе запушчаны. | ||
| Напрыклад, у Windows можа адбыцца заўчаснае перапыненне каманды Git пры спробе выкліку рэдактара. | ||
| ==== | ||
|
|
||
| ==== Your default branch name | ||
| ==== Настройка ветки по умолчанию | ||
|
|
||
| By default Git will create a branch called _master_ when you create a new repository with `git init`. | ||
| From Git version 2.28 onwards, you can set a different name for the initial branch. | ||
| Калі вы ініцыялізуеце рэпазітар камандай `git init`, Git стварае галіну з імем _master_ па змаўчанні. | ||
| Пачынаючы з версіі 2.28, вы можаце задаць іншае імя для стварэння галіны па змаўчанні. | ||
|
|
||
| To set _main_ as the default branch name do: | ||
| Напрыклад, каб усталяваць імя _main_ для вашай галіны па змаўчанні, запусціце наступную каманду: | ||
|
|
||
| [source,console] | ||
| ---- | ||
| $ git config --global init.defaultBranch main | ||
| ---- | ||
|
|
||
| ==== Checking Your Settings | ||
| ==== Проверка настроек | ||
|
|
||
| If you want to check your configuration settings, you can use the `git config --list` command to list all the settings Git can find at that point: | ||
| Калі вы хочаце праверыць свае налады канфігурацыі, вы можаце выкарыстоўваць каманду `git config --list`, каб пералічыць усе налады, якія Git можа знайсці ў бягучым мейсцы: | ||
|
|
||
| [source,console] | ||
| ---- | ||
|
|
@@ -112,10 +112,10 @@ color.diff=auto | |
| ... | ||
| ---- | ||
|
|
||
| You may see keys more than once, because Git reads the same key from different files (`[path]/etc/gitconfig` and `~/.gitconfig`, for example). | ||
| In this case, Git uses the last value for each unique key it sees. | ||
| Некаторыя ключы (назвы) налад могуць быць паказаны некалькі разоў, таму што Git чытае налады з розных файлаў (напрыклад, з `/etc/gitconfig` і `~/.gitconfig`). | ||
| У такім выпадку Git выкарыстоўвае апошняе значэнне для кожнага ключа. | ||
|
|
||
| You can also check what Git thinks a specific key's value is by typing `git config <key>`:(((git commands, config))) | ||
| Таксама вы можаце праверыць значэнне канкрэтнага ключа, выканаўшы `git config <key>`:(((команды git, config))) | ||
|
|
||
| [source,console] | ||
| ---- | ||
|
|
@@ -125,8 +125,9 @@ John Doe | |
|
|
||
| [NOTE] | ||
| ==== | ||
| Since Git might read the same configuration variable value from more than one file, it's possible that you have an unexpected value for one of these values and you don't know why. | ||
| In cases like that, you can query Git as to the _origin_ for that value, and it will tell you which configuration file had the final say in setting that value: | ||
| Git чытае значэнні налад з некалькіх файлаў, таму магчыма сітуацыя калі Git выкарыстае не тое значэнне што вы чакалі. | ||
| У такім выпадку вы можаце спытаць Git аб _origin_ гэтага значэння. | ||
| Git выведзе імя файла, з якога значэнне для налады было ўзята апошнім: | ||
| [source,console] | ||
| ---- | ||
|
|
||