mirror of https://github.com/Kozea/pygal.git
Florian Mounier
13 years ago
4 changed files with 213 additions and 17 deletions
@ -0,0 +1,192 @@ |
|||||||
|
=============== |
||||||
|
Documentation |
||||||
|
=============== |
||||||
|
|
||||||
|
|
||||||
|
Styles |
||||||
|
====== |
||||||
|
|
||||||
|
pygal provides 6 different styles and 2 ways to add your own: |
||||||
|
|
||||||
|
.. contents:: |
||||||
|
|
||||||
|
|
||||||
|
Default |
||||||
|
------- |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic') |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Neon |
||||||
|
---- |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from pygal.style import NeonStyle |
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', style=NeonStyle) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Dark Solarized |
||||||
|
-------------- |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from pygal.style import DarkSolarizedStyle |
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', style=DarkSolarizedStyle) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Light Solarized |
||||||
|
--------------- |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from pygal.style import LightSolarizedStyle |
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', style=LightSolarizedStyle) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Light |
||||||
|
----- |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from pygal.style import LightStyle |
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', style=LightStyle) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Clean |
||||||
|
----- |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from pygal.style import CleanStyle |
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', style=CleanStyle) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Custom |
||||||
|
------ |
||||||
|
|
||||||
|
You can customize styles in two ways: |
||||||
|
|
||||||
|
Using Style class |
||||||
|
^^^^^^^^^^^^^^^^^ |
||||||
|
|
||||||
|
You can instantiate the Style class with some customizations for quick styling: |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from pygal.style import Style |
||||||
|
custom_style = Style( |
||||||
|
background='transparent', |
||||||
|
plot_background='transparent', |
||||||
|
foreground='#53E89B', |
||||||
|
foreground_light='#53A0E8', |
||||||
|
foreground_dark='#630C0D', |
||||||
|
opacity='.6', |
||||||
|
opacity_hover='.9', |
||||||
|
transition='400ms ease-in', |
||||||
|
colors=('#E853A0', '#E8537A', '#E95355', '#E87653', '#E89B53')) |
||||||
|
|
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', style=custom_style) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
||||||
|
|
||||||
|
|
||||||
|
Using a custom css |
||||||
|
^^^^^^^^^^^^^^^^^^ |
||||||
|
|
||||||
|
You can also specify a file containing a custom css for more customization. |
||||||
|
(See the `default css <https://github.com/Kozea/pygal/blob/master/pygal/css/graph.css>`_) |
||||||
|
|
||||||
|
.. pygal-code:: |
||||||
|
|
||||||
|
from tempfile import NamedTemporaryFile |
||||||
|
custom_css = ''' |
||||||
|
text { |
||||||
|
fill: green; |
||||||
|
font-family: monospace; |
||||||
|
} |
||||||
|
.legends .legend text { |
||||||
|
font-size: {{ font_sizes.legend }}; |
||||||
|
} |
||||||
|
.axis { |
||||||
|
stroke: #666; |
||||||
|
} |
||||||
|
.axis text { |
||||||
|
font-size: {{ font_sizes.label }}; |
||||||
|
font-family: sans; |
||||||
|
stroke: none; |
||||||
|
} |
||||||
|
.axis.y text { |
||||||
|
text-anchor: end; |
||||||
|
} |
||||||
|
#tooltip text { |
||||||
|
font-size: {{ font_sizes.tooltip }}; |
||||||
|
} |
||||||
|
.dot { |
||||||
|
fill: yellow; |
||||||
|
} |
||||||
|
.color-0 { |
||||||
|
stroke: #ff1100; |
||||||
|
fill: #ff1100; |
||||||
|
} |
||||||
|
.color-1 { |
||||||
|
stroke: #ffee00; |
||||||
|
fill: #ffee00; |
||||||
|
} |
||||||
|
.color-2 { |
||||||
|
stroke: #66bb44; |
||||||
|
fill: #66bb44; |
||||||
|
} |
||||||
|
.color-3 { |
||||||
|
stroke: #88bbdd; |
||||||
|
fill: #88bbdd; |
||||||
|
} |
||||||
|
.color-4 { |
||||||
|
stroke: #0000ff; |
||||||
|
fill: #0000ff; |
||||||
|
} |
||||||
|
''' |
||||||
|
custom_css_file = '/tmp/pygal_custom_style.css' |
||||||
|
with open(custom_css_file, 'w') as f: |
||||||
|
f.write(custom_css) |
||||||
|
chart = pygal.StackedLine(fill=True, interpolate='cubic', base_css=custom_css_file) |
||||||
|
chart.add('A', [1, 3, 5, 16, 13, 3, 7]) |
||||||
|
chart.add('B', [5, 2, 3, 2, 5, 7, 17]) |
||||||
|
chart.add('C', [6, 10, 9, 7, 3, 1, 0]) |
||||||
|
chart.add('D', [2, 3, 5, 9, 12, 9, 5]) |
||||||
|
chart.add('E', [7, 4, 2, 1, 2, 10, 0]) |
Loading…
Reference in new issue