#use wml::debian::ddp title="Система управления версиями проекта документации Debian" MAINPAGE="true" #use wml::debian::translation-check translation="e6e987deba52309df5b062b1567c8f952d7bd476" maintainer="Lev Lamberov"
Проект документации Debian хранит всё своё содержимое в Salsa, копии GitLab для Debian. Для получения доступа к отдельным файлам, просмотра последних изменений и деятельности проекта в целом, обратитесь к репозиторию DDP.
Если вы хотите загрузить руководства из репозитория целиком, то лучше воспользоваться прямым доступом к Salsa. Следующие разделы объясняют, как клонировать Git-репозиторий (с правами только для чтения, а также для чтения и записи) на вашу локальную машину и как обновлять вашу локальную копию. Для начала установите на вашу машину пакет git.
Используйте следующую команду для загрузки всех файлов одного проект:
git clone https://salsa.debian.org/ddp-team/release-notes.git
Сделайте то же самое для каждого проекта, который вы хотите загрузить на ваш компьютер. Совет: чтобы найти правильный URL для команды git clone
, откройте проект в веб-браузере, нажмите на синюю кнопку Клонировать и скопируйте URL из Клонировать через HTTPS в буфер обмена.
До того как вы сможете получить доступ к серверу Git таким способом, вам должны предоставить права на запись в репозиторий. За дополнительной информацией о том, как запросить права на отправку изменений, обратитесь к этому разделу.
Имея доступ к Salsa с правами на запись, вы можете использовать следующую команду для загрузки всех файлов одного проекта:
git clone git@salsa.debian.org:ddp-team/release-notes.git
Сделайте то же самое для каждого проекта, который вы хотите загрузить на ваш компьютер.
Для обновления вашей локальной копии и добавления в неё изменений, внесённых другими людьми, войдите в каталог соответствующего руководства и выполните следующую команду:
git pull
Права на запись предоставляются всякому, кто желает участвовать в написании руководств, ЧАВО, справочников и т. д.. Обычно требуется, чтобы для начала вы прислали нам несколько полезных исправлений в виде файлов заплат. После этого выполните следующие действия, чтобы подать заявку на получение доступа с правами на запись:
Все руководства публикуются в виде веб-страниц. Они автоматически создаются на www-master.debian.org в ходе регулярной пересборки веб-сайта, которая происходит каждые четыре часа. В ходе этого процесса из архива загружаются наиболее свежие версии пакетов, каждое руководство пересобирается, и все файлы переносятся в подкаталог doc/manuals/
веб-сайта.
Файлы документации, создающиеся обновляющим сценарием, можно найти по адресу https://www.debian.org/doc/manuals/.
Файлы журналов, создающиеся обновляющим сценарием, можно найти по адресу
7doc
и запускается как часть
cron-задачи often
).
Обратите внимание, что этот процесс заново создаёт каталог
# /doc/manuals/
. Содержимое каталога /doc/
создаётся
# либо из webwml, либо из других сценариев,
# таких как те, что распаковывают некоторые руководства из пакетов.