X-Git-Url: http://g0dil.de/git?a=blobdiff_plain;f=src%2Fkoehsel.theme%2Fkoehsel%2Ftheme%2Fbrowser%2Fimages%2FREADME.txt;fp=src%2Fkoehsel.theme%2Fkoehsel%2Ftheme%2Fbrowser%2Fimages%2FREADME.txt;h=2cf87381271c766f5588de2c98d0f3a24599e25e;hb=bdc26fbc59b17fe88607cb3d4acd257fef763710;hp=0000000000000000000000000000000000000000;hpb=aa5dcb3fd8b78f37a9ad92e8ea41aee59d7f7aa7;p=zope-bootstrap.git

diff --git a/src/koehsel.theme/koehsel/theme/browser/images/README.txt b/src/koehsel.theme/koehsel/theme/browser/images/README.txt
new file mode 100644
index 0000000..2cf8738
--- /dev/null
+++ b/src/koehsel.theme/koehsel/theme/browser/images/README.txt
@@ -0,0 +1,56 @@
+README for the 'browser/images/' directory
+==========================================
+
+This folder is a Zope 3 Resource Directory acting as a repository for images.
+
+Its declaration is located in 'browser/configure.zcml':
+
+    <!-- Resource directory for images -->
+    <browser:resourceDirectory
+        name="koehsel.theme.images"
+        directory="images"
+        layer=".interfaces.IThemeSpecific"
+        />
+
+An image placed in this directory (e.g. 'logo.png') can be accessed from
+this relative URL:
+
+    "++resource++koehsel.theme.images/logo.png"
+
+Note that it might be better to register each of these resources separately if
+you want them to be overridable from zcml directives.
+
+The only way to override a resource in a resource directory is to override the
+entire directory (all elements have to be copied over).
+
+A Zope 3 browser resource declared like this in 'browser/configure.zcml':
+
+    <browser:resource
+        name="logo.png"
+        file="images/logo.png"
+        layer=".interfaces.IThemeSpecific"
+        />
+
+can be accessed from this relative URL:
+
+    "++resource++logo.png"
+
+Notes
+-----
+
+* Whatever the way they are declared (in bulk inside a resource directory or
+  as separate resources), images registered as Zope 3 browser resources don't
+  have all the attributes that Zope 2 image objects have (i.e. the 'title'
+  property and the 'tag()' and 'get_size()' methods).
+  This means that if you want the html tag of your image to be auto-generated
+  (this is the case by default for the portal logo), you should store it in a
+  directory that is located in the 'skins/' folder of your package, registered
+  as a File System Directory View in the 'portal_skins' tool, and added to the
+  layers of your skin.
+
+* Customizing/overriding images that are originally accessed from the
+  'portal_skins' tool (e.g. Plone default logo and icons) can be done inside
+  that tool only. There is no known way to do it with Zope 3 browser
+  resources.
+  Vice versa, there is no known (easy) way to override a Zope 3 browser
+  resource from a skin layer in 'portal_skins'.