website annotate fr/devel/forge.html @ rev 452

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