76 lines
3.3 KiB
Plaintext
76 lines
3.3 KiB
Plaintext
/*!
|
|
* 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.
|