commit 4762d8015735299ebdf9c89df08a109ab90298f7 · soopy.moe/gensokyo

+50 -1
docs/tips_n_tricks.md
···

       4
       4
        
       ## overriding packages

     

       5
       5
        
       the pill confused me and i thought i had to make overlays to do overrides but no

     

       6
       6
        
       

     

       7
       7
       -
       in packages (i.e. `environment.systemPackages`), just do 

     

       7
       7
       +
       in packages (i.e. `environment.systemPackages`), just do

     

       8
       8
        
       ```nix

     

       9
       9
        
       #-------8<-Snip-------

     

       10
       10
        
       environment = {

     
···

       21
       21
        
       security.sudo.package = (pkgs.sudo.override {withInsults = true;});

     

       22
       22
        
       ```

     

       23
       23
        
       

     

       24
       24
       +
       ## overlays

     

       25
       25
       +
       overlays are useful when you want to refer to refer to a package globally.

     

       26
       26
       +
       

     

       27
       27
       +
       the gist of overlays is as thus:

     

       28
       28
       +
       

     

       29
       29
       +
       > overlay is just `prev: final: {}` functions where dumbed down idea is

     

       30
       30
       +
       > that you do pkg = prev.pkg.override and refer to everything else from

     

       31
       31
       +
       > final

     

       32
       32
       +
       >

     

       33
       33
       +
       > idea is like final = prev // overlay(prev, final)

     

       34
       34
       +
       > (it's a recursive definition)

     

       35
       35
       +
       

     

       36
       36
       +
       (poorly made) example overlays can be found [here](https://github.com/soopyc/nixos-config/blob/master/overlays/discord-canary.nix)

     

       37
       37
       +
       

     

       38
       38
       +
       *note: replace `self: super:` with `prev: final:` for consistency*

     

       39
       39
       +
       

     

       40
       40
       +
       *concept and content by \@natsukagami*

     

       41
       41
       +
       

     

       42
       42
       +
       ## extra opts

     

       43
       43
       +
       a way of passing additional options globally to modules is by using extraOpts.

     

       44
       44
       +
       

     

       45
       45
       +
       <!-- find a way that we can still use this apart from in nixos config-->

     

       46
       46
       +
       for example, check out this line in our flake.nix:

     

       47
       47
       +
       

     

       48
       48
       +
       https://github.com/soopyc/nix-on-koumakan/blob/3c32de4a69a5963f9cd83bf5cf0dccea88f9f36c/flake.nix#L22-L26

     

       49
       49
       +
       

     

       50
       50
       +
       this avoids the horror of `import ../../../utils/bar.nix;`

     

       51
       51
       +
       

     

       52
       52
       +
       refer to [nixpkgs:nixos/lib/eval-config.nix] and [nixpkgs:lib/modules.nix#122] for more info

     

       53
       53
       +
       

     

       54
       54
       +
       note that extraArgs is deprecated, so you will need to use config._module.args (i have no idea

     

       55
       55
       +
       how this works)

     

       56
       56
       +
       

     

       57
       57
       +
       *pointers by \@natsukagami*

     

       58
       58
       +
       

     

       59
       59
       +
       # @ (at) syntax

     

       60
       60
       +
       very simple.

     

       61
       61
       +
       

     

       62
       62
       +
       ```nix

     

       63
       63
       +
       args@{a, b, c, ...}: {

     

       64
       64
       +
         # args.a and a are the same

     

       65
       65
       +
       }

     

       66
       66
       +
       ```

     

       67
       67
       +
       

     

       24
       68
        
       ## nginx regex location

     

       25
       69
        
       ```nix

     

       26
       70
        
         locations."~ \.php$".extraConfig = ''

     
···

       28
       72
        
         '';

     

       29
       73
        
       ```

     

       30
       74
        
       from [nixos wiki](https://nixos.wiki/wiki/Nginx#LEMP_stack)

     

       75
       75
       +
       

     

       76
       76
       +
       

     

       77
       77
       +
       <!--links-->

     

       78
       78
       +
       [nixpkgs:lib/modules.nix#122]: https://github.com/NixOS/nixpkgs/blob/6e68daefde56a7a8e6fe7c3ca9ceeb436294bb9f/lib/modules.nix#L122

     

       79
       79
       +
       [nixpkgs:nixos/lib/eval-config.nix]: https://github.com/NixOS/nixpkgs/blob/5054472759a3b0df8e18cfe4031a5eff92d4cdc3/nixos/lib/eval-config.nix