diazoframework.plone
package is the base for creating CSS frameworks
(e.g. Twitter Bootstrap, Zurb Foundation, etc.) using the theming and
packaging features available for create Diazo theme using plone.app.theming.
They are useful for creating themes based on CSS frameworks. A Diazo framework should provide the framework resources and diazo rules to reuse and add to in a Diazo theme.
A framework package is set up as follows:
_ diazoframework.name I tend to use paster to create the package scaffolding. _ diazoframework _ name _ framework This folder is registered through configure.zcml as the framework and will be traversable through /++framework++name. _ resources The resources are the files you get in the framework zip you download. In my opinion it is best to change as little as possible for future upgrading of the files. All changes you make here you will also have to make in future versions of the framework. _ rules CSS frameworks generally work by delivering styles and functionality for specific html structures. The rules folder contains diazo rule snippets, that mold the plone html into blocks the framework expects. These rules are often a little more complex than the regular put my content div in that theme div and remold the html in a generic way. The rules files can be included through XIncludes into a diazotheme. _ preview.png I like to provide a generic thumbnail for the theme panel. _ __init__.py _ configure.zcml _ version.txt _ __init__.py _ docs _ HISTORY.txt _ INSTALL.txt _ LICENSE.GPL _ LICENSE.txt _ MANIFEST.in _ README.md _ setup.py
- From the Plone 4.1.x To the Plone 4.3 latest version (https://plone.org/download)
- The
plone.app.theming
package (You will need enable it to use this package)
- Provides the plonetheme.classic resources.
- Provides the plonetheme.sunburst resources.
- Provides the Respond.js v1.1.0 CSS/JS resources.
- Provides the 12-column Deco Grid System CSS resource.
- Provides the 16-column Deco Grid System CSS resource.
- Included Diazo rules for the
head
,icon
,logo
,utility
andcontent
CSS styles.
If you are a developer, you might enjoy installing it via buildout.
For install diazoframework.plone
package add it to your buildout
section's
eggs parameter e.g.:
[buildout] ... eggs = ... diazoframework.plone
and then running bin/buildout
.
Or, you can add it as a dependency on your own product setup.py
file:
install_requires=[ ... 'diazoframework.plone', ],
The resources of this framework can be reached through
/++framework++plone
and there are placed at
diazoframework.plone/diazoframework/plone/framework/
directory with following resources files:
This package is the parent of all frameworks and provides rules and resources that are practical to use in other frameworks as well as themes
_ classic Provides the resources from "plonetheme.classic". _ css _ img _ index.html _ preview.png _ css _ decogrids-12.css _ decogrids-16.css _ respond.css _ favicon _ img Plone icons and logo's to restructure "portal-logo". _ background _ black _ default _ white _ js _ respond.min.js _ rules _ head _ base.xml _ css.xml _ icons.xml _ ie-classes.xml _ js.xml _ icon _ black-128.xml _ black-192.xml _ black-256.xml _ black-32.xml _ black-40.xml _ black-48.xml _ black-56.xml _ black-64.xml _ blue-128.xml _ blue-192.xml _ blue-256.xml _ blue-32.xml _ blue-40.xml _ blue-48.xml _ blue-56.xml _ blue-64.xml _ default-128.xml _ default-192.xml _ default-256.xml _ default-32.xml _ default-40.xml _ default-48.xml _ default-56.xml _ default-64.xml _ white-128.xml _ white-192.xml _ white-256.xml _ white-32.xml _ white-40.xml _ white-48.xml _ white-56.xml _ white-64.xml _ logo _ black-128.xml _ black-192.xml _ black-256.xml _ black-32.xml _ black-40.xml _ black-48.xml _ black-56.xml _ black-64.xml _ blue-128.xml _ blue-192.xml _ blue-256.xml _ blue-32.xml _ blue-40.xml _ blue-48.xml _ blue-56.xml _ blue-64.xml _ default-128.xml _ default-192.xml _ default-256.xml _ default-32.xml _ default-40.xml _ default-48.xml _ default-56.xml _ default-64.xml _ white-128.xml _ white-192.xml _ white-256.xml _ white-32.xml _ white-40.xml _ white-48.xml _ white-56.xml _ white-64.xml _ utility _ clean.xml _ responsify.xml _ structures.xml _ toolbar.xml _ content.xml _ contenttodecocells.xml (only to be used with the body layout of ../sunburst/index.html) _ sunburst Provides the resources from "plonetheme.sunburst". _ index.html An empty html file to fill. It contains a `<html>`, `<head>`, `<title>` and `<body>`, nothing more.
For a typical diazoframework check diazoframework.amazium, with typical diazotheme diazotheme.amazium
A theme that leans towards the complex is diazoframework.bootstrap with diazotheme.bootstrap. You can then see the power of childthemes at work in diazotheme.bootswatch.
- diazoframework.amazium
- diazoframework.baseline
- diazoframework.bootstrap
- diazoframework.foundation
- diazoframework.goldilocks
- diazoframework.kube
- diazoframework.purecss
- diazoframework.skeleton
- diazotheme.amazium
- diazotheme.baseline
- diazotheme.bootstrap
- diazotheme.bootswatch
- diazotheme.foundation
- diazotheme.goldilocks
- diazotheme.kube
- diazotheme.plone
- diazotheme.purecss
- diazotheme.skeleton
- Issue Tracker: https://github.com/collective/diazoframework.plone/issues
- Source Code: https://github.com/collective/diazoframework.plone
The project is licensed under the GPLv2.
- Thijs Jonkman (t.jonkman at gmail dot com).
- Leonardo J. Caballero G. aka macagua (leonardocaballero at gmail dot com).
You can find an updated list of package contributors on https://github.com/collective/diazoframework.plone/contributors