Использование Git и GitHub

Git является распределенной системой контроля версий, используемой MODX для совместной работы с исходным кодом и контроля версий. Как и MODX, это бесплатно и с открытым исходным кодом.

• Git's официальный сайт это отличное место для начала, если вы новичок в Git или контроль версий и управление конфигурацией программного обеспечения в общем. Вы захотите установить Git и ознакомиться с основными параметрами конфигурации и командами.
• Если у вас есть опыт работы в SVN, то этот ускоренный курс может быть то, что вам нужно.
• Если этого недостаточно, есть отличный интерактивная шпаргалка Эндрю Петерсона, или .. дайте нам Google, чтобы найти для вас ;-)

GitHub где хранятся репозитории MODX Git. GitHub - это сервис для «безопасного размещения исходного кода и совместной разработки», но он также является социальной сетью для разработчиков. Подробнее о хостинг репозитория GitHub но также не забудьте добавить в закладки сайт Git Reference.

Обзор¶

Вот краткий обзор рабочего процесса, который вы будете использовать для внесения изменений в любой репозиторий MODX. Это поможет понять это прежде, чем погрузиться более подробно.

Форк¶

Сначала вы создадите форк хранилища кода MODX для своей учетной записи GitHub. Это "твой форк". Вы будете публиковать ваш вклад (коммиты) в ваш код, а не напрямую в репозиторий modxcms. (Это то, что делает Git распределенными, тогда как SVN централизован вокруг одного репозитория.) Затем, для работы с вашим форком, вам понадобится локальная копия или ее clone.

Вот Учебник GitHub по созданию репо и созданию его локального клона.

Ветки и код¶

Вся работа над одной проблемой (ошибка или функция) должна быть выполнена в тематической ветвь.

git checkout -b bug-1111

Вы внесете изменения в файл или файлы. Кодирование .. ууу! Вы делаете один или несколько коммитов на этой ветке. (Многократные коммиты могут действительно помочь сохранить вещи организованными в определенных обстоятельствах.)

По пути, или когда работа сделана, вы пушите ветку в форк. Вы сможете увидеть свою ветку функций и свои коммиты на сайте GitHub.

git push myRepo bug-1111

Заметка: Убедитесь, что ваша работа и ваши коммиты основаны на «свежем» коде - это поможет вам избежать проблем и помогут интеграторам понять, проанализировать и интегрировать (или отозвать) вашу работу.

Pull Request¶

Когда вы будете готовы внести коммит или коммит из вашей ветки, вы делаете Pull Request из вашей учетной записи GitHub. Ваш Pull Request может быть принят интегратором как есть, или они могут вносить изменения или комментировать, задавать вопросы и т.д. GitHub облегчает общение с помощью встроенных комментариев кода, а также простой ветки обсуждения в Pull Requests.

Руководство для участников сообщества¶

С этими основами в рабочем процессе ваш следующий шаг - прочитать Руководство для участников сообщества чтобы понять модель ветвления, которую использует MODX, и для получени более подробной информации о ее применении на практике.

Больше¶

1. Руководство для участников сообщества
2. Git FAC (часто используемые команды)
3. Руководство участника xPDO GitHub

Связанные¶

• Установка Revolution из вашего репозитория Git