diff options
Diffstat (limited to 'fedoratheme/kindofblue/browser/stylesheets/README.txt')
-rw-r--r-- | fedoratheme/kindofblue/browser/stylesheets/README.txt | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/fedoratheme/kindofblue/browser/stylesheets/README.txt b/fedoratheme/kindofblue/browser/stylesheets/README.txt new file mode 100644 index 0000000..4bfb295 --- /dev/null +++ b/fedoratheme/kindofblue/browser/stylesheets/README.txt @@ -0,0 +1,61 @@ +README for the 'browser/stylesheets/' directory +=============================================== + +This folder is a Zope 3 Resource Directory acting as a repository for +stylesheets. + +Its declaration is located in 'browser/configure.zcml': + + <!-- Resource directory for stylesheets --> + <browser:resourceDirectory + name="fedoratheme.kindofblue.stylesheets" + directory="stylesheets" + layer=".interfaces.IThemeSpecific" + /> + +A stylesheet placed in this directory (e.g. 'main.css') can be accessed from +this relative URL: + + "++resource++fedoratheme.kindofblue.stylesheets/main.css" + +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="main.css" + file="stylesheets/main.css" + layer=".interfaces.IThemeSpecific" + /> + +can be accessed from this relative URL: + + "++resource++main.css" + +Notes +----- + +* Stylesheets registered as Zope 3 resources might be flagged as not found in + the 'portal_css' tool if the layer they are registered for doesn't match the + default skin set in 'portal_skins'. + This can be confusing but it must be considered as a minor bug in the CSS + registry instead of a lack in the way Zope 3 resources are handled in + Zope 2. + +* There might be a way to interpret DTML from a Zope 3 resource view. + Although, if you need to use DTML for setting values in a stylesheet (the + same way as in default Plone stylesheets where values are read from + 'base_properties'), it is much easier to 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 stylesheets that are originally accessed from the + 'portal_skins' tool (e.g. Plone default stylesheets) 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 way to override a Zope 3 browser resource from + a skin layer in 'portal_skins'. |