rgoplot/README.md

# goplot

goplot 是一个使用简单的绘制图表的工具，图表绘制使用了[Chart.js](http://www.chartjs.org/)开源库，编译好的goplot只有一个二进制文件，不依赖任何库/网络。

## 下载

[Mac OS X](http://www.bigendian123.com/goplot-darwin.tar.gz)

[Linux amd64](http://www.bigendian123.com/goplot-linux-amd64.tar.gz)

Windows暂缺

## 使用方法

### 基本使用

1. 解压下载包后，进入解压目录，可以看到一个 goplot 的可执行文件和一些 *.chart 文件，这些 chart 文件是默认的一些数据文件样例。可以在这些 chart 文件的目录执行 goplot，然后通过浏览器访问：<http://localhost:8000> 就可以看到图表了。
2. 你可以把 `goplot` 工具放到你的 `PATH` 中，在 chart 文件所在的目录执行 goplot 即可。
3. chart 文件必须是 .chart 后缀名，内容可以参考源码 examples 目录中的例子。启动 goplot 的目录如果有多个 chart 文件，可以通过不断刷新网页来切换图表。

### .chart 文件说明

.chart 文件定义了 Chart 的 Type，可以为以下字符串：

* line
* bar
* pie

### URL 路由说明

goplot 根据路由来匹配 .chart 文件，URL 一级名称即为需要解析的 .chart 文件名（路由中不包含扩展名部分）

```url
http://localhost:8000/\<Chart File Name>
```

例如：

* <http://localhost:8000/line>
* <http://localhost:8000/bar>
* <http://localhost:8000/pie>

### 参数说明

* -c：字符串，默认为“./”，指定 .chart 文件路径。
* -a：字符串，默认为“localhost”，指定监听地址。
* -p：整数，默认为 8000，指定监听端口。

## 曲线图

![line](image/line.png)

## 柱状图

![bar](image/bar.png)

## 饼图

![pie](image/pie.png)