nvd3/README.md
2013-05-13 13:00:38 -04:00

69 lines
2.3 KiB
Markdown

Please see Novus' official statement on nvd3 with an explanation,
apology, and commitment to its permanent status as an open-source
project.
[http://nvd3.org/statement.html](http://nvd3.org/statement.html)
# nvd3 - v0.9
A reusable chart library for d3.JS.
NVD3 may change from its current state, but will always try to follow the style of d3.js.
You can also check out the [examples page](http://nvd3.org/ghpages/examples.html)
---
# Current Improvement focus
Upgrade to d3.v3 in progress!
---
# Installation Instructions
d3.v2.js is a dependency of nv.d3.js. Be sure to include in in your project, then:
Add a script tag to include nv.d3.js OR nv.d3.min.js in your project.
Also add a link to the nv.d3.css file.
Python & Django-wrapped versions available:
https://github.com/areski/python-nvd3
https://github.com/areski/django-nvd3
R package version available:
http://ramnathv.github.io/rCharts/r2js/
---
If one of [the existing models](https://github.com/novus/nvd3/tree/master/src/models) doesn't meet your needs, fork the project, implement the model and an example using it, send us a pull request, for consideration for inclusion in the project.
Please do not aggregate pull requests. Aggregated pull requests are actually more difficult to review!
We are currently changing our branch structure so that master will be gauranteed stable. In addition, there is now a "development" branch. This branch reflects the latest changes to nvd3 and is not necessarily stable.
---
Minifying your fork:
The Makefile requires [UglifyJS](https://github.com/mishoo/UglifyJS).
The easiest way to install is to install via npm. Run `npm install
uglify-js` from your home directory, then add the output from `npm bin`
into your path so that you have access to `uglifyjs` from the command
line (remember to restart your terminal window when adding to the path.)
Once you have `uglifyjs` command available, running `make` from your
fork's root directory will rebuild both `nv.d3.js` and `nv.d3.min.js`.
Without UglifyJS, you won't get the minified version when running make.
**We ask that you DO NOT minify pull requests...
If you need to minify please build pull request in separate branch, and
merge and minify in your master.
## (Officially) Supported Browsers
* Chrome latest version (preferred)
* Firefox latest version
* Safari latest version
* Internet Explorer 9 and 10