diff options
author | Jasper Van der Jeugt <m@jaspervdj.be> | 2012-12-14 12:12:28 +0100 |
---|---|---|
committer | Jasper Van der Jeugt <m@jaspervdj.be> | 2012-12-14 12:12:28 +0100 |
commit | adc8cf8528e7c9d95e2a8406a02e69cce858f088 (patch) | |
tree | 7f55b9adb2b74ba1d2c63f6c6114e6fa32b22264 /web/tutorials/02-basics.markdown | |
parent | a2620eec367711480ee2e34ada39b76dc52dbb17 (diff) | |
download | hakyll-adc8cf8528e7c9d95e2a8406a02e69cce858f088.tar.gz |
Docs
Diffstat (limited to 'web/tutorials/02-basics.markdown')
-rw-r--r-- | web/tutorials/02-basics.markdown | 54 |
1 files changed, 14 insertions, 40 deletions
diff --git a/web/tutorials/02-basics.markdown b/web/tutorials/02-basics.markdown index 79cbe30..f29b549 100644 --- a/web/tutorials/02-basics.markdown +++ b/web/tutorials/02-basics.markdown @@ -3,52 +3,26 @@ title: The basics author: Jasper Van der Jeugt --- -## Let's get started! +Building and cleaning +--------------------- -We're going to discuss a small brochure site to start with. You can find all -code and files necessary to build this site -[right here](http://github.com/jaspervdj/hakyll-examples/tree/master/brochure) --- feel free to look at them as we go trough the tutorial. To fetch all examples -in order to play with them locally, use: +If you followed along with the previous tutorial, you should now have the +example site up and running. By running `./site build`, you created two +directories: - git clone git://github.com/jaspervdj/hakyll-examples.git +- `_site`, with your site as HTML files, ready to be deployed; +- `_cache`, which Hakyll uses internally. -or navigate to the download menu on GitHub. +`./site clean` removes these directories, and `./site rebuild` performs a +`clean` and then a `build`. -Now, for this first tutorial, there's a number of files we will use: +In general, it's only necessary to use `rebuild` when you made changes to your +`site.hs`, and not when you just made changes to the contents of your website. - about.rst A simple page written in RST format - code.lhs Another page with some code (which can be highlighted) - css Directory for CSS files - |- default.css The main CSS file - \- syntax.css CSS file for code syntax highlighting - hakyll.hs Our code to generate the site - images Directory for images - \- haskell-logo.png The logo of my favorite programming language - index.markdown A simple page in markdown format - templates Directory for templates - \- default.html The main template for the site +Basic rules +----------- -By default, hakyll will compile everything to the `_site` directory. We can try -this like this: - - [jasper@phoenix] ghc --make hakyll.hs - [jasper@phoenix] ./hakyll build - -Instead of using `build`, we can also use `preview`, which will fire up a -webserver serving the `_site` directory, so have a look! - -All files have been compiled, and their output has been placed in the `_site` -directory as illustrated in this diagram: - -![Brochure files](/images/brochure-files.png) - -No magic is involved at all -- we will precisely study how and why our items are -compiled like that. All of this is specified in the `hakyll.hs` file. You can -view the full `hakyll.hs` file online [here][brochure-hakyll.hs], or you can -look in the directory you cloned or downloaded. - -[brochure-hakyll.hs]: http://github.com/jaspervdj/hakyll-examples/blob/master/brochure/hakyll.hs +TODO ## Images |