Ajouter un dépot (repository) Maven à votre forge Google Code grâce à Subversion

Discutés aux deux adresses ci-dessous mais l'alternative d'utiliser un dépot public est conseillée

1. http://stackoverflow.com/questions/1280470/maven-repository-for-google-code-project
2. http://www.thewebsemantic.com/2009/04/11/your-very-own-google-code-maven-repo/

Mesurer le nombre de visites sur votre projet hébergé sous Google Code grâce à Google Analytics

Ce post décrit la procédure pour "track visits to Google code projects in Google Analytics".

1. Anyone may sign up for a free Google Analytics account. Once you have an account
2. Add a profile for a new domain and specify URL http://code.google.com/
3. Edit the profile that you just created to change its Website URL to http://code.google.com/p/votre-nom-de-projet/ 
4. Paste your Google Analytics profile's Web Property ID below and save changes. 
5. About 24 hours after you add your Web Property ID, your profile should begin to indicate that it is receiving data.

Publier une Javadoc sous forge Google Code

La procédure est la suivante

1. Récupérez la racine du projet
• svn checkout https://votre-nom-de-projet.googlecode.com/svn/ votre-nom-de-projet --username votre.username
• cd votre-nom-de-projet
2. Ajoutez un répertoire javadoc au versionning
• svn mkdir javadoc 
3. Réalisez l'export de la javadoc via Eclipse se sera plus simple
4. Ajoutez les fichiers javadoc au versionning
• svn add javadoc/*
5. Ajoutez les propriétés adéquates pour que svn interprète les fichiers de la javadoc  avec le bon type mime
• find  javadoc -name "*.html" -exec svn propset svn:mime-type text/html  {} + ;
• find  javadoc -name "*.css" -exec svn propset svn:mime-type text/css  {} + ;
• find  javadoc -name "*.jpeg" -exec svn propset svn:mime-type image/jpeg  {} + ;
6. Commitez vos ajouts
• svn commit javadoc/ -m "ajout de la javadoc"
7. Votre javadoc devrait être désormais accessible via l'url http://votre-nom-de-projet.googlecode.com/svn/javadoc/index.html ; ajoutez ce lien dans la section de links de Administer > Project Summary

Publier sur le Web et partager les droits d'édition à tous d'un Google document

Dans la quête de la recherche d'outils facilitant le travail collaboratif je tente d'utiliser un Google Document qui désormais offrent des fonctionnalités de partage des droits d'édition à tous (sans nécessité de posséder un compte) ainsi que de publication Web.

La procédure ci-dessous est légèrement différente de celle trouvée sur des réponses officielles (publication de vos documents et publication sur le web). Peut être est ce dû à un retard de mise à jour de la documentation ?

La procédure a été testée avec un Google Document, mais reste valable a priori pour tout type de documents (document, feuille de calcul, présentation...). Ici vous trouverez un exemple de Google Document publié et ouvert à l'édition (il s'agit d'un site sérieux merci de ne pas le modifier à moins que vous souhaitiez y contribuer).

Les deux actions, partage de la visibilité et publication sur le web, supposent que vous venez d'ouvrir ou de créer votre Google Document.

Pour partager la visibilité (notamment en édition) 

1. Cliquer sur l'icone "Share". Une fenêtre de configuration intitulée "Share settings" apparaît.
2. Cliquer sur "Change"  au niveau de la première ligne du tableau "Who has access" (par défaut l'accès est limité : "Private - Only the people listed below can access"). Une fenêtre intitulée "Visibility options" apparaît
3. Sélectionner  "Public on the web. Anyone on the Internet can find and access. No sign-in required."
4. Et enfin changer l'accès de "Can view" à "Can edit" au niveau de la ligne "Access:Anyone (no sign-in required)" qui a dû apparaître.

Pour publier sur le Web un Google document

1. Dans le menu File, cliquer sur "Publish to the Web". Une fenêtre "Control publishing" s'affiche.
2. Laisser coché "Automatically republish when changes are made".
3. Cliquer sur "Start publishing" et confirmer. Vous obtiendrez un lien vers le document publié
4. Par ailleurs, le lien par lequel vous éditiez votre document est désormais public. Vous pouvez le faire circuler.

Remarques

• Attention, il est important de noter que la publication sur le Web et sa visibilité sont deux concepts indépendants. 
• Les contributeurs du Web n'auront pas accès aux options de partage mais pourront intervenir sur la publication.
• Ils n'auront pas non plus accès à l'historique des modifications ("File > Revision history")
• Ils pourront télécharger le document dans divers formats (notamment PDF)
• Ils ne pourront pas changer les notifications qui sont propres à un compte à moins qu'ils ne soient connectés.

Créer un projet sous GoogleCode

Dernière mise à jour : 1 mars 2011

La page "A quick guide to getting started with project hosting on Google Code" explique comment contribuer à ou créer un projet sous GoogleCode (par exemple comment choisir la licence d'un nouveau projet).

En quelques cliques...

1. Créer un projet en cliquant sur Create Project et remplir le formulaire
   
• nom, résumé et description du projet, mais aussi des choix comme (ici avec des valeurs exemples que j'utilise en général) 
• Project name: si votre nom est composé alors séparer chaque mot par un tiret (e.g. votre-nom-de-projet)
• Version control system: Subversion
• Source code license: Apache License v2.0
2. Configurer le projet (à l'aide de l'onglet Administer de la barre de menu horizontale. Le fait de cliquer dessus fait apparaître un sous menu.)
   
1. Définir les membres en cliquant sur Project Members (les owners ont tous les droits, les committers peuvent travailler sur le projet mais ne peuvent pas le configurer.)
2. (Optionnel) Sous l'onglet Project Summary, spécifier la notification des modifications de la forge en déclarant le nom de votre liste de discussion ou google groupe (qui servira aussi d'alias dans nos échanges mails) dans la section Activity notifications de Administer puis Issue Tracking. (Pour créer un google groupe se rendre sur http://groups.google.fr/groups/create)
3. (Optionnel) Sous l'onglet Project Summary, spécifier le Web Property ID de Google Analytics afin de pouvoir obtenir des statistiques de visistes via Google Analytics (la note Learn more, rappelé plus bas, vous indique la démarche).
3. Services à disposition et menu de gestion du projet
• La barre d'onglets horizontale offre différents services : Project Home, Downloads, Wiki, Issues, Source, Administer
1. Downloads permet de uploader des fichiers avec le lien New download
   
2. Wiki permet de rédiger des pages avec le lien New page
3. Issues permet de signaler des observations sur le projet pour aider à son bon développement.  Elles émanent des utilisateurs comme des développeurs.
   
1. Cela se fait avec New issue et en spécifiant entre autres le Type de l'issue -Defect (défaut du logiciel), -Enhancement (amélioration demandée sur quelque chose qui existe), -Task (quelque chose de nouveau à développer)... et sa priorité
2. Par la suite, les développeurs consultent les issues et agissent en conséquence. Une issue peut recevoir plusieurs commentaires de différentes personnes. Suivant leurs traitements, les développeurs changeront leur Status (Accepté (le problème est confirmé), Fixed (defect réparée), Invalid (issue invalide), Done (task effectuée)...
4. Source indique les commandes à taper pour récupérer avec un client subversion (svn) depuis un poste linux les sources du projets afin de contribuer ou seulement de les consulter.
• si vous vous trouvez derrière un proxy, alors éditer le fichier ~/.subversion/servers et à la fin, décommenter les lignes suivantes en indiquant les bonnes valeurs
• # http-proxy-host = defaultproxy.whatever.com
  # http-proxy-port = 7000
4. Utiliser le dépot svn
• Votre dépot svn est accessible à une adresse similaire à celle-ci https://votre-nom-de-projet.googlecode.com/svn ; où par défaut 3 sous répertoires sont disponibles : trunk (version principale en cours de développement), tags (précédentes versions stables), branches (évolutions différentes du tronc ou corrections de bugs).
• L'onglet source vous indique comment récupérer le trunk...
• Pour commencer à travailler, faites un checkout pour commencer à travailler sur votre projet. Bien entendu la première version récupérée sera vide mais s'accompagne de fichiers qui permettront de synchroniser votre copie locale avec le référentiel subversion. 
5. Publier une Javadoc sous forge Google Code
6. Mesurer le nombre de visites sur votre projet hébergé sous Google Code grâce à Google Analytics
7. Ajouter un dépot (repository) Maven à votre forge Google Code grâce à Subversion

TODO Liens vers mon cours de svn, notamment pour faire des tags... Choisir sa licence...