Quick Start: using Git with Gedemin-apps on Google Code

ВНИМАНИЕ! Ниже приведены инструкции для работы с Git ТОЛЬКО ИЗ КОМАНДНОЙ СТРОКИ. Если вы планируете использовать TortoiseGit, то следуйте простым инструкциям указанным здесь.

1. Скачиваем дистрибутив

Скачиваем mSysGit - версию Git для Windows.

2. Устанавливаем

шаг: Adjusting your PATH environment
выбор: Run Git and included Unix tools from the Windows Command Prompt

Кроме установки Git, еще и будет прописан путь к консольной версии в PATH (команду ‘Git Bash here’ всё равно можно будет использовать) и путь к различным Unix-утилитам типа find и sort. Будет выведено предупреждение Git о том, что вместо Windows-приложений с соответствующими именами будут вызываться Unix-аналоги, все замечательно, next.

шаг: Configuring the line ending conversions
выбор: Checkout as-is, commit Unix-style line endings

Остальные шаги можно оставить без изменений.

3. Настраиваем

Теория.

Настройки хранятся в текстовых конфигурационных файлах, поэтому при обновлении Git настройки сохранятся.

Варианты расположения конфигурационных файлов, упорядоченные по возрастанию приоритета:

1. системный

файл	gitconfig
расположение	<GIT_INSTALL_DIR>/etc/
область действия	для ВСЕХ пользователей и репозиториев системы
команда	git config --system

2. пользовательский

файл	.gitconfig
расположение	%HOME%/
область действия	для конкретного пользователя системы
команда	git config --global

3. репозитория

файл	config
расположение	<репозиторий>/.git/
область действия	для конкретного репозитория
команда	git config

Клацаем в консоли.

имя пользователя:

 git config --global user.name "Marina K.S."
 git config --global user.email lllli.marina.illll@gmail.com

текстовый редактор для набора сообщений:

 git config --global core.editor 'C:\\Program Files (x86)\\Notepad++\\notepad++.exe' -multiInst -notabbar -nosession -noPlugin
 git config --global core.autocrlf true
 git config --global core.safecrlf true
 git config --global core.quotepath false (корректно выводить русские имена файлов)
 git config --global i18n.commitencoding utf8

если будете работать в консоли, а не в GUI: (передумали - верните обратно utf8)

 git config --global i18n.logoutputencoding = windows-1251 (корректно выводить русские комменты коммитов)

Чтобы в git diff, git show выводились русские буквы, файлы должны быть в кодировке UTF-8. Если кодировка файлов отлична от UTF-8, для преобразования кодировок необходимо воспользоваться консольной утилитой Git\bin\iconv.exe.

А если файлы не ваши, то:

 git config --global core.pager iconv.exe -f cp1251 -t utf-8 | less

ПОБОЧНЫЙ ЭФФЕКТ:

в diff и show русские имена файлов будут отображаться кракозябрами, зато кириллица в содержимом файла - корректно.

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

Содержимое файла %HOME%/.gitconfig должно принять примерно такой вид:

 [user]
    name = Marina K.S.
    email = lllli.marina.illll@gmail.com
 [core]
    quotepath = false
    editor = 'C:\\Program Files (x86)\\Notepad++\\notepad++.exe' -multiInst -notabbar -nosession -noPlugin
    autocrlf = true
    safecrlf = true
    pager = iconv.exe -f windows-1251 -t utf-8 | less
 [i18n]
    commitencoding = utf8
    logoutputencoding = windows-1251

(При проблеме с less задать переменную окружения: set LESSCHARSET=koi8-r)

4. Начинаем работать с проектом на Google Code

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

Хранение в незашифрованном виде!

1) переходим из-под своего аккаунта на code.google.com/hosting/settings и в разделе GoogleCode.com Password копируем строку machine...

2) сохраним ее в файл %HOME%/_netrc

(Если файл отсутствует, то его необходимо создать. Файл не должен иметь расширения)

Файл _netrc примет примерно такой вид:

 machine code.google.com
   login lllli.marina.illll@gmail.com
   password YxYxYxYxYxY

Клацаем в консоли.

 cd С:\ <- папка, в которую склонируем проект
 git clone https://code.google.com/p/gedemin-apps/
 git remote add googlecode https://code.google.com/p/gedemin-apps/ (выберете любой удобный псевдоним или origin - по умолч.)

Добавить изменения в удаленную ветку master репозитория googlecode локальной ветки master:

 git push googlecode master:master

Все, нехитрая настройка системы для работы с проектом на Google Code завершена.