Koodikirja is an online book for learning programming. The site is published at http://www.koodikirja.fi/.
The book is available only in Finnish for now, so here you have yet another reason to learn this unique language.
The whole build/runtime system can be run on the local developement machine without a database server or anything else; all content is included in this git repository. This means you can author content and code on your local machine and deploy the result onto Heroku hosting when everything is ok.
Development instructions below.
bundle install npm install
Start the server
nanoc compilation and then starts the server.
http://127.0.0.1:3000/ and there you go.
Auto-compiling when you update files
Will auto-compile all content.
git push heroku master
How the build/runtime system works
nanoc for building the site content and
In general, assets from
/layouts will be transformed into assets in
/output. Static assets
/static directory will be served as-is. The node.js based
express web server is used for serving content.
The server code can be found in
- Build markdown pages from
/contentinto HTML pages in
- Use HTML/ERB layouts in
/layoutsdirectory to include common templates, partials, scripts and styles
- Build LESS stylesheets from
/app/lessinto CSS in