(Russian) Initial translation

1 files changed, 103 insertions, 0 deletions

diff --git a/russian/doc/vcs.wml b/russian/doc/vcs.wml
new file mode 100644
index 00000000000..ed171d1e2eb
--- /dev/null
+++ b/russian/doc/vcs.wml
@@ -0,0 +1,103 @@
+#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>