Google Charts Gem 技术文档

1. 安装指南

安装步骤

1. 安装 Ruby
   确保你的系统上已经安装了 Ruby。你可以通过以下命令检查 Ruby 是否已安装：

   ruby -v
   

   如果没有安装，请根据你的操作系统安装 Ruby。

2. 安装 Google Charts Gem
   使用 RubyGems 安装 googlecharts gem：

   gem install googlecharts
   

3. 验证安装
   安装完成后，可以通过以下命令验证是否安装成功：

   gem list googlecharts
   

2. 项目的使用说明

基本使用

googlecharts gem 提供了简单易用的接口来生成 Google Charts。以下是一个基本的示例：

require 'googlecharts'

# 创建一个简单的折线图
chart = Gchart.line(
  :size => '200x300',
  :title => "example title",
  :bg => 'efefef',
  :legend => ['first data set label', 'second data set label'],
  :data => [10, 30, 120, 45, 72]
)

puts chart

支持的图表类型

googlecharts gem 支持以下类型的图表：

• 折线图 (line)
• 散点图 (scatter)
• 柱状图 (bar)
• 饼图 (pie)
• 3D 饼图 (pie_3d)
• 气泡图 (bubble)
• 雷达图 (radar)

图表配置

你可以通过传递参数来配置图表的外观和行为。例如：

• 标题：通过 :title 参数设置图表标题。
• 背景颜色：通过 :bg 参数设置图表背景颜色。
• 图例：通过 :legend 参数设置图例。
• 数据：通过 :data 参数传递图表数据。

3. 项目API使用文档

主要API接口

Gchart.line

生成折线图。

参数：

• :size：图表尺寸，格式为 '宽x高'。
• :title：图表标题。
• :bg：背景颜色。
• :legend：图例标签。
• :data：图表数据。

示例：

Gchart.line(
  :size => '200x300',
  :title => "example title",
  :bg => 'efefef',
  :legend => ['first data set label', 'second data set label'],
  :data => [10, 30, 120, 45, 72]
)

Gchart.pie

生成饼图。

参数：

• :size：图表尺寸，格式为 '宽x高'。
• :title：图表标题。
• :labels：饼图标签。
• :data：图表数据。

示例：

Gchart.pie(
  :size => '400x200',
  :title => "example title",
  :labels => ['label 1', 'label 2'],
  :data => [30, 70]
)

Gchart.bar

生成柱状图。

参数：

• :size：图表尺寸，格式为 '宽x高'。
• :title：图表标题。
• :legend：图例标签。
• :data：图表数据。

示例：

Gchart.bar(
  :size => '400x200',
  :title => "example title",
  :legend => ['first data set label', 'second data set label'],
  :data => [10, 30, 120, 45, 72]
)

4. 项目安装方式

通过 RubyGems 安装

最简单的安装方式是通过 RubyGems 安装 googlecharts gem：

gem install googlecharts

手动安装

如果你不想使用 RubyGems，也可以手动下载并安装 gem：

1. 下载 googlecharts gem 文件。
2. 使用以下命令安装：

   gem install googlecharts-x.x.x.gem
   

   其中 x.x.x 是 gem 的版本号。

依赖项

googlecharts gem 依赖于 Ruby 环境，确保你的系统上已经安装了 Ruby 和 RubyGems。

---

通过以上文档，你应该能够顺利安装并使用 googlecharts gem 来生成各种类型的图表。如果在使用过程中遇到问题，可以参考项目的 GitHub Wiki 或提交 Issues。