website annotate de/devel/index.php @ rev 1024

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