This repository hosts the source code for my personal website at http://matthias.vallentin.net.
This site uses the static-site generator nanoc to drive the preprocessing and compilation of the various frameworks unified in this project:
We use HAML to write clean and concise HTML markup.
The repository layout
The Rules file describes the compilation process in detail.
You need Ruby >= 2.3 and node JS to compile the site. (On Mac OS,
brew install ruby node does the trick.) Make sure you have bundler and bower installed:
gem install bundler npm -g install bower
Thereafter, configure the project by installing potentially missing dependencies:
bundle install bower install
You're set. Now compile the site as follows:
bundle exec nanoc
Serve the compiled site at http://localhost:3000:
bundle exec nanoc view
To make the edit-compile-view cycle more efficient, you can also use Guard to watch filesystem changes and automatically recompile the site:
bundle exec guard
If you're tired of manually hitting reload in the browser, just install the LiveReload extension.
After compiling and visually inspecting the changes, perform the unit tests:
bundle exec nanoc check --all
In order to push the new site upstream, you need to setup this very git
repository in the
output directory in branch
cd output git init . git remote add origin THIS_ORIGIN git fetch git checkout -f gh-pages # force overwrite to get current state
Thereafter, use nanoc to automatically push your changes upstream:
bundle exec nanoc deploy
Please consult the licensing terms for details.