You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
solarized-everything-css/README.org

98 lines
4.7 KiB
Org Mode

* Solarized...Everything?
This is a small (growing?) collection of user-stylesheets based upon the [[http://ethanschoonover.com/solarized][Solarized]] theme ([[https://github.com/altercation/solarized][repo]]). It uses [[http://learnboost.github.com/stylus/][Stylus]] to generate the CSS. The home of this stylesheet is at [[https://github.com/alphapapa/solarized-everything-css]].
Wouldn't it be nice if (almost) every web site looked Solarized? I thought so. So here is a start. :)
** Contents :TOC:
- [[#solarizedeverything][Solarized...Everything?]]
- [[#screenshots][Screenshots]]
- [[#installation][Installation]]
- [[#development][Development]]
- [[#license][License]]
** Screenshots
*** GitHub
**** Dark
[[screenshots/github-dark.png]]
**** Light
[[screenshots/github-light.png]]
*** Wikipedia
**** Dark
[[screenshots/wikipedia-dark.png]]
**** Light
[[screenshots/wikipedia-light.png]]
** Installation :noexport_1:
*** From userstyles.org
You may install some of the stylesheets directly in your browser from [[http://userstyles.org][userstyles.org]]:
+ [[https://userstyles.org/styles/127328/solarized-everything-github][Solarized Everything: GitHub]]
+ [[https://userstyles.org/styles/140962/solarized-everything-wikipedia][Solarized Everything: Wikipedia]]
*** Manual
Install the stylesheet of your choice according to your browser's method (e.g. using the Stylish extension in Firefox).
**** Files
- ~solarized-all-sites-*.css~
These have all the sites' styles smushed into one big file. Might work pretty well for most sites. If the collection grows, it might begin to have conflicts--but it still might work pretty well. It might be a lot better than adding a separate stylesheet for every site you visit...
- ~solarized-generic-*.css~
These are intended to be generic, suitable for many simple sites. They probably won't do much for fancy, popular sites with lots of custom CSS, but for simple, mostly unstyled sites, they might work okay.
- ~solarized-mediawiki-*.css~
For MediaWiki sites, like Wikipedia
- ~solarized-disqus-*.css~
For Disqus comments
- ~solarized-github-*.css~
For GitHub
- ~solarized-google-*.css~
For Google
- ~solarized-hackernews-*.css~
For Hacker News
- ~solarized-planet.emacsen.org-*.css~
For [[http://planet.emacsen.org][Planet Emacsen]]
- ~solarized-stackexchange-*.css~
For StackExchange sites. Not all sites are covered, but some of the main ones are. Patches welcome.
- ~solarized-sakai-*.css~
For sites hosted by [[https://sakaiproject.org/][sakai]], a popular course management program.
** Development :noexport_1:
To make changes, just edit the =.styl= files and run =make=. (You need to have Stylus installed, of course.)
Basically, nearly the only things that should be in =dark.styl= or =light.styl= should be changes to the =color-= variables that adjust it for light or dark. Everything else should go in =sites/*.styl=. Colors are defined as =color-= variables, and mixins are used to insert common CSS properties (like =color=, =background=, etc) with =!important=. Most changes can be made without inserting CSS properties directly into the selectors.
I highly recommend using Emacs with =stylus-mode= and =outline-minor-mode=, but, of course, you can use whatever you like. :)
It's a good idea to avoid the use of =*= selectors wherever possible. They tend to have unanticipated side-effects which can take time to track down.
*** Require tree
Stylus can be very confusing when it comes to importing/requiring sheets into other sheets. Unfortunately, the order in which they are imported /does/ matter, as each one seems to be parsed and executed in-order, rather than importing them all at once and then having a global namespace.
This is how the sheets ~require~ in this project:
+ =Makefile=
- =styl/{dark,light}.styl= (in Makefile syntax: ~$$color.styl~)
+ =colors=
+ Contents of ={dark,light}.styl=
- =styl= (which loads =styl/index.styl=)
+ =generic=
- =mixins=
- =sites/*.styl=: The site-specific sheets, as well as =generic.styl=, which applies to all of them, and also builds as a separate sheet for non-specific sites. =all-sites.styl= puts all of the site-specific sheets into one big CSS file, which some people may prefer over setting up custom CSS for each site in their browser.
This way, the Solarized color values are loaded first, followed by the dark- or light-themed mappings of those color values to friendly names, after which those friendly names can be used in the sheets that actually style elements and pages.
** License
Really? Come on, it's just some CSS. Just have fun and share!