forked from AuroraMiddleware/gtk
14620423e8
The min size on the oriented axis used to come from style props with default values in the source file, used if the theme did not provide a min size in CSS. When the style props were removed, so was any notion of a minimal size for proressbars' main axis, meaning that now progressbars without expand or any other source of min size were just tiny specks. The right place to do that was always the theme, so in our themes now, fix that by copying the old default values for the style properties; see: https://gitlab.gnome.org/GNOME/gtk/issues/1191#note_259393 https://gitlab.gnome.org/GNOME/gtk/blob/gtk-3-24/gtk/gtkprogressbar.c#L92 The result should be the same in that (A) the min size is now what it is in GTK+ 3 & (B) an app/user can override the theme exactly the same way. Close https://gitlab.gnome.org/GNOME/gtk/issues/1192 |
||
|---|---|---|
| .. | ||
| assets | ||
| _colors-public.scss | ||
| _colors.scss | ||
| _common.scss | ||
| _drawing.scss | ||
| assets.svg | ||
| assets.txt | ||
| gtk-contained-dark.css | ||
| gtk-contained-dark.scss | ||
| gtk-contained.css | ||
| gtk-contained.scss | ||
| gtk-dark.css | ||
| gtk.css | ||
| meson.build | ||
| parse-sass.sh | ||
| README | ||
| render-assets.sh | ||
Summary
-------
* Do not edit the CSS directly, edit the source SCSS files
* To be able to use the latest/adequate version of sass, install sassc
* The configure script will detect whether or not you have sassc installed;
if you do, it will regenerate the CSS every time you modify the SCSS files.
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.