SVN проекта Debian Documentation

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

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

Доступ к исходным данным в SVN
Получение прав на обновление
Механизм автоматического обновления

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

Вы можете использовать веб-интерфейс для получения доступа к файлам по одному и как список изменений по адресу https://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

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

svn update

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

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

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

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

git svn rebase

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

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

После создания учётной записи в Alioth, запросите привилегии, нажав на ссылку Request to join в правом нижнем углу страницы https://alioth.debian.org/projects/ddp. Убедитесь, что в комментарии вы указали явное обоснование того, почему вам нужна учётная запись. Далее, отправьте сообщение электронной почты на адрес debian-doc@lists.debian.org, содержащее информацию о вашей работе в Debian.

Когда ваш запрос будет подтверждён, вы станете частью проекта 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/.

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

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