···

       
251
       
 
       
   <para>

     

       
252
       
 
       
    The list of available packages in the various ELPA repositories can be seen

     

       
253
       
 
       
    with the following commands:

     

       
254
       
-
       
    <example xml:id="module-services-emacs-querying-packages">

     

       
255
       
-
       
     <title>Querying Emacs packages</title>

     

       
256
       
 
       
<programlisting><![CDATA[

     

       
257
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.elpaPackages

     

       
258
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.melpaPackages

     

       
259
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.melpaStablePackages

     

       
260
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.orgPackages

     

       
261
       
 
       
]]></programlisting>

     

       
262
       
-
       
    </example>

     

       
263
       
 
       
   </para>

     

       
264
       
 
       


     

       
265
       
 
       
   <para>

     
···

       
267
       
 
       
    adding it to the list of system packages (see

     

       
268
       
 
       
    <xref linkend="sec-declarative-package-mgmt" />). Simply modify your file

     

       
269
       
 
       
    <filename>configuration.nix</filename> to make it contain:

     

       
270
       
-
       
    <example xml:id="module-services-emacs-configuration-nix">

     

       
271
       
-
       
     <title>Custom Emacs in <filename>configuration.nix</filename></title>

     

       
272
       
 
       
<programlisting><![CDATA[

     

       
273
       
 
       
{

     

       
274
       
 
       
 environment.systemPackages = [

     
···

       
277
       
 
       
  ];

     

       
278
       
 
       
}

     

       
279
       
 
       
]]></programlisting>

     

       
280
       
-
       
    </example>

     

       
281
       
 
       
   </para>

     

       
282
       
 
       


     

       
283
       
 
       
   <para>

     
···

       
296
       
 
       
    <filename>~/.config/nixpkgs/config.nix</filename> (see

     

       
297
       
 
       
    <link xlink:href="https://nixos.org/nixpkgs/manual/#sec-modify-via-packageOverrides">Nixpkgs

     

       
298
       
 
       
    manual</link>):

     

       
299
       
-
       
    <example xml:id="module-services-emacs-config-nix">

     

       
300
       
-
       
     <title>Custom Emacs in <filename>~/.config/nixpkgs/config.nix</filename></title>

     

       
301
       
 
       
<programlisting><![CDATA[

     

       
302
       
 
       
{

     

       
303
       
 
       
  packageOverrides = super: let self = super.pkgs; in {

     
···

       
305
       
 
       
  };

     

       
306
       
 
       
}

     

       
307
       
 
       
]]></programlisting>

     

       
308
       
-
       
    </example>

     

       
309
       
 
       
   </para>

     

       
310
       
 
       


     

       
311
       
 
       
   <para>

     
···

       
327
       
 
       
    <filename>emacs.nix</filename> in this way:

     

       
328
       
 
       
   </para>

     

       
329
       
 
       


     

       
330
       
-
       
   <example xml:id="ex-emacsGtk3Nix">

     

       
331
       
-
       
    <title>Custom Emacs build</title>

     

       
332
       
 
       
<programlisting><![CDATA[

     

       
333
       
 
       
{ pkgs ? import <nixpkgs> {} }:

     

       
334
       
 
       
let

     
···

       
345
       
 
       
  });

     

       
346
       
 
       
in [...]

     

       
347
       
 
       
]]></programlisting>

     

       
348
       
-
       
   </example>

     

       
349
       
 
       


     

       
350
       
 
       
   <para>

     

       
351
       
 
       
    After building this file as shown in <xref linkend="ex-emacsNix" />, you

     
···

       
483
       
 
       
  <para>

     

       
484
       
 
       
   The Emacs init file should be changed to load the extension packages at

     

       
485
       
 
       
   startup:

     

       
486
       
-
       
   <example xml:id="module-services-emacs-package-initialisation">

     

       
487
       
-
       
    <title>Package initialization in <filename>.emacs</filename></title>

     

       
488
       
 
       
