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