doc/book/devweb/css.rst
author Sylvain Thénault <sylvain.thenault@logilab.fr>
Fri, 10 Mar 2017 16:55:57 +0100
changeset 12034 e7e469d0539b
parent 10491 c67bcee93248
permissions -rw-r--r--
[cleanup] Drop references to the old internal_session method dropped a while ago, no need to talk about it in a docstring nor to fake it.

.. -*- coding: utf-8 -*-

CSS Stylesheet
---------------
Conventions
~~~~~~~~~~~

.. XXX external_resources variable
..    naming convention
..    request.add_css


Extending / overriding existing styles
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

We cannot modify the order in which the application is reading the CSS. In
the case we want to create new CSS style, the best is to define it a in a new
CSS located under ``myapp/data/`` and use those new styles while writing
customized views and templates.

If you want to modify an existing CSS styling property, you will have to use
``!important`` declaration to override the existing property. The application
apply a higher priority on the default CSS and you can not change that.
Customized CSS will not be read first.


CubicWeb stylesheets
~~~~~~~~~~~~~~~~~~~~

.. XXX explain diffenrent files and main classes