doc/refactoring-the-css-with-uiprops.rst
changeset 10492 68c13e0c0fc5
parent 10491 c67bcee93248
child 10493 64b4e1def4ec
--- a/doc/refactoring-the-css-with-uiprops.rst	Thu Jan 08 22:11:06 2015 +0100
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,42 +0,0 @@
-=========================================
-Refactoring the CSSs with UI properties
-=========================================
-
-Overview
-=========
-
-Managing styles progressively became difficult in CubicWeb. The
-introduction of uiprops is an attempt to fix this problem.
-
-The goal is to make it possible to use variables in our CSSs.
-
-These variables are defined or computed in the uiprops.py python file
-and inserted in the CSS using the Python string interpolation syntax.
-
-A quick example, put in ``uiprops.py``::
-
-  defaultBgColor = '#eee'
-
-and in your css::
-
-  body { background-color: %(defaultBgColor)s; }
-
-
-The good practices are:
-
-- define a variable in uiprops to avoid repetitions in the CSS
-  (colors, borders, fonts, etc.)
-
-- define a variable in uiprops when you need to compute values
-  (compute a color palette, etc.)
-
-The algorithm implemented in CubicWeb is the following:
-
-- read uiprops file while walk up the chain of cube dependencies: if
-  cube myblog depends on cube comment, the variables defined in myblog
-  will have precedence over the ones in comment
-
-- replace the %(varname)s in all the CSSs of all the cubes
-
-Keep in mind that the browser will then interpret the CSSs and apply
-the standard cascading mechanism.