Taginfo
=======

Brings together information about OpenStreetMap tags and makes it searchable and browsable.

Documentation: http://wiki.openstreetmap.org/wiki/Taginfo
Live System: http://taginfo.openstreetmap.org/


FILES
-----

* sources  - Import scripts
* web      - Web User Interface and API
* examples - Some misc example stuff
* tagstats - C++ program to create database statistics


PREREQUISITES
-------------

Uses
    * Ruby (must be at least 1.9.1)
    * Mongrel or Apache2 mod_passenger
    * Sinatra web framework http://www.sinatrarb.com/
    * Rack Contrib Gem (for Rack::JSONP)
    * JSON gem (install with gem, Debian/Ubuntu packages are too old and buggy)
    * curl binary
    * sqlite3 binary and ruby libs
    * m4 binary

Debian/Ubuntu packages:
    curl m4 sqlite3 ruby-sqlite3 ruby-passenger libapache2-mod-passenger

Gems:
    gem install rack rack-contrib sinatra sinatra-r18n json

There is a developer mailing list at
http://lists.openstreetmap.org/listinfo/taginfo-dev


DATA IMPORT
-----------

See http://wiki.openstreetmap.org/wiki/Taginfo/Running


WEB USER INTERFACE
------------------

You need a 'data' directory in the parent directory of the directory where
this README is. It must contain the sqlite database files created in the
data import step or downloaded from http://taginfo.openstreetmap.org/download .

To start the web user interface:
cd web
./taginfo.rb


JAVASCRIPT
----------

Taginfo uses the following Javascript libraries:
* jQuery 1.9.0
* jQuery UI 1.9.2
* customSelect (http://adam.co/lab/jquery/customselect/)
* tipsy (http://onehackoranother.com/projects/jquery/tipsy/)
* jQuery Cookie (https://github.com/carhartl/jquery-cookie/)
* Flexigrid (Originally from http://code.google.com/p/flexigrid/
    http://www.flexigrid.info/ , the version used and included
    has some changes and bugfixes.)

All the Javascript and CSS needed is already included.


THANKS
------
Stefano Tampieri - for the Italian translation
Ilya Zverev <zverik@textual.ru> - for the Russion translation
Jocelyn Jaubert <jocelyn.jaubert@gmail.com> - for the French translation
Jacek Buczyński <jacekzlodzi@gmail.com> - for the Polish translation


AUTHOR
------

Jochen Topf <jochen@remote.org>
http://wiki.openstreetmap.org/wiki/User:Joto