Commit ca9f4e54 authored by Lev Lamberov's avatar Lev Lamberov

(Russian) Initial translation

parent d2ce99ec
#use wml::debian::ddp title="Система управления версиями проекта документации Debian"
#use wml::debian::toc
#use wml::debian::translation-check translation="63b253e9f683a3e51632a8be03911a02d53a936e" maintainer="Lev Lamberov"
<p>Проект документации Debian хранит свои веб-страницы и большую часть руководств
в службе Debian Salsa по адресу
<strong>salsa.debian.org</strong>, которая представляет собой копию GitLab для Debian.
За дополнительной информацией о том, как работает эта служба, обратитесь к
<a href="https://wiki.debian.org/Salsa">документации по Salsa</a>.
</p>
<p>Всякий может загрузить исходный код с Salsa, но только участники
проекта документации Debian могут обновлять файлы.</p>
<toc-display />
<toc-add-entry name="access">Доступ к исходному коду в git</toc-add-entry>
<p>Вы можете использовать веб-интерфейс для получения доступа к отдельным файлам и просмотра
изменений каждого проекта по адресу
<url "https://salsa.debian.org/ddp-team/" /></p>
<p>Для загрузки всего руководства обычно удобнее использовать прямое обращение к
серверу git. Вам потребуется
пакет <tt><a href="https://packages.debian.org/git">git</a></tt>.</p>
<h3>Анонимное клонирование git-репозитория (только для чтения)</h3>
<p>Используйте следующую команду для загрузки всех файлов одного проекта:</p>
<p style="margin-left: 2em">
<code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code>
</p>
<p>Проделайте то же самое для всякого проекта, который вы ходите клонировать локально.</p>
<h3>Клонирование git-репозитория с правами на изменение (чтение и запись)</h3>
<p>До обращения к серверу git с помощью этого метода, вам должны быть
предоставлены права на изменение. Прочтите, как <a
href="#obtaining">запросить</a> права на изменение.</p>
<p>Используйте следующую команду для загрузки всех файлов одного проекта:</p>
<p style="margin-left: 2em">
<code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code>
</p>
<p>Проделайте то же самое для всякого проекта, который вы ходите клонировать локально.</p>
<h3>Загрузка изменений из удалённого git-репозитория</h3>
<p>Для обновления вашей локальной копии и получения изменений, внесённых другими людьми, войдите
в каталог <strong>manuals</strong> и запустите следующую команду:</p>
<p style="margin-left: 2em">
<code>git pull</code>
</p>
<toc-add-entry name="obtaining">Получение прав на запись</toc-add-entry>
<p>Права на запись доступны всякому, кто желает участвовать в написании
руководств. Обычно мы просим для начала отправить нам несколько полезных
заплат.</p>
<p>После создания вашей учётной записи в <a href="https://salsa.debian.org/">Salsa</a>,
запросите права на запись, нажав кнопку <q>Request to join</q> в группе
или в любом конкретном проекте в
<url "https://salsa.debian.org/ddp-team/" />.
Кроме того, отправьте сообщение электронной почты на адрес debian-doc@lists.debian.org с
описанием того, что вы ранее делали в Debian.</p>
<p>Когда ваш запрос будет подтверждён, вы станите либо частью группы <a
href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q></a>, либо
одного из проектов группы.
</p>
<hr />
<toc-add-entry name="updates">Механизм автоматического обновления</toc-add-entry>
<p>Создание опубликованных веб-страниц руководств происходит на www-master.debian.org
в качестве части обычного процесса пересборки веб-сайта,
которая происходит каждый четыре часа.</p>
<p>Сценарий выполняет команду <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd>, а затем
<kbd>make -C trunk publish</kbd>.</p>
<p>Файл Makefile настроен так, чтобы происходила пересборка каждого подкаталога (содержащего
сопровождаемую документацию), и устанавливает файлы из каждого подкаталога
в подкаталог <code>doc/manuals/</code> веб-сайта. Файлы Makefile подкаталогов
наследуются из <code>manuals/standard.makefile</code>.</p>
<p>Файлы документации, создающиеся обновляющим сценарием, можно найти по адресу
<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
<p>Файлы журналов, создающиеся обновляющим сценарием, можно найти по адресу
<url "https://www-master.debian.org/build-logs/ddp/" /></p>
<p>Обратите внимание, что этот процесс заново создаёт каталог
<code>/doc/manuals/</code>. Содержимое каталога <code>/doc/</code> создаётся
либо из <a href="/devel/website/desc">webwml</a>, либо из других сценариев,
таких как те, что распаковывают некоторые руководства из пакетов.</p>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment