README.md 1.23 KB
Newer Older
isaagar's avatar
isaagar committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
Notes
-------

* Do not edit the CSS files directly, edit the source SCSS files and process them with SASS (run 
  `sass --update --sourcemap=none .` in this directory when you have the required software installed)
* Do not edit the PNG or SVG assets directly, edit and render the sources in the `src` folder in the source root and render those.

## SASS Assets (SASSets)

Paper is a large and complex theme, to keep it maintainable and easily editable it's written and processed in SASS and organized in a modular fashion. 

`_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.

`_common.scss`
- shared definitions for the theme

`widgets/_*.scss`
- styles for widgets are on individual sheets to make the theme more modular and easier to batch edit 

`_apps.scss` & `apps/_*.scss`
- style definitions for specific apps and environments. This is where colored headerbars are made