doc: add module README for Firefox and derivatives (#897)
Link: https://github.com/danth/stylix/pull/897 Reviewed-by: NAHO <90870942+trueNAHO@users.noreply.github.com>
This commit is contained in:
parent
225b4c57c9
commit
ebdcc2a190
1 changed files with 37 additions and 0 deletions
37
modules/firefox/README.md
Normal file
37
modules/firefox/README.md
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
# Firefox and its derivatives
|
||||
|
||||
This module supports [Firefox](https://www.mozilla.org/firefox/), in addition
|
||||
to [Floorp](https://floorp.app/) and [LibreWolf](https://librewolf.net/),
|
||||
which are Firefox derivatives.
|
||||
|
||||
The same implementation is shared between all of these browsers, but they don't
|
||||
share option values.
|
||||
|
||||
> [!IMPORTANT]
|
||||
>
|
||||
> For any theming to be applied, you need to tell this module which
|
||||
> [profiles](https://support.mozilla.org/en-US/kb/profiles-where-firefox-stores-user-data)
|
||||
> you're using:
|
||||
>
|
||||
> ```nix
|
||||
> {
|
||||
> programs.firefox = {
|
||||
> enable = true;
|
||||
>
|
||||
> profiles = {
|
||||
> my-profile = {
|
||||
> # bookmarks, extensions, search engines...
|
||||
> };
|
||||
> my-friends-profile = {
|
||||
> # bookmarks, extensions, search engines...
|
||||
> };
|
||||
> };
|
||||
> };
|
||||
>
|
||||
> stylix.targets.firefox.profileNames = [ "my-profile" "my-friends-profile" ];
|
||||
> }
|
||||
> ```
|
||||
>
|
||||
> This is necessary due to a limitation of the module system: we can either
|
||||
> detect the list of profiles, or change their configuration, but we can't do
|
||||
> both without infinite recursion.
|
||||
Loading…
Add table
Add a link
Reference in a new issue