website diff fr/devel/forge.php @ rev 1021
fr: utf-8
author | Paul Issott <paul@slitaz.org> |
---|---|
date | Sat Mar 31 16:55:59 2012 +0100 (2012-03-31) |
parents | 175ff0253b7a |
children | e0ee682de0a0 |
line diff
1.1 --- a/fr/devel/forge.php Fri Mar 30 17:56:58 2012 +0300 1.2 +++ b/fr/devel/forge.php Sat Mar 31 16:55:59 2012 +0100 1.3 @@ -3,8 +3,8 @@ 1.4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="fr" lang="fr"> 1.5 <head> 1.6 <title>SliTaz (fr) - Forge</title> 1.7 - <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.8 - <meta name="description" content="Développement de SliTaz GNU/Linux" /> 1.9 + <meta http-equiv="content-type" content="text/html; charset=utf-8" /> 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="author" content="Christophe Lincoln"/> 1.13 <?php include("../../lib/html/meta-link.html"); ?> 1.14 @@ -20,7 +20,7 @@ 1.15 <div id="block_info"> 1.16 <h4>Forge</h4> 1.17 <p> 1.18 - Les outils et services utilisés pour forger Slitaz :-) 1.19 + Les outils et services utilisés pour forger Slitaz :-) 1.20 </p> 1.21 <p> 1.22 <img src="../../images/users.png" alt="users.png" /> 1.23 @@ -33,13 +33,13 @@ 1.24 <!-- Content --> 1.25 <div id="content"> 1.26 1.27 -<h2>Gestion collaborative du développement</h2> 1.28 +<h2>Gestion collaborative du développement</h2> 1.29 1.30 <ul> 1.31 <li><a href="#kiss">KISS et respect des standards.</a></li> 1.32 <li><a href="#tank">Build host & home.</a></li> 1.33 - <li><a href="#repos">Dépôts Mercurial.</a></li> 1.34 - <li><a href="#iconv">Implémentation d'iconv().</a></li> 1.35 + <li><a href="#repos">Dépôts Mercurial.</a></li> 1.36 + <li><a href="#iconv">Implémentation d'iconv().</a></li> 1.37 <li><a href="#pkgs">Paquets tazpkg.</a></li> 1.38 <li><a href="#pkgs-naming">Nommage des paquets.</a></li> 1.39 <li><a href="#site">Gestion du site Web et des livres.</a></li> 1.40 @@ -47,28 +47,28 @@ 1.41 </ul> 1.42 1.43 <p> 1.44 -Le projet SliTaz dispose de divers moyens pour gérer le travail des 1.45 -développeurs et collaborer. Un système de gestion de révision avec Mercurial 1.46 +Le projet SliTaz dispose de divers moyens pour gérer le travail des 1.47 +développeurs et collaborer. Un système de gestion de révision avec Mercurial 1.48 (Hg), des modules de synchronisation avec Rsync, de la documentation, une 1.49 <a href="../mailing-list.php">liste de discussion</a> et un canal IRC. Tous 1.50 -les développeurs sont inscrits sur la liste, c'est le moyen de collaboration 1.51 -principal et privilégié. 1.52 +les développeurs sont inscrits sur la liste, c'est le moyen de collaboration 1.53 +principal et privilégié. 1.54 </p> 1.55 1.56 <a name="kiss"></a> 1.57 <h3>KISS et respect des standards</h3> 1.58 <p> 1.59 -Rester simple, respecter au mieux les standards, réaliser un travail soigné, 1.60 -rédiger de la documentation de haute qualité, fournir un système stable et 1.61 -robuste et garder le <em>rootfs</em> du LiveCD standard assez léger pour que 1.62 -SliTaz tourne sur des machines ayant au minimum 128 Mb de RAM. Possibilité 1.63 +Rester simple, respecter au mieux les standards, réaliser un travail soigné, 1.64 +rédiger de la documentation de haute qualité, fournir un système stable et 1.65 +robuste et garder le <em>rootfs</em> du LiveCD standard assez léger pour que 1.66 +SliTaz tourne sur des machines ayant au minimum 128 Mb de RAM. Possibilité 1.67 d'utiliser GTK+2, Dialog, Gtkdialog, des scripts SHell ou encore PHP pour 1.68 -coder des outils propres à la distribution. L'idée est aussi de ne pas faire 1.69 +coder des outils propres à la distribution. L'idée est aussi de ne pas faire 1.70 de doublons et de penser mini... 1.71 </p> 1.72 <p> 1.73 -SliTaz se veut un projet proche et à l'écoute des ses utilisateurs. Il y a 1.74 -plusieurs développeurs actifs sur le <a href="http://forum.slitaz.org/">forum</a> 1.75 +SliTaz se veut un projet proche et à l'écoute des ses utilisateurs. Il y a 1.76 +plusieurs développeurs actifs sur le <a href="http://forum.slitaz.org/">forum</a> 1.77 et sur la <a href="../mailing-list.php">liste de discussion</a>. 1.78 </p> 1.79 1.80 @@ -76,53 +76,53 @@ 1.81 <h3>Tank - Build host & home</h3> 1.82 <p> 1.83 Chaque contributeur peut avoir un compte sur le serveur principal du 1.84 -projet, avec un accès sécurisé, de l'espace disque, un répertoire public 1.85 -et tous les outils de développement. Les développeurs peuvent y compiler 1.86 +projet, avec un accès sécurisé, de l'espace disque, un répertoire public 1.87 +et tous les outils de développement. Les développeurs peuvent y compiler 1.88 leurs paquets et les mainteneurs du miroir s'occupent de la synchronisation. 1.89 -Tank héberge aussi le site internet, le web boot et les dépôts Mercurial: 1.90 +Tank héberge aussi le site internet, le web boot et les dépôts Mercurial: 1.91 <a href="http://tank.slitaz.org/">tank.slitaz.org</a> 1.92 </p> 1.93 <p> 1.94 -L'utilisation du build host est décrite dans le Cookbook: 1.95 +L'utilisation du build host est décrite dans le Cookbook: 1.96 <a href="http://doc.slitaz.org/en:cookbook:buildhost">SliTaz Build Host (tank)</a>. 1.97 </p> 1.98 1.99 <a name="repos"></a> 1.100 -<h3>Dépôts Mercurial</h3> 1.101 +<h3>Dépôts Mercurial</h3> 1.102 <p> 1.103 Tous les sous-projets tels que Tazpkg, Tazwok ou Tazlito ont leurs propres 1.104 -dépôts Hg sur le serveur du projet, tout comme le wok. Les développeurs ont 1.105 -un compte et des droits en écriture afin de pouvoir envoyer leurs recettes, 1.106 -mises à jour ou modifications. Il est bien sûr possible de demander la création 1.107 -d'un nouveau dépôt pour collaborer sur un nouveau sous-projet lié à SliTaz. 1.108 +dépôts Hg sur le serveur du projet, tout comme le wok. Les développeurs ont 1.109 +un compte et des droits en écriture afin de pouvoir envoyer leurs recettes, 1.110 +mises à jour ou modifications. Il est bien sûr possible de demander la création 1.111 +d'un nouveau dépôt pour collaborer sur un nouveau sous-projet lié à SliTaz. 1.112 A noter qu'il y a 2 domaines : <a href="http://hg.slitaz.org/">hg.slitaz.org</a> 1.113 -est public et <code>repos.slitaz.org</code> nécessite une authentification, c'est-à-dire 1.114 +est public et <code>repos.slitaz.org</code> nécessite une authentification, c'est-à -dire 1.115 que vous pouvez cloner hg.slitaz.org mais pas y pousser vos changements ou fichiers. 1.116 </p> 1.117 <h4>~/.hgrc</h4> 1.118 <p> 1.119 -Mercurial utilise un fichier caché <code>~./hgrc</code> permettant de 1.120 -spécifier son nom d'utilisateur. Il faut mettre votre nom et adresse mail pour 1.121 -qu'on sache qui a modifié quoi. Et attention à ne pas être <em>root</em> pour 1.122 +Mercurial utilise un fichier caché <code>~./hgrc</code> permettant de 1.123 +spécifier son nom d'utilisateur. Il faut mettre votre nom et adresse mail pour 1.124 +qu'on sache qui a modifié quoi. Et attention à ne pas être <em>root</em> pour 1.125 pousser vos modifications. Exemple : 1.126 </p> 1.127 <pre class="script"> 1.128 [ui] 1.129 -username = Prénom Nom <you@example.org> 1.130 +username = Prénom Nom <you@example.org> 1.131 </pre> 1.132 <h4>Cloner, modifier, commiter et pousser</h4> 1.133 <p> 1.134 Vous avez le choix de cloner anonymement via hg.slitaz.org ou directement avec 1.135 -votre login et mot de passe. Pour cloner un dépôt tel que le wok : 1.136 +votre login et mot de passe. Pour cloner un dépôt tel que le wok : 1.137 </p> 1.138 <pre> 1.139 $ hg clone http://repos.slitaz.org/wok/ 1.140 </pre> 1.141 <p> 1.142 -Copier, créer, modifier des recettes ou des fichiers dans <code>stuff</code>. 1.143 -Avant de pouvoir pousser vos modifs, il faut les additionner à votre dépôt 1.144 +Copier, créer, modifier des recettes ou des fichiers dans <code>stuff</code>. 1.145 +Avant de pouvoir pousser vos modifs, il faut les additionner à votre dépôt 1.146 local et les commiter. A noter que la commande <code>status</code> permet de 1.147 -savoir quels fichiers ont été modifiés : 1.148 +savoir quels fichiers ont été modifiés : 1.149 </p> 1.150 <pre> 1.151 $ cd wok 1.152 @@ -131,8 +131,8 @@ 1.153 $ hg commit 1.154 </pre> 1.155 <p> 1.156 -La commande <code>commit</code> va ouvrir l'éditeur de texte Nano pour écrire le message 1.157 -destiné aux logs (Ctrl + X pour enregistrer et quitter). Vous pouvez éviter 1.158 +La commande <code>commit</code> va ouvrir l'éditeur de texte Nano pour écrire le message 1.159 +destiné aux logs (Ctrl + X pour enregistrer et quitter). Vous pouvez éviter 1.160 Nano en utilisant l'option : <code>-m "Message"</code>. And please, 1.161 messages in English if possible : 1.162 </p> 1.163 @@ -140,8 +140,8 @@ 1.164 $ hg commit -m "Message for Mercurial log" 1.165 </pre> 1.166 <p> 1.167 -Une fois que tout est prêt, vous pouvez encore utiliser la commande 1.168 -<code>log</code> pour voir ce qui va être affiché sur l'interface web. Pour 1.169 +Une fois que tout est prêt, vous pouvez encore utiliser la commande 1.170 +<code>log</code> pour voir ce qui va être affiché sur l'interface web. Pour 1.171 pousser vos changements c'est <code>push</code> : 1.172 </p> 1.173 <pre> 1.174 @@ -149,15 +149,15 @@ 1.175 $ hg push 1.176 </pre> 1.177 <p> 1.178 -Si vous avez cloné depuis hg.slitaz.org, il faut alors pousser en spécifiant 1.179 +Si vous avez cloné depuis hg.slitaz.org, il faut alors pousser en spécifiant 1.180 le bon URL : 1.181 </p> 1.182 <pre> 1.183 $ hg push http://repos.slitaz.org/wok/ 1.184 </pre> 1.185 -<h4>Mettre à jour un wok local</h4> 1.186 +<h4>Mettre à jour un wok local</h4> 1.187 <p> 1.188 -Pour mettre à jour votre wok local avec celui du serveur (<em>pull</em> pour 1.189 +Pour mettre à jour votre wok local avec celui du serveur (<em>pull</em> pour 1.190 tirer les changements) : 1.191 </p> 1.192 <pre> 1.193 @@ -169,17 +169,17 @@ 1.194 Des commandes hg qui peuvent servir. 1.195 </p> 1.196 <ul> 1.197 - <li><code>hg help</code> : affiche la liste complète des commandes.</li> 1.198 - <li><code>hg rollback</code> : annule la dernière action exécutée (commit, 1.199 + <li><code>hg help</code> : affiche la liste complète des commandes.</li> 1.200 + <li><code>hg rollback</code> : annule la dernière action exécutée (commit, 1.201 pull, push).</li> 1.202 <li><code>hg log <paquet></code> : affiche les logs pour un paquet.</li> 1.203 <li><code>hg head</code> : affiche le dernier log.</li> 1.204 </ul> 1.205 1.206 <a name="iconv"></a> 1.207 -<h3>Implémentation d'iconv()</h3> 1.208 +<h3>Implémentation d'iconv()</h3> 1.209 <p> 1.210 -SliTaz utilise iconv() fourni par la GNU glibc, même si certain paquets 1.211 +SliTaz utilise iconv() fourni par la GNU glibc, même si certain paquets 1.212 proposent d'utiliser <code>libiconv</code> il faut utiliser la version de 1.213 la glibc (paquet <code>glibc-locale</code>). Il n'y a donc pas de paquet 1.214 libiconv (1,2 Mb) dans SliTaz. 1.215 @@ -188,38 +188,38 @@ 1.216 <a name="pkgs"></a> 1.217 <h3>Paquets tazpkg</h3> 1.218 <p> 1.219 -Les paquets tazpkg de SliTaz sont créés automatiquement via Tazwok et les 1.220 +Les paquets tazpkg de SliTaz sont créés automatiquement via Tazwok et les 1.221 recettes contenues dans le wok, <a href="http://doc.slitaz.org/fr:cookbook:start">le Cookbook</a> 1.222 -décrit <a href="http://doc.slitaz.org/fr:cookbook:wok">l'utilisation des outils SliTaz</a> 1.223 +décrit <a href="http://doc.slitaz.org/fr:cookbook:wok">l'utilisation des outils SliTaz</a> 1.224 et le format des <a href="http://doc.slitaz.org/fr:cookbook:receipt">recettes</a>, 1.225 c'est sans doute par un petit peu de lecture qu'il faut commencer. 1.226 </p> 1.227 <p> 1.228 -Concernant le choix des paquets, l'idée est de proposer un paquet par tâche ou 1.229 -fonctionnalité, c'est à dire pas (trop) de doublons et de trouver 1.230 -l'application la plus légère dans son domaine. A noter que les paquets actuels 1.231 -ne sont pas figés, si vous trouvez une alternative à un paquet existant, étant 1.232 -plus légère, ayant plus de fonctionnalités ou étant plus <em>sexy</em> pour 1.233 -quelques Ko supplémentaires, vous pouvez la proposer sur la liste. Une 1.234 -attention particulière est portée aux paquets destinés au LiveCD : strip, 1.235 -suppression de tout ce qui est inutile, dépendances et options de compilation. 1.236 -En général, les paquets candidats pour le corps du LiveCD sont discutés sur 1.237 +Concernant le choix des paquets, l'idée est de proposer un paquet par tâche ou 1.238 +fonctionnalité, c'est à dire pas (trop) de doublons et de trouver 1.239 +l'application la plus légère dans son domaine. A noter que les paquets actuels 1.240 +ne sont pas figés, si vous trouvez une alternative à un paquet existant, étant 1.241 +plus légère, ayant plus de fonctionnalités ou étant plus <em>sexy</em> pour 1.242 +quelques Ko supplémentaires, vous pouvez la proposer sur la liste. Une 1.243 +attention particulière est portée aux paquets destinés au LiveCD : strip, 1.244 +suppression de tout ce qui est inutile, dépendances et options de compilation. 1.245 +En général, les paquets candidats pour le corps du LiveCD sont discutés sur 1.246 la liste. 1.247 </p> 1.248 <p> 1.249 -Avant de commencer à compiler et créer des paquets pour SliTaz, assurez-vous 1.250 +Avant de commencer à compiler et créer des paquets pour SliTaz, assurez-vous 1.251 qu'une recette n'existe pas dans le wok undigest, disponible sur le miroir 1.252 principal de SliTaz. N'oubliez pas non plus que les membres de la liste sont 1.253 -là pour vous aider et que pour bien commencer, <a href="http://doc.slitaz.org/fr:cookbook:wok" 1.254 +là pour vous aider et que pour bien commencer, <a href="http://doc.slitaz.org/fr:cookbook:wok" 1.255 >la documentation du wok et des outils</a> existe. 1.256 </p> 1.257 1.258 <a name="pkgs-naming"></a> 1.259 <h3>Nommage des paquets</h3> 1.260 <p> 1.261 -Dans la majorité des cas le nom du paquet est celui des sources exception 1.262 +Dans la majorité des cas le nom du paquet est celui des sources exception 1.263 faite des modules Python, Perl, PHP, Ruby, Lua. Par example le paquet Kid 1.264 -fournissant un système de template XML et écrit en Python se nomme: 1.265 +fournissant un système de template XML et écrit en Python se nomme: 1.266 <code>python-kid</code>. 1.267 </p> 1.268 1.269 @@ -227,10 +227,10 @@ 1.270 <h3>Gestion du site Web et des livres</h3> 1.271 <p> 1.272 La gestion du site et des livres (Handbook et Cookbook) est faite via un 1.273 -dépôt Mercurial, ce qui nous permet de traviller à plusieurs. Il faut 1.274 -juste installer <code>mercurail</code> sur SliTaz et connaître les commandes 1.275 -de base. Une fois le dépôt cloné vous avez une copie complète du site en 1.276 -local pour commencer à travailler. Pour cloner le site web : 1.277 +dépôt Mercurial, ce qui nous permet de traviller à plusieurs. Il faut 1.278 +juste installer <code>mercurail</code> sur SliTaz et connaître les commandes 1.279 +de base. Une fois le dépôt cloné vous avez une copie complète du site en 1.280 +local pour commencer à travailler. Pour cloner le site web : 1.281 </p> 1.282 <pre> 1.283 $ hg clone http://hg.slitaz.org/website 1.284 @@ -243,35 +243,35 @@ 1.285 </pre> 1.286 <p> 1.287 Sur SliTaz vous pouvez installer le serveur web Lighttpd et mettre le 1.288 -site dans votre répertoire ~/Public, cela permet de naviguer dans votre 1.289 +site dans votre répertoire ~/Public, cela permet de naviguer dans votre 1.290 copie locale via localhost/~user. 1.291 </p> 1.292 1.293 <a name="xhtml"></a> 1.294 <h3>xHTML coding style</h3> 1.295 <p> 1.296 -Les pages du site et des différents <em>books</em> sont codés en xHTML 1.0 1.297 +Les pages du site et des différents <em>books</em> sont codés en xHTML 1.0 1.298 Transitional, les couleurs pour le <code>body</code> et les titres sont 1.299 -directement mis dans la page, cela permet d'avoir une présentation plus soignée 1.300 -pour Links. Le titre de niveau 1 est utilisé une seule fois en haut de page, 1.301 +directement mis dans la page, cela permet d'avoir une présentation plus soignée 1.302 +pour Links. Le titre de niveau 1 est utilisé une seule fois en haut de page, 1.303 le titre 2 correspond au titre du document et les titres de niveau 3 et 4 sont 1.304 -ensuite utilisés pour les sous-titres. Si il y a lieu d'avoir une liste à puces 1.305 -avec des ancres, elle se met en haut juste après le titre de niveau 2. Les 1.306 +ensuite utilisés pour les sous-titres. Si il y a lieu d'avoir une liste à puces 1.307 +avec des ancres, elle se met en haut juste après le titre de niveau 2. Les 1.308 paragraphes sont contenus dans les balises <code><p></p></code>. 1.309 -Pour indenter, nous utilisons des tabulations, elles ont une raison d'être 1.310 -sémantique et prennent moins de place en terme d'octets. Pour mettre 1.311 +Pour indenter, nous utilisons des tabulations, elles ont une raison d'être 1.312 +sémantique et prennent moins de place en terme d'octets. Pour mettre 1.313 du code tel que le nom d'une commande dans un paragraphe, la balise 1.314 -<code><code></code> est recommandée. Pour afficher une ou des commandes 1.315 -à lancer dans un terminal, les pages du site utilisent la balise 1.316 -<code><pre></code> permettant d'afficher du texte préformaté. Exemple : 1.317 +<code><code></code> est recommandée. Pour afficher une ou des commandes 1.318 +à lancer dans un terminal, les pages du site utilisent la balise 1.319 +<code><pre></code> permettant d'afficher du texte préformaté. Exemple : 1.320 </p> 1.321 <pre> 1.322 $ command 1.323 </pre> 1.324 <p> 1.325 -Pour afficher du texte à copier/coller tels que des scripts, des bouts de 1.326 +Pour afficher du texte à copier/coller tels que des scripts, des bouts de 1.327 code, des exemples de fichiers de configuration, etc, c'est aussi la balise 1.328 -<code><pre></code> mais avec une classe CSS nommée "script". Exemple: 1.329 +<code><pre></code> mais avec une classe CSS nommée "script". Exemple: 1.330 </p> 1.331 <pre class="script"> 1.332 <pre class="script"> 1.333 @@ -282,18 +282,18 @@ 1.334 </pre> 1.335 <p> 1.336 Les mots en <em>English</em> se mettent dans la balise <code><em></code> 1.337 -et les liens internes sont relatifs. Penser à vérifier la validité du code via 1.338 +et les liens internes sont relatifs. Penser à vérifier la validité du code via 1.339 le <em>validator</em> en ligne du W3C. 1.340 </p> 1.341 1.342 <h3>Diff et patch</h3> 1.343 <p> 1.344 Les utilitaires <code>diff</code> et <code>patch</code> sont des outils en 1.345 -ligne de commande permettant de créer et d'appliquer un fichier contenant 1.346 -les différences entre deux fichiers. Cette technique est souvent utilisée 1.347 -pour collaborer et permet d'extraire clairement les modifications apportées 1.348 -au fichier original. Pour créer un fichier <code>diff</code> lisible par 1.349 -les humains dans un simple éditeur de texte, il faut utiliser l'option 1.350 +ligne de commande permettant de créer et d'appliquer un fichier contenant 1.351 +les différences entre deux fichiers. Cette technique est souvent utilisée 1.352 +pour collaborer et permet d'extraire clairement les modifications apportées 1.353 +au fichier original. Pour créer un fichier <code>diff</code> lisible par 1.354 +les humains dans un simple éditeur de texte, il faut utiliser l'option 1.355 <code>-u</code> en argument : 1.356 </p> 1.357 <pre>