website view de/devel/index.php @ rev 1294

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