Project

General

Profile

Code structure » History » Version 2

jahoti, 07/13/2021 11:12 AM
Removed COPYING.txt and TODOS.org, and added build.sh, copyright and default_settings.json

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
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
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
Contains javascript, HTML and (in the future) CSS files for settings and popup pages.
27
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
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 a redesign of the entire extension). Temporarily, the same `manifest.json` is being used for both browser families.
36
37
## `README.txt`
38
Contains some general information about the extension.