18.12.2015

- Удалён ненужный раздел "папки и файлы" - Готов раздел Git - Небольшие улучшения подсветки кода
info-expert-projects · Dec 18, 2015 · a3d310d · a3d310d
1 parent ab4b13f
commit a3d310d
Show file tree

Hide file tree

Showing 4 changed files with 204 additions and 25 deletions.
diff --git a/storage/pages/code/folders.md b/storage/pages/code/folders.md
diff --git a/storage/pages/git/index.md b/storage/pages/git/index.md
@@ -8,11 +8,205 @@ template: index
 
 # Правила работы с Git
 
-<div class="tip">
-    :construction: Страница не закончена. <a href="https://github.com/pafnuty/bqs-site/blob/dev/storage/pages/git/index.md" class="btn btn-small" target="_blank">Редактировать</a>
+<a href="https://github.com/pafnuty/bqs-site/blob/dev/storage/pages/git/index.md" class="btn btn-mini" target="_blank">Редактировать страницу</a>
+
+<div class="tip col-margin">
+    На этой странице описаны лишь общие моменты работы с репозиториями, перед началом работы необходимо согласовать все особенности проекта с коллегами.
+</div>
+
+<div class="alert alert-error">
+    :exclamation: <b>ВНИМАНИЕ!</b> <br>Для примера взята гипотетическая площадка DEMO XX.
+</div>
+
+---
+## [Настройка своего аккаунта на SSH](#configSSH){#configSSH .h3}
+---
+
+- Авторизуемся на SSH под своим логином и паролем и пишем в консоли:
+```bash
+cd
+git config --global user.name "ЛОГИН_НА БИТБАКЕТЕ"
+git config --global user.email "EMAIL_НА БИТБАКЕТЕ"
+```
+- Проверяем настройки
+```bash
+git config --list
+```
+
+
+---
+## [Создание репозитория](#configRepo){#configRepo .h3}
+---
+
+- Просим того, кто имеет право создавать новые репы, сделать это :smile:.
+
+---
+## [Создание репозитория на демке](#repoCreate){#repoCreate .h3}
+---
+
+Перед началом работы с репозиторием **ОБЯЗАТЕЛЬНО** создаём в корне файл `.gitignore` с вот таким содержимым:
+```
+# Исключаем всё
+/*
+# Кроме самого .gitignore (и как следствие всего, что в нём написано)
+!.gitignore
+# Кроме папки local
+!/local/
+```
+ Это необходимо для исключения из репозитория того, что нам там не нужно.
+
+- Заходим на сервер через SSH
+- Выполняем сдедующие команды для первоначальной настройки    
+```bash 
+cd /var/www/demoXX
+git init 
+```
+
+- Настраиваем короткое имя репозитория и URL, куда будут уходить коммиты.
+```bash
+git remote add demoXX https://bitbucket.org/путь_до_репозитория/
+```
+`demoXX` - котроткое имя репозитория, может быть в принципе каким угодно.
+
+- Отправляем данные в репозторий:
+```bash
+git add .
+git commit -m "Initial Commit"
+git push 
+```
+
+
+---
+## [Работа с репозиторием при разработке](#workWRepo){#workWRepo .h3}
+---
+
+#### Первым делом идём на SSH:
+```bash 
+cd /var/www/demoXX
+```
+
+#### Стягиваем изменения:
+```bash
+git pull demoXX master
+```
+
+#### Отправляем коммит:
+```bash 
+git status 
+git add .
+git commit -a
+```
+
+#### Вводим информацию о коммите в следующем формате:
+```
+[дата в формате ДД.ММ.ГГГГ][Заголовок коммита]
+Список выполненной работы в коммите. 
+Краткий changelog для того, что бы потом можно было сходу понять 
+что сделано в репозитории конкретным разработчиком.
+```
+
+<div class="alert alert-error">
+    :bangbang::bangbang: <b>ВСЕ КОММИТЫ БЕЗ ОПИСАНИЯ БУДУТ БЕЗ ПРЕДУПРЕЖДЕНИЯ ОТКАТЫВАТЬСЯ</b>. <br>Это означает, что вся работа, которая проделана без описания будет в итоге похерена (и с большой вероятностью перетёрта другим разработчиком) и её придётся делать заново, но уже с описанием.
 </div>
 
-## BitBucket
-## GitHub
-## Правила оформления коммитов и пушей
-## Настройка автоматического деплоя на сайте
+#### Пример коммита:
+```md 
+07.09.2015
+- Добавлен новый компонент `custom.news.list`
+- Исправлена ошибка в `80-main.less`
+- Реализован шаблон главной
+```
+
+#### Отправляем данные в реп
+```bash
+git push demoXX master
+```
+
+
+---
+## [Работа с репозиторием после выгрузки сайта на бой (продакшн)](#workProduction){#workProduction .h3}
+---
+
+#### Первым делом идём на SSH
+```bash 
+cd /var/www/demoXX
+git init
+git clone https://bitbucket.org/infoexpertteam/tb-houseboats.ru
+```
+
+#### Стягиваем актуальные изменения
+```bash 
+git pull demoXX
+```
+
+#### Создаём ветку dev (если её не было)
+```bash 
+git branch dev
+```
+
+#### Переходим ветку dev и там уже будем работать
+```bash 
+git checkout dev
+```
+
+#### Коммит (правильный коммит см. выше)
+```bash 
+git add .
+git commit -a
+```
+
+#### Отправка данных
+```bash 
+git push demoXX dev
+```
+
+
+---
+## [Полезные советы](#tips){#tips .h3}
+---
+
+### Алиасы
+Для удобства использования командной строки можно добавить алиасы для гита. Для этого открываем файл `/home/ИМЯ_ПОЛЬЗОВАТЕЛЯ/.bashrc` и добавляем алиасы для удобного вызова команд гита:
+```bash
+alias g='git'
+alias cit='git'
+alias gs='git status '
+alias ga='git add '
+alias gb='git branch '
+alias gc='git commit'
+alias gd='git diff'
+alias go='git checkout '
+alias gk='gitk --all&'
+alias gx='gitx --all'
+alias gp='git push'
+
+alias got='git '
+alias get='git '
+```
+Теперь можно настроить алиасы для конкретного проекта. Для этого идём в папку `.git` проекта, открываем файл `config`  и в конец дописываем:
+```
+[alias]
+    # one-line log
+    l = log --pretty=format:"%C(yellow)%h\\ %ad%Cred%d\\ %Creset%s%Cblue\\ [%cn]" --decorate --date=short
+
+    a = add
+    ap = add -p
+    c = commit --verbose
+    ca = commit -a --verbose
+    cm = commit -m
+    cam = commit -a -m
+    m = commit --amend --verbose
+
+    d = diff
+    ds = diff --stat
+    dc = diff --cached
+
+    s = status -s
+    co = checkout
+    cob = checkout -b
+    # list branches sorted by last modified
+    b = "!git for-each-ref --sort='-authordate' --format='%(authordate)%09%(objectname:short)%09%(refname)' refs/heads | sed -e 's-refs/heads/--'"
+
+    # list aliases
+    la = "!git config -l | grep alias | cut -c 7-"
+```