doc/book/en/A02b-components.en.txt
changeset 261 20d5eae54d57
parent 127 ae611743f5c6
child 262 170e0990b2d1
--- a/doc/book/en/A02b-components.en.txt	Mon Dec 22 17:35:07 2008 +0100
+++ b/doc/book/en/A02b-components.en.txt	Mon Dec 22 08:59:12 2008 -0800
@@ -1,26 +1,26 @@
 .. -*- coding: utf-8 -*-
 
-.. _components:
+.. _cubes:
 
-Components
-----------
+Cubes
+-----
 
-What is a component
-~~~~~~~~~~~~~~~~~~~
+What is a cube
+~~~~~~~~~~~~~~
 
-A component is a model grouping one or more entity types and/or views associated
+A cube is a model grouping one or more entity types and/or views associated
 in order to provide a specific feature or even a complete application using
-others components.
-You can decide to write your own set of components if you wish to re-use the 
-entity types you develop. By default, LAX comes with its owns set of components
+others cubes.
+You can decide to write your own set of cubes if you wish to re-use the 
+entity types you develop. By default, LAX comes with its owns set of cubes
 that you can start using right away.
 
 
 Standard library
 ~~~~~~~~~~~~~~~~
 
-A library of standard components is part of the `LAX` release (look at
-``lax/skel/ginco-apps``). Components provide entities and views. With
+A library of standard cubes is part of the `LAX` release (look at
+``lax/skel/ginco-apps``). Cubes provide entities and views. With
 ``lax-0.4``, you should get a set of application entities and system
 entities you can re-use.
 
@@ -28,48 +28,48 @@
 
 * addressbook: PhoneNumber and PostalAddress
 
-* ebasket: Basket (like a shopping cart)
+* basket: Basket (like a shopping cart)
 
-* eblog: Blog (a *very* basic blog)
+* blog: Blog (a *very* basic blog)
 
-* eclassfolder: Folder (to organize things but grouping them in folders)
+* classfolder: Folder (to organize things but grouping them in folders)
 
-* eclasstags: Tag (to tag anything)
+* classtags: Tag (to tag anything)
 
 
-* efile: File (to allow users to upload and store binary or text files)
+* file: File (to allow users to upload and store binary or text files)
 
-* elink: Link (to collect links to web resources)
+* link: Link (to collect links to web resources)
 
-* emailinglist: MailingList (to reference a mailing-list and the URLs
+* mailinglist: MailingList (to reference a mailing-list and the URLs
   for its archives and its admin interface)
 
-* eperson: Person (easily mixed with addressbook)
+* person: Person (easily mixed with addressbook)
 
-* etask: Task (something to be done between start and stop date)
+* task: Task (something to be done between start and stop date)
 
-* ezone: Zone (to define places within larger places, for example a
+* zone: Zone (to define places within larger places, for example a
   city in a state in a country)
 
 The available system entities are:
 
-* ecomment: Comment (to attach comment threads to entities)
+* comment: Comment (to attach comment threads to entities)
 
 
 
 Adding comments to BlogDemo
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To import a component in your application just change the line in the
+To import a cube in your application just change the line in the
 ``app.conf`` file. For example::
 
-    included-yams-components=ecomment
+    included-yams-cubes=ecomment
 
 will make the ``Comment`` entity available in your ``BlogDemo``
 application.
 
 Change the schema to add a relationship between ``BlogEntry`` and
-``Comment`` and you are done. Since the ecomment component defines the
+``Comment`` and you are done. Since the comment cube defines the
 ``comments`` relationship, adding the line::
 
     comments = ObjectRelation('Comment', cardinality='1*', composite='object')
@@ -78,13 +78,13 @@
 
 Clear the datastore and restart.
 
-Component structure
-~~~~~~~~~~~~~~~~~~~
+Cube structure
+~~~~~~~~~~~~~~
 
-A complex component is structured as follows:
+A complex  cube is structured as follows:
 ::
 
-  mycomponent/
+  mycube/
   |
   |-- schema.py
   |
@@ -111,7 +111,7 @@
 We can also define simple Python module instead of directories (packages), for example:
 ::
 
-  mycomponent/
+  mycube/
   |
   |-- entities.py
   |-- hooks.py
@@ -145,6 +145,6 @@
 
 [WRITE ME]
 
-* explain the component architecture
+* explain the cube architecture
 
-* add comments to the blog by importing the comments component
+* add comments to the blog by importing the comments cube