| 1 |
Summary |
| 2 |
------- |
| 3 |
|
| 4 |
* Do not edit the CSS directly, edit the source SCSS files and process them with SASS (run |
| 5 |
`./parse-sass.sh` when you have the required software installed, as described below) |
| 6 |
* To be able to use the latest/adequate version of sass, install ruby, gem, sass & bundler. |
| 7 |
On Fedora F20, this is done with `sudo dnf install rubygems && gem install bundle && bundle install` |
| 8 |
from the same directory this README resides in. |
| 9 |
|
| 10 |
How to tweak the theme |
| 11 |
---------------------- |
| 12 |
|
| 13 |
Greybird is a complex theme (based on Adwaita), so to keep it maintainable it's written and processed |
| 14 |
in SASS. |
| 15 |
|
| 16 |
It is very likely your change will happen in the _common.scss file. That's where all the widget |
| 17 |
selectors are defined. Here's a rundown of the "supporting" stylesheets, that are unlikely to be the |
| 18 |
right place for a drive by stylesheet fix: |
| 19 |
|
| 20 |
_colors.scss - global color definitions. We keep the number of defined colors to a necessary minimum, |
| 21 |
most colors are derived form a handful of basics. It covers both the light variant and |
| 22 |
the dark variant. |
| 23 |
|
| 24 |
_colors-public.scss - SCSS colors exported through gtk to allow for 3rd party apps color mixing. |
| 25 |
|
| 26 |
_drawing.scss - drawing helper mixings/functions to allow easier definition of widget drawing under |
| 27 |
specific context. This is why Adwaita isn't 15000 LOC. |
| 28 |
|
| 29 |
_common.scss - actual definitions of style for each widget. This is where you are likely to add/remove |
| 30 |
your changes. |
| 31 |
|
| 32 |
You can read about SASS at http://sass-lang.com/documentation/. Once you make your changes to the |
| 33 |
_common.scss file, you can either run the ./parse-sass.sh script or keep SASS watching for changes as you |
| 34 |
edit. This is done by running `bundle exec sass --watch --sourcemap=none .` If sass is out of date, or is |
| 35 |
missing, you can install it with `bundle install`. |