Project

General

Profile

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.