This is a Middleman static site generator wrapper for the Discover Meteor book's Markdown sources.

It takes the Markdown sources in any language and generates a static HTML site from them.

Clone this repo:

git clone [email protected]:DiscoverMeteor/DiscoverMeteorStatic.git

Then install Middleman and the other required gems:

bundle install

Initialize Git submodules:

git submodule init

Update them:

git submodule foreach git pull origin master

Then run with:

middleman

This repo uses one git submodule per language. Please take care not to commit any translations sources as part of this repo itself.

Middleman can only generate files for a single language at a time. It will look for a LANG environment variable, but if it can't find it it will fall back to a default language, as specificed in line 6 of config.rb:

LANG = ENV['LANG'] || 'fr'

We recommend using that environment variable if you can. Otherwise, the easiest way to change your local language is simply to change this hardcoded string, and then restart Middleman.

In some cases, the README.md file included with each language's repo can trigger a Middleman error, because it lacks the proper formatting. Simply delete it to get rid of the error (but don't commit the deletion!).

Pushing a commit to this repo will automatically redeploy all translation instances (see full list).