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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
#use wml::debian::ddp title="Debian-Dokumentations-Projekt SVN"
#use wml::debian::toc
#use wml::debian::translation-check translation="1.37"
# $Id$
# Translator: Martin Schulze <joey@debian.org>
<p>Das Debian-Dokumentations-Projekt speichert seine Webseiten und
viele der Handbuchtexte auf dem Subversion-Server von Debian unter
<strong>svn.debian.org</strong>. svn.debian.org ist Teil der Gforge-Installation
auf alioth.debian.org. Bitte lesen Sie die <a
href="https://wiki.debian.org/Alioth">Alioth-Dokumentation</a> für weitere
Informationen, wie dieser Dienst funktioniert.</p>
<p>Jeder kann sich die Dateien vom SVN-Server herunterladen. Nur Mitglieder
des Debian-Dokumentations-Projekts können die Dateien bearbeiten.</p>
<toc-display />
<toc-add-entry name="access">Auf die Dateien im SVN zugreifen</toc-add-entry>
<p>Sie können unter <url "http://anonscm.debian.org/viewvc/ddp/manuals/trunk/" /> eine
Web-Schnittstelle verwenden, um einzeln auf die Dateien zuzugreifen und deren
Änderungen zu sehen.</p>
<p>Zum Herunterladen eines kompletten Handbuchs ist der direkte Zugriff auf
den SVN-Server meistens die bessere Wahl. Sie benötigen dazu das
<tt><a href="https://packages.debian.org/subversion">subversion</a></tt>-Paket auf Ihrem
eigenen Rechner.</p>
<h3>Anonyme Verbindung zum SVN-Server (nur lesend)</h3>
<p>Verwenden Sie diesen Befehl, um alle Dateien herunterzuladen:</p>
<p style="margin-left: 2em">
<code>svn co svn://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
</p>
<p>Das wird die Verzeichnisse rekursiv erzeugen und entsprechend
behandeln.</p>
<p>Um Ihre lokale Kopie mit allen Änderungen zu aktualisieren, die von
den Entwicklern gemacht wurden, begeben Sie sich in das Verzeichnis
<strong>manuals</strong> und führen den folgenden Befehl aus:</p>
<p style="margin-left: 2em">
<code>svn export --force svn://svn.debian.org/svn/ddp/manuals</code>
</p>
<h3>Zugang zum SVN-Server mit Update-Privilegien (svn)</h3>
<p>Bevor Sie auf den SVN-Server mit dieser Methode zugreifen können,
muss Ihnen zuerst Schreibzugriff gewährt worden sein. Bitte lesen Sie,
wie Sie diesen <a href="#obtaining">anfordern</a> können.</p>
<p>Verwenden Sie diesen Befehl, um alle Dateien herunterzuladen:</p>
<p style="margin-left: 2em">
<code>svn co svn+ssh://svn.debian.org/svn/ddp/manuals/trunk manuals</code>
</p>
<p>Das wird die Verzeichnisse rekursiv erzeugen und entsprechend
behandeln.</p>
<p>Um Ihre lokale Kopie mit allen Änderungen zu aktualisieren, die von
den Entwicklern gemacht wurden, begeben Sie sich in das Verzeichnis
<strong>manuals</strong> und führen den folgenden Befehl aus:</p>
<p style="margin-left: 2em">
<code>svn update</code>
</p>
<h3>Zugang zum SVN-Server mit Update-Privilegien (git-svn)</h3>
<p>Bevor Sie auf den SVN-Server mit dieser Methode zugreifen können,
muss Ihnen zuerst Schreibzugriff gewährt worden sein. Bitte lesen Sie,
wie Sie diesen <a href="#obtaining">anfordern</a> können.</p>
<p>Verwenden Sie diesen Befehl, um alle Dateien herunterzuladen:</p>
<p style="margin-left: 2em">
<code>git svn clone -s -rHEAD svn+ssh://svn.debian.org/svn/ddp/manuals manuals</code>
</p>
<p>Dies wird die Verzeichnisse rekursiv erstellen, sie mit Daten befüllen
und auch ein lokales Git-Depot ohne älteren Verlauf erstellen, der zur
Nachverfolgung des Alioth-SVN-Servers dienen kann.
</p>
<p>Um Ihre lokale Kopie mit allen Änderungen zu aktualisieren, die von anderen
Leuten durchgeführt wurden, wechseln Sie in das Verzeichnis
<strong>manuals</strong> und führen Sie den folgenden Befehl aus:</p>
<p style="margin-left: 2em">
<code>git svn rebase</code>
</p>
<toc-add-entry name="obtaining">Update-Privilegien bekommen</toc-add-entry>
<p>Update-Privilegien kann jede Person bekommen, die sich am Schreiben von
Handbüchern beteiligen möchte. Wir fordern üblicherweise, dass Sie zuerst
einige nützliche Patches eingebracht haben.</p>
<p>Um Update-Privilegien zu bekommen, müssen Sie eine Anfrage an die
<a href="mailto:debian-doc@lists.debian.org">Debian-Dokumentations-\
Mailingliste</a> senden. Bitte erläutern Sie, warum Sie Zugriff benötigen.
Bitte geben Sie Ihren <a href="http://alioth.debian.org">Alioth</a>-Login-Namen
an. Sobald Ihrer Anfrage zugestimmt wurde, werden Sie Teil des <a
href="http://alioth.debian.org/projects/ddp"><q>ddp</q>-Projektes</a> (und der
Unix-Gruppe) auf Alioth.</p>
<hr />
# Disabled (obsolete)
#<toc-add-entry name="organization">Organisation der Dateien</toc-add-entry>
#
#<p>Diese Abbildung zeigt die Struktur des CVS-Verzeichnisbaumes:
#</p>
#<div class="center">
#<img src="dirtree.jpg" alt="DDP CVS-Verzeichnis-Baum" />
#</div>
#
#<p>Bitte beachten Sie, dass die DDP-Website im webwml-Modul des
#CVS-Archives enthalten ist, die mit dem Rest der Debian-Webseiten
#integriert werden soll.</p>
#
#<hr />
<toc-add-entry name="updates">Automatische Update-Mechanismen</toc-add-entry>
<p>Die veröffentlichten Webseiten der Handbücher werden auf
www-master.debian.org als Teil des regulären Bauprozesses der Website
(der alle vier Stunden stattfindet) generiert.</p>
<p>Das Skript führt <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd> und anschließend
<kbd>make -C trunk publish</kbd> aus.</p>
<p>Die Make-Datei ist so eingerichtet, dass Dateien in jedem
Unterverzeichnis neu generiert werden (das gepflegte Dokumentation
enthält), und dass es Dateien aus jedem Unterverzeichnis im Verzeichnis
<code>doc/manuals/</code> der Website installiert. Die Make-Dateien der
Unterverzeichnisse sind Abkömmlinge von
<code>manuals/standard.makefile</code>.</p>
<p>Die Dokumentationsdateien, die vom update-Skript generiert werden, finden
Sie unter <a href="manuals/">http://www.debian.org/doc/manuals/</a>.</p>
<p>Die Protokoll-Dateien, die vom update-Skript generiert werden, finden Sie
unter <url "http://www-master.debian.org/build-logs/ddp/" />.</p>
<p>Beachten Sie, dass dieser Prozess das Verzeichnis <code>/doc/manuals/</code>
neu generiert. Die Inhalte des Verzeichnisses <code>/doc/</code> werden
entweder aus <a href="/devel/website/desc">webwml</a> oder von anderen
Skripten (wie denen, die bestimmte Handbücher aus ihren Paketen extrahieren)
generiert.</p>
|
