README.md

Nix By Example

Learn nix, following a series of examples!

You can visit the rendered course here: https://mimoo.github.io/nixbyexample/.

Adding your own examples (chapters)

Create a folder in book/chapters/ (using another example), then add your chapter in book/chapters.json.

Some guidelines:

1. short examples are best
2. one chapter teaches one concept well
3. one block of explanation teaches one subconcept well
4. a concept is always introduced and explained the first time it is being used in an example

How to render the webpage locally

You need the OCaml language setup. Once you've set up OCaml you can install the dependencies needed by the project with:

make deps

Then simply run:

make

or to automatically update the website as you change files:

make watch

Can I use this for another programming language?

Yes, while the code is written in OCaml you can use it to build similar webpages for any programming language (although syntax highlighting will only work for languages supported by highlight.js).

So feel free to fork this page and use to teach your own stuff!