Emacs: Difference between revisions

<syntaxhighlight lang="bash" start="3">

nix-shell -p emacs

</syntaxhighlight>After modifying your configuration, apply the changes by running:<syntaxhighlight lang="bash">

sudo nixos-rebuild switch

</syntaxhighlight>After updating your configuration, apply the changes by running:<syntaxhighlight lang="bash">

home-manager switch

<code>emacs.pkgs.pretty-sha-path</code> is quality of life improvement for nix, guix users.

Allows toggling Guix / Nix store paths by replacing SHA-sequences with ellipsis, i.e.:

<syntaxhighlight lang="bash">

/gnu/store/72f54nfp6g1hz873w8z3gfcah0h4nl9p-foo-0.1  →  /gnu/store/…-foo-0.1

/nix/store/nh4n4yzb1bx7nss2rg342dz44g14m06x-bar-0.2  →  /nix/store/…-bar-0.2

</syntaxhighlight>

==== Adding packages from outside ELPA / MELPA ====

==== Packaging and testing emacs nixpkgs ====

They are located at pkgs/applications/editors/emacs/elisp-packages/manual-packages/ and a new pkg must be added under pkgs/applications/editors/elisp-packages/manual-packages.nix.

Once the nixpkg is ready, it can be tested using the following command. This inserts the nixpkg into the load-path of emacs.

  nix-shell -I nixpkgs=<path_to_nixpkgs_copy> -p "(emacsPackagesFor pkgs.emacs28).emacsWithPackages (epkgs: [ epkgs.<package> ])"

[https://github.com/NixOS/nixpkgs/pull/189543 Since 2022-09], the package called <code>emacs</code> now installs the lucid toolkit instead of gtk. The reason is that emacs is less stable with gtk especially in daemon mode. However, the lucid flavor of emacs will not take into account the gtk theme (since it is not even gtk) and looks quite… ugly (see comparisons [https://emacs.stackexchange.com/questions/33065/on-linux-why-should-one-choose-lucid-over-gtk-gui-for-emacs here]). If you still prefer the gtk version of emacs, you can instead install <code>emacs-gtk</code> (before 2022-09 this package does not exist and emacs defaults to the gtk version).

The [https://github.com/nix-community/emacs-overlay community overlay] provides nightly versions of the Emacs unstable branches, ELPA / MELPA packages, and [https://github.com/ch11ng/exwm EXWM] + its dependencies. '''To use these, first apply the overlay (instructions below), which will make the packages available in nixpkgs.''' Then you can follow the normal nixpkgs installation instructions (above), but use your package of choice from the overlay (e.g. <code>pkgs.emacsGit</code>) in place of <code>pkgs.emacs</code>. See the [https://github.com/nix-community/emacs-overlay#emacs-overlay README] for a complete list of packages provided, and their differences.

Using a system flake, one can specify the specific revision of the overlay as a flake input, for example:

 

inputs.emacs-overlay.url = "github:nix-community/emacs-overlay/da2f552d133497abd434006e0cae996c0a282394";

 

This can then be used in the system configuration by using the {{ic|self}} argument:

nixpkgs.overlays = [ (import self.inputs.emacs-overlay) ];

For installing one of the unstable branches of emacs, add the following lines to {{ic|/etc/nixos/configuration.nix}}:

To fix/workaround [[Plasma]] grouping emacs incorrectly (confusing emacs.desktop with emacsclient.desktop), perform the following:

2. right click title bar

3. More Actions > Configure Special Window Settings

4. click Add Property > Desktop File Name

5. set desktop file name to "/home/<USERNAME>/.nix-profile/share/applications/emacs.desktop"

7. restart emacs if need

all emacs instances should now be grouped together, allowing you to pin it and reliably switch to it with Super+<number>

Because emacs expects the dictionaries to be on the same directory as aspell, they won't be picked up. To fix it install the <code>aspellWithDicts</code> package, specifying the dictionaries you want to use: