Skip to content

Commit

Permalink
Updating README to be an introduction to docs, testing, and building …
Browse files Browse the repository at this point in the history
…as well.
  • Loading branch information
Tom MacWright committed May 26, 2011
1 parent a2f3591 commit c1d68cb
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 20 deletions.
20 changes: 0 additions & 20 deletions README

This file was deleted.

48 changes: 48 additions & 0 deletions README.md
@@ -0,0 +1,48 @@
_ _ _
| | | | (_)
_ __ ___ ___ __| | ___ ___| |_ _ __ ___ __ _ _ __ ___ _ ___
| '_ ` _ \ / _ \ / _` |/ _ \/ __| __| | '_ ` _ \ / _` | '_ \/ __| | / __|
| | | | | | (_) | (_| | __/\__ \ |_ | | | | | | (_| | |_) \__ \ | \__ \
|_| |_| |_|\___/ \__,_|\___||___/\__| |_| |_| |_|\__,_| .__/|___/ | |___/
| | _/ |
|_| |__/

Modest Maps JS is a BSD-licensed display and interaction library for tile-based
maps in Javascript.

Our intent is to provide a minimal, extensible, customizable, and free display
library for discriminating designers and developers who want to use interactive
maps in their own projects. Modest Maps provides a core set of features in a
tight, clean package, with plenty of hooks for additional functionality.

Though Modest Maps JS is in its infancy it's derived from our trusty Python and
Actionscript code that has served us well for years. The best place to see it
in action today is Walking Papers, at http://walkingpapers.org

# Usage:

See `examples/` and [the wiki home page](https://github.com/stamen/modestmaps-js/wiki)
for ideas on how to start out using Modest Maps.

# Building

This package includes a copy of [YUICompressor](http://developer.yahoo.com/yui/compressor/),
which requires a version of Java on your system. To create a new build of
Modest Maps (only necessary for development), run `make` from the root
directory.

# Developing with npm:

Modest Maps includes a `package.json` file to guide usage of its code on the
server-side, and to handle certain dependencies.

To install developer dependencies - needed for documentation and tests -
you'll need [npm](http://npmjs.org/):

npm install --dev

# Tests

Tests require `expresso` to be installed by `npm`, as noted above. To run tests,

make tests

0 comments on commit c1d68cb

Please sign in to comment.