SVN проекта Debian Documentation

Веб-страницы и большинство текстов руководств проекта документации Debian (Debian Documentation) хранятся на Subversion-сервере Debian по адресу svn.debian.org. svn.debian.org является частью установки Gforge на alioth.debian.org. Для получения дополнительной информации о том, как работает этот сервис, прочтите документацию Alioth.

Всякий может загружать исходные данные с сервера SVN, но только члены проекта документации Debian могут обновлять файлы.

Доступ к исходным данным в SVN

Вы можете использовать веб-интерфейс для получения доступа к файлам по одному и как список изменений по адресу http://anonscm.debian.org/viewvc/ddp/manuals/trunk/

Для загрузки всего руководства лучше использовать прямой доступ к серверу SVN. Вам нужно иметь на своей машине пакет subversion.

Анонимное соединение (только для чтения) с сервером SVN

Используйте эту команду для того, чтобы загрузить все файлы:

svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals

Она рекурсивно создаст каталоги и заполнит их.

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

svn export --force svn://svn.debian.org/svn/ddp/manuals

Соединение с сервером SVN с правами на обновление (svn)

До получения доступа к серверу SVN с использованием этого метода, вам следует для начала получить права на запись. Ознакомьтесь с тем, как запросить права на обновление.

Используйте следующую команду, чтобы загрузить все файлы:

svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals

Она рекурсивно создаст каталоги и заполнит их.

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

svn update

Соединение с сервером SVN с правами на обновление (git-svn)

До получения доступа к серверу SVN с использованием этого метода, вам следует для начала получить права на запись. Ознакомьтесь с тем, как запросить права на обновление.

Используйте следующую команду, чтобы загрузить все файлы:

git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals

Она рекурсивно создаст каталоги и заполнит их, а также создаст локальный репозиторий git без предшествующей истории, который сможет следить за сервером alioth SVN.

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

git svn rebase

Получение прав на обновление

Права на обновление доступны всякому, кто желает участвовать в написании руководств. Обычно мы требуем, чтобы вы для начала прислали парочку полезных заплат.

Чтобы получить права на обновление, вам следует выслать запрос в список рассылки документации Debian. Объясните, почему вам нужен доступ. Укажите имя вашей учётной записи на Alioth. Когда ваш запрос будет подтверждён, вы станете частью проекта ddp (и Unix-группы) на Alioth.


Механизм автоматического обновления

Опубликованные веб-страницы текста руководств создаются на www-master.debian.org как часть обычного процесса сборки веб-сайта, который происходит каждые четыре часа.

Сценарий выполняет svn export --force svn://svn.debian.org/svn/ddp/manuals и затем make -C trunk publish.

Настроен файл сборки (makefile) для пересборки каждого подкаталога (который содержит сопровождаемую документацию) и для установки файлов из каждого подкаталога в подкаталог doc/manuals/ веб-сайта. Файлы сборки для подкаталогов производны от manuals/standard.makefile.

Файлы документации создаются сценарием обновления, который можно найти в https://www.debian.org/doc/manuals/.

Файлы журналов, создаваемые сценарием обновления, могут быть найдены по адресу http://www-master.debian.org/build-logs/ddp/

Заметьте, этот процесс пересоздаёт каталог /doc/manuals/. Содержание каталога /doc/ создаётся либо из webwml, либо с помощью других сценариев, например тех, которые извлекают определённые руководства из пакетов.