/*!
* Timemap.js Copyright 2008 Nick Rabinowitz.
* Licensed under the MIT License (see LICENSE.txt)
*/
Timemap.js
By Nick Rabinowitz (www.nickrabinowitz.com)
Timemap.js is intended to sync a SIMILE Timeline with a web-based map.
Depends on: jQuery, Mapstraction 2.x, a map provider of your choice, SIMILE Timeline v1.2 - 2.3.1.
Tested browsers: Firefox 3.x, Google Chrome, IE7, IE8
Tested map providers: Google v2, Google v3, OpenLayers, Bing Maps
Thanks to Jörn Clausen (http://www.oe-files.de) for initial concept and code.
-------------------------------------------------------------------------------
Getting Started
The best way to get started depends on your learning style, but here are the
places you should look:
* Working Examples: ./examples/index.html
* Basic Usage: http://code.google.com/p/timemap/wiki/BasicUsage
* Code Documentation: ./docs/index.html
* Homepage: http://code.google.com/p/timemap/
* Discussion Group: http://groups.google.com/group/timemap-development
-------------------------------------------------------------------------------
Files in the project, in order of importance:
Packed files (YUI Compressor)
* timemap_full.pack.js: The library and all helper files. This is the recommended file to use in production.
* timemap.pack.js: Just the core library file
Examples (in examples/)
* I recommend starting with index.html, which describes each example.
Documentation
* docs/ Code documentation produced by jsdoc-toolkit
* examples/ Example HTML code
* LICENSE.txt The MIT license
* README.txt This file
Supporting Libraries (in lib/)
* timeline-1.2.js Packed version of Timeline v1.2 - smaller and faster than SIMILE version
* timeline-2.3.0.js Packed version of Timeline v2.3.0 - *required* to use this version of Timeline,
as the SIMILE version removes jQuery from the global namespace.
* mxn/* Mapstraction library - fork found here: https://github.com/nrabinowitz/mxn
This version is *required* for timemap.js, until my changes get pulled into the
official library
* jquery-1.x.x.min.js jQuery. Just for convenience - use a CDN version if you prefer
* json2.pack.js JSON library - usually not required
Source files (in src/)
* timemap.js: The core timemap.js library
* param.js Abstraction layer for parameters
* state.js Functions for loading and serializing timemap state
* manipulation.js: Additional functions to manipulate a timemap after loading
Loaders (in src/loaders/)
* flickr.js Loader for geotagged Flickr feeds
* kml.js Loader for KML files
* georss.js Loader for GeoRSS files
* xml.js Base loader for XML files
* google_spreadsheet.js Loader for the Google Spreadsheets API
* json.js: Loaders for JSON (both string and jsonp)
* progressive.js Loader for data loaded in chunks based on timeline location
* metaweb.js Loader for Metaweb data from freebase.com
Other stuff
* src/ext/ A couple of extension files I didn't think were worth being in the core library
* images/ Simple icons for timeline events
* tests/ jsUnit tests
Comments welcomed at nick (at) nickrabinowitz (dot) com.
1be82831a9