Django-GoogleCharts 项目下载及安装教程

1. 项目介绍

Django-GoogleCharts 是一个基于 Django 模板标签的库，它可以帮助开发者在使用 Django 框架开发网站时，轻松地通过 Google 的图表 API 生成图表。该项目不提供 Python 层面的 API，而是通过模板标签实现图表的生成。它目前只经过了 Django 1.1 版本的测试，支持的 Python 版本为 2.4 和 2.5。

2. 项目下载位置

该项目存储在 GitHub 上，开源地址为：https://github.com/jacobian/django-googlecharts。

3. 项目安装环境配置

在安装 Django-GoogleCharts 前，确保你的开发环境中已安装以下软件：

• Python 2.4 或 2.5 版本
• Django 1.1 版本

以下是环境配置的步骤（假设你已经安装了 Git）：

1. 克隆项目到本地：

   git clone https://github.com/jacobian/django-googlecharts.git
   

2. 进入项目目录：

   cd django-googlecharts
   

3. 查看项目目录结构，你应该看到类似以下的文件结构：

   django-googlecharts/
   ├── docs/
   ├── googlecharts/
   ├── gitignore
   ├── LICENSE
   ├── README
   ├── distribute_setup.py
   ├── setup.py
   └── ...
   

   

4. 项目安装方式

安装 Django-GoogleCharts 的步骤如下：

1. 在项目根目录下运行以下命令安装项目依赖：

   python setup.py install
   

2. 在 Django 项目的 settings.py 文件中，将 googlecharts 添加到 INSTALLED_APPS 中：

   INSTALLED_APPS = [
       ...
       'googlecharts',
       ...
   ]
   

3. 在需要显示图表的 Django 模板文件中，使用 {% load googlecharts %} 来加载标签库。

5. 项目处理脚本

Django-GoogleCharts 的使用主要通过在 Django 模板中插入相应的标签来实现。以下是一个使用 Django-GoogleCharts 标签的示例：

{% load googlecharts %}

{% googlechart %}
// 这里插入 Google 图表 API 的 JavaScript 代码
google.load('visualization', '1', {packages:['corechart'], callback: drawChart});
function drawChart() {
  var data = google.visualization.arrayToDataTable([
    ['Task', 'Hours per Day'],
    ['Work', 11],
    ['Eat', 2],
    ['Commute', 2],
    ['Watch TV', 2],
    ['Sleep', 7]
  ]);

  var options = {
    title: 'My Daily Activities'
  };

  var chart = new google.visualization.PieChart(document.getElementById('piechart'));
  chart.draw(data, options);
}
{% endgooglechart %}

确保在 HTML 文件中有一个 ID 为 piechart 的元素，图表将会在这个元素中渲染。

以上步骤完成之后，Django-GoogleCharts 便安装完成，你可以开始在其帮助下生成图表了。