gtk2/Adwaita at 11015a49aee52946b1c65c58fc1fd0ce64a47cc5 - gtk2

History

Matthias Clasen 7e9372bafa Fix fonts in context menus Context menus inherit their style from the widget they are attached to. This can have unexpected effects in particular for font, as can be seen in gedit or gnome-calculator. Prevent this by resetting the font of context-menus to the initial value.		2014-10-01 07:11:43 -04:00
..
assets	Adwaita: blue selection mode checks	2014-09-10 20:03:26 +02:00
_colors-public.scss	Adwaita: take named colors out of _colors.scss	2014-08-28 13:21:14 +02:00
_colors.scss	Adwaita: make links readable in the dark variant	2014-09-29 14:41:49 -04:00
_common.scss	Fix fonts in context menus	2014-10-01 07:11:43 -04:00
_drawing.scss	Adwaita: tranlucent shadows inside entries	2014-09-05 15:06:37 +02:00
assets.svg	Adwaita: blue selection mode checks	2014-09-10 20:03:26 +02:00
assets.txt	Adwaita: special case checks/radios on selected bg	2014-08-30 14:33:20 +02:00
Gemfile	depend on particular version of sass	2014-09-29 13:46:32 +02:00
gtk-contained-dark.css	Provisional sidebar theming	2014-10-01 00:46:13 -04:00
gtk-contained-dark.scss	Adwaita: take named colors out of _colors.scss	2014-08-28 13:21:14 +02:00
gtk-contained.css	Provisional sidebar theming	2014-10-01 00:46:13 -04:00
gtk-contained.scss	Adwaita: take named colors out of _colors.scss	2014-08-28 13:21:14 +02:00
gtk-dark.css
gtk.css
parse-sass.sh	depend on particular version of sass	2014-09-29 13:46:32 +02:00
README	Adwaita: provide simple guidelines for theming	2014-09-29 14:07:10 +02:00
render-assets.sh

README

Summary
-------

* Do not edit the CSS directly, edit the source SCSS files and process them with SASS (run
`/.parse-sass.sh` when you have the required sofwtare installed, as described below)
* To be able to use the lates/adequate version of sass, install ruby, gem, sass & bundle.
On Fedora F20, this is done with `sudo dnf install rubygems && gem install bundle && bundle install`
from the same directory this README resides in.

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

Adwaita is a complex themes, 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 most of 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 form 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, you can either run the ./parse-sass.sh script or keep SASS watching for changes as you
edit. This is done by running `bundle exec sass --watch --sourcemap=none .` If sass is out of date, or is
missing, you can install it with `bundle install`.