[Commits] python.it commit r202 - twisted/trunk/contrib/nevow/doc/txt

Sab 29 Lug 2006 13:04:32 CEST

Author: manlio
Date: Sat Jul 29 13:04:13 2006
New Revision: 202

Added:
   twisted/trunk/contrib/nevow/doc/txt/nevow-caching.txt   (contents, props changed)
   twisted/trunk/contrib/nevow/doc/txt/nevow-ssl.txt   (contents, props changed)
   twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates-dummies.txt   (contents, props changed)
Modified:
   twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates.txt
Log:
aggiunta documentazione e segnaposti

Added: twisted/trunk/contrib/nevow/doc/txt/nevow-caching.txt
==============================================================================

--- (empty file)
+++ twisted/trunk/contrib/nevow/doc/txt/nevow-caching.txt	Sat Jul 29 13:04:13 2006
@@ -0,0 +1,13 @@
+Caching
+=======
+
+Cache handling in Nevow.
+
+TODO
+
+* describe default support for cache (HTTP Validators, ETag and
+  Last-Modified).
+* describe advanced caching support
+* how to cache dynamic content?
+
+see the tutorial on http://www.mnot.net/cache_docs/

Added: twisted/trunk/contrib/nevow/doc/txt/nevow-ssl.txt
==============================================================================
--- (empty file)
+++ twisted/trunk/contrib/nevow/doc/txt/nevow-ssl.txt	Sat Jul 29 13:04:13 2006
@@ -0,0 +1,8 @@
+How to setup SSL with Nevow
+===========================
+
+XXX documentation stolen from the PostgreSQL book.
+
+
+TODO
+

Added: twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates-dummies.txt
==============================================================================
--- (empty file)
+++ twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates-dummies.txt	Sat Jul 29 13:04:13 2006
@@ -0,0 +1,8 @@
+Nevow XML Templates for Dummies (aka HTML monkey)
+=================================================
+
+This document explain the Nevow XML Template in terms of XML elements
+and DOM.
+
+XXX TODO.
+

Modified: twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates.txt
==============================================================================
--- twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates.txt	(original)
+++ twisted/trunk/contrib/nevow/doc/txt/nevow-xml-templates.txt	Sat Jul 29 13:04:13 2006
@@ -17,6 +17,7 @@
 * `nevow:pattern`_
 * `nevow:slot`_
 * `nevow:attr`_
+* `nevow:invisible`_
 * `xmlstr, htmlfile, and htmlstr`_
 
 loaders.xmlfile
@@ -236,6 +237,34 @@
 attribute may be used inside the nevow:attr node. This makes setting attributes
 of tags uniform with every other method of manipulating the XML template.
 
+nevow:invisible
+---------------
+
+Sometimes you need to group some elements, because you need to use a
+renderer for a group of children.
+
+However this elements are not related in your XML structure.
+
+In this cases, use nevow:invisible.
+
+As suggested by the name, a nevow:invisible tag is removed in the
+rendered XML. Here is an example::
+ 
+  <html><nevow:invisible nevow:data="name" nevow:render="data" /></html>
+
+With the data_name method::
+
+  def data_name(self, ctx, data):
+      return "Hello!"
+
+Will result in the document::
+
+ <html>Hello!</hyml>
+
+Of course a more interesting example is when you need to use
+nevow:pattern and nevow:slot.
+  
+  
 xmlstr, htmlfile, and htmlstr
 -----------------------------
 
