Update README.md
This commit is contained in:
parent
dac1af701d
commit
52b4a9f14c
1 changed files with 11 additions and 10 deletions
21
README.md
21
README.md
|
@ -4,25 +4,26 @@ Included theme originally modified from [Filip Sutkowy's *blurclean-firefox-them
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
This script will create or modify the following files and directories:
|
This script will create or modify the following files and directories:
|
||||||
+ `<browser profile directory>/chrome/` and subsidiary CSS files will be created if they do not exist, or overwritten if `-o` is passed, in order to provide the necessary styles
|
+ `$XDG_CONFIG_HOME/foxtheme/chrome/` and subsidiary CSS files will be created if they do not exist, or overwritten if `-o` is passed, in order to provide the necessary styles
|
||||||
|
+ `<browser profile directory>/chrome` will be created as a symlink to `$XDG_CONFIG_HOME/foxtheme/chrome/`
|
||||||
+ `<browser profile directory>/user.js` will be created if it does not exist, or appended to in the case of an existing `user.js`, in order to modify the necessary `about:config` settings for the theme
|
+ `<browser profile directory>/user.js` will be created if it does not exist, or appended to in the case of an existing `user.js`, in order to modify the necessary `about:config` settings for the theme
|
||||||
+ `<browser profile directory>/user-overrides.js` will be created if it does not exist, or appended to in the case of an existing `user-overrides.js`, with the same modifications as the regular `user.js` file in order to ensure current or a potential future compatibility with the [arkenfox user.js (GitHub)](https://github.com/arkenfox/user.js) or similar
|
+ `<browser profile directory>/user-overrides.js` will be created instead of `user.js` if it does not exist and `-r` is passed, or appended to in the case of an existing `user-overrides.js`, with the same modifications as the regular `user.js` file in order to ensure current or a potential future compatibility with the [arkenfox user.js (GitHub)](https://github.com/arkenfox/user.js) or similar
|
||||||
|
|
||||||
Note: `user.js` files are read "top-to-bottom" by the browser, thus giving priority to the final alteration of a given preference that appears within the file. As such, the appending of the necessary preferences for this theme may overwrite users' existing settings for those preferences.
|
|
||||||
|
|
||||||
## Options
|
## Options
|
||||||
```
|
```
|
||||||
Usage: ./foxtheme.sh [OPTIONS] [PROFILE | -a PROFILESDIR]
|
Usage: ./foxtheme.sh [OPTIONS] [PROFILE | -a PROFILESDIR]
|
||||||
-a Apply theme to all (current) browser profiles
|
|
||||||
-j Just create or modify user.js and not user-overrides.js
|
|
||||||
-o Remove and replace an existing theme if found
|
|
||||||
-h Display this help message
|
-h Display this help message
|
||||||
|
-o Remove and replace an existing theme if found
|
||||||
|
-a Apply theme to all (current) browser profiles
|
||||||
|
-r Apply modifications to user-overrides.js instead of user.js
|
||||||
|
-d Don't modify existing user.js values. May cause the theme to behave incorrectly
|
||||||
```
|
```
|
||||||
## Custom themes
|
## Custom themes
|
||||||
This script is ultimately just a glorified wrapper for:
|
This script is ultimately just a glorified wrapper for:
|
||||||
```
|
```
|
||||||
cp -r chrome/ <browser profile directory>/
|
mkdir $XDG_CONFIG_DIR/foxtheme/
|
||||||
|
cp -r chrome/ $XDG_CONFIG_DIR/foxtheme/
|
||||||
|
ln -s -f $XDG_CONFIG_DIR/foxtheme/chrome/ <browser profile directory>
|
||||||
cat user.js >> <browser profile directory>/user.js
|
cat user.js >> <browser profile directory>/user.js
|
||||||
cat user.js >> <browser profile directory>/user-overrides.js
|
|
||||||
```
|
```
|
||||||
As such, replacing the `user.js` or contents of the `chrome` directory with custom preferences and themes should offer the same functionality.
|
As such, replacing the supplied `user.js` or contents of the `chrome` directory with custom preferences and themes should offer the same functionality.
|
||||||
|
|
Loading…
Reference in a new issue