website view de/devel/index.html @ rev 819

Change links to new bugtracker
author Claudinei Pereira <claudinei@slitaz.org>
date Thu Apr 14 03:36:49 2011 +0000 (2011-04-14)
parents dcf245cc4632
children 87d04172ed56
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="de" lang="de">
4 <head>
5 <title>SliTaz - Entwicklung</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="SliTaz GNU/Linux LiveCD" />
8 <meta name="keywords" lang="en" content="slitaz download, get slitaz" />
9 <meta name="robots" content="index, follow, all" />
10 <meta name="modified" content="2011-03-26 19:00:00" />
11 <meta name="author" content="F Steiner (Sevala)"/>
12 <link rel="shortcut icon" href="../../favicon.ico" />
13 <link rel="stylesheet" type="text/css" href="../../slitaz.css" />
14 </head>
15 <body>
17 <!-- Header -->
18 <div id="header">
19 <div id="logo"></div>
20 <div id="network">
21 <a href="http://www.slitaz.org/netmap.php">
22 <img src="../../images/network.png" alt="network.png" /></a>
23 <a href="http://scn.slitaz.org/">Community</a>
24 <a href="http://doc.slitaz.org/">Doc</a>
25 <a href="http://forum.slitaz.org/">Forum</a>
26 <a href="http://bugs.slitaz.org">Bugs</a>
27 <a href="http://hg.slitaz.org/">Hg</a>
28 </div>
29 <h1><a href="http://www.slitaz.org/">SliTaz GNU/Linux</a></h1>
30 </div>
32 <!-- Block -->
33 <div id="block">
34 <!-- Navigation -->
35 <div id="block_nav">
36 <h4>Navigation</h4>
37 <div class="right_box">
38 <ul>
39 <li><a href="../mailing-list.html">Mailing List</a></li>
40 <li><a href="../devel/">Entwicklung</a></li>
41 <li><a href="../packages/">Pakete</a></li>
42 <li><a href="../artwork/">Artwork</a></li>
43 <li><a href="../search.html">Suchen</a></li>
44 </ul>
45 </div>
46 <div class="left_box">
47 <ul>
48 <li><a href="../">Neuigkeiten</a></li>
49 <li><a href="../about/">Über SliTaz</a></li>
50 <li><a href="../get/">Download</a></li>
51 <li><a href="../../en/asso/">Association (en)</a></li>
52 <li><a href="http://doc.slitaz.org/de:start">Dokumentation</a></li>
53 </ul>
54 </div>
55 </div>
56 <!-- Information/image -->
57 <div id="block_info">
58 <h4>Entwicklung</h4>
59 <p>
60 SliTaz is a community based distribution made by many
61 people all over the world and everyone is welcome to help
62 and get involve in the project.
63 </p>
64 <p>
65 <img src="../../images/users.png" alt="users.png" />
66 <a href="http://scn.slitaz.org/">Join us on SCN</a> and
67 the <a href="../mailing-list.html">mailing list</a>
68 </p>
69 </div>
70 </div>
72 <!-- Content -->
73 <div id="content">
75 <h2>Entwicklung von SliTaz</h2>
77 <ul>
78 <li><a href="index.html#repos">Mercurial Repositories.</a></li>
79 <li><a href="index.html#pkgs">Tazpkg Pakete.</a></li>
80 <li><a href="index.html#website">Website Management.</a></li>
81 <li><a href="../../mailing-list.html">Mailing List.</a></li>
82 <li><a href="http://doc.slitaz.org/en:cookbook:wok">Wok &amp; Tools.</a></li>
83 <li>Mercurial Repositories: <a href="http://hg.slitaz.org" >hg.slitaz.org</a></li>
84 <li>SliTaz Laboratories: <a href="http://labs.slitaz.org/">labs.slitaz.org</a></li>
85 </ul>
87 <p>
88 SliTaz ist ein Opensource-Projekt, das von einer Community entwickelt wird.
89 Jeder kann und darf gerne dazu seinen Beitrag leisten, Nutzer, Grafiker oder
90 Programmierer sind gleichermassen willkommen, es gibt immer etwas zu tun. Sei
91 es das Vervollständigen des <a href="http://doc.slitaz.org/de:start">Wikis</a> und der
92 Dokumentation, Bugs im <a href="http://bugs.slitaz.org"
93 title="Bug Tracking system">Bug Tracking System</a> melden, neue Pakete zu erstellen
94 und sie auf die Mirrors hochladen oder einfach anderen SliTaz-Nutzern im
95 Forum oder der Mailing-List zu helfen.
96 </p>
98 <p>
99 SliTaz besitzt eine kleine Community und hört auf die Nutzer. Viele der Entwickler
100 sind im <a href="http://forum.slitaz.org/">Forum</a> und der
101 <a href="../mailing-list.html">Mailing Liste</a> selbst aktiv. Einfach in der
102 jeweiligen Sprache/Forum ansprechen.
103 </p>
105 <a name="repos"></a>
106 <h2>Mercurial Repositories</h2>
107 <p>
108 Die Website, Konfigurationsdateien und Skripte von SliTaz werden über das
109 Mercurial Repository verwaltet.
110 SliTaz Mercurial oder "Hg Repositories" können von jedem unter der Addresse
111 <a href="http://hg.slitaz.org/">http://hg.slitaz.org/</a> angesehen werden.
112 Leute mit Schreibzugriff können über folgende Adresse
113 direkt auf das Repositorium zugreifen:
114 <code>repos.slitaz.org</code>, Nutzername und Passwort sind dabei erforderlich.
115 Mercurial arbeitet mit Python, unter SliTaz lässt es sich mit
116 <code>tazpkg get-install mercurial</code> installieren.
117 </p>
118 <h4>~/.hgrc</h4>
119 <p>
120 Bevor Du Deinen ersten Beitrag leistest, stelle bitte sicher, dass
121 die Konfigurationsdatei (.hgrc) für das Repository vorhanden und richtig
122 konfiguriert ist. Es sollte Deine E-Mail-Adresse enthalten, sowie den Nutzernamen
123 (üblicherweise kein Pseudonym). Beispiel einer lokalen, persönlichen
124 Datei ~/.hgrc :
125 </p>
126 <pre class="script">
127 [ui]
128 username = Vorname Nachname &lt;you@example.org&gt;
129 </pre>
130 <h4>"Clone", "modify", "commit" und "push"</h4>
131 <p>
132 Die repositories werden über die Kommandozeile verwaltet. Zuerst erstellt man eine
133 lokale Kopie:
134 </p>
135 <pre>
136 $ hg clone http://repos.slitaz.org/website
137 </pre>
138 <p>
139 Im Dateimanager in das erstellte Verzeichnis wechseln. Um alle
140 Änderungen anzuzeigen dient der Befehl <code>log</code>
141 (mit der Option <code>log -l 2</code> nur die
142 beiden letzten Änderungen). <code>head</code> zeigt den letzten Logeintrag an.
143 Damit diese Befehle funktionieren musst Du Dich im lokalen Verzeichnis befinden!
144 </p>
145 <pre>
146 $ hg log
147 $ hg head
148 </pre>
149 <p>
150 Nach dem Editieren einer Datei, den Status abrufen:
151 </p>
152 <pre>
153 $ hg status
154 </pre>
155 <p>
156 Soll eine Datei neu hinzugefügt werden, muss vorher der Befehl <code>add</code> verwendet werden.
157 Nun noch nach zwischenzeitlichen Neuerungen anfragen, und, falls welche existieren,
158 mit <code>update</code> in Deine Änderungen einfügen.
159 </p>
160 <pre>
161 $ hg pull
162 </pre>
163 Nun die Änderungen in das lokale Logbuch eintragen:
164 </p>
165 <pre>
166 $ hg commit -m "Logeintrag, kurze und kräftige Aussagen bitte..."
167 $ hg log
168 </pre>
169 <p>
170 Um nun Deine Änderungen auf dem Server zu veröffentlichen
171 </p>
172 <pre>
173 $ hg push
174 </pre>
175 <p>
176 Das war es auch schon; nach ein bisschen Eingewöhnungszeit geht es leicht von der Hand.
177 Mit dem Befehl <code>rollback</code> können die letzten Änderungen übrigens
178 wieder rückgängig gemacht werden.
179 </p>
181 <a name="pkgs"></a>
182 <h2>Tazpkg Pakete</h2>
183 <p>
184 Tazpkg Pakete werden bei SliTaz automatisch via Tazwok und einem "Rezept"
185 generiert. Im Wiki entsteht gerade eine Referenz von <a href="http://hg.slitaz.org/
186 tazwok/raw-file/tip/doc/tazwok.en.html">Tazwok</a>, den <a href="http://doc.slitaz.org/
187 en:cookbook:receipts">Rezepten</a> sowie ein <a href="
188 http://doc.slitaz.org/en:cookbook:wok">Manual</a>.
189 Kenntnisse dieser Anleitungen werden vorrausgesetzt.
190 </p>
191 <p>
192 Zuerst zur Auswahl des Paketes. Es sollen nur Pakete angeboten werden,
193 die nützlich erscheinen und funktionabel sind. Dabei bitte das kleinste
194 Paket aus der Anwendungskategorie verwenden. Existiert schon eine Anwendung
195 aus dem Bereich, bitte nicht noch ein ähnliches Paket erstellen.
196 Wenn Du aber eine Alternative dafür findest, die leichter ist, oder mehr Funktionalität
197 für ein paar kB mehr bietet, stelle es in der Mailing-List zur Diskussion.
198 Besondere Anforderungen werden an Pakete gestellt, die auf der Live-CD
199 mitgeliefert werden sollen. Erleichtern des Codes, Auflösen unnötiger
200 Abhängigkeiten gehören zur Selbstverständlichkeit!
201 Allgemein werden solche Pakete vorerst ebenfalls in der Mailing-List zur
202 Diskussion gestellt.
203 </p>
204 <p>
205 Bevor Du beginnst zu kompilieren und aus den Dateien ein SliTaz-Paket zu erstellen,
206 pprüfe, ob ein ähnliches, oder sogar gleiches Paket nicht schon
207 Auf dem SliTaz Mirror (v.a. Sektion "indigest") zur verfügung steht.
208 Nicht vergessen, die Mitglieder der Mailing-List stehen Dir gerne
209 zur Verfügung, ebenso das <a href="http://hg.slitaz.org/tazwok/raw-file/tip/doc/tazwok.en.html">Tazwok Manual</a>.
210 </p>
212 <a name="website"></a>
213 <h2>Website Management und Handbuch</h2>
214 <p>
215 Das Management der Website findet über das Mercurial Repository
216 statt. Dazu gibt es einige Tools:<br>
217 <code>rsync</code> ist ist ein Synchronisierungstool, lokal und fürs Netzwerk. Es nutzt einen
218 enorm schnellen und kleinen Algorithmus, der es zu einer nützlichen Anwendung macht.
219 <code>diff</code> wird dafür verwendet, Logs hochzualden, <code>patch</code>
220 dient des Uploads des eigentlichen Inhalte.
221 <br><br>
222 Das deutsche Handbuch ist vollständig ins Wiki verlegt, jeder kann sich gerne daran
223 konstruktiv beteiligen. Eine Anmeldung ist erforderlich.
224 </p>
225 <p>
226 Als grafische Oberfläche kann Grsync dienen, schneller geht es aber über die
227 Kommandozeile. Um die Seite zum ersten Mal in das Vezeichnis
228 <code>/home/tux/Public/slitaz/website</code> herunterzuladen:
229 </p>
230 <pre>
231 $ rsync -r -t -p -v \
232 --progress --delete \
233 rsync://slitaz.org/website /home/tux/Public/slitaz/website
234 </pre>
236 <h3>Diff und patch</h3>
237 <p>
238 Die Anwendungen <code>diff</code> und <code>patch</code> sind Kommando-Zeilen
239 Tools zur Erzeugung von Unterschieden zwischen zwei Dateien.
240 Diese Methode wird häufig bei Zusammenarbeit genutzt, Veränderungen und Metadaten
241 können leicht und schnell eingesehen werden.
242 Um eine <code>diff</code> Datei zu erstellen, die in einem Texteditor gelesen werden kann
243 dient die Option <code>-u</code> :
244 </p>
245 <pre>
246 $ diff -u file.orig file.new &gt; file.diff
247 </pre>
248 <p>
249 Um den Patch zu übernehmen:
250 </p>
251 <pre>
252 $ patch file.orig file.diff
253 </pre>
255 <!-- End of content -->
256 </div>
258 <!-- Footer -->
259 <div id="footer">
260 Copyright &copy; <span class="year"></span>
261 <a href="http://www.slitaz.org/">SliTaz</a> - Network:
262 <a href="http://scn.slitaz.org/">Community</a>
263 <a href="http://doc.slitaz.org/">Doc</a>
264 <a href="http://forum.slitaz.org/">Forum</a>
265 <a href="http://pkgs.slitaz.org/">Packages</a>
266 <a href="http://bugs.slitaz.org">Bugs</a>
267 <a href="http://hg.slitaz.org/">Hg</a>
268 <p>
269 SliTaz @
270 <a href="http://twitter.com/slitaz">Twitter</a>
271 <a href="http://www.facebook.com/slitaz">Facebook</a>
272 <a href="http://distrowatch.com/slitaz">Distrowatch</a>
273 <a href="http://en.wikipedia.org/wiki/SliTaz">Wikipedia</a>
274 <a href="http://flattr.com/profile/slitaz">Flattr</a>
275 </p>
276 </div>
278 </body>
279 </html>