Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
groupes:ubuntu-fr-webteam [Le 23/10/2011, 19:17] Gemnoc ajout tag groupe |
groupes:ubuntu-fr-webteam [Le 14/06/2017, 10:49] (Version actuelle) YoBoY |
||
|---|---|---|---|
| Ligne 4: | Ligne 4: | ||
| ====== Groupe des développeurs des applications web ====== | ====== Groupe des développeurs des applications web ====== | ||
| - | Ubuntu-fr vous propose en permanence le meilleur d'Ubuntu grâce à son forum, sa documentation et son planet. Tous cela fonctionne grâce à des applications web. L'équipe des développeurs ubuntu-fr-webteam est en charge du développement et du maintiens de ces applications. | + | Ubuntu-fr vous propose en permanence le meilleur d'Ubuntu grâce à son forum, sa documentation et son planet. Tous cela fonctionne grâce à des applications web. L'équipe des développeurs **ubuntu-fr-webteam** est en charge du développement et du maintiens de ces applications. |
| ===== Nos applications ===== | ===== Nos applications ===== | ||
| Ligne 22: | Ligne 22: | ||
| Pour participer sur [[:Launchpad]], il faudra vous créer un compte utilisateur. | Pour participer sur [[:Launchpad]], il faudra vous créer un compte utilisateur. | ||
| - | Vous trouverez l'ensemble de ces applications web dans le projet : [[https://launchpad.net/ubuntu-fr-website-project|ubuntu-fr-website-project]] | + | Vous trouverez l'ensemble de ces applications web dans le projet : [[https://launchpad.net/ubuntu-fr|ubuntu-fr]] |
| - | Si vous souhaitez nous contactez, vous pouvez utiliser la liste de diffusion [[https://eshu.ubuntu-eu.org/cgi-bin/mailman/listinfo/ubuntu_webdev-fr|ubuntu_webdev-fr]] ou le salon IRC [[irc://irc.freenode.net/ubuntu-fr|#ubuntu-fr-devweb]]. | + | Si vous souhaitez nous contacter, vous pouvez utiliser la liste de diffusion [[http://listes.ubuntu-fr.org/info/ubuntu_webdev-fr|ubuntu_webdev-fr]] ou le salon IRC [[irc://irc.freenode.net/ubuntu-fr|#ubuntu-fr-devweb]]. |
| ===== Comment nous aider ===== | ===== Comment nous aider ===== | ||
| ==== Signaler un bug ==== | ==== Signaler un bug ==== | ||
| - | Si vous constatez une erreur dans nos outils, quelque chose qui s'affiche mal, un problème de sécurité, ou quoi que ce soit, n'hésitez pas à nous le signaler : [[https://bugs.launchpad.net/ubuntu-fr-website-project/+filebug|rapporter un bug]] | + | Si vous constatez une erreur dans nos outils, quelque chose qui s'affiche mal, un problème de sécurité, ou quoi que ce soit, n'hésitez pas à nous le signaler : [[https://bugs.launchpad.net/ubuntu-fr/+filebug|rapporter un bug]] |
| - | Choisissez le projet concerné. Il vous sera demandé un rapide résumé du problème, afin de vérifier si ce problème n'a pas déjà été signalé, et ensuite une description plus complète. Mettez le maximum de détails, une capture d'écran, la façon de le reproduire le problème, le navigateur et sa version si vous la connaissez, la version d'Ubuntu éventuellement | + | Choisissez le projet concerné. Il vous sera demandé un rapide résumé du problème, afin de vérifier si ce problème n'a pas déjà été signalé, et ensuite une description plus complète. Mettez le maximum de détails, une capture d'écran, la façon de reproduire le problème, le navigateur utilisé et sa version si vous la connaissez, et la version d'Ubuntu éventuellement. |
| - | Une fois toutes ces informations renseignées, nous recevrons un mail et ne manqueront pas d'apporter une réponse à ce problème rapidement. | + | Une fois toutes ces informations renseignées, nous recevrons un mail et ne manquerons pas d'apporter une réponse à ce problème rapidement. |
| ==== Aider à améliorer le code ==== | ==== Aider à améliorer le code ==== | ||
| - | Pour commencer il faudra apprendre les commandes de base de [[:bzr|bazaar]], qui est le gestionnaire de version que nous utilisons, et être un peu familiarisé avec [[https://launchpad.net/|Launchpad]]. | + | Pour commencer il faudra apprendre les commandes de base de [[:git|git]], qui est le gestionnaire de version que nous utilisons, et être un peu familiarisé avec [[https://launchpad.net/|Launchpad]]. |
| + | |||
| + | <note tip> | ||
| + | Afin de simplifier l'utilisation de git avec launchpad, il est recommandé de créer ou [[:tutoriel:comment_modifier_un_fichier|modifiez le fichier]] **~/.gitconfig** et d'y ajouter ces lignes : | ||
| + | <code> | ||
| + | [url "git+ssh://USER@git.launchpad.net/"] | ||
| + | insteadof = lp: | ||
| + | </code> | ||
| + | Où **USER** est votre identifiant sur Launchpad. | ||
| + | |||
| + | Ceci vous permet d'utiliser une url du dépôt git distant simplifiée **lp:NOMDUPROJET** à la place de %%git+ssh://USER@git.launchpad.net/NOMDUPROJET%% | ||
| + | </note> | ||
| Après cela, suivez simplement les étapes suivantes : | Après cela, suivez simplement les étapes suivantes : | ||
| Ligne 41: | Ligne 52: | ||
| === Étape 1 : récupérer le code source === | === Étape 1 : récupérer le code source === | ||
| - | Allez sur l'onglet //code// et sélectionnez le code que vous voulez récupérer. Vous verrez alors affiché une ligne de commande sous "Get this branch". | + | Allez sur l'onglet //code// et sélectionnez le code que vous voulez récupérer. Vous verrez alors affiché une ligne de commande sous "Get this repository". |
| Ouvrez un [[:terminal]], créez un dossier de travail si besoin et rendez-vous dans votre dossier de travail et entrez cette commande, comme par exemple pour la documentation : | Ouvrez un [[:terminal]], créez un dossier de travail si besoin et rendez-vous dans votre dossier de travail et entrez cette commande, comme par exemple pour la documentation : | ||
| Ligne 47: | Ligne 58: | ||
| mkdir documentation | mkdir documentation | ||
| cd documentation | cd documentation | ||
| - | bzr branch lp:ubuntu-fr-doc | + | git clone git+ssh://git.launchpad.net/ubuntu-fr-doc |
| + | </code> | ||
| + | ou avec l'URL simplifiée : | ||
| + | <code> | ||
| + | git clone lp:ubuntu-fr-doc | ||
| </code> | </code> | ||
| Ligne 58: | Ligne 73: | ||
| Une seule recommandation, nous ne vérifions qu'une amélioration à la fois, c'est à dire que si vous voulez corriger des bugs, n'en corrigez pas plusieurs sur la même branche alors qu'il est si simple de créer une nouvelle branche. | Une seule recommandation, nous ne vérifions qu'une amélioration à la fois, c'est à dire que si vous voulez corriger des bugs, n'en corrigez pas plusieurs sur la même branche alors qu'il est si simple de créer une nouvelle branche. | ||
| - | Par exemple pour travailler sur le **bug 12345**, créer une nouvelle branche avec le code distant dans votre dossier de travail : | + | Par exemple pour travailler sur le **bug 12345**, créer une nouvelle branche dans votre dossier de travail : |
| - | <code>bzr branch lp:ubuntu-fr-doc fixe-12345</code> | + | <code>git checkout -b fixe-12345</code> |
| - | ou avec le code local si vous l'avez déjà récupéré dans votre dossier de travail : | + | La commandes aura pour effet de créer la branche **fixe-12345** dans laquelle vous allez travailler. |
| - | <code>bzr branch ubuntu-fr-doc fixe-12345</code> | + | |
| - | Les deux commandes auront pour effet de créer le dossier **fixe-12345** dans lequel vous allez travailler. | + | |
| === Étape 3 : Versionner localement ces modifications === | === Étape 3 : Versionner localement ces modifications === | ||
| - | Vous travaillez sur du code localement, avec un gestionnaire de version, n'hésitez pas à enregistrer vos modifications par étapes afin de pouvoir revenir en arrière si besoin. La commande est tout simplement sous bazaar : | + | Vous travaillez sur du code localement, avec un gestionnaire de version, n'hésitez pas à enregistrer vos modifications par étapes afin de pouvoir revenir en arrière si besoin. La commande est tout simplement sous git: |
| - | <code>bzr commit -m "un message explicatif"</code> | + | <code> |
| + | git add monfichier.php | ||
| + | git commit -m "un message explicatif" | ||
| + | </code> | ||
| Si vos modifications corrigent un bug, précisez le dans le commit, cela permettra d'automatiser certaines actions dans le rapport de bug (exemple avec le bug 12345) : | Si vos modifications corrigent un bug, précisez le dans le commit, cela permettra d'automatiser certaines actions dans le rapport de bug (exemple avec le bug 12345) : | ||
| - | <code>bzr commit --fixes lp:12345 -m "message explicatif"</code> | + | <code>git commit -m "LP: #12345 un message explicatif"</code> |
| === Étape 4 : Envoyer ces modification sur Launchpad === | === Étape 4 : Envoyer ces modification sur Launchpad === | ||
| - | Une fois que vous êtes satisfait des modifications apportées à votre branche de travail, il ne vous reste plus qu'à la partager afin que nous puissions contrôler le code et l'intégrer à la branche principale. Là encore c'est très simple, vous aller envoyer votre branche dans votre espace personnel. Par exemple pour une modification corrigeant le **bug 12345** du projet **ubuntu-fr-doc** : | + | Une fois que vous êtes satisfait des modifications apportées à votre branche de travail, il ne vous reste plus qu'à la partager afin que nous puissions contrôler le code et l'intégrer à la branche principale. Là encore c'est très simple, vous allez envoyer votre branche dans votre espace personnel. Par exemple pour une modification corrigeant le **bug 12345** du projet **ubuntu-fr-doc** avec votre identifiant USER : |
| - | <code>bzr push lp:~votresurnom/ubuntu-fr-doc/fixe-12345</code> | + | <code>git push lp:~USER/ubuntu-fr-doc fixe-12345</code> |
| Vous pouvez aussi juste vouloir partager votre travail pour le montrer à une autre personne pour qu'elle vous aide, ou qu'elle récupère vos modifications. | Vous pouvez aussi juste vouloir partager votre travail pour le montrer à une autre personne pour qu'elle vous aide, ou qu'elle récupère vos modifications. | ||
| Ligne 81: | Ligne 97: | ||
| === Étape 5 : Nous proposer ces modifications === | === Étape 5 : Nous proposer ces modifications === | ||
| - | Vous avez réalisé toutes les étapes ci-dessus, il ne vous reste plus qu'à nous demander d'intégrer votre code dans la branche principale. Pour cela rendez-vous sur launchpad, sur la page où ce trouve ce code. Dans notre exemple : | + | Vous avez réalisé toutes les étapes ci-dessus, il ne vous reste plus qu'à nous demander d'intégrer votre code dans la branche principale. Pour cela rendez-vous sur launchpad, sur la page de votre dépôt personnel où ce trouve ce code. Dans notre exemple : |
| - | <code>https://code.launchpad.net/~votresurnom/ubuntu-fr-doc/fixe-12345</code> | + | <code>https://code.launchpad.net/~USER/ubuntu-fr-doc</code> |
| - | Vous aurez sur cette page un lien << Propose for merging >>, il ne vous restera plus qu'à compléter si besoin les renseignements demandés. Un ou plusieurs membres de l'équipe ubuntu-fr-webteam vérifieront ces modifications et les intègrerons à la branche principale ou vous demanderont avant quelques modifications. | + | Cliquez sur votre branche de travail, ici fix-12345, vous aurez sur la page de cette branche un lien << Propose for merging >>. Il ne vous restera plus qu'à compléter si besoin les renseignements demandés. Un ou plusieurs membres de l'équipe ubuntu-fr-webteam vérifieront ces modifications et les intégreront à la branche principale, ou vous demanderont quelques modifications préalables. |
| === Astuces === | === Astuces === | ||
| - | Pour vous familiariser avec le couple bazaar / Launchpad, il existe une [[https://staging.launchpad.net/ubuntu-fr-website-project|version démo de Launchpad]] où vous pouvez vous entraîner sans conséquences. | + | Pour vous familiariser avec le couple git / Launchpad, il existe une [[https://staging.launchpad.net/ubuntu-fr|version démo de Launchpad]] où vous pouvez vous entraîner sans conséquences.\\ |
| + | Pour en savoir un peu plus sur git il y a une page qui le traite un peu plus dans le détail [[:git|git]] | ||