blob: ae742f41b09ff9e3ce82c6a7a06c49c91367f8c6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
#+TITLE: nix-wrapper around hakyll
This is a simple wrapper around hakyll, which will build hakyll sites
with nix while attempting to minimise the hassle of constantly
recompiling the ~site.hs~ script.
* Components
~default.nix~ contains a function that will take exactly one argument
(a path to some directory containing a ~site.hs~ file), and will return
a function that can be called with ~haskellPackages.callPackage~ to
make a derivation.
~build.nix~ containes a function that will build a hakyll site if given
a suitable directory. However, consider decoupling the build logic
from your site's content by putting your ~site.hs~ script into a
seperate directory from the rest of your site, to stop nix from
recompiling it each time you make a minor change to any other file.
Called with default arguments, ~build.nix~ will built the hakyll
example that ships with ~hakyll-init~, as found in ~./defaultsite~.
* Considerations
Usually, it is advisable to build haskell projects with ~stack~, but
this can easily result in the ~site.hs~ script being compiled to a
single binary over a gigabyte in size (and recompiled from scratch
each time something changes). Instead, the version here will use
the haskell packages contained in ~nixpkgs~ to minimise build times,
since these are usually available as prebuilt substitutes.
Also note that the built hakyll script is only needed to build the
actual site itself, and not a runtime-dependency, i.e. it will not
be connected to a garbage collection root by default and may be removed
by ~nix-collect-garbage~.
|
