[Checkins] SVN: zope.browserpage/trunk/ Fix package description.

Dan Korostelev nadako at gmail.com
Mon Aug 24 12:29:59 EDT 2009


Log message for revision 103165:
  Fix package description.

Changed:
  U   zope.browserpage/trunk/README.txt
  U   zope.browserpage/trunk/setup.py

-=-
Modified: zope.browserpage/trunk/README.txt
===================================================================
--- zope.browserpage/trunk/README.txt	2009-08-24 16:24:29 UTC (rev 103164)
+++ zope.browserpage/trunk/README.txt	2009-08-24 16:29:58 UTC (rev 103165)
@@ -6,97 +6,13 @@
 chunk of the Zope Toolkit and its assumptions. It is maintained by the*
 `Zope Toolkit project <http://docs.zope.org/zopetoolkit/>`_.
 
-``zope.publisher`` is a general purpose object publishing framework
-which delegates to a publication object for determining the
-to-be-published object.  With Zope 3's default publication from
-``zope.app.publication``, this is usually a view or a resource.
+This package provides ZCML directives for configuring browser views.
+More specifically it defines the following ZCML directives:
 
-This package, ``zope.app.publisher``, provides base implementations
-for those.  It also provides ZCML directives for configuring views and
-resources.  More specifically, ``zope.app.publisher`` defines the
-following ZCML directives:
+ * browser:page
+ * browser:pages
+ * browser:view
 
-* browser:page
-
-* browser:pages
-
-* browser:view
-
-* browser:menu
-
-* browser:menuItem
-
-* browser:menuItems
-
-* browser:addMenuitem
-
-* browser:resource
-
-* browser:resourceDirectory
-
-* browser:defaultSkin
-
-* browser:icon
-
-* xmlrpc:view
-
-
-Views and Browser pages
-=======================
-
-XXX writeme
-
-
-Resources
-=========
-
-Resources are static files and directories that are served to the browser
-directly from the filesystem. The most common example are images, CSS style
-sheets, or JavaScript files.
-
-Resources are be registered under a symbolic name and can later be referred to
-by that name, so their usage is independent from their physical location.
-
-You can register a single file with the `<browser:resource>` directive, and a
-whole directory with the `<browser:resourceDirectory>` directive, for example
-
-  <browser:resource
-    directory="/path/to/static.file"
-    name="myfile"
-    />
-
-  <browser:resourceDirectory
-    directory="/path/to/images"
-    name="main-images"
-    />
-
-This causes a named adapter to be registered that adapts the request to
-zope.interface.Interface (XXX why do we not use an explicit interface?),
-so to later retrieve a resource, use
-`zope.component.getAdapter(request, name='myfile')`.
-
-There are two ways to traverse to a resource,
-
-1. with the 'empty' view on a site, e. g. `http://localhost/@@/myfile`
-   (This is declared by zope.app.publisher.browser)
-
-2. with the `++resource++` namespace, e. g. `http://localhost/++resource++myfile`
-   (This is declared by zope.traversing.namespace)
-
-In case of resource-directories traversal simply continues through its contents,
-e. g. `http://localhost/@@/main-images/subdir/sample.jpg`
-
-Rather than putting together the URL to a resource manually, you should use
-zope.traversing.browser.interfaces.IAbsoluteURL to get the URL, or for a
-shorthand, call the resource object. This has an additional benefit:
-
-If you want to serve resources from a different URL, for example
-because you want to use a web server specialized in serving static files instead
-of the appserver, you can register an IAbsoluteURL adapter for the site under
-the name 'resource' that will be used to compute the base URLs for resources.
-
-For example, if you register 'http://static.example.com/' as the base 'resource'
-URL, the resources from the above example would yield the following absolute
-URLs: http://static.example.com/myfile and
-http://static.example.com/main-images
-(XXX what about http://static.example.com/main-images/subdir/sample.jpg?)
+These directives also support menu item registration for pages, when
+``zope.browsermenu`` package is installed. Otherwise, they simply ignore
+the menu attribute.

Modified: zope.browserpage/trunk/setup.py
===================================================================
--- zope.browserpage/trunk/setup.py	2009-08-24 16:24:29 UTC (rev 103164)
+++ zope.browserpage/trunk/setup.py	2009-08-24 16:29:58 UTC (rev 103165)
@@ -31,8 +31,7 @@
                      'Topic :: Internet :: WWW/HTTP',
                      'Framework :: Zope3',
                      ],
-      description='Implementations and means for configuration of Zope 3-'
-                  'style views.',
+      description='ZCML directives for configuration browser views for Zope 3.',
       long_description=long_description,
 
       packages=find_packages('src'),



More information about the Checkins mailing list