# HG changeset patch # User Nicolas Chauvat # Date 1226961420 -3600 # Node ID 7fd4ffeb082baefc8a0fe26fca074bcf9ec3c8dd # Parent 1524656026b061038409f7da09fbd1b5aa01eddf [doc] images were renamed and table of content changed diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/advanced_notes.fr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/book/fr/advanced_notes.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -0,0 +1,6 @@ +.. -*- coding: utf-8 -*- + +La différence entre la classe `AppRsetObject` et la classe `AppObject` est que +les instances de la premières sont séléctionnées pour une requête et un "result +set" et alors que les secondes ne sont séléctionnées qu'en fonction de leur +identifiant. diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/advanced_notes.txt --- a/doc/book/fr/advanced_notes.txt Mon Nov 17 23:10:02 2008 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,6 +0,0 @@ -.. -*- coding: utf-8 -*- - -La différence entre la classe `AppRsetObject` et la classe `AppObject` est que -les instances de la premières sont séléctionnées pour une requête et un "result -set" et alors que les secondes ne sont séléctionnées qu'en fonction de leur -identifiant. diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/chap_definition_workflows.txt --- a/doc/book/fr/chap_definition_workflows.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/chap_definition_workflows.txt Mon Nov 17 23:37:00 2008 +0100 @@ -143,7 +143,7 @@ can be applied, the target state of the transition, and the permissions (e.g. list of the groups of users who can apply the transition). -.. image:: images/lax-book.03-transitions-view.en.png +.. image:: images/lax-book.03-transitions-view.fr.png You can now notice that in the actions box of a BlogEntry, the state is now listed as well as the possible transitions from this state diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/chap_site_configuration.txt --- a/doc/book/fr/chap_site_configuration.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/chap_site_configuration.txt Mon Nov 17 23:37:00 2008 +0100 @@ -3,7 +3,7 @@ Interface de configuration du site ================================== -.. image:: images/lax-book.03-site-config-panel.en.png +.. image:: images/lax-book.03-site-config-panel.fr.png This panel allows you to configure the appearance of your application site. Six menus are available and we will go through each of them to explain how diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/chap_visualisation_donnees.txt --- a/doc/book/fr/chap_visualisation_donnees.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/chap_visualisation_donnees.txt Mon Nov 17 23:37:00 2008 +0100 @@ -102,7 +102,7 @@ When displaying same blog entry as before, you will notice that the page is now looking much nicer. -.. image:: images/lax-book.09-new-view-blogentry.en.png +.. image:: images/lax-book.09-new-view-blogentry.fr.png :alt: blog entries now look much nicer Let us now improve the primary view of a blog :: @@ -139,7 +139,7 @@ Assuming we added entries to the blog titled `MyLife`, displaying it now allows to read its description and all its entries. -.. image:: images/lax-book.10-blog-with-two-entries.en.png +.. image:: images/lax-book.10-blog-with-two-entries.fr.png :alt: a blog and all its entries **Before we move forward, remember that the selection/view principle is diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/faq.fr.txt --- a/doc/book/fr/faq.fr.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/faq.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -20,10 +20,6 @@ s'applique. Il faut donc bien reflechir avant de decider de l'un ou de l'autre, mais vous avez la possibilite de choisir. - -HOW TO -====== - * Comment mettre à jour une base de données après avoir modifié le schéma? Cela dépend de ce qui a été modifié dans le schéma. diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/gae.fr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/book/fr/gae.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -0,0 +1,20 @@ +.. -*- coding: utf-8 -*- + +.. _contents: + +========================== +Google AppEngine Datastore +========================== + + +.. include:: 01-intro.fr.txt +.. include:: 02-install.fr.txt +.. include:: 03-create-app.fr.txt +.. include:: 04-develop-views.fr.txt +.. include:: 05-components.fr.txt +.. include:: 06-maintemplate.fr.txt +.. include:: 07-rss-xml.fr.txt +.. include:: 08-rql.fr.txt +.. include:: 09-urlrewrite.fr.txt +.. include:: 10-security.fr.txt +.. include:: 11-faq.fr.txt diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/gae.txt --- a/doc/book/fr/gae.txt Mon Nov 17 23:10:02 2008 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,20 +0,0 @@ -.. -*- coding: utf-8 -*- - -.. _contents: - -========================== -Google AppEngine Datastore -========================== - - -.. include:: 01-intro.fr.txt -.. include:: 02-install.fr.txt -.. include:: 03-create-app.fr.txt -.. include:: 04-develop-views.fr.txt -.. include:: 05-components.fr.txt -.. include:: 06-maintemplate.fr.txt -.. include:: 07-rss-xml.fr.txt -.. include:: 08-rql.fr.txt -.. include:: 09-urlrewrite.fr.txt -.. include:: 10-security.fr.txt -.. include:: 11-faq.fr.txt diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/index-content.fr.txt --- a/doc/book/fr/index-content.fr.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/index-content.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -25,9 +25,9 @@ chap_migration.txt chap_tests.txt chap_i18n.txt - gae.txt - references.txt + gae.fr.txt + references.fr.txt + faq.fr.txt - diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/index.txt --- a/doc/book/fr/index.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/index.txt Mon Nov 17 23:37:00 2008 +0100 @@ -36,15 +36,6 @@ index-content.fr.txt - -FAQ -=== -.. toctree:: - :maxdepth: 1 - - faq.fr.txt - - Indices and tables ================== diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/introduction.fr.txt --- a/doc/book/fr/introduction.fr.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/introduction.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -182,7 +182,7 @@ puis validez le formulaire d'édition en cliquant sur le bouton ``Validate``. -.. image:: images/cbw-create-blog.en.png +.. image:: images/cbw-create-blog.fr.png :alt: from to create blog En cliquant sur le logo situé dans le coin gauche de la fenêtre, @@ -190,7 +190,7 @@ sur le lien Blog, vous devriez voir la liste des entités Blog, en particulier celui que vous venez juste de créer ``Tech-Blog``. -.. image:: images/cbw-list-one-blog.en.png +.. image:: images/cbw-list-one-blog.fr.png :alt: displaying a list of a single blog Si vous cliquez sur ``Tech-Blog`` vous devriez obtenir une description @@ -201,7 +201,7 @@ Blog ``MyLife`` et retournons sur la page d'accueil, puis suivons le lien Blog et nous constatons qu'à présent deux blogs sont listés. -.. image:: images/cbw-list-two-blog.en.png +.. image:: images/cbw-list-two-blog.fr.png :alt: displaying a list of two blogs Créons un article @@ -221,14 +221,14 @@ Vous auriez pu aussi, au moment où vous avez crée votre article, sélectionner ``appliquer`` au lieu de ``valider`` et le menu ``ajouter relation`` serait apparu. -.. image:: images/cbw-add-relation-entryof.en.png +.. image:: images/cbw-add-relation-entryof.fr.png :alt: editing a blog entry to add a relation to a blog Validez vos modifications en cliquant sur ``Valider``. L'entité article qui est listée contient maintenant un lien vers le Blog auquel il appartient, ``MyLife``. -.. image:: images/cbw-detail-one-blogentry.en.png +.. image:: images/cbw-detail-one-blogentry.fr.png :alt: displaying the detailed view of a blogentry Rappelez-vous que pour le moment, tout a été géré par la plate-forme @@ -237,7 +237,7 @@ le lien `Application schema`` a l'URL suivante : http://localhost:8080/view?vid=schema -.. image:: images/cbw-schema.en.png +.. image:: images/cbw-schema.fr.png :alt: graphical view of the schema (aka data-model) @@ -324,7 +324,7 @@ Nous pouvons voir que la date de publication est préfixée comme souhaitée. -.. image:: images/cbw-update-primary-view.en.png +.. image:: images/cbw-update-primary-view.fr.png :alt: modified primary view diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/querier.fr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/book/fr/querier.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -0,0 +1,62 @@ +.. -*- coding: utf-8 -*- + +Déroulement de l'éxecution d'une requête en multi-source avec insertion de sécurité +``````````````````````````````````````````````````````````````````````````````````` + +* 3 sources (system, ldap (Euser) et rql (Card) +* permission en lecture Card is elle appartient à l'utilisateur + +Soit la requête de départ: :: + + Any X,T WHERE X owned_by U, U login "syt", X title T + +1. récupération arbre de syntaxe et solution (+cache) :: + + -> {X: Card, U: Euser}, {X: Blog, U: Euser}, {X: Bookmark, U: Euser} + +2. insertion sécurité :: + + -> Any X,T WHERE X owned_by U, U login "syt", X title T, EXISTS(X owned_by UEID) / {X: Card, U: Euser} + Any X,T WHERE X owned_by U, U login "syt", X title T / {X: Blog, U: Euser}, {X: Bookmark, U: Euser} + +3. construction plan + 0. preprocessing (annotation des arbres de syntaxe) + + 1. Any U WHERE U login "syt" / {U: Euser} + [system+ldap] => table1/varmap1{U:U2} + + 2. Any X,T WHERE X owned_by U2, X title T / {X: Blog, U: Euser}, {X: Bookmark, U: Euser} + [varmap1|system] => TABLE2 + + 3 Deux alernatives: + + 1. Any X,T WHERE X is Card, X title T {X: Card} :: + + [system+rql] => table3/varmap3{X:X3, T:T3} + + Any X3,T3 WHERE X3 owned_by U2, X3 title T3, EXISTS(X owned_by UEID) / {X3: Card, U2: Euser} :: + + [(varmap1, varmap3)|system] => TABLE2 + + 2 Any X WHERE X is Card X owned_by U2, EXISTS(X owned_by UEID) / {X: Card, U2: Euser} :: + + [varmap1|system] => EIDS + + Any X,T WHERE X title T, X eid IN(EIDS) {X: Card} :: + + [system+rql] => TABLE2 + + 4. renvoie contenu TABLE2. + Note : si aggrégat / tri / distinct TABLE2 est nécessairement une table temporaire et besoin d'une + étape AggrStep supplémentaire + +4. éxécution du plan + +5. [construction description] + +6. renvoie ResultSet + +Notes sur UNION +``````````````` + +* en multi-sources, les résultats des unions peuvent être mélangés diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/querier.txt --- a/doc/book/fr/querier.txt Mon Nov 17 23:10:02 2008 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,62 +0,0 @@ -.. -*- coding: utf-8 -*- - -Déroulement de l'éxecution d'une requête en multi-source avec insertion de sécurité -``````````````````````````````````````````````````````````````````````````````````` - -* 3 sources (system, ldap (Euser) et rql (Card) -* permission en lecture Card is elle appartient à l'utilisateur - -Soit la requête de départ: :: - - Any X,T WHERE X owned_by U, U login "syt", X title T - -1. récupération arbre de syntaxe et solution (+cache) :: - - -> {X: Card, U: Euser}, {X: Blog, U: Euser}, {X: Bookmark, U: Euser} - -2. insertion sécurité :: - - -> Any X,T WHERE X owned_by U, U login "syt", X title T, EXISTS(X owned_by UEID) / {X: Card, U: Euser} - Any X,T WHERE X owned_by U, U login "syt", X title T / {X: Blog, U: Euser}, {X: Bookmark, U: Euser} - -3. construction plan - 0. preprocessing (annotation des arbres de syntaxe) - - 1. Any U WHERE U login "syt" / {U: Euser} - [system+ldap] => table1/varmap1{U:U2} - - 2. Any X,T WHERE X owned_by U2, X title T / {X: Blog, U: Euser}, {X: Bookmark, U: Euser} - [varmap1|system] => TABLE2 - - 3 Deux alernatives: - - 1. Any X,T WHERE X is Card, X title T {X: Card} :: - - [system+rql] => table3/varmap3{X:X3, T:T3} - - Any X3,T3 WHERE X3 owned_by U2, X3 title T3, EXISTS(X owned_by UEID) / {X3: Card, U2: Euser} :: - - [(varmap1, varmap3)|system] => TABLE2 - - 2 Any X WHERE X is Card X owned_by U2, EXISTS(X owned_by UEID) / {X: Card, U2: Euser} :: - - [varmap1|system] => EIDS - - Any X,T WHERE X title T, X eid IN(EIDS) {X: Card} :: - - [system+rql] => TABLE2 - - 4. renvoie contenu TABLE2. - Note : si aggrégat / tri / distinct TABLE2 est nécessairement une table temporaire et besoin d'une - étape AggrStep supplémentaire - -4. éxécution du plan - -5. [construction description] - -6. renvoie ResultSet - -Notes sur UNION -``````````````` - -* en multi-sources, les résultats des unions peuvent être mélangés diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/references.fr.txt --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/doc/book/fr/references.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -0,0 +1,22 @@ +.. -*- coding: utf-8 -*- + +.. _contents: + +Références +========== + +Détails d'implémentations +------------------------- +.. toctree:: + :maxdepth: 1 + + ../cubicweb-uml.txt + +Détail sur l'éxécution d'une requête complexe en multi-sources +-------------------------------------------------------------- + +.. toctree:: + :maxdepth: 1 + + ../querier.txt + diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/references.txt --- a/doc/book/fr/references.txt Mon Nov 17 23:10:02 2008 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,22 +0,0 @@ -.. -*- coding: utf-8 -*- - -.. _contents: - -Références -========== - -Détails d'implémentations -------------------------- -.. toctree:: - :maxdepth: 1 - - ../cubicweb-uml.txt - -Détail sur l'éxécution d'une requête complexe en multi-sources --------------------------------------------------------------- - -.. toctree:: - :maxdepth: 1 - - ../querier.txt - diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/tut-create-app.fr.txt --- a/doc/book/fr/tut-create-app.fr.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/tut-create-app.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -83,7 +83,7 @@ and point your browser at http://localhost:8080/ (if it is easier for you, use the on-line demo at http://lax.appspot.com/). -.. image:: images/lax-book.00-login.en.png +.. image:: images/lax-book.00-login.fr.png :alt: login screen After you log in, you will see the home page of your application. It @@ -92,7 +92,7 @@ internationalization (i18n) is not working for you yet. Please ignore this for now. -.. image:: images/lax-book.01-start.en.png +.. image:: images/lax-book.01-start.fr.png :alt: home page Creating system entities @@ -115,7 +115,7 @@ ``everything about technology`` as the description, then validate the form by clicking on ``Validate``. -.. image:: images/lax-book.02-create-blog.en.png +.. image:: images/lax-book.02-create-blog.fr.png :alt: from to create blog Click on the logo at top left to get back to the home page, then @@ -123,14 +123,14 @@ You should be seeing a list with a single item ``Tech-blog`` you just created. -.. image:: images/lax-book.03-list-one-blog.en.png +.. image:: images/lax-book.03-list-one-blog.fr.png :alt: displaying a list of a single blog Clicking on this item will get you to its detailed description except that in this case, there is not much to display besides the name and the phrase ``everything about technology``. -.. image:: images/lax-book.04-detail-one-blog.en.png +.. image:: images/lax-book.04-detail-one-blog.fr.png :alt: displaying the detailed view of a blog Now get back to the home page by clicking on the top-left logo, then @@ -138,7 +138,7 @@ again to follow the Blog link for the second time. The list now has two items. -.. image:: images/lax-book.05-list-two-blog.en.png +.. image:: images/lax-book.05-list-two-blog.fr.png :alt: displaying a list of two blogs @@ -159,14 +159,14 @@ new entity BlogEntry, hit ``Apply`` instead of ``Validate`` and the combobox titled ``add relation`` would have showed up. -.. image:: images/lax-book.06-add-relation-entryof.en.png +.. image:: images/lax-book.06-add-relation-entryof.fr.png :alt: editing a blog entry to add a relation to a blog Validate the changes by clicking ``Validate``. The entity BlogEntry that is displayed now includes a link to the entity Blog named ``MyLife``. -.. image:: images/lax-book.07-detail-one-blogentry.en.png +.. image:: images/lax-book.07-detail-one-blogentry.fr.png :alt: displaying the detailed view of a blogentry Remember that all of this was handled by the framework and that the @@ -175,13 +175,13 @@ explained in the installation section and point your browser to the URL http://localhost:8080/schema -.. image:: images/lax-book.08-schema.en.png +.. image:: images/lax-book.08-schema.fr.png :alt: graphical view of the schema (aka data-model) Site configuration ------------------ -.. image:: images/lax-book.03-site-config-panel.en.png +.. image:: images/lax-book.03-site-config-panel.fr.png This panel allows you to configure the appearance of your application site. Six menus are available and we will go through each of them to explain how @@ -357,7 +357,7 @@ can be applied, the target state of the transition, and the permissions (e.g. list of the groups of users who can apply the transition). -.. image:: images/lax-book.03-transitions-view.en.png +.. image:: images/lax-book.03-transitions-view.fr.png You can now notice that in the actions box of a BlogEntry, the state is now listed as well as the possible transitions from this state diff -r 1524656026b0 -r 7fd4ffeb082b doc/book/fr/tut-create-gae-app.fr.txt --- a/doc/book/fr/tut-create-gae-app.fr.txt Mon Nov 17 23:10:02 2008 +0100 +++ b/doc/book/fr/tut-create-gae-app.fr.txt Mon Nov 17 23:37:00 2008 +0100 @@ -90,7 +90,7 @@ vous pouvez utiliser la démo en ligne http://lax.appspot.com/). [FIXME] -- changer la demo en ligne en quelque chose qui marche (!) -.. image:: images/lax-book.00-login.en.png +.. image:: images/lax-book.00-login.fr.png :alt: login screen Après vous être authentifié, vous arrivez sur la page d'accueil de votre @@ -99,7 +99,7 @@ et ``blogentry_plural`` cela signifie que l'internationalisation (i18n) n'a pas encore fonctionné. Ignorez cela pour le moment. -.. image:: images/lax-book.01-start.en.png +.. image:: images/lax-book.01-start.fr.png :alt: home page Créez des entités système @@ -126,7 +126,7 @@ ``Validate``. -.. image:: images/lax-book.02-create-blog.en.png +.. image:: images/lax-book.02-create-blog.fr.png :alt: from to create blog En cliquant sur le logo situé dans le coin gauche de la fenêtre, @@ -134,7 +134,7 @@ sur le lien Blog, vous devriez voir la liste des entités Blog, en particulier celui que vous venez juste de créer ``Tech-Blog``. -.. image:: images/lax-book.03-list-one-blog.en.png +.. image:: images/lax-book.03-list-one-blog.fr.png :alt: displaying a list of a single blog Si vous cliquez sur ``Tech-Blog`` vous devriez obtenir une description @@ -142,14 +142,14 @@ et la phrase ``everything about technology`` -.. image:: images/lax-book.04-detail-one-blog.en.png +.. image:: images/lax-book.04-detail-one-blog.fr.png :alt: displaying the detailed view of a blog Maintenant retournons sur la page d'accueil et créons un nouveau Blog ``MyLife`` et retournons sur la page d'accueil, puis suivons le lien Blog et nous constatons qu'à présent deux blogs sont listés. -.. image:: images/lax-book.05-list-two-blog.en.png +.. image:: images/lax-book.05-list-two-blog.fr.png :alt: displaying a list of two blogs Créons un article @@ -169,14 +169,14 @@ Vous auriez pu aussi, au moment où vous avez crée votre article, sélectionner ``appliquer`` au lieu de ``valider`` et le menu ``ajouter relation`` serait apparu. -.. image:: images/lax-book.06-add-relation-entryof.en.png +.. image:: images/lax-book.06-add-relation-entryof.fr.png :alt: editing a blog entry to add a relation to a blog Validez vos modifications en cliquant sur ``Valider``. L'entité article qui est listée contient maintenant un lien vers le Blog auquel il appartient, ``MyLife``. -.. image:: images/lax-book.07-detail-one-blogentry.en.png +.. image:: images/lax-book.07-detail-one-blogentry.fr.png :alt: displaying the detailed view of a blogentry Rappelez-vous que pour le moment, tout a été géré par la plate-forme @@ -185,7 +185,7 @@ la commande ``laxctl genschema blogdemo`` et vous pourrez visualiser votre schéma a l'URL suivante : http://localhost:8080/schema -.. image:: images/lax-book.08-schema.en.png +.. image:: images/lax-book.08-schema.fr.png :alt: graphical view of the schema (aka data-model)