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
|
#use wml::debian::ddp title="Система управления версиями проекта документации Debian" MAINPAGE="true"
#use wml::debian::translation-check translation="e6e987deba52309df5b062b1567c8f952d7bd476" maintainer="Lev Lamberov"
<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css">
<ul class="toc">
<li><a href="#access">Доступ к исходному коду в Git</a></li>
<li><a href="#obtaining">Получение прав на запись</a></li>
<li><a href="#updates">Механизм автоматического обновления</a></li>
</ul>
<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>
<h2><a id="access">Доступ к исходному коду в Git</a></h2>
<p>
Проект документации Debian хранит всё своё содержимое в Salsa, копии GitLab для Debian. Для получения доступа к отдельным файлам, просмотра последних изменений и деятельности проекта в целом, обратитесь к <a href="https://salsa.debian.org/ddp-team/">репозиторию DDP</a>.
</p>
<p>
Если вы хотите загрузить руководства из репозитория целиком, то лучше воспользоваться прямым доступом к Salsa. Следующие разделы объясняют, как клонировать Git-репозиторий (с правами только для чтения, а также для чтения и записи) на вашу локальную машину и как обновлять вашу локальную копию. Для начала установите на вашу машину пакет <tt><a href="https://packages.debian.org/git">git</a></tt>.
</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>
<h3>Анонимное клонирование Git-репозитория (только для чтения)</h3>
<p>
Используйте следующую команду для загрузки всех файлов одного проект:
</p>
<pre>
git clone https://salsa.debian.org/ddp-team/release-notes.git
</pre>
<p>
Сделайте то же самое для каждого проекта, который вы хотите загрузить на ваш компьютер. <strong>Совет:</strong> чтобы найти правильный URL для команды <code>git clone</code>, откройте проект в веб-браузере, нажмите на синюю кнопку <em>Клонировать</em> и скопируйте URL из <em>Клонировать через HTTPS</em> в буфер обмена.
</p>
<h3>Клонирование Git-репозитория с правами на отправку изменений (чтение и запись)</h3>
<p>
До того как вы сможете получить доступ к серверу Git таким способом, вам должны предоставить права на запись в репозиторий. За дополнительной информацией о том, как запросить права на отправку изменений, обратитесь к <a href="#obtaining">этому разделу</a>.
</p>
<p>
Имея доступ к Salsa с правами на запись, вы можете использовать следующую команду для загрузки всех файлов одного проекта:
</p>
<pre>
git clone git@salsa.debian.org:ddp-team/release-notes.git
</pre>
<p>Сделайте то же самое для каждого проекта, который вы хотите загрузить на ваш компьютер.</p>
<h3>Получение изменений из удалённого Git-репозитория</h3>
<p>
Для обновления вашей локальной копии и добавления в неё изменений, внесённых другими людьми, войдите в каталог соответствующего руководства и выполните следующую команду:
</p>
<pre>
git pull
</pre>
<h2><a id="obtaining">Получение прав на запись</a></h2>
<p>
Права на запись предоставляются всякому, кто желает участвовать в написании руководств, ЧАВО, справочников и т. д.. Обычно требуется, чтобы для начала вы прислали нам несколько полезных исправлений в виде файлов заплат. После этого выполните следующие действия, чтобы подать заявку на получение доступа с правами на запись:
</p>
<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>
<h2><a id="updates">Механизм автоматического обновления</a></h2>
<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/webwml/" />
(сценарий имеет имя <code>7doc</code> и запускается как часть
cron-задачи <code>often</code>).</p>
# <p>Обратите внимание, что этот процесс заново создаёт каталог
# <code>/doc/manuals/</code>. Содержимое каталога <code>/doc/</code> создаётся
# либо из <a href="/devel/website/desc">webwml</a>, либо из других сценариев,
# таких как те, что распаковывают некоторые руководства из пакетов.</p>
|
