# HG changeset patch # User Sandrine Ribeau # Date 1230149861 28800 # Node ID a21688a55d211dda2acf93860d27a2ac2b391ff8 # Parent 2d9e83c34b23def0901411d46c2c4ee6b190213c [doc] Move out from tutoriel RSS and CSS to make it independant chapters. Adds a conclusion to the tutorial. diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/A020-tutorial.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 diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/A02c-maintemplate.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'
') self.w(u'This website has been created with LAX.') @@ -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. - - - - diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/A02d-conclusion.en.txt --- /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. + diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/A030-foundation.en.txt --- 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_. diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/B1-web-interface.en.txt --- 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 diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/B1120-urlrewrite.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] diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/B1130-css.en.txt --- /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. diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/B2020-hooks.en.txt --- 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 ===== diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/B4-advanced.en.txt --- 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 diff -r 2d9e83c34b23 -r a21688a55d21 doc/book/en/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 + +