Différences

Ci-dessous, les différences entre deux révisions de la page.

--- ubuntu-fr-scripts_aide [Le 12/03/2009, 06:10]
fidji
+++ ubuntu-fr-scripts_aide [Le 07/02/2010, 00:05] (Version actuelle)
frombenny
@@ Ligne 1: / Ligne 1: @@
-{{tag>irc launchpad bazaar bzr bzr-gtk scripts programmation}}
+**[[wiki/syntaxe#redirection|Redirection]]**
+~~REDIRECT>:ubuntu-fr-scripts_participer~~
-----
-====== Projet de développement de scripts ======
-Le but de ce projet est de collecter et de maintenir sur le long terme un dépôt de scripts (bash, perl, python, java, etc) facilitant la vie des utilisateurs ubuntu et/ou d'autres distributions linux.
-<note info>Vous pouvez nous rejoindre sur **[[https://launchpad.net/~ubuntu-fr-scripts|ubuntu-fr-scripts]]** et contribuer activement au développement et/ou à l'internationalisation.
-Vous pouvez nous contacter via le site web, sur le [[http://forum.ubuntu-fr.org/viewtopic.php?pid=2476027|forum]], sur la mailing liste (en cours de création) et sur le canal IRC [[irc://irc.freenode.net/ubuntu-fr-scripts|#ubuntu-fr-scripts]]. N'hésitez pas à y poser toute question !</note>
-===== Prérequis =====
-==== Inscription sur le launchpad ====
-Dans un premier temps il faudra vous inscrire sur le site [[https://launchpad.net/+login|launchpad.net]] (ce qui vous permettra également, sans rapport avec ce projet, de rapporter les bugs que vous rencontrez sous Ubuntu, entre autres, et ainsi d'améliorer votre distribution préférée ;)).
-Pour pouvoir modifier/ajouter vos scripts, vous devrez déposer votre clef ssh publique (la création de la clef ssh devra être sans passphrase de préférence) sur la page :
-https://launchpad.net/~XXXX/+editsshkeys
-(remplacez XXXX par votre login launchpad).
-Si vous n'avez pas de clef [[:ssh|ssh]] :
-  ssh-keygen -t rsa
-ou encore
-  ssh-keygen -t dsa
-Vous pouvez ensuite demander à rejoindre [[https://launchpad.net/~ubuntu-fr-scripts|l'équipe de développement]]. L'adhésion au projet n'est pas obligatoire et vous pouvez contribuer de manière indépendante, cependant pour des raisons pratiques elle est fortement recommandée.
-==== Installation de bazaar ====
-Vous devrez installer certains outils du projet [[bazaar]] pour pouvoir travailler sur le projet.
-Au minimum [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **[[apt://bzr|bzr]]**. **[[apt://bzr-gtk|bzr-gtk]]**, une interface graphique à bazaar, peut être utile aussi.
-==== Configuration de bazaar ====
-La commande
-  bzr whoami
-permet de visualiser la manière dont vous êtes identifié lors de vos apports au projet. Il est conseillé de le configurer correctement, de la manière suivante :
-  bzr whoami "Votre Nom <email@example.com>"
-===== Travailler avec ubuntu-fr-scripts =====
-<note important>Ne mettez pas d'accent ou d'espace dans les noms de projets ou de vos fichiers !</note>
-Un projet (ou branche) contiendra un ou plusieurs scripts traitant d'un même sujet, par exemple sauvegarde de données, statistiques réseau, scripts action pour dolphin/konqueror/nautilus, etc.
-Dans chaque projet il sera d'usage d'avoir un fichier README.nomduscript contenant la description et l'usage de votre script.
-<note warning>Dans la suite, nous nous placerons systématiquement en [[:terminal|ligne de commande]], pour des raisons de simplicité. Vous pouvez jeter un œil du côté de [[:bzr-gtk]] pour une interface graphique.</note>
-==== Création de votre projet ====
-La création d'un projet se déroule en plusieurs étapes très simples. Tout d'abord, il faut créer un répertoire, s'y placer, et initialiser le projet avec bazaar :
-  mkdir ~/MonProjet
-  cd ~/MonProjet
-  bzr init
-NB : Vous pouvez évidemment remplacer le nom du dossier comme bon vous semble. Attention : un projet correspond à un répertoire (et d'éventuels sous-dossiers). Ne tentez pas de mélanger les projets au sein d'un même dossier.
-Créez ensuite le ou les fichiers que vous souhaitez associer à votre projet. Une fois cela fait, il faut indiquer à bazaar quels fichiers sont à ajouter au projet :
-  bzr add
-(par défaut, ajoute tous les fichiers du répertoire courant), puis valider localement l'ajout de vos fichiers :
-  bzr commit -m "Commentaire explicite"
-Voilà, il ne reste plus qu'à créer ou updater votre projet, ou « branche », sur le launchpad :
-  bzr push lp:~VotreLogin/ubuntu-fr-scripts/MonProjet
-NB : Vous pouvez également créer un projet privé, non partagé avec l'équipe ubuntu-fr-scripts. Il suffit de remplacer **ubuntu-fr-scripts** par **+junk** dans la commande précédente.
-==== Récupérer un projet ====
-<note important>Pensez à ajouter votre clef ssh publique sur votre compte Launchpad (cf [[#Inscription sur le launchpad|plus haut]]).</note>
-Pour récupérer un projet, il suffit d'effectuer la commande suivante :
-  bzr branch lp:~UnLogin/ubuntu-fr-scripts/NomDuProjet
-Vous pouvez remplacer « UnLogin » par votre login si vous souhaitez récupérer un de vos projets déjà existant, ou par « ubuntu-fr-scripts » pour récupérer un projet de l'équipe ubuntu-fr-scripts. Vous pouvez également remplacer « ubuntu-fr-scripts » par « +junk » s'il s'agit d'un projet personnel.
-Le projet est alors rappatrié dans le répertoire courant.
-==== Modifier le projet ====
-Lorsque vous modifiez un projet (que ce soit au niveau du code ou pour ajouter un fichier), la procédure est similaire à la création du projet. Commencez par vérifiez que vos sources sont à jour :
-  bzr update
-En cas de création de fichier, n'oubliez pas de marquer tous les nouveaux fichiers à ajouter :
-  bzr add
-Validez localement les modifications :
-  bzr commit -m "Commentaire suffisamment explicite"
-Transmettez les modifications au serveur launchpad :
-  bzr push lp:~VotreLogin/ubuntu-fr-scripts/MonProjet
-==== Fusionner un projet ====
-Bazaar est un outil de développement collaboratif. Il arrive donc fréquemment que plusieurs personnes travaillent sur le même projet en même temps, auquel cas il est nécessaire de fusionner les modifications apportées.
-=== Merging ===
-La fusion ne peut se faire qu'avec des branches équivalentes, c'est-à-dire issues du même projet initial. Pour effectuer une fusion avec une branche officielle, la commande à effectuer est la suivante :
-  bzr merge lp:~ubuntu-fr-scripts/ubuntu-fr-scripts/NomDuProjet
-Il peut être nécessaire d'indiquer le numéro de la révision (c'est-à-dire le énième « commit »), par exemple pour la révision 42 :
-  bzr merge -r 42 lp:~ubuntu-fr-scripts/ubuntu-fr-scripts/NomDuProjet
-=== Conflits ===
-Lors d'une fusion peuvent apparaître des conflits, auquel cas la commande vous gratifiera d'un message du type :
-  Text conflict in NomDuProjet
-conflicts encountered.
-Pour déterminer quels fichiers posent problème, exécutez la commande :
-  bzr conflicts
-Trois copies de chaque fichier rencontrant des conflits seront alors crées en plus du fichier original, avec les extensions .THIS, .OTHER et .BASE. La version .BASE est la dernière version identique des deux branches, la version .THIS est votre version, et la version .OTHER est le fichier tel que dans la branche avec laquelle vous essayer d'effectuer la fusion.
-Le fichier sans extension, quant à lui, est une tentative de fusion à corriger. Les conflits apparaîssent à l'intérieur sous la forme :
-  <<<<<<< TREE
-  Partie conflictuelle de votre version.
-  =======
-  Partie conflictuelle de la version à fusionner.
-  >>>>>>> MERGE-SOURCE
-Pour résoudre le conflit, vous pouvez corriger n'importe lequel des 4 fichiers, puis supprimer les trois fichiers avec extension (attention si vous avez choisi de garder ou modifier un fichier avec extension…). N'oubliez pas de supprimer les marqueurs de conflit (« <<<<<<< TREE », « ======= » et « >>>>>>> MERGE-SOURCE ») si vous avez choisi de modifier le fichier sans extension. Puis exécutez la commande :
-  bzr resolve
-Si tout va bien, cette commande confirmera que les conflits ont été corrigés, et vous pourrez alors terminer la procédure par les traditionnels **bzr commit** et **bzr push**.
-==== Quelques commandes utiles ====
-Pour mettre à jour votre version locale du projet :
-  bzr update
-Pour créer un sous-dossier (équivaut à un **mkdir SousDossier && bzr add SousDossier**) :
-  bzr mkdir SousDossier
-==== Validation de votre projet ====
-Une fois que vous considérez que votre projet est stable, merci de prendre contact avec les administrateurs ubuntu-fr-scripts afin de porter votre projet vers les branches stables du groupe et éventuellement la production de paquet .deb.
-===== Conventions =====
-==== Nommage des branches ====
-Les branches officielles sont nommées suivant la convention suivante :
-  * ufrs-xxxx (pour « //Ubuntu-FR Scripts// ») : ensemble de plusieurs scripts regroupés par thème.
-  * oufs-xxxx (pour « //Orphan Ubuntu-Fr Script// ») : script seul.
-==== Readme ====
-Chaque script doit être accompagné d'un fichier README.nomduscript, décrivant le but du script, son installation le cas échéant et son utilisation.
-===== Documentation =====
-Pour plus d'information sur la commande bzr veuillez consulter la documentation [[http://doc.bazaar-vcs.org/bzr.dev/en/user-guide/|Bazaar User Guide (en)]]
-Les commandes les plus usuelles regroupées en une [[http://doc.bazaar-vcs.org/bzr.dev/en/quick-reference/quick-start-summary.svg|page]]
-==== Bazaar ====
-Les commandes suivantes peuvent être utiles :
-  man bzr
-  bzr help
-  bzr help commands # Liste des commandes
-  bzr help xxx # Aide sur la commande xxx
-N'hésitez pas également à consulter [[http://bazaar-vcs.org/Documentation|la documentation Bazaar (en)]], dont une partie est [[http://bazaar-vcs.org/fr/|traduite en français]].
-==== Launchpad ====
-Les pages d'aides concernant l'utilisation du launchpad sont regroupées [[https://help.launchpad.net/|ici (en)]]. Lire également [[http://doc.ubuntu-fr.org/launchpad|la page dédiée]] sur le wiki.
-==== Ubuntu-fr-scripts ====
-Vous pouvez nous rejoindre sur **[[https://launchpad.net/~ubuntu-fr-scripts|ubuntu-fr-scripts]]** et contribuer activement au développement et/ou à l'internationalisation.
-Vous pouvez nous contacter via le site web, sur le [[http://forum.ubuntu-fr.org/viewtopic.php?pid=2476027|forum]], sur la mailing liste (en cours de création) et sur le canal IRC [[irc://irc.freenode.net/ubuntu-fr-scripts|#ubuntu-fr-scripts]]. N'hésitez pas à y poser toute question !