_                         

___ __ _ _ | | __ _ __ _ ___ _ __
/ / | '__| __/ _ |/ ` |/ _ \ ' \ | (| (| | | | || (| | (| | / | | | __,|| __,|_, |_|| || |__/

Cartagen is a vector-based, client-side framework for rendering maps in native HTML 5. Maps are styled in GSS, a cascading stylesheet specification for geospatial information – a decision which leverages literacy in CSS to make map styling more accessible.

http://cartagen.org is a demonstration of the latest release of Cartagen. Test it out, visit places, and create your own maps!

================================================= Quick links

Installation Packages: http://github.com/jywarren/cartagen/downloads Source Code: http://github.com/jywarren/cartagen Cartagen Wiki: https://github.com/jywarren/cartagen/wiki API Documentation: http://cartagen.org/api/index.html (also included in source) GSS Usage: https://github.com/jywarren/cartagen/wiki/GssUsage

Importing OSM XML (.osm files): https://github.com/jywarren/cartagen/issues/103

================================================= What to install

The client edition is the simplest version of Cartagen, and the easiest to get started with – you don’t need a web server to run it. However, you must provide it with static data or every location you want it to load - it cannot dynamically fetch data from a server. Download a copy from: http://github.com/jywarren/cartagen/downloads

Read more at the Cartagen Wiki: https://github.com/jywarren/cartagen/wiki/CartagenClient

================================================= Requirements

Cartagen Client requires a modern JavaScript browser (recommended: Safari 3+, Firefox 3.1+, Chrome)

================================================= Installation

Note: There is a full installation tutorial with screenshots available at http://wiki.cartagen.org/wiki/show/CartagenClient

• Download a copy from: http://github.com/jywarren/cartagen/downloads
• Decompress the .zip file (This is important - Cartagen cannot run within a .zip file!)
• Open the folder cartagen-client-0.x.x and open index.html in a web browser.
• You're done! Now learn how to get your own data set from OpenStreetMap here: http://wiki.cartagen.org/wiki/show/CartagenClient

================================================= Documentation

Cartagen usage and documentation is available at http://wiki.cartagen.org, and a periodically downloaded version is available at http://github.com/jywarren/cartagen/downloads. A cached version is included in the /wiki.cartagen.org directory in the source.

================================================= Development

If you're interested in developing or modifying the Cartagen client-side source code (cartagen.js), review the README file at /public/cartagen/README, and see the following Wiki pages:

https://github.com/jywarren/cartagen/wiki/DeveloperCenter https://github.com/jywarren/cartagen/wiki/NavigatingTheSource