[doc] Move out from tutoriel RSS and CSS to make it independant chapters. Adds a conclusion to the tutorial.
authorSandrine Ribeau <sandrine.ribeau@logilab.fr>
Wed, 24 Dec 2008 12:17:41 -0800
changeset 293 a21688a55d21
parent 292 2d9e83c34b23
child 294 6bfc384eecf0
[doc] Move out from tutoriel RSS and CSS to make it independant chapters. Adds a conclusion to the tutorial.
doc/book/en/A020-tutorial.en.txt
doc/book/en/A02c-maintemplate.en.txt
doc/book/en/A02d-conclusion.en.txt
doc/book/en/A030-foundation.en.txt
doc/book/en/B1-web-interface.en.txt
doc/book/en/B1120-urlrewrite.en.txt
doc/book/en/B1130-css.en.txt
doc/book/en/B2020-hooks.en.txt
doc/book/en/B4-advanced.en.txt
doc/book/en/B4040-rss-xml.en.txt
--- a/doc/book/en/A020-tutorial.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/A020-tutorial.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -23,4 +23,4 @@
 .. include:: A02a-create-cube.en.txt
 .. include:: A02b-components.en.txt
 .. include:: A02c-maintemplate.en.txt
-.. include:: A02d-rss-xml.en.txt
+.. include:: A02d-conclusion.en.txt
--- a/doc/book/en/A02c-maintemplate.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/A02c-maintemplate.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -87,11 +87,12 @@
 ````````````````
 
 If you want to change the footer for example, look
-for HTMLPageFooter and override it in your views file as in: 
-::
+for HTMLPageFooter and override it in your views file as in: ::
 
-  form ginco.web.views.basetemplates import HTMLPageFooter
+  from cubicweb.web.views.basetemplates import HTMLPageFooter
+
   class MyHTMLPageFooter(HTMLPageFooter):
+
       def call(self, **kwargs):
           self.w(u'<div class="footer">')
           self.w(u'This website has been created with <a href="http://lax.logilab.org">LAX</a>.')
@@ -123,21 +124,4 @@
 
 * customize MainTemplate and show that everything in the user
   interface can be changed
-* Add login menu in left column ?
 
-CSS changes
-~~~~~~~~~~~
-
-We cannot modify the order in which the application is reading the CSS. In
-the case we want to create new CSS style, the best is to define it a in a new
-CSS located under ``myapp/data/`` and use those new styles while writing
-customized views and templates.
-
-If you want to modify an existing CSS styling property, you will have to use
-``!important`` declaration to override the existing property. The application
-apply a higher priority on the default CSS and you can not change that. 
-Customized CSS will not be read first.
-
-
-
-
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/book/en/A02d-conclusion.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -0,0 +1,17 @@
+.. -*- coding: utf-8 -*-
+
+What's next?
+------------
+
+We demonstrated how from a straight out of the box `CubicWeb`
+installation, you can build your web-application based on a
+schema. It's all already there: views, templates, permissions,
+etc. The step forward is now for you to customize according
+to your needs.
+
+More than a web application, many features are available to
+extend your application, for example: RSS channel integration 
+(:ref:`rss`), hooks (:ref:`hooks`), support of sources such as 
+Google App Engine (:ref:`gaecontents`) and lots of others to 
+discover through our book.
+
--- a/doc/book/en/A030-foundation.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/A030-foundation.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -24,7 +24,9 @@
 public phone directory (see http://www.118000.fr/), a system for managing 
 digital studies and simulations for a research lab, a tool for shared children
 babysitting (see http://garde-partagee.atoukontact.fr/), a tool to manage
-software developpment (see http://www.logilab.org), etc.
+software developpment (see http://www.logilab.org), an application for
+managing museums collections (see 
+http://collections.musees-haute-normandie.fr/collections/), etc.
 
 In 2008, `CubicWeb` was ported for a new type of source : the datastore 
 from GoogleAppEngine_.
--- a/doc/book/en/B1-web-interface.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/B1-web-interface.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -17,3 +17,4 @@
    B1100-online-doc.en.txt
    B1110-embedding-external-page.en.txt
    B1120-urlrewrite.en.txt
+   B1130-css.en.txt
--- a/doc/book/en/B1120-urlrewrite.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/B1120-urlrewrite.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -3,7 +3,6 @@
 URL Rewriting
 =============
 
-XXX FIXME this should be a chapter
 
 [WRITE ME]
 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/book/en/B1130-css.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -0,0 +1,16 @@
+.. -*- coding: utf-8 -*-
+
+CSS changes
+===========
+
+XXX FIXME explain CSS used by cubciweb
+
+We cannot modify the order in which the application is reading the CSS. In
+the case we want to create new CSS style, the best is to define it a in a new
+CSS located under ``myapp/data/`` and use those new styles while writing
+customized views and templates.
+
+If you want to modify an existing CSS styling property, you will have to use
+``!important`` declaration to override the existing property. The application
+apply a higher priority on the default CSS and you can not change that. 
+Customized CSS will not be read first.
--- a/doc/book/en/B2020-hooks.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/B2020-hooks.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -1,5 +1,7 @@
 .. -*- coding: utf-8 -*-
 
+.. _hooks:
+
 Hooks
 =====
 
--- a/doc/book/en/B4-advanced.en.txt	Tue Dec 23 13:50:56 2008 -0800
+++ b/doc/book/en/B4-advanced.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -8,4 +8,4 @@
    B4010-configuration.en.txt
    B4020-dbapi.en.txt
    B4030-registry.en.txt
-
+   B4040-rss-xml.en.txt 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/book/en/B4040-rss-xml.en.txt	Wed Dec 24 12:17:41 2008 -0800
@@ -0,0 +1,48 @@
+.. -*- coding: utf-8 -*-
+
+.. _rss:
+
+RSS Channel
+-----------
+
+Assuming you have several blog entries, click on the title of the
+search box in the left column. A larger search box should appear. Enter::
+
+   Any X ORDERBY D WHERE X is BlogEntry, X creation_date D
+
+and you get a list of blog entries.
+
+Click on your login at the top right corner. Chose "user preferences",
+then "boxes", then "possible views box" and check "visible = yes"
+before validating your changes.
+
+Enter the same query in the search box and you will see the same list,
+plus a box titled "possible views" in the left column. Click on
+"entityview", then "RSS". 
+
+You just applied the "RSS" view to the RQL selection you requested.
+
+That's it, you have a RSS channel for your blog.
+
+Try again with::
+
+    Any X ORDERBY D WHERE X is BlogEntry, X creation_date D, 
+    X entry_of B, B title "MyLife"
+
+Another RSS channel, but a bit more focused.
+
+A last one for the road::
+
+    Any C ORDERBY D WHERE C is Comment, C creation_date D LIMIT 15
+    
+displayed with the RSS view, that's a channel for the last fifteen
+comments posted.
+
+[WRITE ME]
+
+* show that the RSS view can be used to display an ordered selection
+  of blog entries, thus providing a RSS channel
+
+* show that a different selection (by category) means a different channel
+
+