Code structure » History » Version 4
koszko, 09/04/2021 07:06 PM
1 | 1 | jahoti | # Code structure |
---|---|---|---|
2 | |||
3 | The idea of arranging script files based on their execution context might not be the best one. Suggestions are welcome. |
||
4 | |||
5 | {{toc}} |
||
6 | |||
7 | ## `background/` |
||
8 | Contains scripts that are to be run exclusively in the context of the background page. |
||
9 | |||
10 | 2 | jahoti | ## `build.sh` |
11 | 3 | jahoti | Builds the project, creating a `build_mozilla` or `build_chromium` folder in the working directory containing the unpacked extension. Run as `/path/to/build.sh mozilla|chromium`. |
12 | 2 | jahoti | |
13 | 1 | jahoti | ## `common/` |
14 | Contains scripts that are to be run in more than one context. E.g. script that gets evaluated in contexts of both settings page and background page is going to reside in this directory. |
||
15 | |||
16 | ## `content/` |
||
17 | Contains scripts that execute exclusively in the context of content scripts. |
||
18 | |||
19 | 2 | jahoti | ## `copyright` |
20 | Contains copyright information in [Debian's machine-readable format](https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/) (not all license texts are included; these reside under `licenses/`). |
||
21 | 1 | jahoti | |
22 | 2 | jahoti | ## `default_settings.json` |
23 | The default settings for the extension, in the format that settings are exported from the extension. This will be removed at some point, as per #48 . |
||
24 | |||
25 | 1 | jahoti | ## `html/` |
26 | 4 | koszko | Contains javascript, HTML and CSS files for settings and popup pages. |
27 | 1 | jahoti | |
28 | ## `icons/` |
||
29 | Contains icons graphics used by the extension. |
||
30 | |||
31 | ## `licenses/` |
||
32 | Contains full legal texts of licenses used. |
||
33 | |||
34 | ## `manifest.json` |
||
35 | 4 | koszko | Is the manifest file with the most important extension information for the browser. For now this is a version 2 manifest (version 3 is to require some more changes in he extension). This file is not a complete manifest - that one gets generated from `manifest.json` when `build.sh` script gets run. |
36 | 1 | jahoti | |
37 | ## `README.txt` |
||
38 | Contains some general information about the extension. |