gnome-shell/data/theme
Mario Sanchez Prada c62e7a6a82 build: Make sassc mandatory and always generate CSS files from Sass sources
The previous implementation of the CSS generation logic considered sassc
an optional dependency and made sure for that reason that the result CSS
files ended up in the source directory, so that they could be checked
in and kept in sync with the source sass files.

As we are making sassc a required dependency, we can now stop doing that
extra work and simply rely on the CSS files being automatically generated
each time the sass sources change. By doing this, we can now effectively
get rid of the CSS files checked in the repo as well as of the parse_sass.sh
script, since the CSS files will now live on the build directory only.

https://bugzilla.gnome.org/show_bug.cgi?id=792822
2018-02-10 07:54:40 +00:00
..
gnome-shell-sass theme: Replace gnome-shell-sass submodule with subtree 2018-02-09 21:45:09 +00:00
calendar-arrow-left.svg Calendar: Implement new mockup 2011-01-31 11:52:27 -05:00
calendar-arrow-right.svg Calendar: Implement new mockup 2011-01-31 11:52:27 -05:00
calendar-today.svg calendar: make day with events more prominent 2015-04-15 13:05:01 +02:00
checkbox-focused.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
checkbox-off-focused.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
checkbox-off.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
checkbox.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
close-window-active.svg add missing close button states 2017-09-22 17:13:07 +02:00
close-window-hover.svg add missing close button states 2017-09-22 17:13:07 +02:00
close-window.svg add missing close button states 2017-09-22 17:13:07 +02:00
close.svg [overview] Port pane to CSS 2009-11-12 11:42:01 -05:00
corner-ripple-ltr.png Fix ripple animation for RTL locales 2011-03-22 19:35:21 +01:00
corner-ripple-rtl.png Fix ripple animation for RTL locales 2011-03-22 19:35:21 +01:00
dash-placeholder.svg dash: Improve DND to dash and allow reordering 2010-11-29 16:35:54 +01:00
filter-selected-ltr.svg theme: Adjust CSS for RTL locales 2011-03-05 19:49:21 +01:00
filter-selected-rtl.svg theme: Adjust CSS for RTL locales 2011-03-05 19:49:21 +01:00
gnome-shell-high-contrast.scss HighContrast: provide more contrasty switches 2015-04-15 19:35:51 +02:00
gnome-shell.scss theme: Use gnome-shell-sass as a submodule 2015-02-20 17:15:29 +01:00
HACKING theme: Use gnome-shell-sass as a submodule 2015-02-20 17:15:29 +01:00
logged-in-indicator.svg loginDialog: Indicate whether users are logged in 2012-08-01 22:20:35 +02:00
meson.build build: Make sassc mandatory and always generate CSS files from Sass sources 2018-02-10 07:54:40 +00:00
message-indicator-symbolic.svg dateMenu: Use icon for message indicator 2017-09-12 17:32:51 +02:00
no-events.svg calendar: Add MessageList and Section/Message base types 2015-02-20 17:38:04 +01:00
no-notifications.svg calendar: Add NotificationSection to message list 2015-02-20 17:39:25 +01:00
noise-texture.png theme: Use the noise texture for the background of the screen shield 2012-08-03 14:00:48 -03:00
pad-osd.css ui: Add PadOsd 2016-11-04 16:08:10 +01:00
page-indicator-active.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
page-indicator-checked.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
page-indicator-hover.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
page-indicator-inactive.svg theme: Add hover/active states to indicators 2013-09-27 15:50:28 +02:00
process-working.svg spinner: use a 60fps spinner 2015-08-05 13:44:32 +02:00
README build: Make sassc mandatory and always generate CSS files from Sass sources 2018-02-10 07:54:40 +00:00
running-indicator.svg theme: Make the running indicator look as it's supposed to 2011-06-27 12:53:38 -04:00
source-button-border.svg MessageTray: style summary sources 2011-03-21 21:50:27 -04:00
summary-counter.svg messageTray: Restyle the summary counters 2012-09-10 17:41:30 +02:00
toggle-off-hc.svg HighContrast: provide more contrasty switches 2015-04-15 19:35:51 +02:00
toggle-off-intl.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
toggle-off-us.svg theme: update some svg assets to adwaita 3.14 counterparts 2015-02-20 15:14:40 +01:00
toggle-on-hc.svg HighContrast: provide more contrasty switches 2015-04-15 19:35:51 +02:00
toggle-on-intl.svg theme: dark $selected_bg_color for toggle switches 2015-04-15 13:04:20 +02:00
toggle-on-us.svg theme: dark $selected_bg_color for toggle switches 2015-04-15 13:04:20 +02:00
ws-switch-arrow-down.png Use symbolic icons for workspace switch OSD 2012-08-13 13:27:40 -04:00
ws-switch-arrow-up.png Use symbolic icons for workspace switch OSD 2012-08-13 13:27:40 -04:00

Summary
-------

* Do not edit the CSS directly, edit the source SCSS files and the CSS files will be generated
  automatically when building with meson + ninja and left inside the build directory to be
  incorporated into the gresource XML (you'll need to have sassc installed).

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 is an exact copy of the gtk+ 
                      counterpart. Light theme is used for the classic theme and dark is for GNOME3 shell 
                      default.

_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, you can run ninja to generate the final CSS files.