diff options
author | Lev Lamberov <dogsleg@debian.org> | 2024-02-28 19:20:55 +0500 |
---|---|---|
committer | Lev Lamberov <dogsleg@debian.org> | 2024-02-28 19:20:55 +0500 |
commit | 016d170fdfe267a9503ee7273701ad1edf8daeec (patch) | |
tree | b1804eee83b28af625adda60b9890ff1d39a9178 /russian/doc | |
parent | 809745b7d5bfcf2a254a82d855de3c3432902a56 (diff) |
(Russian) Update translations
Diffstat (limited to 'russian/doc')
-rw-r--r-- | russian/doc/vcs.wml | 121 |
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> |