paper-gtk-theme/Paper/README.md

29 lines
1.2 KiB
Markdown
Raw Normal View History

2016-04-15 05:41:36 +02:00
Notes
2016-04-15 03:54:38 +02:00
-------
2016-04-15 05:41:36 +02:00
* 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.
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
## SASS Assets (SASSets)
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
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.
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
`_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.
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
`_colors-public.scss`
- SCSS colors exported through gtk to allow for 3rd party apps color mixing.
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
`_drawing.scss`
- drawing helper mixings/functions to allow easier definition of widget drawing under specific context.
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
`_common.scss`
- shared definitions for the theme
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
`widgets/_*.scss`
- styles for widgets are on individual sheets to make the theme more modular and easier to batch edit
2016-04-15 03:54:38 +02:00
2016-04-15 05:41:36 +02:00
`_apps.scss` & `apps/_*.scss`
- style definitions for specific apps and environments. This is where colored headerbars are made