Trouble getting started

[jflorian]

I can confirm your installation section is apparently not idiot proof. I'm running Firefox and have just installed the Stylish add-on. I tried Stylish once before but gave up having not found a theme I could like. Yours looks tempting but I'm lost on how to use it. I made a git clone of your repo and then took a WAG by clicking on the S > Manage styles ... > Install from URLS ... > entered full path to my clone's styl/dark.styl with a prefix of "file://". I gave it a name of "Solarized-Everything" and then exactly nothing seemed different. :-(

I removed that attempt in the Stylish manager and retried with sites/all-sites.styl and still nothing.

Where did I go wrong?

[alphapapa]

styl files are not CSS stylesheets, they are Stylus files. You don't need to mess with those unless you are making changes that you want to submit.

To install the stylesheets into Stylish or another browser extension, use the CSS files in the css directory. If you want to paste the URL into something, you'll need to use the "Raw" link on GitHub. Otherwise, just download the ones you want to use and add them directly.

Does that clear it up a bit? Sorry for the confusion. I'll see if I can clarify the instructions. Thanks for the report.

[jflorian]

Well, I knew the styl files were not CSS, but figured they might be what Stylish likes for lunch, although I doubted that too given your development section indicated these were like source for the Make.

Otherwise I think I follow you correctly. So if I wanted to enable all of these css files I would create one Stylish style for each css file. Am I correct? I was expecting to get everything in a single shot which is where my confusion may have started.

[alphapapa]

Yeah, Stylish and userStyles.css and that sort of thing just use plain CSS. Stylus is more efficient to work with than plain CSS, so it makes this sort of project easier.

Well, in the Files section of the readme, I try to explain what the different CSS files are for. The all-sites files have all of the rules for all of the sites put into a single CSS file. This works pretty well in my experience so far, but of course, since there's a single CSS namespace, it's possible that there could be conflicting rules if more than one site were to use the same class name or ID. If you use the all-sites file and want to apply it to every site you visit, you would add it as a "global" style.

I also generate the CSS files for individual sites, so if you only want to style certain sites, you can just add the appropriate files as site-specific styles.

And then there's the generic CSS file, which doesn't have any site-specific rules, just general HTML element rules.

I guess what's missing from the documentation is info about how to use Stylish/etc. I took it for granted that anyone who wanted to do this would already be using it and know how to add these stylesheets to it. I guess it would be a good idea to have a basic how-to to get people started who haven't used them before. What do you think? :)

[jflorian]

I understand so much more now just from your last comment. I do think having a how-to would be helpful with the uptake. I was sent here from a comment on lwn.net and hoped for an experience about as trivial as a Firefox add-on. IMHO, you shouldn't need to have your own how-to. The Stylish add-on suggested visiting userstyles.org for info but when I got there I really didn't see anything helpful to get me going with your setup. They did make it trivial to use one of their styles and I had even found a style there named "Solarized Dark Everywhere" and immediately wondered if it was related to this project -- I still don't know but I suspect it's independent. If they're indeed independent maybe it would be best to get yours there? Then this site could focus more on bug reporting and general development of the style.

[alphapapa]

FYI, I just added sheets for LWN specifically. Sadly, they use the span tag without any class or ID, so I had to leave that unstyled, because otherwise it conflicts with other sites in the all-sites files.

BTW, that "Solarized Dark Everywhere" is not by me. I will see about getting this project on userstyles.org though. Thanks for the idea. :)

[alphapapa]

FYI, I put the GitHub one up: https://userstyles.org/styles/127328/github-solarized

[doneill]

How do you switch from Dark to Light? Do you have to edit the style after install?

[The-Compiler]

@doneill by e.g. using solarized-all-sites-light.css instead of solarized-all-sites-dark.css.

[doneill]

Thanks @The-Compiler, thought there might be a setting to change.