Structure

This project uses Jekyll as its framework. Long story short:

Jekyll is a simple, blog aware, static site generator. It takes a template directory (representing the raw form of a website), runs it through Textile or Markdown and Liquid converters, and spits out a complete, static website suitable for serving with Apache or your favorite web server.

As ruby-lang.org is an international website available in several languages, support for i18n makes for a little more complex structure than the basic Jekyll-based project.

Each language is namespaced under its matching directory: Japanese version is available under /ja, English under /en, and so on.

Within a lang directory lies a collection of .md (markdown) files. Each lang directory mimics the structure of the /en "master" directory, which enforces naming and path conventions. The sub-directories map directly to URLs.