1 README for the 'browser/stylesheets/' directory
2 ===============================================
4 This folder is a Zope 3 Resource Directory acting as a repository for
7 Its declaration is located in 'browser/configure.zcml':
9 <!-- Resource directory for stylesheets -->
10 <browser:resourceDirectory
11 name="koehsel.theme.stylesheets"
12 directory="stylesheets"
13 layer=".interfaces.IThemeSpecific"
16 A stylesheet placed in this directory (e.g. 'main.css') can be accessed from
19 "++resource++koehsel.theme.stylesheets/main.css"
21 Note that it might be better to register each of these resources separately if
22 you want them to be overridable from zcml directives.
24 The only way to override a resource in a resource directory is to override the
25 entire directory (all elements have to be copied over).
27 A Zope 3 browser resource declared like this in 'browser/configure.zcml':
31 file="stylesheets/main.css"
32 layer=".interfaces.IThemeSpecific"
35 can be accessed from this relative URL:
37 "++resource++main.css"
42 * Stylesheets registered as Zope 3 resources might be flagged as not found in
43 the 'portal_css' tool if the layer they are registered for doesn't match the
44 default skin set in 'portal_skins'.
45 This can be confusing but it must be considered as a minor bug in the CSS
46 registry instead of a lack in the way Zope 3 resources are handled in
49 * There might be a way to interpret DTML from a Zope 3 resource view.
50 Although, if you need to use DTML for setting values in a stylesheet (the
51 same way as in default Plone stylesheets where values are read from
52 'base_properties'), it is much easier to store it in a directory that is
53 located in the 'skins/' folder of your package, registered as a File System
54 Directory View in the 'portal_skins' tool, and added to the layers of your
57 * Customizing/overriding stylesheets that are originally accessed from the
58 'portal_skins' tool (e.g. Plone default stylesheets) can be done inside that
59 tool only. There is no known way to do it with Zope 3 browser resources.
60 Vice versa, there is no known way to override a Zope 3 browser resource from
61 a skin layer in 'portal_skins'.