Fondements CubicWeb
================

Concepts et vocabulaire
-----------------------

*schéma*
  le schéma définit le modèle de données d'une application sous forme d'entités
  et de relations, grâce au package `yams`_. C'est l'élément central d'une
  application. Il est initialement défini sur le système de fichiers et est
  stocké dans la base de données lors de la création d'une instance. CubicWeb 
  fournit un certain nombres de types d'entités inclus systématiquement 
  car nécessaire au noyau CubicWeb et une librairie de composants devant être
  inclus explicitement le cas échéant.

*source*
  une source de données est un conteneur de données quelquonque (SGBD, annuaire
  LDAP...) intégré par l'entrepôt CubicWeb. Un entrepôt possède au moins une source
  dite "system" contenant le schéma de l'application, l'index plein-texte et
  d'autres informations vitales au système.

*composant*
  un composant est un modèle regroupant un ou plusieurs types de données et/ou
  des vues afin de fournir une fonctionalité précise, ou une application CubicWeb
  complète utilisant éventuellement d'autres composants. Les différents
  composants disponibles sur une machine sont installés dans
  `/usr/share/cubicweb/templates`

*result set*
  objet encaspulant les résultats d'une requête RQL et des informations sur
  cette requête.

.. _`Python Remote Object`: http://pyro.sourceforge.net/
.. _`yams`: http://www.logilab.org/project/name/yams/


Structure générale d'une application LAX
----------------------------------------

Un composant complexe est structuré selon le modèle suivant :

::
    
  .
  |-- app.yaml
  |-- custom.py
  |-- data
  |-- cubicweb/
  |-- i18n/
  |-- logilab/
  |-- main.py
  |-- mx/
  |-- rql/
  |-- schema.py
  |-- simplejson/
  |-- tools/
  |   |-- generate_schema_img.py
  |   `-- i18ncompile.py
  |-- views.py
  |-- yams/
  `-- yapps/
        

où :

* ``schema.py`` contient la définition du schéma
* ``views.py`` contient les définitions des vues
* ``i18n`` contient les catalogues de messages pour les langues supportées (coté
  serveur et interface web) 
* ``data`` contient des fichiers de données arbitraires servis statiquement
  (images, css, fichiers javascripts)... (coté interface web uniquement)