Giter VIP home page Giter VIP logo

monkeyman's Introduction

README

Introduction

Monkeyman is a Scala static web site generator, similar to Middleman. At this stage, it doesn't even come close to the features Middleman has to offer, but it has one major advantage for Scala programmers: it's written in Scala.

Monkeyman was created out of unease with the existing blogging solutions. I know, that sounds weird, because there's an abundance of Blogging solutions out there, and this certainly isn't the first static web site generator. However, this tool would not have been created if there would have been a solution that supports:

  • Layouts in HAML (or in this case, SCAML)
  • Content pages in Markdown
  • Nice permalinks
  • Offline editing and preview
  • Scala extensions

If ever such a solution arrives, then there is a chance Monkeyman will no longer be maintained.

Features

  • Jade, HAML (SCAML), Mustache, SSP for layouts
  • LESS and ZUSS to CSS transformation
  • Live preview (web server running on port 4567)
  • Live updates (monitoring file system changes)
  • Static web site generation
  • Content management through tags

Usage

For information on how to use Monkeyman, check the [sample blog] (http://monkeyman.flotsam.nl/), or watch the video.

But basically, it boils down to this:

  • Create a source directory; store HAML, Jade, SSP, Markdown, Mustache files with YAML frontmatter and other static resources in that directory.
  • Create a layout directory; store HAML, Jade or SSP layouts in that directory.
  • Have a web server pick up all of the changes you are making, providing you live preview, by typing monkeyman server.
  • Build your final version in the target directory, by typing monkeyman generate.

Downloads

You can download releases here.

Installation

Download the monkeyman jar from the Downloads section. Start it with java -jar monkeyman.jar, or create a script for it, as I did:

#!/bin/sh

java -jar ~/workspace/monkeyman/target/monkeyman.jar "$@"

Changes

0.3 Gibbon

Breaking changes:

  • The general pattern now is to move *.html.scaml into *.html files, *.js.coffee files into *.js files, and so on. In line with Middleman's approach.

Other changes:

  • 2012-03-13: Genuine YAML support (decent YAML parser used now).
  • 2012-03-13: Added summary and subtitle for every resource.
  • 2012-12-21: Add switch to switch directory browsing on/off.
  • 2012-12-21: Fix for allResources not getting updated when new files appear.
  • 2013-04-18: Added coffeescript transpiler support.
  • 2013-04-18: Added image resizing support.

0.2

  • 2012-02-20: Default site template (no need to start creating a layout)
  • 2012-02-18: File system monitoring (detect changes and update content when required)

0.1

  • 2012-02-14: Add LESS support.
  • 2012-02-13: Add live preview support.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.