README 1.7 KB

12345678910111213141516171819202122232425262728293031323334
  1. Summary
  2. -------
  3. * Do not edit the CSS directly, edit the source SCSS files
  4. * To be able to use the latest/adequate version of SASS, install sassc
  5. * The configure script will detect whether or not you have sassc installed;
  6. if you do, it will regenerate the CSS every time you modify the SCSS files
  7. and rebuild GTK+.
  8. How to tweak the theme
  9. ----------------------
  10. Adwaita is a complex theme, so to keep it maintainable it's written and processed in SASS. The
  11. generated CSS is then transformed into a GResource file during GTK+ build and used at runtime in a
  12. non-legible or editable form.
  13. It is very likely your change will happen in the _common.scss file. That's where all the widget
  14. selectors are defined. Here's a rundown of the "supporting" stylesheets, that are unlikely to be the
  15. right place for a drive by stylesheet fix:
  16. _colors.scss - global color definitions. We keep the number of defined colors to a necessary minimum,
  17. most colors are derived form a handful of basics. It covers both the light variant and
  18. the dark variant.
  19. _colors-public.scss - SCSS colors exported through gtk to allow for 3rd party apps color mixing.
  20. _drawing.scss - drawing helper mixings/functions to allow easier definition of widget drawing under
  21. specific context. This is why Adwaita isn't 15000 LOC.
  22. _common.scss - actual definitions of style for each widget. This is where you are likely to add/remove
  23. your changes.
  24. You can read about SASS at http://sass-lang.com/documentation/. Once you make
  25. your changes to the _common.scss file, GTK+ will rebuild the CSS files.