Contenu du fichier de configuration principal

Le fichier buildout.cfg contient les paramètres qui seront utilisés pour installer les modules nécessaires.
Le texte affiché en gras correspond au contenu du fichier.
Les lignes précédées d'un # sont des lignes mises en commentaire.

Attention: veuillez noter que contenu indiqué ici est un exemple. Les buildouts récupérés sur le svn peuvent être différents !!

Ci-dessous une partie du fichier :

[buildout]

extends =
    xxx.cfg

Le paramètre optionnel "extends" permet d'inclure le contenu d'un autre fichier.

parts =
    plone
    zope2
    productdistros
    svnproducts
    omelette
    instance
    zopepy

Le paramètre "parts" décrit les différentes sections qui vont constituer la recette globale.
Les sections "plone" et "zope2" peuvent être désactivées dans certains cas.
Lors de la récupération des produits mentionnés dans le fichier de configuration, la plupart des sections définies dans "parts" correspondront à un sous-dossier créé dans le dossier parts sur le système de fichier.

eggs =
    elementtree
    appy.pod
    appy.shared

Le paramètre "eggs" permet de définir les produits python disponibles sous forme d'oeufs à partir du site http://pypi.python.org.

[productdistros]
recipe = plone.recipe.distros
urls =
    http://plone.org/products/atgooglemaps/releases/0.5.2/ATGoogleMaps-0.5.2.tar.gz
    http://plone.org/products/clouseau/releases/0.8.1/clouseau-0-8-1.zip
    http://www.zope.org/Members/shh/DocFinderTab/1.0.2/DocFinderTab-1.0.2.tar.gz
    http://plone.org/products/ploneformgen/releases/1.2.3/pfg-1-2-3-scriptablefields-1-1-1.tgz
...
nested-packages =
    pfg-1-2-3-scriptablefields-1-1-1.tgz

La section "productdistros" contient les produits Plone à télécharger sous forme de fichier distribuable (compressé). 

[svnproducts]
recipe = infrae.subversion
urls =
    http://svn.plone.org/svn/collective/ATPhoto/trunk ATPhoto
    http://svn.plone.org/svn/collective/CMFSin/trunk CMFSin
    http://svn.communesplone.org/svn/communesplone/contacts/trunk contacts
    http://svn.communesplone.org/svn/communesplone/Container/trunk Container
...

La section "svnproducts" contient les produits Plone à télécharger à partir d'un repository subversion.

[omelette]
recipe = collective.recipe.omelette
eggs = ${instance:eggs}
products = ${instance:products}

La section "omelette" permet de rassembler dans le dossier parts/omelette les différents produits Plone récupérés par différentes méthodes. En fait ce dossier contiendra des liens vers les produits se trouvant dans d'autres dossiers.

[instance]
...

#effective-user =
user = admin:admin
http-address = 8080
#debug-mode = on
verbose-security = on
zope-conf-additional =
     %include ${buildout:directory}/zope_add.conf

La section "instance" contient des paramètres relatifs à l'instance zope qui sera créée.

Le paramètre "effective-user" permet d'indiquer un nom d'utilisateur qui sera utilisé pour exécuter le serveur. 
Le paramètre "user" permet d'indiquer un nom d'utilisateur admin et son mot de passe. Ce dernier peut être changé une fois l'instance créée.
Le paramètre "http-address" indique le port utilisé pour accéder au serveur web.
Le paramètre "zope-conf-additional" permet d'indiquer des lignes complémentaires qui seront rajoutées au fichier de configuration principal "parts/instance/etc/zope.conf". Dans notre cas, la ligne %include permet d'indiquer un nom de sous-fichier qui sera inclu dans le fichier zope.conf.