Git/firefox-user.js
1
0
Fork 0
mirror of https://github.com/arkenfox/user.js.git synced 2024-11-25 20:11:38 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated 3.2 Additonal JS Files (markdown)

Thorin-Oakenpants 2017-12-24 16:09:50 +13:00
parent 8c67df1879
commit 0fc780d453
1 changed files with 8 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
3.2-Additonal-JS-Files.md

@ -4,11 +4,15 @@ Keeping track of all **your** changes/additions and keeping up to date with all
### :small_orange_diamond: The Solution
Keep your changes in a SEPARATE file (see the example below), and append them to the end of the `user.js` when you update. This simplifies updating the `user.js` (for which we have created some [updater scripts](https://github.com/ghacksuserjs/ghacks-user.js/wiki/3.3-Updater-Scripts) for you). Then all you have to do is follow our easy, succinct [changelogs](https://github.com/ghacksuserjs/ghacks-user.js/search?q=label%3Achangelog&type=Issues&utf8=✓) to discover new items and changes
Keep your changes in a SEPARATE file as your master copy (see the example below), and manually append them to the end of the `user.js` when you ~~update~~ replace it with the latest version. This simplifies updating the `user.js`. Then all you have to do is follow our easy, succinct [changelogs](https://github.com/ghacksuserjs/ghacks-user.js/search?q=label%3Achangelog&type=Issues&utf8=✓) to discover new items and changes.
We have created some [updater scripts](https://github.com/ghacksuserjs/ghacks-user.js/wiki/3.3-Updater-Scripts) to do all of this for you - i.e backup your `user.js`, create a new `user.js` using our current master, and append your overrides - BUT you need to follow our file naming convention.
Note the caveats below including having to manually reapply any one-char section switches if they differ from our master.
> :small_blue_diamond: `user-override.js` [recommended]
>
> Create a `user-override.js` file in your profile directory. This acts as the master copy of all your tweaks, and our updater scripts will auto append its contents for you to the end of the `user.js`
> Create a `user-override.js` file in your profile directory. This acts as the master copy of all your tweaks, and our updater scripts will auto append its contents for you to the end of the `user.js` after it downloads the current `ghacks user.js` master.
> :small_blue_diamond: `profile/preferences/*.js` [old method]
>
@ -46,6 +50,8 @@ The next time you update the `profile/user.js` and replace it, all your have to
You will need to monitor your small set of overrides due to Firefox changes. Just keep an eye on things is all I'm saying
- One-Char Switches
* Several sections in the `user.js` have one-char switches to enable/disable the entire section (e.g. deprecated items by ESR version). You will have to remember to do these manually if required.
- Deprecated Items
* A deprecated item will not remove, or comment itself out in your override.js, you will have to do it manually (and reset in about:config to get rid of it, which you would need to do anyway). No harm, it will just not be a pref that does anything anymore.
- Changes to Default Values