Jump to main content Jump to doc navigation

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

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

Связанные

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

  • modmore
  • Jens Wittmann – Gestaltung & Entwicklung
  • Digital Penguin
  • eydolan
  • deJaya
  • Sepia River Studios
  • Following Sea
  • Fabian Christen
  • Dannevang Digital
  • Anton Tarasov
  • Lefthandmedia
  • Murray Wood
  • Nick Clark
  • YJ
  • Chris Fickling
  • CrewMark
  • Richard

Budget

$269 per month—let's make that $500!

Learn more