<programlisting><![CDATA[

     

       
489
       
 
       
(require 'package)

     

       
490
       
 
       


     
···

       
494
       
 
       
(setq package-enable-at-startup nil)

     

       
495
       
 
       
(package-initialize)

     

       
496
       
 
       
]]></programlisting>

     

       
497
       
-
       
   </example>

     

       
498
       
 
       
  </para>

     

       
499
       
 
       


     

       
500
       
 
       
  <para>

     
···

       
556
       
 
       
    Then customize the variable <varname>rng-schema-locating-files</varname> to

     

       
557
       
 
       
    include <filename>~/.emacs.d/schemas.xml</filename> and put the following

     

       
558
       
 
       
    text into that file:

     

       
559
       
-
       
    <example xml:id="ex-emacs-docbook-xml">

     

       
560
       
-
       
     <title>nXML Schema Configuration (<filename>~/.emacs.d/schemas.xml</filename>)</title>

     

       
561
       
 
       
<programlisting language="xml"><![CDATA[

     

       
562
       
 
       
<?xml version="1.0"?>

     

       
563
       
 
       
<!--

     
···

       
577
       
 
       
  -->

     

       
578
       
 
       
</locatingRules>

     

       
579
       
 
       
]]></programlisting>

     

       
580
       
-
       
    </example>

     

       
581
       
 
       
   </para>

     

       
582
       
 
       
  </section>

     

       
583
       
 
       
 </section>

     

···

       
251
       
 
       
   <para>

     

       
252
       
 
       
    The list of available packages in the various ELPA repositories can be seen

     

       
253
       
 
       
    with the following commands:

     

       
254
       
+
       
    <anchor xml:id="module-services-emacs-querying-packages" />

     

       
0
       
 
       

     

       
255
       
 
       
<programlisting><![CDATA[

     

       
256
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.elpaPackages

     

       
257
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.melpaPackages

     

       
258
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.melpaStablePackages

     

       
259
       
 
       
nix-env -f "<nixpkgs>" -qaP -A emacs.pkgs.orgPackages

     

       
260
       
 
       
]]></programlisting>

     

       
0
       
 
       

     

       
261
       
 
       
   </para>

     

       
262
       
 
       


     

       
263
       
 
       
   <para>

     
···

       
265
       
 
       
    adding it to the list of system packages (see

     

       
266
       
 
       
    <xref linkend="sec-declarative-package-mgmt" />). Simply modify your file

     

       
267
       
 
       
    <filename>configuration.nix</filename> to make it contain:

     

       
268
       
+
       
    <anchor xml:id="module-services-emacs-configuration-nix" />

     

       
0
       
 
       

     

       
269
       
 
       
<programlisting><![CDATA[

     

       
270
       
 
       
{

     

       
271
       
 
       
 environment.systemPackages = [

     
···

       
274
       
 
       
  ];

     

       
275
       
 
       
}

     

       
276
       
 
       
]]></programlisting>

     

       
0
       
 
       

     

       
277
       
 
       
   </para>

     

       
278
       
 
       


     

       
279
       
 
       
   <para>

     
···

       
292
       
 
       
    <filename>~/.config/nixpkgs/config.nix</filename> (see

     

       
293
       
 
       
    <link xlink:href="https://nixos.org/nixpkgs/manual/#sec-modify-via-packageOverrides">Nixpkgs

     

       
294
       
 
       
    manual</link>):

     

       
295
       
+
       
    <anchor xml:id="module-services-emacs-config-nix" />

     

       
0
       
 
       

     

       
296
       
 
       
<programlisting><![CDATA[

     

       
297
       
 
       
{

     

       
298
       
 
       
  packageOverrides = super: let self = super.pkgs; in {

     
···

       
300
       
 
       
  };

     

       
301
       
 
       
}

     

       
302
       
 
       
]]></programlisting>

     

       
0
       
 
       

     

       
303
       
 
       
   </para>

     

       
304
       
 
       


     

       
305
       
 
       
   <para>

     
···

       
321
       
 
       
    <filename>emacs.nix</filename> in this way:

     

       
322
       
 
       
   </para>

     

       
323
       
 
       


     

       
324
       
+
       
   <anchor xml:id="ex-emacsGtk3Nix" />

     

       
0
       
 
       

     

       
325
       
 
       
<programlisting><![CDATA[

     

       
326
       
 
       
{ pkgs ? import <nixpkgs> {} }:

     

       
327
       
 
       
let

     
···

       
338
       
 
       
  });

     

       
339
       
 
       
in [...]

     

       
340
       
 
       
]]></programlisting>

     

       
0
       
 
       

     

       
341
       
 
       


     

       
342
       
 
       
   <para>

     

       
343
       
 
       
    After building this file as shown in <xref linkend="ex-emacsNix" />, you

     
···

       
475
       
 
       
  <para>

     

       
476
       
 
       
   The Emacs init file should be changed to load the extension packages at

     

       
477
       
 
       
   startup:

     

       
478
       
+
       
   <anchor xml:id="module-services-emacs-package-initialisation" />

     

       
0
       
 
       

     

       
479
       
 
       
<programlisting><![CDATA[

     

       
480
       
 
       
(require 'package)

     

       
481
       
 
       


     
···

       
485
       
 
       
(setq package-enable-at-startup nil)

     

       
486
       
 
       
(package-initialize)

     

       
487
       
 
       
]]></programlisting>

     

       
0
       
 
       

     

       
488
       
 
       
  </para>

     

       
489
       
 
       


     

       
490
       
 
       
  <para>

     
···

       
546
       
 
       
    Then customize the variable <varname>rng-schema-locating-files</varname> to

     

       
547
       
 
       
    include <filename>~/.emacs.d/schemas.xml</filename> and put the following

     

       
548
       
 
       
    text into that file:

     

       
549
       
+
       
    <anchor xml:id="ex-emacs-docbook-xml" />

     

       
0
       
 
       

     

       
550
       
 
       
<programlisting language="xml"><![CDATA[

     

       
551
       
 
       
<?xml version="1.0"?>

     

       
552
       
 
       
<!--

     
···

       
566
       
 
       
  -->

     

       
567
       
 
       
</locatingRules>

     

       
568
       
 
       
]]></programlisting>

     

       
0
       
 
       

     

       
569
       
 
       
   </para>

     

       
570
       
 
       
  </section>

     

       
571
       
 
       
 </section>