From 38e6ef09542088cf4f046b5a9ec6b4d8d0a5f4fa Mon Sep 17 00:00:00 2001
From: Florian Mounier <florian.mounier@kozea.fr>
Date: Mon, 19 Mar 2012 12:02:44 +0100
Subject: [PATCH] Add chart types page

---
 pages/chart_types.rst   | 87 +++++++++++++++++++++++++++++++++++++++++
 pages/documentation.rst |  1 +
 2 files changed, 88 insertions(+)
 create mode 100644 pages/chart_types.rst

diff --git a/pages/chart_types.rst b/pages/chart_types.rst
new file mode 100644
index 0000000..ac8e90e
--- /dev/null
+++ b/pages/chart_types.rst
@@ -0,0 +1,87 @@
+===============
+ Documentation
+===============
+
+
+Chart types
+===========
+
+pygal provides X kind of charts:
+
+.. contents::
+
+Line charts
+-----------
+
+Basic
+^^^^^
+
+Basic simple line graph:
+
+.. pygal-code::
+
+  line_chart = pygal.Line()
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [   0,    0,    0, 16.6, 25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [   0,    0,    0,    0,  0,    0,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,  9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+Stacked
+^^^^^^^
+
+Same graph but with stacked values and filled rendering:
+
+.. pygal-code::
+
+  line_chart = pygal.StackedLine(fill=True)
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [   0,    0,    0, 16.6, 25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [   0,    0,    0,    0,  0,    0,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,  9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+
+Bar charts / Histograms
+-----------------------
+
+Basic
+^^^^^
+
+Basic simple bar graph:
+
+.. pygal-code::
+
+  line_chart = pygal.Bar()
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [   0,    0,    0, 16.6, 25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [   0,    0,    0,    0,  0,    0,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,  9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+Stacked
+^^^^^^^
+
+Same graph but with stacked values:
+
+.. pygal-code::
+
+  line_chart = pygal.StackedBar()
+  line_chart.title = 'Browser usage evolution (in %)'
+  line_chart.x_labels = map(str, range(2002, 2013))
+  line_chart.add('Firefox', [   0,    0,    0, 16.6, 25,   31, 36.4, 45.5, 46.3, 42.8, 37.1])
+  line_chart.add('Chrome',  [   0,    0,    0,    0,  0,    0,    0,  3.9, 10.8, 23.8, 35.3])
+  line_chart.add('IE',      [85.8, 84.6, 84.7, 74.5, 66, 58.6, 54.7, 44.8, 36.2, 26.6, 20.1])
+  line_chart.add('Others',  [14.2, 15.4, 15.3,  8.9,  9, 10.4,  8.9,  5.8,  6.7,  6.8,  7.5])
+
+
+XY charts
+---------
+
+Basic
+^^^^^
+
+*TODO*
diff --git a/pages/documentation.rst b/pages/documentation.rst
index a3090a1..ae979b1 100644
--- a/pages/documentation.rst
+++ b/pages/documentation.rst
@@ -7,6 +7,7 @@ User documentation
 ==================
 
 - `First steps </first_steps>`_
+- `Charts types </chart_types>`_
 
 
 Developper documentation