2011-09-05 07:00:41 +08:00
|
|
|
Windshaft-CartoDB
|
|
|
|
|
==================
|
|
|
|
|
|
2015-02-18 22:12:43 +08:00
|
|
|
[](https://travis-ci.org/CartoDB/Windshaft-cartodb)
|
2012-07-09 19:21:19 +08:00
|
|
|
|
2015-03-09 21:37:26 +08:00
|
|
|
This is the [CartoDB Maps API](http://docs.cartodb.com/cartodb-platform/maps-api.html) tiler. It extends
|
|
|
|
|
[Windshaft](https://github.com/CartoDB/Windshaft) with some extra functionality and custom filters for authentication.
|
2011-09-05 07:17:39 +08:00
|
|
|
|
2013-12-17 00:17:55 +08:00
|
|
|
* reads dbname from subdomain and cartodb redis for pretty tile urls
|
2015-03-09 21:37:26 +08:00
|
|
|
* configures windshaft to publish `cartodb_id` as the interactivity layer
|
2011-10-08 01:31:45 +08:00
|
|
|
* gets the default geometry type from the cartodb redis store
|
2013-12-17 00:17:55 +08:00
|
|
|
* allows tiles to be styled individually
|
2011-12-13 02:02:10 +08:00
|
|
|
* provides a link to varnish high speed cache
|
2015-03-09 21:37:26 +08:00
|
|
|
* provides a [template maps API](https://github.com/CartoDB/Windshaft-cartodb/blob/master/docs/Template-maps.md)
|
2011-09-05 07:17:39 +08:00
|
|
|
|
2015-12-31 09:19:41 +08:00
|
|
|
Install
|
|
|
|
|
-------
|
|
|
|
|
See [INSTALL.md](INSTALL.md) for detailed installation instructions.
|
2015-11-19 19:50:34 +08:00
|
|
|
|
2012-07-23 21:02:52 +08:00
|
|
|
Configure
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
Create the config/environments/<env>.js files (there are .example files
|
|
|
|
|
to start from). You can optionally use the ./configure script for this,
|
|
|
|
|
see ```./configure --help``` to see available options.
|
|
|
|
|
|
|
|
|
|
Look at lib/cartodb/server_options.js for more on config
|
|
|
|
|
|
2015-06-30 17:00:32 +08:00
|
|
|
Upgrading
|
|
|
|
|
---------
|
|
|
|
|
|
2015-07-01 13:22:37 +08:00
|
|
|
Checkout your commit/branch. If you need to reinstall dependencies (you can check [NEWS](NEWS.md)) do the following:
|
2015-06-30 17:00:32 +08:00
|
|
|
|
|
|
|
|
```
|
2017-03-18 00:41:20 +08:00
|
|
|
rm -rf node_modules; yarn
|
2015-06-30 17:00:32 +08:00
|
|
|
```
|
2012-03-15 19:08:50 +08:00
|
|
|
|
|
|
|
|
Run
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
```
|
2017-03-18 00:41:20 +08:00
|
|
|
node app.js <env>
|
2011-09-05 07:17:39 +08:00
|
|
|
```
|
|
|
|
|
|
2012-07-20 23:31:10 +08:00
|
|
|
Where <env> is the name of a configuration file under config/environments/.
|
|
|
|
|
|
|
|
|
|
Note that caches are kept in redis. If you're not seeing what you expect
|
|
|
|
|
there may be out-of-sync records in there.
|
2012-04-18 18:09:43 +08:00
|
|
|
Take a look: http://redis.io/commands
|
|
|
|
|
|
2011-09-05 07:17:39 +08:00
|
|
|
|
2015-03-09 21:37:26 +08:00
|
|
|
Documentation
|
|
|
|
|
-------------
|
2011-10-08 01:31:45 +08:00
|
|
|
|
2015-03-09 21:37:26 +08:00
|
|
|
The [docs directory](https://github.com/CartoDB/Windshaft-cartodb/tree/master/docs) contains different documentation
|
|
|
|
|
resources, from higher level to more detailed ones:
|
|
|
|
|
The [Maps API](https://github.com/CartoDB/Windshaft-cartodb/blob/master/docs/Map-API.md) defined the endpoints and their
|
|
|
|
|
expected parameters and outputs.
|
2011-10-08 01:31:45 +08:00
|
|
|
|
|
|
|
|
|
2015-03-09 21:37:26 +08:00
|
|
|
Examples
|
|
|
|
|
--------
|
2011-10-08 01:31:45 +08:00
|
|
|
|
2015-03-09 21:37:26 +08:00
|
|
|
[CartoDB's Map Gallery](http://cartodb.com/gallery/) showcases several examples of visualisations built on top of this.
|
2015-09-08 22:44:44 +08:00
|
|
|
|
|
|
|
|
Contributing
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
See [CONTRIBUTING.md](CONTRIBUTING.md).
|
2016-02-15 23:53:31 +08:00
|
|
|
|
|
|
|
|
### Developing with a custom windshaft version
|
|
|
|
|
|
|
|
|
|
If you plan or want to use a custom / not released yet version of windshaft (or any other dependency) the best option is
|
2017-03-18 00:41:20 +08:00
|
|
|
to use `yarn link`. You can read more about it at [yarn-link: Symlink a package folder](https://yarnpkg.com/en/docs/cli/link).
|
2016-02-15 23:53:31 +08:00
|
|
|
|
|
|
|
|
**Quick start**:
|
|
|
|
|
|
|
|
|
|
```shell
|
2017-03-18 00:41:20 +08:00
|
|
|
~/windshaft-directory $ yarn
|
|
|
|
|
~/windshaft-directory $ yarn link
|
|
|
|
|
~/windshaft-cartodb-directory $ yarn link windshaft
|
2016-02-15 23:53:31 +08:00
|
|
|
```
|
