Skip to content
Opinionated blog-aware static site generator
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin Release Motyl 1.0.2. May 7, 2019
AUTHORS Remove all Twitter mentions Feb 9, 2017
ChangeLog Release Motyl 1.0.2. May 7, 2019
LICENSE Bump copyright year to 2019. Jan 28, 2019 Documentation update Apr 28, 2018
TODO Update TODO, theme is now configurable Oct 18, 2018


Motyl is an opinionated blog-aware static site generator written in Ruby. It uses Mustache as templating system, and all content is written in Markdown.

For the record, motyl means butterfly in Polish.


  • Small and easy to understand codebase
  • Minimal dependencies (only three gems)
  • Pages and posts written in Markdown
  • Templates are logic-less and use Mustache
  • Support for multiple categories per post
  • Syntax highlighting (using Rouge)
  • Customizable URLs (constructed from filename)
  • Atom feed generator


Ruby modules

Motyl requires the following Ruby modules:

  • kramdown
  • mustache
  • rouge

Installing dependencies via gem:

gem install kramdown mustache rouge

Alternatively, those modules can be installed directly via the operating system's package manager.


The 'examples' directory contains a sample site which can be used as a starting point.

Installing a theme

Clone the Chrysalide theme repository and place it in the themes directory.


Simply run motyl to build the site, it will generate posts and pages into the public directory, and will also copy static assets.


Motyl is released under the BSD 2-Clause license. See LICENSE file for details.


Motyl is developed by Frederic Cambus.



You can’t perform that action at this time.