website annotate devel/forge.html @ rev 84

fr: Fix second level links
author Christophe Lincoln <pankso@slitaz.org>
date Sat Jun 28 09:53:34 2008 +0200 (2008-06-28)
parents 9db15af4ad78
children 88d44d2671a9
rev   line source
pankso@3 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
pankso@3 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
pankso@3 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr">
pankso@3 4 <head>
pankso@3 5 <title>SliTaz - Forge</title>
pankso@3 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
pankso@3 7 <meta name="description" content="Développement de SliTaz GNU/Linux" />
pankso@3 8 <meta name="keywords" lang="fr" content="developpement slitaz developer GNU Linux" />
pankso@3 9 <meta name="robots" content="index, follow, all" />
pankso@3 10 <meta name="revisit-after" content="7 days" />
pankso@3 11 <meta name="expires" content="never" />
pankso@3 12 <meta name="modified" content="2008-01-30 11:00:00" />
pankso@3 13 <meta name="author" content="Christophe Lincoln"/>
pankso@3 14 <meta name="publisher" content="www.slitaz.org" />
pankso@3 15 <link rel="shortcut icon" href="../favicon.ico" />
pankso@3 16 <link rel="stylesheet" type="text/css" href="../slitaz.css" />
pankso@81 17 <link rel="Content" href="#content" />
pankso@3 18 </head>
pankso@3 19 <body bgcolor="#ffffff">
pankso@3 20
pankso@3 21 <!-- Header -->
pankso@3 22 <div id="header">
pankso@3 23 <a name="top"></a>
pankso@3 24 <!-- Access -->
pankso@3 25 <div id="access">
pankso@75 26 Language:
pankso@3 27 <a href="../en/" title="English Web site main page">English</a>
pankso@3 28 </div>
pankso@3 29 <a href="http://www.slitaz.org/"><img id="logo"
pankso@3 30 src="../pics/website/logo.png" title="www.slitaz.org" alt="www.slitaz.org"
pankso@3 31 style="border: 0px solid ; width: 200px; height: 74px;" /></a>
pankso@3 32 <p id="titre">#!/GNU/Linux</p>
pankso@3 33 </div>
pankso@3 34
pankso@3 35 <!-- Navigation menu -->
pankso@3 36 <div id="nav">
pankso@3 37 <div id="nav_top"></div>
pankso@3 38 <ul>
pankso@84 39 <li><a href="../about/" title="Informations au sujet du projet SliTaz">A propos du projet</a></li>
pankso@84 40 <li><a href="../get/" title="Téléchargements - LiveCD et sous projets">Obtenir SliTaz</a></li>
pankso@84 41 <li><a href="../doc/" title="Handbook, Cookbook et manuels">Documentation</a></li>
pankso@84 42 <li><a href="../packages/" title="Paquets logiciels disponibles">Paquets</a></li>
pankso@84 43 <li><a href="../mailing-list.html" title="Support, contact et collaboration">Liste de discussion</a></li>
pankso@84 44 <li><a href="../devel/" title="Le coin du développeur">Développement</a></li>
pankso@84 45 <li><a href="../artwork/" title="Artwork, couleurs et images">Art &amp; graphisme</a></li>
pankso@84 46 <li><a href="../search.html" title="Rechercher des infos et/ou de la doc">Recherche</a></li>
pankso@84 47 <li><a href="../sitemap.html" title="Vue globale du site web">Plan du site</a></li>
pankso@81 48 </ul>
pankso@81 49 <hr />
pankso@81 50 <ul>
pankso@81 51 <li><a href="http://forum.slitaz.org/" title="Forum d'aide et support">Forum de support</a></li>
pankso@81 52 <li><a href="http://wiki.slitaz.org/" title="Wiki collaboratif">Ressources Wiki</a></li>
pankso@81 53 <li><a href="http://wiki.slitaz.org/doku.php?id=bts:bts" title="Bug Tracking system">Suivi des Bugs</a></li>
pankso@3 54 </ul>
pankso@3 55 <div id="nav_bottom">
pankso@3 56 <div id="nav_bottom_img"></div>
pankso@3 57 </div>
pankso@3 58 </div>
pankso@3 59
pankso@3 60 <!-- Content top. -->
pankso@3 61 <div id="content_top">
pankso@3 62 <div class="top_left"></div>
pankso@3 63 <div class="top_right"></div>
pankso@3 64 </div>
pankso@3 65
pankso@3 66 <!-- Content -->
pankso@3 67 <div id="content">
pankso@3 68 <a name="content"></a>
pankso@3 69
pankso@3 70 <h1><font color="#3E1220">Forge</font></h1>
pankso@3 71
pankso@3 72 <h2><font color="#DF8F06">Gestion collaborative du développement</font></h2>
pankso@3 73
pankso@3 74 <ul>
pankso@3 75 <li><a href="#repos">Dépôts Mercurial.</a></li>
pankso@3 76 <li><a href="#pkgs">Paquets tazpkg.</a></li>
pankso@3 77 <li><a href="#site">Gestion du site Web et des livres.</a></li>
pankso@3 78 <li><a href="guidelines.html">Guidelines.</a></li>
pankso@3 79 </ul>
pankso@3 80
pankso@3 81 <p>
pankso@3 82 Le projet SliTaz dispose de divers moyens pour gérer le travail des
pankso@3 83 développeurs et collaborer. Un système de gestion de révision avec Mercurial
pankso@3 84 (Hg), des modules de synchronisations avec Rsync, de la documentation, une
pankso@3 85 <a href="../mailing-list.html">liste de discussion</a> et un canal IRC. Tous
pankso@3 86 les développeurs sont inscrits sur la liste, c'est le moyen de collaboration
pankso@3 87 principal et privilégié.
pankso@3 88 </p>
pankso@3 89
pankso@3 90 <a name="repos"></a>
pankso@3 91 <h3>Dépôts Mercurial</h3>
pankso@3 92 <p>
pankso@3 93 Tous les sous projets tels que Tazpkg, Tazwok ou Tazlito ont leurs propres
pankso@3 94 dépôts Hg sur le serveur du projet, tout comme le wok. Les développeurs ont
pankso@3 95 un compte et des droits en écriture afin de pouvoir envoyer leurs recettes,
pankso@3 96 mises à jour ou modifications. Il est bien sûr possible de demander la création
pankso@3 97 d'un nouveau dépôt pour collaborer sur un nouveau sous projet lié à SliTaz.
pankso@3 98 A noter qu'il y a 2 domaines : <a href="http://hg.slitaz.org/">hg.slitaz.org</a>
pankso@3 99 est public et <code>repos.slitaz.org</code> nécessite authentification, c'est
pankso@3 100 a dire que vous pouvez cloner hg.slitaz.org mais pas y pousser vos changements
pankso@3 101 ou fichiers.
pankso@3 102 </p>
pankso@3 103 <h4>~/.hgrc</h4>
pankso@3 104 <p>
pankso@3 105 Mercurial utilise un fichier caché <code>~./hgrc</code> permettant de
pankso@3 106 spécifier son nom d'utilisateur. Il faut mettre votre nom et adresse mail pour
pankso@3 107 qu'on sache qui a modifié quoi. Et attention à ne pas être <em>root</em> pour
pankso@3 108 pousser vos modifications. Exemple :
pankso@3 109 </p>
pankso@3 110 <pre class="script">
pankso@3 111 [ui]
pankso@3 112 username = Prénom Nom &lt;you@example.org&gt;
pankso@3 113 </pre>
pankso@3 114 <h4>Cloner, modifier, commiter et pousser</h4>
pankso@3 115 <p>
pankso@3 116 Vous avez le choix de cloner anonymement via hg.slitaz.org ou directement avec
pankso@3 117 votre login et mot de passe. Pour cloner un dépôt tel que le wok :
pankso@3 118 </p>
pankso@3 119 <pre>
pankso@3 120 $ hg clone http://repos.slitaz.org/wok/
pankso@3 121 </pre>
pankso@3 122 <p>
pankso@3 123 Copier, créer, modifier des recettes ou des fichiers dans <code>stuff</code>.
pankso@3 124 Avant de pouvoir pousser vos modifs il faut les additionner à votre dépôt
pankso@3 125 local et les commiter. A noter que la commande <code>status</code> permet de
pankso@3 126 savoir quels fichiers ont été modifiés :
pankso@3 127 </p>
pankso@3 128 <pre>
pankso@3 129 $ cd wok
pankso@3 130 $ hg status
pankso@3 131 $ hg add
pankso@3 132 $ hg commit
pankso@3 133 </pre>
pankso@3 134 <p>
pankso@3 135 La commande commit va ouvrir l'éditeur de texte Nano pour écrire le message
pankso@3 136 déstiné aux logs (Ctrl + X pour enregistrer et quitter). Vous pouvez éviter
pankso@3 137 Nano en utilisant l'option : <code>-m "Meassage"</code>. And please,
pankso@3 138 messages in English if possible :
pankso@3 139 </p>
pankso@3 140 <pre>
pankso@3 141 $ hg commit -m "Message for Mercurial log"
pankso@3 142 </pre>
pankso@3 143 <p>
pankso@3 144 Une fois que tout est prêt, vous pouvez encore utiliser la commande
pankso@3 145 <code>log</code> pour voir ce qui va être affiché sur l'interface web. Pour
pankso@3 146 pousser vos changements c'est <code>push</code> :
pankso@3 147 </p>
pankso@3 148 <pre>
pankso@3 149 $ hg log
pankso@3 150 $ hg push
pankso@3 151 </pre>
pankso@3 152 <p>
pankso@3 153 Si vous avez cloné depuis hg.slitaz.org il faut alors pousser en spécifiant
pankso@3 154 le bon URL :
pankso@3 155 </p>
pankso@3 156 <pre>
pankso@3 157 $ hg push http://repos.slitaz.org/wok/
pankso@3 158 </pre>
pankso@3 159 <h4>Mettre à jour un wok local</h4>
pankso@3 160 <p>
pankso@3 161 Pour mettre à jour votre wok local avec celui du serveur (<em>pull</em> pour
pankso@3 162 tirer les changements) :
pankso@3 163 </p>
pankso@3 164 <pre>
pankso@3 165 $ hg pull
pankso@3 166 $ hg update
pankso@3 167 </pre>
pankso@3 168 <h4>Commande utiles</h4>
pankso@3 169 <p>
pankso@3 170 Des commandes hg qui peuvent servir.
pankso@3 171 </p>
pankso@3 172 <ul>
pankso@3 173 <li><code>hg help</code> : Affiche la liste complète des commandes.</li>
pankso@3 174 <li><code>hg rollback</code> : Annule la dernière action exécutée (commit,
pankso@3 175 pull, push).</li>
pankso@3 176 <li><code>hg log &lt;paquet&gt;</code> : Affiche les log pour un paquet.</li>
pankso@3 177 <li><code>hg head</code> : Affiche le dernier log.</li>
pankso@3 178 </ul>
pankso@3 179
pankso@3 180 <a name="pkgs"></a>
pankso@3 181 <h3>Paquets tazpkg</h3>
pankso@3 182 <p>
pankso@3 183 Les paquets tazpkg de SliTaz sont créer automatiquement via Tazwok et les
pankso@3 184 recettes contenues dans le wok, <a href="../doc/cookbook/">le Cookbook</a>
pankso@3 185 décrit <a href="../doc/cookbook/wok-tools.html">l'utilisation des outils SliTaz</a>
pankso@3 186 et le format des <a href="../doc/cookbook/receipts.html">recettes</a>,
pankso@3 187 c'est sans doutes par un petit peu de lecture qu'il faut commencer.
pankso@3 188 </p>
pankso@3 189 <p>
pankso@3 190 Au niveau du choix des paquets, l'idée est de proposer un paquet par tâche ou
pankso@3 191 fonctionnalités, c'est à dire pas (trop) de doublons et de trouver
pankso@3 192 l'application la plus légère dans son domaine. A noter que les paquets actuels
pankso@3 193 ne sont pas figés, si vous trouvez une alternative à un paquet existant, étant
pankso@3 194 plus légère, ayant plus de fonctionnalités ou soyant plus <em>sexy</em> pour
pankso@3 195 quelques Ko supplémentaires, vous pouvez la proposer sur la liste. Une
pankso@3 196 attention particulière est portée aux paquets destinés au LiveCD, strip,
pankso@3 197 suppression de tout ce qui est inutile, dépendances et options de compilation.
pankso@3 198 En général, les paquets candidats pour le corps du LiveCD sont discutés sur
pankso@3 199 la liste.
pankso@3 200 </p>
pankso@3 201 <p>
pankso@3 202 Avant de commencer à compiler et créer des paquets pour SliTaz assurez-vous
pankso@3 203 qu'une recettes n'existe pas dans le wok indigest disponible sur le miroir
pankso@3 204 principale de SliTaz. N'oubliez pas non plus que les membres de la liste sont
pankso@3 205 là pour vous aider et que <a href="../doc/cookbook/wok-tools.html"
pankso@3 206 >la documentation du wok et des outils</a> existe pour bien commencer.
pankso@3 207 </p>
pankso@3 208
pankso@3 209 <a name="site"></a>
pankso@3 210 <h3>Gestion du site Web et des livres</h3>
pankso@3 211 <p>
pankso@3 212 La gestion du site et des livres (Handbook et Cookbook) est faites via un
pankso@3 213 modules Rsync, diff et patch et la liste de discussion. Rsync est un outil de
pankso@3 214 sauvegarde incrémentale, utilisant un algorithme ultra rapide. Il permet de
pankso@3 215 transférer, synchroniser ou sauvegarder des données en local ou en réseau.
pankso@3 216 L'utilitaire <code>diff</code> est utilisés pour envoyer sur la liste des
pankso@3 217 fichiers contenant uniquement les modifications et <code>patch</code> pour
pankso@3 218 appliquer les modifications au pages originales.
pankso@3 219 </p>
pankso@3 220 <p>
pankso@3 221 Vous pouver synchroniser le site et les livres graphiquement avec Grsync ou via
pankso@3 222 la ligne de commandes. Pour rapatrier une première fois ou synchroniser le site
pankso@3 223 dans un répertoire <code>/home/hacker/Public/slitaz/site</code> et cela depuis
pankso@3 224 <code>rsync://slitaz.org/site</code> :
pankso@3 225 </p>
pankso@3 226 <pre>
pankso@3 227 $ rsync -r -t -p -v \
pankso@3 228 --progress --delete \
pankso@3 229 rsync://slitaz.org/site /home/hacker/Public/slitaz/site
pankso@3 230 </pre>
pankso@3 231 <h4>Diff et patch</h4>
pankso@3 232 <p>
pankso@3 233 Les utilitaires <code>diff</code> et <code>patch</code> sont des outils en
pankso@3 234 ligne de commande permettant de créer et d'appliquer un fichier contenant
pankso@3 235 les différences entre deux fichiers. Cette technique est souvent utilisée
pankso@3 236 pour collaborer et permet d'extraire clairement les modifications apportée
pankso@3 237 au fichier original. Pour créer un fichier <code>diff</code> lisible par
pankso@3 238 les humains dans un simple éditeur de texte, il faut utiliser l'option
pankso@3 239 <code>-u</code> en argument :
pankso@3 240 </p>
pankso@3 241 <pre>
pankso@3 242 $ diff -u file.orig file.new > file.diff
pankso@3 243 </pre>
pankso@3 244 <p>
pankso@3 245 Pour appliquer un patch :
pankso@3 246 </p>
pankso@3 247 <pre>
pankso@3 248 $ patch file.orig file.diff
pankso@3 249 </pre>
pankso@3 250
pankso@3 251 <!-- End of content with round corner -->
pankso@3 252 </div>
pankso@3 253 <div id="content_bottom">
pankso@3 254 <div class="bottom_left"></div>
pankso@3 255 <div class="bottom_right"></div>
pankso@3 256 </div>
pankso@3 257
pankso@3 258 <!-- Start of footer and copy notice -->
pankso@3 259 <div id="copy">
pankso@3 260 <p>
pankso@3 261 Dernière modification : 2008-01-01 12:00:00 -
pankso@3 262 <a href="#top">Haut de la page</a>
pankso@3 263 </p>
pankso@3 264 <p>
pankso@3 265 Copyright &copy; 2008 <a href="http://www.slitaz.org/">SliTaz</a> -
pankso@3 266 <a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a>
pankso@3 267 </p>
pankso@3 268 <!-- End of copy -->
pankso@3 269 </div>
pankso@3 270
pankso@3 271 <!-- Bottom and logo's -->
pankso@3 272 <div id="bottom">
pankso@3 273 <p>
pankso@3 274 <a href="http://validator.w3.org/check?uri=referer"><img
pankso@3 275 src="../pics/website/xhtml10.png" alt="Valid XHTML 1.0"
pankso@3 276 title="Code validé XHTML 1.0"
pankso@3 277 style="width: 80px; height: 15px;" /></a>
pankso@3 278 </p>
pankso@3 279 </div>
pankso@3 280
pankso@3 281 </body>
pankso@3 282 </html>
pankso@3 283
pankso@3 284