Les différentes lectures proposées sont dédiées à des développeurs.

Un tutoriel Python

Python est un langage très simple qui s'apprend assez rapidement.
Il n'est pas vraiment nécessaire d'acheter un livre pour apprendre le langage.
Un bon tutoriel (comme celui présent sur le site http://python.org) comprenant quelques exercices suffit.

Un livre sur Zope2

Afin de commencer à développer un produit Plone, il est nécessaire de comprendre le framework utilisé.
Le meilleur moyen est de lire un livre sur Zope2.

Une version en ligne du manuel de référence est disponible en anglais sur le site de Zope.

Un bon livre est également disponible en français.

Une fois ces deux premières lectures effectuées, le développeur aura les bases nécessaires pour commencer à développer. Il peut alors aborder le point suivant de ce guide.
Des lectures complémentaires sont proposées ci-dessous pour étoffer les connaissances déjà acquises.

Un livre sur Plone 3

Le livre proposé (en anglais) explique le développement d'applications pour Plone 3. Il présente les nouvelles techniques à utiliser pour réaliser des développements bénéficiants des dernières nouveautés de Plone 3.

 

Deux façons de procéder sont possibles :

• installer python, Zope, Plone et tous les produits nécessaires séparément
• utiliser un buildout qui permet d'installer tous ces outils automatiquement

Nous proposons un buildout qui permet d'installer un environnement comprenant tous les outils développés dans le cadre du projet ou proposés sur le serveur central. Un tutoriel explique comment utiliser ce buildout.

La création d'un produit Plone basé sur Archetypes suit généralement ces différentes étapes :

1. Création d'un modèle UML contenant les classes détaillées (diagramme de classe) ainsi que les workflows (diagramme d'états-transitions)
2. Génération d'un squelette de produit à partir du modèle UML (la modification du modèle et la regénération est possible à tout moment, sans perte des éléments rajoutés manuellement)
3. Ajout dans le produit de modifications manuelles : contenu des méthodes, redéfinition de templates, écriture de tests...

Installation de l'outil de modélisation UML

L'outil recommandé est ArgoUML car ce dernier est utilisé par la communauté de développeurs ArchGenXML, en outre il s'agit évidemment d'un outil libre et très facile à installer...

• récupérer la dernière version d'ArgoUML (0.24 au 06/2008) sur http://argouml.tigris.org/
• comme il s'agit d'un outil de modélisation développé en Java, l'installation de JRE est nécessaire
• pour lancer ArgoUML il suffit d'exécuter argouml.jar ou d'utiliser les fichiers de commandes argouml.bat (Windows) ou argouml.sh (Linux)

Il est intéressant d'utiliser ArgoUML avec un profil adapté à Plone. Ce profil nommé "argouml_profile.xmi" se trouve sur le svn dans le produit ArchGenXML (voir point suivant).
ArgoUML doit alors être exécuté en utilisant le profil, avec une commande similaire à "java -Dargo.defaultModel=c:\software\devlpt\argouml_profile.xmi -jar argouml.jar".

Installation d'ArchGenXML2 (qui génère le code)

Idéalement, il faut utiliser une version stable (tags) proposée sur le Subversion Archetypes de Plone

• ArchGenXML devra être récupéré grâce à l'outil subversion (commande "svn"), il faut donc l'installer auparavant (voir le tutoriel subversion)
• récupérer la version à installer sur http://svn.plone.org/svn/archetypes/ArchGenXML.  Le répertoire de destination n'est pas important puisqu'ArchGenXML sera installé à un autre endroit par après.  Tapez par exemple "svn co http://svn.plone.org/svn/archetypes/ArchGenXML/tags/2.0/ ArchGenXML"
• après avoir récupéré ArchGenXML2, il faut maintenant l'installer.  Se positionner dans le dossier où a été récupéré ArchGenXML2 et taper "python setup.py install"
• ajoutez un fichier ".agx_zope_path" dans le dossier de l'utilisateur qui va exécuter archgenxml.  Ajoutez y le chemin complet vers un installation de Zope 2.10.X, par exemple /opt/Zope-2.10.6/lib/python

Mise en place de la structure du produit

Au sein d'une instance Zope-2.10.x avec un Plone 3.x

• dans le dossier /Products de l'instance, ajouter un dossier avec le nom du produit à créer (par exemple "MyProduct")
• créer un dossier /model dans le dossier du produit dans lequel le modèle UML sera stocké
• ajouter un fichier generate.conf dans le dossier /model qui contiendra les paramètres de configuration nécessaires à ArchGenXML (voir un exemple sur http://svn.communesplone.org/svn/communesplone/CPClassifiedAd/trunk/model/generate.conf)
• ajouter un fichier generate.sh qui contiendra la ligne de commande appelant ArchGenXML (plus simple que d'écrire la ligne de commande lors de chaque génération) :
  

  archgenxml --cfg generate.conf CPClassifiedAd.zargo -o ..

Génération du produit Archetypes

Dans le dossier du produit :

• sauvegarder le modèle UML dans le dossier /model du produit
• exécuter le fichier generate.sh en tapant "./generate.sh"
• le produit est alors généré et ArchGenXML nous affiche le déroulement dans un log à l'écran et nous prévient s'il y a eu un problème

Conclusion

Lorsque le produit est généré il peut déjà être testé dans l'interface de Plone.  ArchGenXML est un générateur de squelette de produit Archetypes.  Les profils, workflows et schemas seront générés entièrement depuis le modèle tandis que le corps des méthodes, les vues et autre fonctionnalités propres devront être complétées manuellement.
 

Les développeurs se rencontrent souvent pour travailler ensemble lors de sessions de développement.

Ce travail se fait souvent par binôme : deux développeurs travaillent autour d'une même machine.

Les avantages sont les suivants :

• échange rapide des connaissances entre développeurs
• vérification directe du code introduit : discussion sur la meilleure façon de faire
• connaissances partagées sur le code introduit