Ru:Subversion
<< Back to Developer manuals page
Subversion, сокращенно SVN, – это система контроля версий, во многом схожа с CVS, но лучше. Сообщество TYPO3 использует ее для совместной работы, разработки исходного кода TYPO3 и расширений. На этой странице можно получить ответы на вопросы как работать и зачем все это нужно.
Contents |
Репозитории SVN
Имейте ввиду, что репозитории SVN не имеют ничего общего с репозиторием расширений TYPO3(TER). Расширения находятся в обоих репозиториях, но не обязательно в обоих сразу... TER не предназначен для совместной разработки расширений, поэтому SVN используется для непрерывной, ежедневной разработки расширений, а TER – для хранения стабильных версий.
Все репозитории управления версиями перемещены по адресу
https://svn.typo3.org/
| Проект | Subversion/ trunk |
| TYPO3 4.x | https://svn.typo3.org/TYPO3v4/Core/trunk/ Внимание: этот репозиторий более не используется. Вместо него используется репозиторий Git. За информацией обратитесь на эту страницу. |
| Расширения TYPO3 4.x | https://svn.typo3.org/TYPO3v4/Extensions/EXTENSIONKEY/trunk/ |
| TYPO3 5.x | https://svn.typo3.org/TYPO3v5/Distributions/Base/trunk/ |
| Пакет FLOW3 | https://svn.typo3.org/FLOW3/Packages/PACKAGENAME/trunk/ |
Смотрите
Клиенты с графическим интерфейсом
TortoiseSVN
| Платформа | Скачать | Лицензия |
| Windows | http://tortoisesvn.net/downloads | CC |
Aptana
http://www.aptana.com/ (IDE для сетевых проектов на основе Eclipse)
Подготовка
- включить режим просмотра в меню: Window/ Open Perspective / SVN Repository Exploring
- добавить репозиторий: URL "https://svn.typo3.org/Teams/DocTeam" (будет загружено 37,7 MB, все файлы DocTeam)
- в контекстном меню по щелчку правой кнопки мыши нужно выбрать "New repository location"
- установить "checkout as new project"
Обновление
Для обновления файлов в своей рабочей копии, выберете основную папку нужного проекта SVN, в контекстном меню по щелчку правой кнопки мыши выберете Team > Update.
Фиксация (Commit)
Файл можно отредактировать в локальной копии проекта. Для фиксации (commit) файла в контекстном меню по щелчку правой кнопки мыши выберете Team > Commit.
rapidSVN
rapidSVN – это кросс-платформенный клиент subversion. Существуют версии для windows, linux и mac. На Ubuntu можно установить его при помощи менеджера пакетов.
Документация: http://www.rapidsvn.org/index.php/Documentation
проверка при помощи rapidSVN
- Откройте rapidSVN;
- в контекстном меню по щелчку правой кнопки мыши выберете "add existing repository";
- в качестве местоположения (location) введите "https://svn.typo3.org/path/to/your/repository";
- теперь возможно перемещаться по сетевому репозиторию;
- для проверки части хранилища, в контекстном меню по щелчку правой кнопки мыши по нужной папке выберете "checkout new working copy";
- выберете папку (назначения) для хранения локальной копии и нажмите OK.
Можно выполнить проверку и без начального создания закладок:
- В главном меню выберете репозиторий;
- нажмите checkout;
- введите соответствующую информацию и нажмите OK.
пометки (tagging) при помощи rapidSVN
- слева перейдите к помечаемой папке с расширением, например "doc_tut_editors";
- щелкните по папке "tags" - она станет оранжевой;
- выберете в главном меню "modify", и элемент "create new folder" (либо выберете это в контекстном меню по щелчку правой кнопкой мыши);
- стиль именования "1-0-0";
- перейдите в папку "trunk" и выберете все ее содержимое;
- выберете в контекстном меню по щелчку правой кнопкой мыши "copy";
- заполните YOUR LOCAL location: /path/to/your/local/copy/extension/tags/1-0-0 (NO слеш в конце!);
- проверьте в браузере: http://forge.typo3.org/repositories/show/projectname.
Фиксация (commit) / загрузка (upload) изменений
- если локальные файлы были изменены, в проводнике rapidSVN они отображаются оранжевыми;
- для фиксации (commit) сделанных изменений просто щелкните правой кнопкой мыши на названии файла и выберете "commit".
Создание diffs / патчей
- для создания diff достаточно выбрать файл, из которого создается diff и выбрать "diff" в контекстном меню по щелчку правой мыши;
- обратите внимание, что необходимо установить программу для diff (список приведен здесь: http://www.rapidsvn.org/index.php/OnlineHelp:Contents#Programs )
CrossVC
Кросс-платформенное управление версиями
KDEsvn
| Платформа | Загрузить | Руководство |
| Linux KDE или GNOME, Mac OS X, FreeBSD | пакет "kdesvn" (project) |
kdesvn |
Новичкам - как выполнять проверку
- создайте папку: "SVN_external" и вложенную папку "TYPO3_v4". В нее добавьте еще одну папку: "tx_ttnews";
- при помощи браузера, выберете нужный для проверки проект: https://svn.typo3.org/TYPO3v4/Extensions/ , в нашем случае "tx_ttnews";
- установите (например, для Debian/ Ubuntu): ;
apt-get install kdesvn - запустите KDEsvn и выберете в меню "Bookmarks": New Folder "TYPO3 version 4";
- нажмите кнопку "Checkout Repository" или выберете в меню "Subversion" / "general";
- введите URL, например, для "tx_ttnews":
https://svn.typo3.org/TYPO3v4/Extensions/EXTENSIONKEY/trunk
- используйте только что созданную локальную папку для хранения локальных копий файлов
/d/SVN-extern/TYPO3_EXT/tx_ttnews
; - используйте настройку "HEAD" для выбора актуальной версии;
- сохраните в виде закладки для TYPO3 версии 4, например по местоположению
/d/SVN-extern/TYPO3_EXT/tx_ttnews/trunk
.
Новичкам - как создать diff
- внесите поправки в код (например, в ChangeLog);
- запустите KDEsvn, перейдите по ссылке закладке в локальную копию репозитория;
- выберете в контекстном меню по щелчку правой кнопкой мыши "diff of local changes".
Расширение: интеграция Subversion (np_subversion)
Записанное здесь служит напоминанием, требующим дальнейших изменений...
Возможно в дальнейшем информация будет полезной. При этом мы должны рассказать об этом расширении, как возможности использования SVN в TYPO3.
Замечания от разработчиков:
Пока мы подготовили лишь бета версию, не имеющую следующих возможностей:
- визуализация различий (diff) между актуальной (HEAD)и рабочей копией;
- совместимость с TYPO3 4.2;
- исправление в документации;
- дополнительные параметры настроек (например, отключение 'автоматической резервной копии' по умолчанию);
Сайт проекта с актуальной информацией: http://projects.network-publishing.org/projects/show/np-subversion
исходный код: http://typo3.org/extensions/repository/view/np_subversion/0.7.1/
документация: tt_address
svn - доступ из командной строки
Смотрите:
- Управление проектом forge
- Diff-patch
- Сетевая книга по subversion: http://svnbook.red-bean.com/
Проверка источников из репозитория
Проверка последних версий (HEAD) ядра TYPO3 v.4 из trunk:
svn co https://svn.typo3.org/TYPO3v4/Core/trunk/ typo3
Внимание: этот репозиторий больше не используется и не отражает актуальное состояние исходного кода проекта.
Вместо этого используйте новый репозиторий Git.
Дополнительная информация доступна на этой странице.
Создание diff
После исправления ошибки в коде, создайте патч с исправлениями в универсальном формате diff:
svn diff
Можно переместить патч в файл для отправки непосредственно на bugtracker:
svn diff > bug_1234.diff
Список ядра открыт для запросов. Посмотрите здесь: Правила списка рассылки разработчиков ядра, как сделать запрос на добавление созданного патча.
