Comment télécharger et installer un produit de CommunesPlone
This How-to is intended for:
Intégrateur - Integrator, Développeur - Developer
Le code source des produits est entièrement et gratuitement disponible. Le projet respecte la licence GPL. N'hésitez pas à récupérer les différents produits, à les tester et à nous faire vos remarques et suggestions.
Le code source des produits développés dans le cadre du projet CommunesPlone est contenu dans un outil de gestion des sources appelé SVN, diminutif de SUBVERSION.
Le SVN est accessible à l'adresse http://svn.communesplone.org/svn/.
En utilisant un navigateur internet avec l'adresse sus-mentionnée, vous pourrez visualiser les produits présents dans le projet ainsi que leur arborescence MAIS vous ne pourrez pas télécharger globalement un produit.
Afin de copier localement un produit et son arborescence, il est nécessaire d'utiliser un client subversion.
- Sous Windows, vous pouvez installer le client subversion situé dans le répertoire de téléchargement du site officiel. (N'hésitez pas à vérifier si une version plus récente existe)
- Sous Linux, vous trouverez parmi tous les packages disponibles, un package nommé "subversion", à installer.
- Pour les autres systèmes d'exploitation, je vous invite à vous rendre sur le site officiel pour de plus amples renseignements.
Sur le svn, chaque produit est localisé sous l'adresse "http://svn.communesplone.org/svn/communesplone/".
Dans chaque produit, il y a dossier "trunk" (qui correspond à la dernière version en cours de développement), un dossier "branches" (qui correspond à des version particulières ou en cours de développement) et éventuellement un dossier "tags" contenant des versions stables bien définies.
N'hésitez pas à nous demander le chemin exact de la dernière version pour le produit qui vous intéresse !
Une fois le client installé, vous devez, dans une fenêtre "invite de commande", vous positionner dans le répertoire Products de votre instance Plone (pour savoir comment installer Plone, reportez-vous au document d'installation).
Sous Windows, ce répertoire est situé dans le dossier nommé "data" de l'instance Plone.
Pour installer par exemple l'outil TeleServices, tapez la commande suivante :
svn co http://svn.communesplone.org/svn/communesplone/TeleServices/trunk/ TeleServices
Cette commande correspond au téléchargement du contenu de l'URL dans le répertoire de destination qui est créé.
Pour mettre à jour par la suite un produit, il est nécessaire de se positionner dans le répertoire du produit et de taper la commande :
svn up
Une fois un produit copié sur le système de fichiers, n'oubliez pas de redémarrer l'instance et de vous rendre dans le panneau de configuration pour ajouter le produit.
Derrière un proxy
Pour utiliser svn derrière un proxy, il est nécessaire d'adapter le fichier servers (dans ~/.subversion) et de compléter les variables :
http-proxy-host = ...
http-proxy-port = ...
ou bien de créer la variable d'environnement suivante :
http_proxy="host:port"