doc/book/devweb/css.rst
author Jérémy Bobbio <jeremy.bobbio@irq7.fr>
Thu, 13 Jun 2019 16:47:47 +0200
changeset 12646 ca06ce5eba38
parent 10491 c67bcee93248
permissions -rw-r--r--
[pkg] Tidy substvars usage in control file The documentation package was missing a Built-Using field to record the provenance of the templates. Empty packages or meta packages do not require Depends on a specific Python version, so we can remove the relevant substvars.

.. -*- 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