website diff fr/devel/forge.html @ rev 368
fr: Add devel and get section
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sat Apr 11 18:38:16 2009 +0200 (2009-04-11) |
| parents | |
| children | 1115ef34f1b1 |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/fr/devel/forge.html Sat Apr 11 18:38:16 2009 +0200 1.3 @@ -0,0 +1,293 @@ 1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 1.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 1.7 +<head> 1.8 + <title>SliTaz - Forge</title> 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="Développement de SliTaz GNU/Linux" /> 1.11 + <meta name="keywords" lang="fr" content="developpement slitaz developer GNU Linux" /> 1.12 + <meta name="robots" content="index, follow, all" /> 1.13 + <meta name="revisit-after" content="7 days" /> 1.14 + <meta name="expires" content="never" /> 1.15 + <meta name="modified" content="2009-16-01 16:00:00" /> 1.16 + <meta name="author" content="Christophe Lincoln"/> 1.17 + <meta name="publisher" content="www.slitaz.org" /> 1.18 + <link rel="shortcut icon" href="../../favicon.ico" /> 1.19 + <link rel="stylesheet" type="text/css" href="../../slitaz.css" /> 1.20 + <link rel="Content" href="#content" /> 1.21 +</head> 1.22 +<body bgcolor="#ffffff"> 1.23 + 1.24 +<!-- Header --> 1.25 +<div id="header"> 1.26 + <a name="top"></a> 1.27 +<!-- Access --> 1.28 +<div id="access"> 1.29 + Language: 1.30 + <a href="../../en/" title="English Web site main page">English</a> 1.31 +</div> 1.32 + <a href="http://www.slitaz.org/fr/"><img id="logo" 1.33 + src="../../pics/website/logo.png" title="www.slitaz.org" alt="www.slitaz.org" 1.34 + style="border: 0px solid ; width: 200px; height: 74px;" /></a> 1.35 + <p id="titre">#!/GNU/Linux</p> 1.36 +</div> 1.37 + 1.38 +<!-- Navigation menu --> 1.39 +<div id="nav"> 1.40 +<div id="nav_top"></div> 1.41 +<ul> 1.42 + <li><a href="../about/" title="Informations au sujet du projet SliTaz">A propos du projet</a></li> 1.43 + <li><a href="../asso/" title="Infrastructure et services">Association</a></li> 1.44 + <li><a href="../get/" title="Téléchargements - LiveCD et sous projets">Obtenir SliTaz</a></li> 1.45 + <li><a href="../doc/" title="Handbook, Cookbook et manuels">Documentation</a></li> 1.46 + <li><a href="../packages/" title="Paquets logiciels disponibles">Paquets</a></li> 1.47 + <li><a href="../devel/" title="Le coin du développeur">Développement</a></li> 1.48 + <li><a href="../artwork/" title="Artwork, couleurs et images">Art & graphisme</a></li> 1.49 + <li><a href="../search.html" title="Rechercher des infos et/ou de la doc">Recherche</a></li> 1.50 + <li><a href="../sitemap.html" title="Vue globale du site web">Plan du site</a></li> 1.51 +</ul> 1.52 +<ul> 1.53 + <li><a href="../mailing-list.html" title="Support, contact et collaboration">Liste de discussion</a></li> 1.54 + <li><a href="http://forum.slitaz.org/" title="Forum d'aide et support">Forum de support</a></li> 1.55 +</ul> 1.56 +<ul> 1.57 + <li><a href="http://wiki.slitaz.org/" title="Wiki collaboratif">Ressources Wiki</a></li> 1.58 + <li><a href="http://labs.slitaz.org/" title="Gestion du projet">Laboratoires</a></li> 1.59 + <li><a href="http://labs.slitaz.org/issues" title="Bug Tracking system">Suivi des Bugs</a></li> 1.60 +</ul> 1.61 +<div id="nav_bottom"> 1.62 +<div id="nav_bottom_img"></div> 1.63 +</div> 1.64 +</div> 1.65 + 1.66 +<!-- Content top. --> 1.67 +<div id="content_top"> 1.68 +<div class="top_left"></div> 1.69 +<div class="top_right"></div> 1.70 +</div> 1.71 + 1.72 +<!-- Content --> 1.73 +<div id="content"> 1.74 +<a name="content"></a> 1.75 + 1.76 +<h1><font color="#3E1220">Forge</font></h1> 1.77 + 1.78 +<h2><font color="#DF8F06">Gestion collaborative du développement</font></h2> 1.79 + 1.80 +<ul> 1.81 + <li><a href="#tank">Build host & home.</a></li> 1.82 + <li><a href="#repos">Dépôts Mercurial.</a></li> 1.83 + <li><a href="#pkgs">Paquets tazpkg.</a></li> 1.84 + <li><a href="#site">Gestion du site Web et des livres.</a></li> 1.85 + <li><a href="guidelines.html">Guidelines.</a></li> 1.86 +</ul> 1.87 + 1.88 +<p> 1.89 +Le projet SliTaz dispose de divers moyens pour gérer le travail des 1.90 +développeurs et collaborer. Un système de gestion de révision avec Mercurial 1.91 +(Hg), des modules de synchronisation avec Rsync, de la documentation, une 1.92 +<a href="../mailing-list.html">liste de discussion</a> et un canal IRC. Tous 1.93 +les développeurs sont inscrits sur la liste, c'est le moyen de collaboration 1.94 +principal et privilégié. 1.95 +</p> 1.96 + 1.97 +<a name="tank"></a> 1.98 +<h3>Tank - Build host & home</h3> 1.99 +<p> 1.100 +Chaque contributeur peut avoir un compte sur le serveur principal du 1.101 +projet, avec un accès sécurisé, de l'espace disque, un répertoire public 1.102 +et tous les outils de développement. Les développeurs peuvent y compiler 1.103 +leurs paquets et les mainteneurs du miroir s'occupent de la synchronisation. 1.104 +Tank héberge aussi le site internet, le web boot et les dépôts Mercurial: 1.105 +<a href="http://tank.slitaz.org/">tank.slitaz.org</a> 1.106 +</p> 1.107 +<p> 1.108 +L'utilisation du build host est décrite dans le Cookbook: 1.109 +<a href="../en/doc/cookbook/build-host.html">SliTaz Build Host (tank)</a>. 1.110 +</p> 1.111 + 1.112 +<a name="repos"></a> 1.113 +<h3>Dépôts Mercurial</h3> 1.114 +<p> 1.115 +Tous les sous-projets tels que Tazpkg, Tazwok ou Tazlito ont leurs propres 1.116 +dépôts Hg sur le serveur du projet, tout comme le wok. Les développeurs ont 1.117 +un compte et des droits en écriture afin de pouvoir envoyer leurs recettes, 1.118 +mises à jour ou modifications. Il est bien sûr possible de demander la création 1.119 +d'un nouveau dépôt pour collaborer sur un nouveau sous-projet lié à SliTaz. 1.120 +A noter qu'il y a 2 domaines : <a href="http://hg.slitaz.org/">hg.slitaz.org</a> 1.121 +est public et <code>repos.slitaz.org</code> nécessite authentification, c'est 1.122 +a dire que vous pouvez cloner hg.slitaz.org mais pas y pousser vos changements 1.123 +ou fichiers. 1.124 +</p> 1.125 +<h4>~/.hgrc</h4> 1.126 +<p> 1.127 +Mercurial utilise un fichier caché <code>~./hgrc</code> permettant de 1.128 +spécifier son nom d'utilisateur. Il faut mettre votre nom et adresse mail pour 1.129 +qu'on sache qui a modifié quoi. Et attention à ne pas être <em>root</em> pour 1.130 +pousser vos modifications. Exemple : 1.131 +</p> 1.132 +<pre class="script"> 1.133 +[ui] 1.134 +username = Prénom Nom <you@example.org> 1.135 +</pre> 1.136 +<h4>Cloner, modifier, commiter et pousser</h4> 1.137 +<p> 1.138 +Vous avez le choix de cloner anonymement via hg.slitaz.org ou directement avec 1.139 +votre login et mot de passe. Pour cloner un dépôt tel que le wok : 1.140 +</p> 1.141 +<pre> 1.142 + $ hg clone http://repos.slitaz.org/wok/ 1.143 +</pre> 1.144 +<p> 1.145 +Copier, créer, modifier des recettes ou des fichiers dans <code>stuff</code>. 1.146 +Avant de pouvoir pousser vos modifs, il faut les additionner à votre dépôt 1.147 +local et les commiter. A noter que la commande <code>status</code> permet de 1.148 +savoir quels fichiers ont été modifiés : 1.149 +</p> 1.150 +<pre> 1.151 + $ cd wok 1.152 + $ hg status 1.153 + $ hg add 1.154 + $ hg commit 1.155 +</pre> 1.156 +<p> 1.157 +La commande commit va ouvrir l'éditeur de texte Nano pour écrire le message 1.158 +déstiné aux logs (Ctrl + X pour enregistrer et quitter). Vous pouvez éviter 1.159 +Nano en utilisant l'option : <code>-m "Message"</code>. And please, 1.160 +messages in English if possible : 1.161 +</p> 1.162 +<pre> 1.163 + $ hg commit -m "Message for Mercurial log" 1.164 +</pre> 1.165 +<p> 1.166 +Une fois que tout est prêt, vous pouvez encore utiliser la commande 1.167 +<code>log</code> pour voir ce qui va être affiché sur l'interface web. Pour 1.168 +pousser vos changements c'est <code>push</code> : 1.169 +</p> 1.170 +<pre> 1.171 + $ hg log 1.172 + $ hg push 1.173 +</pre> 1.174 +<p> 1.175 +Si vous avez cloné depuis hg.slitaz.org, il faut alors pousser en spécifiant 1.176 +le bon URL : 1.177 +</p> 1.178 +<pre> 1.179 + $ hg push http://repos.slitaz.org/wok/ 1.180 +</pre> 1.181 +<h4>Mettre à jour un wok local</h4> 1.182 +<p> 1.183 +Pour mettre à jour votre wok local avec celui du serveur (<em>pull</em> pour 1.184 +tirer les changements) : 1.185 +</p> 1.186 +<pre> 1.187 + $ hg pull 1.188 + $ hg update 1.189 +</pre> 1.190 +<h4>Commande utiles</h4> 1.191 +<p> 1.192 +Des commandes hg qui peuvent servir. 1.193 +</p> 1.194 +<ul> 1.195 + <li><code>hg help</code> : Affiche la liste complète des commandes.</li> 1.196 + <li><code>hg rollback</code> : Annule la dernière action exécutée (commit, 1.197 + pull, push).</li> 1.198 + <li><code>hg log <paquet></code> : Affiche les logs pour un paquet.</li> 1.199 + <li><code>hg head</code> : Affiche le dernier log.</li> 1.200 +</ul> 1.201 + 1.202 +<a name="pkgs"></a> 1.203 +<h3>Paquets tazpkg</h3> 1.204 +<p> 1.205 +Les paquets tazpkg de SliTaz sont créés automatiquement via Tazwok et les 1.206 +recettes contenues dans le wok, <a href="../doc/cookbook/">le Cookbook</a> 1.207 +décrit <a href="../doc/cookbook/wok-tools.html">l'utilisation des outils SliTaz</a> 1.208 +et le format des <a href="../doc/cookbook/receipts.html">recettes</a>, 1.209 +c'est sans doute par un petit peu de lecture qu'il faut commencer. 1.210 +</p> 1.211 +<p> 1.212 +Au niveau du choix des paquets, l'idée est de proposer un paquet par tâche ou 1.213 +fonctionnalité, c'est à dire pas (trop) de doublons et de trouver 1.214 +l'application la plus légère dans son domaine. A noter que les paquets actuels 1.215 +ne sont pas figés, si vous trouvez une alternative à un paquet existant, étant 1.216 +plus légère, ayant plus de fonctionnalités ou étant plus <em>sexy</em> pour 1.217 +quelques Ko supplémentaires, vous pouvez la proposer sur la liste. Une 1.218 +attention particulière est portée aux paquets destinés au LiveCD: strip, 1.219 +suppression de tout ce qui est inutile, dépendances et options de compilation. 1.220 +En général, les paquets candidats pour le corps du LiveCD sont discutés sur 1.221 +la liste. 1.222 +</p> 1.223 +<p> 1.224 +Avant de commencer à compiler et créer des paquets pour SliTaz, assurez-vous 1.225 +qu'une recette n'existe pas dans le wok indigest disponible sur le miroir 1.226 +principal de SliTaz. N'oubliez pas non plus que les membres de la liste sont 1.227 +là pour vous aider et que <a href="../doc/cookbook/wok-tools.html" 1.228 + >la documentation du wok et des outils</a> existe pour bien commencer. 1.229 +</p> 1.230 + 1.231 +<a name="site"></a> 1.232 +<h3>Gestion du site Web et des livres</h3> 1.233 +<p> 1.234 +La gestion du site et des livres (Handbook et Cookbook) est faite via un 1.235 +un dépôt Mercurial, il peut être cloné via: 1.236 +</p> 1.237 +<pre> 1.238 + $ hg clone http://hg.slitaz.org/website 1.239 + si vous avez les droits: 1.240 + $ hg clone http://repos.slitaz.org/website 1.241 +</pre> 1.242 + 1.243 +<h3>Diff et patch</h3> 1.244 +<p> 1.245 +Les utilitaires <code>diff</code> et <code>patch</code> sont des outils en 1.246 +ligne de commande permettant de créer et d'appliquer un fichier contenant 1.247 +les différences entre deux fichiers. Cette technique est souvent utilisée 1.248 +pour collaborer et permet d'extraire clairement les modifications apportées 1.249 +au fichier original. Pour créer un fichier <code>diff</code> lisible par 1.250 +les humains dans un simple éditeur de texte, il faut utiliser l'option 1.251 +<code>-u</code> en argument : 1.252 +</p> 1.253 +<pre> 1.254 + $ diff -u file.orig file.new > file.diff 1.255 +</pre> 1.256 +<p> 1.257 +Pour appliquer un patch : 1.258 +</p> 1.259 +<pre> 1.260 + $ patch file.orig file.diff 1.261 +</pre> 1.262 + 1.263 +<!-- End of content with round corner --> 1.264 +</div> 1.265 +<div id="content_bottom"> 1.266 +<div class="bottom_left"></div> 1.267 +<div class="bottom_right"></div> 1.268 +</div> 1.269 + 1.270 +<!-- Start of footer and copy notice --> 1.271 +<div id="copy"> 1.272 +<p> 1.273 +Dernière modification : 2009-20-03 03:00:00 - 1.274 +<a href="#top">Haut de la page</a> 1.275 +</p> 1.276 +<p> 1.277 +Copyright © 2009 <a href="http://www.slitaz.org/">SliTaz</a> - 1.278 +<a href="http://www.gnu.org/licenses/gpl.html">GNU General Public License</a> 1.279 +</p> 1.280 +<!-- End of copy --> 1.281 +</div> 1.282 + 1.283 +<!-- Bottom and logo's --> 1.284 +<div id="bottom"> 1.285 +<p> 1.286 +<a href="http://validator.w3.org/check?uri=referer"><img 1.287 + src="../../pics/website/xhtml10.png" alt="Valid XHTML 1.0" 1.288 + title="Code validé XHTML 1.0" 1.289 + style="width: 80px; height: 15px;" /></a> 1.290 +</p> 1.291 +</div> 1.292 + 1.293 +</body> 1.294 +</html> 1.295 + 1.296 +