1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
#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>
<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>Процесс настроен на загрузку самых свежих версий пакетов из
архива, повторную сборку каждого руководства и установку файлов
в подкаталог <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/" />
(сценарий имеет имя <code>7doc</code> и запускается как часть
cron-задачи <code>often</code>).</p>
# <p>Обратите внимание, что этот процесс заново создаёт каталог
# <code>/doc/manuals/</code>. Содержимое каталога <code>/doc/</code> создаётся
# либо из <a href="/devel/website/desc">webwml</a>, либо из других сценариев,
# таких как те, что распаковывают некоторые руководства из пакетов.</p>
|
