[doc] Move out from tutoriel RSS and CSS to make it independant chapters. Adds a conclusion to the tutorial.
--- 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
+
+