summaryrefslogtreecommitdiff
path: root/web/tutorials/01-installation.markdown
diff options
context:
space:
mode:
Diffstat (limited to 'web/tutorials/01-installation.markdown')
-rw-r--r--web/tutorials/01-installation.markdown32
1 files changed, 11 insertions, 21 deletions
diff --git a/web/tutorials/01-installation.markdown b/web/tutorials/01-installation.markdown
index cede105..ce4e30b 100644
--- a/web/tutorials/01-installation.markdown
+++ b/web/tutorials/01-installation.markdown
@@ -6,17 +6,13 @@ author: Jasper Van der Jeugt
Installation
------------
-Installation is provided using [cabal], and some packages are available for
-different distributions.
+Installation is provided via Hackage, and some packages are available for
+different distributions. For installation from source (i.e. via Hackage),
+[stack] is recommended:
- $ cabal install hakyll
+ $ stack install hakyll
-[cabal]: http://www.haskell.org/cabal/
-
-If you have a recent installation of `cabal` and your time is somewhat valuable,
-use:
-
- $ cabal install -j hakyll
+[stack]: http://www.haskellstack.org/
Linux distro packages:
@@ -34,27 +30,21 @@ started:
This creates a folder `my-site` in the current directory, with some example
content and a generic configuration.
-If `hakyll-init` is not found, you should make sure `$HOME/.cabal/bin` is in
-your `$PATH`.
-
-(If you're on OS X you may not have a bin directory in `$HOME/.cabal`. In this
-case, check `$HOME/Library/Haskell/bin` and put it on your path if you find
-`hakyll-init` there. See [here] for more information on installation paths on
-OS X.)
-
-[here]: http://www.haskell.org/haskellwiki/Mac_OS_X_Common_Installation_Paths
+If `hakyll-init` is not found, you should make sure your stack bin path
+(usually `$HOME/.local/bin`) is in your `$PATH`. You can check your stack local
+bin path by running `stack path --local-bin-path`.
The file `site.hs` holds the configuration of your site, as an executable
haskell program. We can compile and run it like this:
$ cd my-site
- $ ghc --make -threaded site.hs
- $ ./site build
+ $ stack build
+ $ stack exec site build
If you installed `hakyll` with a preview server (this is the default), you can
now use
- $ ./site watch
+ $ stack exec site watch
and have a look at your site at
[http://localhost:8000/](http://localhost:8000/).