aboutsummaryrefslogtreecommitdiffstats
path: root/russian/doc
diff options
context:
space:
mode:
authorLev Lamberov <dogsleg@debian.org>2024-02-28 19:20:55 +0500
committerLev Lamberov <dogsleg@debian.org>2024-02-28 19:20:55 +0500
commit016d170fdfe267a9503ee7273701ad1edf8daeec (patch)
treeb1804eee83b28af625adda60b9890ff1d39a9178 /russian/doc
parent809745b7d5bfcf2a254a82d855de3c3432902a56 (diff)
(Russian) Update translations
Diffstat (limited to 'russian/doc')
-rw-r--r--russian/doc/vcs.wml121
1 files changed, 59 insertions, 62 deletions
diff --git a/russian/doc/vcs.wml b/russian/doc/vcs.wml
index dab72cb586c..b5ca497f60b 100644
--- a/russian/doc/vcs.wml
+++ b/russian/doc/vcs.wml
@@ -1,97 +1,94 @@
-#use wml::debian::ddp title="Система управления версиями проекта документации Debian"
-#use wml::debian::toc
-#use wml::debian::translation-check translation="bf1a0486dfbf35e11a7ff98a29d9e2e4f2eda3f3" maintainer="Lev Lamberov"
-
-<p>Проект документации Debian хранит свои веб-страницы и большую часть руководств
-в службе Debian Salsa по адресу
-<strong>salsa.debian.org</strong>, которая представляет собой копию GitLab для Debian.
-За дополнительной информацией о том, как работает эта служба, обратитесь к
-<a href="https://wiki.debian.org/Salsa">документации по Salsa</a>.
-</p>
+#use wml::debian::ddp title="Система управления версиями проекта документации Debian" MAINPAGE="true"
+#use wml::debian::translation-check translation="e6e987deba52309df5b062b1567c8f952d7bd476" maintainer="Lev Lamberov"
-<p>Всякий может загрузить исходный код с Salsa, но только участники
-проекта документации Debian могут обновлять файлы.</p>
+<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css">
-<toc-display />
+<ul class="toc">
+ <li><a href="#access">Доступ к исходному коду в Git</a></li>
+ <li><a href="#obtaining">Получение прав на запись</a></li>
+ <li><a href="#updates">Механизм автоматического обновления</a></li>
+</ul>
-<toc-add-entry name="access">Доступ к исходному коду в git</toc-add-entry>
+<aside>
+<p><span class="fas fa-caret-right fa-3x"></span> <a href="ddp">Проект документации Debian (DDP)</a> хранит свои веб-страницы и большую часть руководств в <a href="https://salsa.debian.org">Salsa</a>, которая представляет собой копию GitLab для Debian. Всякий может загрузить исходный код с Salsa, но только участники DDP имеют права на запись и могут обновлять файлы.</p>
+</aside>
-<p>Вы можете использовать веб-интерфейс для получения доступа к отдельным файлам и просмотра
-изменений каждого проекта по адресу
-<url "https://salsa.debian.org/ddp-team/" /></p>
+<h2><a id="access">Доступ к исходному коду в Git</a></h2>
-<p>Для загрузки всего руководства обычно удобнее использовать прямое обращение к
-серверу git. Вам потребуется
-пакет <tt><a href="https://packages.debian.org/git">git</a></tt>.</p>
+<p>
+Проект документации Debian хранит всё своё содержимое в Salsa, копии GitLab для Debian. Для получения доступа к отдельным файлам, просмотра последних изменений и деятельности проекта в целом, обратитесь к <a href="https://salsa.debian.org/ddp-team/">репозиторию DDP</a>.
+</p>
-<h3>Анонимное клонирование git-репозитория (только для чтения)</h3>
+<p>
+Если вы хотите загрузить руководства из репозитория целиком, то лучше воспользоваться прямым доступом к Salsa. Следующие разделы объясняют, как клонировать Git-репозиторий (с правами только для чтения, а также для чтения и записи) на вашу локальную машину и как обновлять вашу локальную копию. Для начала установите на вашу машину пакет <tt><a href="https://packages.debian.org/git">git</a></tt>.
+</p>
-<p>Используйте следующую команду для загрузки всех файлов одного проекта:</p>
+<p style="text-align:center"><button type="button"><span class="fas fa-book-open fa-2x"></span> <a href="https://wiki.debian.org/Salsa">Прочтите документацию по Salsa</a></button></p>
-<p style="margin-left: 2em">
- <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code>
+<h3>Анонимное клонирование Git-репозитория (только для чтения)</h3>
+
+<p>
+Используйте следующую команду для загрузки всех файлов одного проект:
</p>
-<p>Проделайте то же самое для всех проектов, которые вы хотите клонировать локально.</p>
+<pre>
+git clone https://salsa.debian.org/ddp-team/release-notes.git
+</pre>
-<h3>Клонирование git-репозитория с правами на изменение (чтение и запись)</h3>
+<p>
+Сделайте то же самое для каждого проекта, который вы хотите загрузить на ваш компьютер. <strong>Совет:</strong> чтобы найти правильный URL для команды <code>git clone</code>, откройте проект в веб-браузере, нажмите на синюю кнопку <em>Клонировать</em> и скопируйте URL из <em>Клонировать через HTTPS</em> в буфер обмена.
+</p>
-<p>До обращения к серверу git с помощью этого метода, вам должны быть
-предоставлены права на изменение. Прочтите, как <a
-href="#obtaining">запросить</a> права на изменение.</p>
+<h3>Клонирование Git-репозитория с правами на отправку изменений (чтение и запись)</h3>
-<p>Используйте следующую команду для загрузки всех файлов одного проекта:</p>
+<p>
+До того как вы сможете получить доступ к серверу Git таким способом, вам должны предоставить права на запись в репозиторий. За дополнительной информацией о том, как запросить права на отправку изменений, обратитесь к <a href="#obtaining">этому разделу</a>.
+</p>
-<p style="margin-left: 2em">
- <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code>
+<p>
+Имея доступ к Salsa с правами на запись, вы можете использовать следующую команду для загрузки всех файлов одного проекта:
</p>
-<p>Проделайте то же самое для всех проектов, которые вы хотите клонировать локально.</p>
+<pre>
+git clone git@salsa.debian.org:ddp-team/release-notes.git
+</pre>
-<h3>Загрузка изменений из удалённого git-репозитория</h3>
+<p>Сделайте то же самое для каждого проекта, который вы хотите загрузить на ваш компьютер.</p>
-<p>Для обновления вашей локальной копии и получения изменений, внесённых другими людьми, войдите
-в каталог <strong>manuals</strong> и запустите следующую команду:</p>
+<h3>Получение изменений из удалённого Git-репозитория</h3>
-<p style="margin-left: 2em">
- <code>git pull</code>
+<p>
+Для обновления вашей локальной копии и добавления в неё изменений, внесённых другими людьми, войдите в каталог соответствующего руководства и выполните следующую команду:
</p>
-<toc-add-entry name="obtaining">Получение прав на запись</toc-add-entry>
-
-<p>Права на запись доступны всякому, кто желает участвовать в написании
-руководств. Обычно мы просим для начала отправить нам несколько полезных
-заплат.</p>
+<pre>
+git pull
+</pre>
-<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>
+<h2><a id="obtaining">Получение прав на запись</a></h2>
-<p>Когда ваш запрос будет подтверждён, вы станете либо частью группы <a
-href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q></a>, либо
-одного из проектов группы.
+<p>
+Права на запись предоставляются всякому, кто желает участвовать в написании руководств, ЧАВО, справочников и т. д.. Обычно требуется, чтобы для начала вы прислали нам несколько полезных исправлений в виде файлов заплат. После этого выполните следующие действия, чтобы подать заявку на получение доступа с правами на запись:
</p>
-<hr />
+<ol>
+ <li>Создайте учётную запись <a href="https://salsa.debian.org/">Salsa</a>, если вы этого ещё не сделали.</li>
+ <li>Перейдите в <a href="https://salsa.debian.org/ddp-team/">репозиторий DDP</a> и нажмите кнопку <em>Запросить доступ</em>.</li>
+ <li>Отправьте письмо по электронной почте по адресу <a href="mailto:debian-doc@lists.debian.org">debian-doc@lists.debian.org</a> и расскажите в нём, как вы участвовали в проекте Debian ранее.</li>
+ <li>Когда доступ будет вам предоставлен, вы станете частью команды DDP.</li>
+</ol>
-<toc-add-entry name="updates">Механизм автоматического обновления</toc-add-entry>
+<h2><a id="updates">Механизм автоматического обновления</a></h2>
-<p>Создание опубликованных веб-страниц руководств происходит на www-master.debian.org
-в качестве части обычного процесса пересборки веб-сайта,
-которая происходит каждый четыре часа.</p>
-
-<p>Процесс настроен на загрузку самых свежих версий пакетов из
-архива, повторную сборку каждого руководства и установку файлов
-в подкаталог <code>doc/manuals/</code> веб-сайта.</p>
+<p>
+Все руководства публикуются в виде веб-страниц. Они автоматически создаются на www-master.debian.org в ходе регулярной пересборки веб-сайта, которая происходит каждые четыре часа. В ходе этого процесса из архива загружаются наиболее свежие версии пакетов, каждое руководство пересобирается, и все файлы переносятся в подкаталог <code>doc/manuals/</code> веб-сайта.
+</p>
<p>Файлы документации, создающиеся обновляющим сценарием, можно найти по адресу
<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p>
<p>Файлы журналов, создающиеся обновляющим сценарием, можно найти по адресу
-<url "https://www-master.debian.org/build-logs/ddp/" />
+<url "https://www-master.debian.org/build-logs/webwml/" />
(сценарий имеет имя <code>7doc</code> и запускается как часть
cron-задачи <code>often</code>).</p>

© 2014-2024 Faster IT GmbH | imprint | privacy policy