You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+28-8Lines changed: 28 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,6 +3,31 @@
3
3
4
4
## Contributing
5
5
6
+
### Building
7
+
8
+
Development requires [Node.js](https://nodejs.org) and NPM:
9
+
10
+
```shell
11
+
sudo apt install nodejs npm
12
+
```
13
+
14
+
To build the extension:
15
+
16
+
```shell
17
+
npm run build
18
+
```
19
+
20
+
There is also `npm run dev` which will spawn a process that watches for changes and rebuilds the extension automatically.
21
+
22
+
The files that drive the extension are:
23
+
24
+
*`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.
25
+
*`options.html` - This is the webpage that appears when you open the extension's options, and is the UI for setting preferences.
26
+
*`options.js` - This handles the loading and saving of preferences via the `chrome.storage.sync.get/set` API.
27
+
*`main.js` - This handles the injection of the stylesheets into the bottom of the `head` so they cascade correctly.
28
+
29
+
### Adding new styles
30
+
6
31
There are five available types of stylesheets to build:
7
32
8
33
1. Layouts (movement of elements around the page, margins and padding for big block-level stuff.
@@ -15,6 +40,8 @@ They also cascade in that order, with layout injected first and ratings last. Th
15
40
16
41
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
42
43
+
If you add a stylesheet, you need to add a corresponding option line in `options.html`. 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.
44
+
18
45
There is also a `/img` folder where you put your thumbnail of the look of the thing. Dimensions are:
19
46
20
47
* Color: 275x225
@@ -25,13 +52,6 @@ There is also a `/img` folder where you put your thumbnail of the look of the th
25
52
26
53
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
54
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.
34
-
35
55
## Overriding S-CSS-P
36
56
37
-
If you have a page that contains custom CSS and would like to alert users of S-CSS-P that they should consider disabling the extension, please edit the slug of your page into http://scp-wiki.net/component:s-css-p in the code block. This is not yet implemented but the next major milestone will include this capability.
57
+
If you have a page that contains custom CSS and would like to alert users of S-CSS-P that they should consider disabling the extension, please edit the slug of your page into http://scp-wiki.net/component:s-css-p in the code block. This is not yet implemented but the next major milestone will include this capability.
0 commit comments