Translations
Info
All page names need to be in English.
en da  de  fr  it  ja  km  nl  ru  zh

Ru:Subversion

From TYPO3Wiki
Jump to: navigation, search

<< Back to Developer manuals page

[edit]

notice - Note

Смотрите устаревшую версию: Subversion/Old

Subversion, сокращенно SVN, – это система контроля версий, во многом схожа с CVS, но лучше. Сообщество TYPO3 использует ее для совместной работы, разработки исходного кода TYPO3 и расширений. На этой странице можно получить ответы на вопросы как работать и зачем все это нужно.


Репозитории 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

Aptana.jpg 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"

notice - Note

Указать, какие файлы НЕ должны быть загружены в репозиторий:

меню Windows > Preferences > Team > Ignored Resources
.project

.settings

Обновление

Для обновления файлов в своей рабочей копии, выберете основную папку нужного проекта 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 слеш в конце!);
  • проверьте в браузере: https://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
    .
Subversion kdesvn checkout.jpg

Новичкам - как создать diff

  • внесите поправки в код (например, в ChangeLog);
  • запустите KDEsvn, перейдите по ссылке закладке в локальную копию репозитория;
  • выберете в контекстном меню по щелчку правой кнопкой мыши "diff of local changes".

Расширение: интеграция Subversion (np_subversion)

Записанное здесь служит напоминанием, требующим дальнейших изменений...

Возможно в дальнейшем информация будет полезной. При этом мы должны рассказать об этом расширении, как возможности использования SVN в TYPO3.

notice - Note

На данный момент разработчик не советует использовать расширение на работающих сайтах.

Замечания от разработчиков:

Пока мы подготовили лишь бета версию, не имеющую следующих возможностей:

  • визуализация различий (diff) между актуальной (HEAD)и рабочей копией;
  • совместимость с TYPO3 4.2;
  • исправление в документации;
  • дополнительные параметры настроек (например, отключение 'автоматической резервной копии' по умолчанию);

notice - Note

Мы использовали np_subversion примерно в 10 рабочих проектах на протяжении нескольких месяцев, и хотя некоторые функции все еще работают с ошибками, но вцелом расширение довольно полезно и вполне пригодно к использованию.

Сайт проекта с актуальной информацией: http://projects.network-publishing.org/projects/show/np-subversion

исходный код: https://extensions.typo3.org/extension/np_subversion/

документация: tt_address

svn - доступ из командной строки

Смотрите:

Проверка источников из репозитория

Проверка последних версий (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

Список ядра открыт для запросов. Посмотрите здесь: Правила списка рассылки разработчиков ядра, как сделать запрос на добавление созданного патча.