gtk2/gtk/theme/Adwaita
Emmanuele Bassi f1003d6ae8 Rename GResources for standard GTK themes
After commit 2ab9be54fb we had to rename
the generated CSS files to be included into the GResource bundle; we
kept the URI stable to avoid too much churn, and allow backporting the
change to the 3.24 stable branch. This had the adverse effect of making
it harder to debug issues, as the on-disk file name does not match the
location in the GResource that will be used to print out warnings,
errors, and debugging messages.
2020-03-27 15:20:59 +00:00
..
assets Adwaita: update checkbox & radio 2020-01-13 13:45:34 +01:00
_colors-public.scss
_colors.scss Adwaita: make insensitive slightly less sensitive 2020-03-26 17:22:47 +01:00
_common.scss Adwaita: make insensitive slightly less sensitive 2020-03-26 17:22:47 +01:00
_drawing.scss
Adwaita-dark.scss Rename the SCSS files for our themes 2020-02-12 20:22:43 +00:00
Adwaita.scss Rename the SCSS files for our themes 2020-02-12 20:22:43 +00:00
assets.svg
assets.txt
gtk-dark.css Rename GResources for standard GTK themes 2020-03-27 15:20:59 +00:00
gtk.css Rename GResources for standard GTK themes 2020-03-27 15:20:59 +00:00
meson.build Rename the SCSS files for our themes 2020-02-12 20:22:43 +00:00
README build: require sassc and drop generated .css files 2020-01-30 20:45:38 +01:00
render-assets.sh

Summary
-------

* To be able to use the latest/adequate version of sass, install sassc
* meson will regenerate the CSS every time you modify the SCSS files.
* Note that meson always builds out-of-tree, so the modified css files will
  appear in your builddir.

How to tweak the theme
----------------------

Adwaita is a complex theme, so to keep it maintainable it's written and
processed in SASS. The generated CSS is then transformed into a gresource file
during gtk build and used at runtime in a non-legible or editable form.

It is very likely your change will happen in the _common.scss file. That's where
all the widget selectors are defined. Here's a rundown of the "supporting"
stylesheets, that are unlikely to be the right place for a drive by stylesheet
fix:

_colors.scss        - global color definitions. We keep the number of defined
                      colors to a necessary minimum, most colors are derived
                      from a handful of basics. It covers both the light variant
                      and the dark variant.

_colors-public.scss - SCSS colors exported through gtk to allow for 3rd party
                      apps color mixing.

_drawing.scss       - drawing helper mixings/functions to allow easier
                      definition of widget drawing under specific context. This
                      is why Adwaita isn't 15000 LOC.

_common.scss        - actual definitions of style for each widget. This is
                      where you are likely to add/remove your changes.
                      
You can read about SASS at http://sass-lang.com/documentation/. Once you make
your changes to the _common.scss file, GTK will rebuild the CSS files.