Skip to content

Commit d1eb354

Browse files
authored
Added readme.
1 parent bb91c97 commit d1eb354

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
# S-CSS-P
2+
*A stylesheet picker for The SCP Wiki.*
3+
4+
##Contributing
5+
6+
There are five available types of stylesheets to build:
7+
8+
1. Layouts (movement of elements around the page, margins and padding for big block-level stuff.
9+
2. Colors (colors, background colors, border styles and colors, box shadows, menu images, and margins and padding for small item-level stuff.
10+
3. Images (Primarily used to override the #header background url, but could also be used for other url-level replacements if they don't make sense in color)
11+
4. Fonts (Uses an import from a trusted CDN like Google Fonts and overrides font-face appearance)
12+
5. Ratings (Controls the visibility of the rating module)
13+
14+
They also cascade in that order, with layout injected first and ratings last. The site's extant stylesheets load before any of these, so any element not styled by one of the five will use the site's stylesheet, and finally the user-agent stylesheet as a fallback. This will affect the elements that may need `!important` set on them.
15+
16+
If you want a unified theme that touches more than one area, it needs to be broken out into different stylesheets. That means no `background-color:` selectors in a `.layouts.css` file and no `position:` stuff in a `.fonts.css` file.
17+
18+
There is also a `/img` folder where you put your thumbnail of the look of the thing. Dimensions are:
19+
20+
* Color: 275x225
21+
* Font: 50px height
22+
* Layout: 275x225 unless showing full-width, then 457x225
23+
* Logo: 100x100
24+
* Rating: 275x225
25+
26+
If you have assets that need to be loaded like alternate logos, please store them on http://www.scp-wiki.net/component:s-css-p which will require a wikidot login, or get them to me in some other manner and I will handle it. Do *not* link to imgur or some other image hosting service in your CSS.
27+
28+
The files that drive the extension are:
29+
30+
* `manifest.json` - This is read by browsers to let it know what permissions the extension needs, and where things like the extension options page and icons are. Note the `content_scripts` section that calls out `scpnet.org`, this is for the "interwiki" iframe provided by SCP-RU.
31+
* `options.html` - This is static so if you add a stylesheet, you need to add a corresponding option line here. The extension is not smart enough to do it dynamically and probably won't ever be due to an interest in keeping it small and lightweight.
32+
* `options.js` - This handles the loading and saving of preferences via the `chrome.storage.sync.get/set` API.
33+
* `main.js` - This handles the injection of the stylesheets into the bottom of the `head` so they cascade correctly.

0 commit comments

Comments
 (0)