Robert Cranston authored on 26/03/2022 11:46:59
| ... | ... |
@@ -2,11 +2,51 @@ |
| 2 | 2 |
|
| 3 | 3 |
An [Ansible][] [role][] for installing [Firefox][] [extension][]s. |
| 4 | 4 |
|
| 5 |
+Takes a list of extension [slug][]s (the part after |
|
| 6 |
+`https://addons.mozilla.org/en-US/firefox/addon/`) and downloads and places the |
|
| 7 |
+extensions in the `extensions` directory in the default profile (a subdirectory |
|
| 8 |
+of `$HOME/.mozilla/firefox/`). |
|
| 9 |
+ |
|
| 10 |
+Note that, unless `extensions.autoDisableScopes` is set to an appropriate value |
|
| 11 |
+in `user.js`, extensions have to be enabled manually (e.g. from "Extensions" in |
|
| 12 |
+`about:addons`). |
|
| 13 |
+ |
|
| 5 | 14 |
[`ansible-role-firefox-extensions`]: https://git.rcrnstn.net/rcrnstn/ansible-role-firefox-extensions |
| 6 | 15 |
[Ansible]: https://docs.ansible.com/ansible |
| 7 | 16 |
[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html |
| 8 | 17 |
[Firefox]: https://en.wikipedia.org/wiki/Firefox |
| 9 | 18 |
[extension]: https://en.wikipedia.org/wiki/Firefox#Browser_extensions |
| 19 |
+[slug]: https://en.wikipedia.org/wiki/Clean_URL#Slug |
|
| 20 |
+ |
|
| 21 |
+## Usage |
|
| 22 |
+ |
|
| 23 |
+Example [`requirements.yml`][]: |
|
| 24 |
+ |
|
| 25 |
+```yaml |
|
| 26 |
+--- |
|
| 27 |
+ |
|
| 28 |
+roles: |
|
| 29 |
+ - name: 'firefox-extensions' |
|
| 30 |
+ src: 'https://git.rcrnstn.net/rcrnstn/ansible-firefox-extensions' |
|
| 31 |
+ scm: 'git' |
|
| 32 |
+``` |
|
| 33 |
+ |
|
| 34 |
+Example [playbook][]: |
|
| 35 |
+ |
|
| 36 |
+```yaml |
|
| 37 |
+--- |
|
| 38 |
+ |
|
| 39 |
+- hosts: 'all' |
|
| 40 |
+ roles: |
|
| 41 |
+ - role: 'firefox-extensions' |
|
| 42 |
+ firefox_extensions: |
|
| 43 |
+ - 'ublock-origin' |
|
| 44 |
+ - 'old-reddit-redirect' |
|
| 45 |
+ - 'tridactyl-vim' |
|
| 46 |
+``` |
|
| 47 |
+ |
|
| 48 |
+[`requirements.yml`]: https://docs.ansible.com/ansible/latest/galaxy/user_guide.html#installing-multiple-roles-from-a-file |
|
| 49 |
+[playbook]: https://docs.ansible.com/ansible/latest/user_guide/playbooks.html |
|
| 10 | 50 |
|
| 11 | 51 |
## License |
| 12 | 52 |
|
Robert Cranston authored on 26/03/2022 07:57:06
| ... | ... |
@@ -7,3 +7,11 @@ An [Ansible][] [role][] for installing [Firefox][] [extension][]s. |
| 7 | 7 |
[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html |
| 8 | 8 |
[Firefox]: https://en.wikipedia.org/wiki/Firefox |
| 9 | 9 |
[extension]: https://en.wikipedia.org/wiki/Firefox#Browser_extensions |
| 10 |
+ |
|
| 11 |
+## License |
|
| 12 |
+ |
|
| 13 |
+Licensed under the [ISC License][] unless otherwise noted, see the |
|
| 14 |
+[`LICENSE`][] file. |
|
| 15 |
+ |
|
| 16 |
+[ISC License]: https://choosealicense.com/licenses/isc/ |
|
| 17 |
+[`LICENSE`]: LICENSE |
Robert Cranston authored on 26/03/2022 07:57:05
| 1 | 1 |
new file mode 100644 |
| ... | ... |
@@ -0,0 +1,9 @@ |
| 1 |
+# [`ansible-role-firefox-extensions`][] |
|
| 2 |
+ |
|
| 3 |
+An [Ansible][] [role][] for installing [Firefox][] [extension][]s. |
|
| 4 |
+ |
|
| 5 |
+[`ansible-role-firefox-extensions`]: https://git.rcrnstn.net/rcrnstn/ansible-role-firefox-extensions |
|
| 6 |
+[Ansible]: https://docs.ansible.com/ansible |
|
| 7 |
+[role]: https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html |
|
| 8 |
+[Firefox]: https://en.wikipedia.org/wiki/Firefox |
|
| 9 |
+[extension]: https://en.wikipedia.org/wiki/Firefox#Browser_extensions |
git.rcrnstn.net