website view de/devel/index.php @ rev 1014
de: applied {header|nav|footer} templates
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Fri Mar 30 16:38:09 2012 +0300 (2012-03-30) |
| parents | 7bb8568e1c75 |
| children | e43ee5c5ace0 |
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=utf-8" />
7 <meta name="description" content="SliTaz GNU/Linux LiveCD" />
8 <meta name="keywords" lang="en" content="slitaz download, get slitaz" />
9 <meta name="author" content="F Steiner (Sevala)"/>
10 <?php include("../../lib/html/meta-link.html"); ?>
11 </head>
12 <body>
14 <?php include("../../lib/html/header.html"); ?>
16 <!-- Block -->
17 <div id="block">
18 <?php include("../../lib/html/nav.de.html"); ?>
19 <!-- Information/image -->
20 <div id="block_info">
21 <h4>Entwicklung</h4>
22 <p>
23 SliTaz is a community based distribution made by many
24 people all over the world and everyone is welcome to help
25 and get involve in the project.
26 </p>
27 <p>
28 <img src="../../images/users.png" alt="users.png" />
29 <a href="http://scn.slitaz.org/">Join us on SCN</a> and
30 the <a href="../mailing-list.php">mailing list</a>
31 </p>
32 </div>
33 </div>
35 <?php include("../../lib/lang.php"); ?>
37 <!-- Content -->
38 <div id="content">
40 <h2>Entwicklung von SliTaz</h2>
42 <ul>
43 <li><a href="#repos">Mercurial Repositories.</a></li>
44 <li><a href="#pkgs">Tazpkg Pakete.</a></li>
45 <li><a href="#website">Website Management.</a></li>
46 <li><a href="../../mailing-list.php">Mailing List.</a></li>
47 <li><a href="http://doc.slitaz.org/en:cookbook:wok">Wok & Tools.</a></li>
48 <li>Mercurial Repositories: <a href="http://hg.slitaz.org" >hg.slitaz.org</a></li>
49 <li>SliTaz Laboratories: <a href="http://labs.slitaz.org/">labs.slitaz.org</a></li>
50 </ul>
52 <p>
53 SliTaz ist ein Opensource-Projekt, das von einer Community entwickelt wird.
54 Jeder kann und darf gerne dazu seinen Beitrag leisten, Nutzer, Grafiker oder
55 Programmierer sind gleichermassen willkommen, es gibt immer etwas zu tun. Sei
56 es das Vervollständigen des <a href="http://doc.slitaz.org/de:start">Wikis</a> und der
57 Dokumentation, Bugs im <a href="http://bugs.slitaz.org"
58 title="Bug Tracking system">Bug Tracking System</a> melden, neue Pakete zu erstellen
59 und sie auf die Mirrors hochladen oder einfach anderen SliTaz-Nutzern im
60 Forum oder der Mailing-List zu helfen.
61 </p>
63 <p>
64 SliTaz besitzt eine kleine Community und hört auf die Nutzer. Viele der Entwickler
65 sind im <a href="http://forum.slitaz.org/">Forum</a> und der
66 <a href="../mailing-list.php">Mailing Liste</a> selbst aktiv. Einfach in der
67 jeweiligen Sprache/Forum ansprechen.
68 </p>
70 <a name="repos"></a>
71 <h2>Mercurial Repositories</h2>
72 <p>
73 Die Website, Konfigurationsdateien und Skripte von SliTaz werden über das
74 Mercurial Repository verwaltet.
75 SliTaz Mercurial oder "Hg Repositories" können von jedem unter der Addresse
76 <a href="http://hg.slitaz.org/">http://hg.slitaz.org/</a> angesehen werden.
77 Leute mit Schreibzugriff können über folgende Adresse
78 direkt auf das Repositorium zugreifen:
79 <code>repos.slitaz.org</code>, Nutzername und Passwort sind dabei erforderlich.
80 Mercurial arbeitet mit Python, unter SliTaz lässt es sich mit
81 <code>tazpkg get-install mercurial</code> installieren.
82 </p>
83 <h4>~/.hgrc</h4>
84 <p>
85 Bevor Du Deinen ersten Beitrag leistest, stelle bitte sicher, dass
86 die Konfigurationsdatei (.hgrc) für das Repository vorhanden und richtig
87 konfiguriert ist. Es sollte Deine E-Mail-Adresse enthalten, sowie den Nutzernamen
88 (üblicherweise kein Pseudonym). Beispiel einer lokalen, persönlichen
89 Datei ~/.hgrc :
90 </p>
91 <pre class="script">
92 [ui]
93 username = Vorname Nachname <you@example.org>
94 </pre>
95 <h4>"Clone", "modify", "commit" und "push"</h4>
96 <p>
97 Die repositories werden über die Kommandozeile verwaltet. Zuerst erstellt man eine
98 lokale Kopie:
99 </p>
100 <pre>
101 $ hg clone http://repos.slitaz.org/website
102 </pre>
103 <p>
104 Im Dateimanager in das erstellte Verzeichnis wechseln. Um alle
105 Änderungen anzuzeigen dient der Befehl <code>log</code>
106 (mit der Option <code>log -l 2</code> nur die
107 beiden letzten Änderungen). <code>head</code> zeigt den letzten Logeintrag an.
108 Damit diese Befehle funktionieren musst Du Dich im lokalen Verzeichnis befinden!
109 </p>
110 <pre>
111 $ hg log
112 $ hg head
113 </pre>
114 <p>
115 Nach dem Editieren einer Datei, den Status abrufen:
116 </p>
117 <pre>
118 $ hg status
119 </pre>
120 <p>
121 Soll eine Datei neu hinzugefügt werden, muss vorher der Befehl <code>add</code> verwendet werden.
122 Nun noch nach zwischenzeitlichen Neuerungen anfragen, und, falls welche existieren,
123 mit <code>update</code> in Deine Änderungen einfügen.
124 </p>
125 <pre>
126 $ hg pull
127 </pre>
128 Nun die Änderungen in das lokale Logbuch eintragen:
129 </p>
130 <pre>
131 $ hg commit -m "Logeintrag, kurze und kräftige Aussagen bitte..."
132 $ hg log
133 </pre>
134 <p>
135 Um nun Deine Änderungen auf dem Server zu veröffentlichen
136 </p>
137 <pre>
138 $ hg push
139 </pre>
140 <p>
141 Das war es auch schon; nach ein bisschen Eingewöhnungszeit geht es leicht von der Hand.
142 Mit dem Befehl <code>rollback</code> können die letzten Änderungen übrigens
143 wieder rückgängig gemacht werden.
144 </p>
146 <a name="pkgs"></a>
147 <h2>Tazpkg Pakete</h2>
148 <p>
149 Tazpkg Pakete werden bei SliTaz automatisch via Tazwok und einem "Rezept"
150 generiert. Im Wiki entsteht gerade eine Referenz von <a href="http://hg.slitaz.org/
151 tazwok/raw-file/tip/doc/tazwok.en.html">Tazwok</a>, den <a href="http://doc.slitaz.org/
152 en:cookbook:receipts">Rezepten</a> sowie ein <a href="
153 http://doc.slitaz.org/en:cookbook:wok">Manual</a>.
154 Kenntnisse dieser Anleitungen werden vorrausgesetzt.
155 </p>
156 <p>
157 Zuerst zur Auswahl des Paketes. Es sollen nur Pakete angeboten werden,
158 die nützlich erscheinen und funktionabel sind. Dabei bitte das kleinste
159 Paket aus der Anwendungskategorie verwenden. Existiert schon eine Anwendung
160 aus dem Bereich, bitte nicht noch ein ähnliches Paket erstellen.
161 Wenn Du aber eine Alternative dafür findest, die leichter ist, oder mehr Funktionalität
162 für ein paar kB mehr bietet, stelle es in der Mailing-List zur Diskussion.
163 Besondere Anforderungen werden an Pakete gestellt, die auf der Live-CD
164 mitgeliefert werden sollen. Erleichtern des Codes, Auflösen unnötiger
165 Abhängigkeiten gehören zur Selbstverständlichkeit!
166 Allgemein werden solche Pakete vorerst ebenfalls in der Mailing-List zur
167 Diskussion gestellt.
168 </p>
169 <p>
170 Bevor Du beginnst zu kompilieren und aus den Dateien ein SliTaz-Paket zu erstellen,
171 pprüfe, ob ein ähnliches, oder sogar gleiches Paket nicht schon
172 Auf dem SliTaz Mirror (v.a. Sektion "indigest") zur verfügung steht.
173 Nicht vergessen, die Mitglieder der Mailing-List stehen Dir gerne
174 zur Verfügung, ebenso das <a href="http://hg.slitaz.org/tazwok/raw-file/tip/doc/tazwok.en.html">Tazwok Manual</a>.
175 </p>
177 <a name="website"></a>
178 <h2>Website Management und Handbuch</h2>
179 <p>
180 Das Management der Website findet über das Mercurial Repository
181 statt. Dazu gibt es einige Tools:<br>
182 <code>rsync</code> ist ist ein Synchronisierungstool, lokal und fürs Netzwerk. Es nutzt einen
183 enorm schnellen und kleinen Algorithmus, der es zu einer nützlichen Anwendung macht.
184 <code>diff</code> wird dafür verwendet, Logs hochzualden, <code>patch</code>
185 dient des Uploads des eigentlichen Inhalte.
186 <br><br>
187 Das deutsche Handbuch ist vollständig ins Wiki verlegt, jeder kann sich gerne daran
188 konstruktiv beteiligen. Eine Anmeldung ist erforderlich.
189 </p>
190 <p>
191 Als grafische Oberfläche kann Grsync dienen, schneller geht es aber über die
192 Kommandozeile. Um die Seite zum ersten Mal in das Vezeichnis
193 <code>/home/tux/Public/slitaz/website</code> herunterzuladen:
194 </p>
195 <pre>
196 $ rsync -r -t -p -v \
197 --progress --delete \
198 rsync://slitaz.org/website /home/tux/Public/slitaz/website
199 </pre>
201 <h3>Diff und patch</h3>
202 <p>
203 Die Anwendungen <code>diff</code> und <code>patch</code> sind Kommando-Zeilen
204 Tools zur Erzeugung von Unterschieden zwischen zwei Dateien.
205 Diese Methode wird häufig bei Zusammenarbeit genutzt, Veränderungen und Metadaten
206 können leicht und schnell eingesehen werden.
207 Um eine <code>diff</code> Datei zu erstellen, die in einem Texteditor gelesen werden kann
208 dient die Option <code>-u</code> :
209 </p>
210 <pre>
211 $ diff -u file.orig file.new > file.diff
212 </pre>
213 <p>
214 Um den Patch zu übernehmen:
215 </p>
216 <pre>
217 $ patch file.orig file.diff
218 </pre>
220 <!-- End of content -->
221 </div>
223 <?php include("../../lib/html/footer.html"); ?>
225 </body>
226 </html>