callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Adwaita/README: Update to reflect we use sassc now

Browse Source 
We moved from the Ruby compiler to sassc in
commit 67953e9cfb, so this copies across
the updated info about building from GTK+ 4.

Also, explain the purpose of parse-sass.sh, since while that is not
mentioned in GTK+ 4 – and perhaps does not need to be, thanks to Meson –
we are still on Autotools here, and rebuilding the entirety of GTK+ 3 if
you only edited the CSS is a lot of waiting for no good reason.
This commit is contained in:
Daniel Boles
2017-10-08 13:59:30 +01:00
parent 30effaf7fc
commit 4515c72706
1 changed files with 8 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
gtk/theme/Adwaita/README
View File

@ -1,11 +1,11 @@
Summary Summary
------- -------
* Do not edit the CSS directly, edit the source SCSS files and process them with SASS (run * Do not edit the CSS directly, edit the source SCSS files
`./parse-sass.sh` when you have the required software installed, as described below) * To be able to use the latest/adequate version of SASS, install sassc
* To be able to use the latest/adequate version of sass, install ruby, gem, sass & bundle. * The configure script will detect whether or not you have sassc installed;
On Fedora F20, this is done with `sudo dnf install rubygems && gem install bundle && bundle install` if you do, it will regenerate the CSS every time you modify the SCSS files
from the same directory this README resides in. and rebuild GTK+. To rebuild the CSS only, run the script ./parse-sass.sh
How to tweak the theme How to tweak the theme
---------------------- ----------------------
@ -30,7 +30,6 @@ _drawing.scss - drawing helper mixings/functions to allow easier definitio
_common.scss - actual definitions of style for each widget. This is where you are likely to add/remove _common.scss - actual definitions of style for each widget. This is where you are likely to add/remove
your changes. your changes.
You can read about SASS at http://sass-lang.com/documentation/. Once you make your changes to the You can read about SASS at http://sass-lang.com/documentation/. Once you make
_common.scss file, you can either run the ./parse-sass.sh script or keep SASS watching for changes as you your changes to the _common.scss file, GTK+ will rebuild the CSS files. If you
edit. This is done by running `bundle exec sass --watch --sourcemap=none .` If sass is out of date, or is want to build only the CSS files, not all of GTK+, simply run ./parse-sass.sh
missing, you can install it with `bundle install`.