# -*- coding: utf-8 -*- # Copyright © 2012-2020 Roberto Alsina and others. # Permission is hereby granted, free of charge, to any # person obtaining a copy of this software and associated # documentation files (the "Software"), to deal in the # Software without restriction, including without limitation # the rights to use, copy, modify, merge, publish, # distribute, sublicense, and/or sell copies of the # Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice # shall be included in all copies or substantial portions of # the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY # KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE # WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR # PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS # OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR # OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR # OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE # SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. """Chart directive for reSTructuredText.""" from docutils import nodes from docutils.parsers.rst import Directive, directives from nikola.plugin_categories import RestExtension try: import pygal except ImportError: pygal = None _site = None class Plugin(RestExtension): """Plugin for chart role.""" name = "rest_chart" def set_site(self, site): """Set Nikola site.""" global _site _site = self.site = site directives.register_directive('chart', Chart) return super().set_site(site) class Chart(Directive): """reStructuredText extension for inserting charts as SVG. Usage: .. chart:: Bar :title: 'Browser usage evolution (in %)' :x_labels: ["2002", "2003", "2004", "2005", "2006", "2007"] 'Firefox', [None, None, 0, 16.6, 25, 31] 'Chrome', [None, None, None, None, None, None] 'IE', [85.8, 84.6, 84.7, 74.5, 66, 58.6] 'Others', [14.2, 15.4, 15.3, 8.9, 9, 10.4] """ has_content = True required_arguments = 1 option_spec = { "box_mode": directives.unchanged, "classes": directives.unchanged, "css": directives.unchanged, "defs": directives.unchanged, "data_file": directives.unchanged, "disable_xml_declaration": directives.unchanged, "dots_size": directives.unchanged, "dynamic_print_values": directives.unchanged, "explicit_size": directives.unchanged, "fill": directives.unchanged, "force_uri_protocol": directives.unchanged, "half_pie": directives.unchanged, "height": directives.unchanged, "human_readable": directives.unchanged, "include_x_axis": directives.unchanged, "inner_radius": directives.unchanged, "interpolate": directives.unchanged, "interpolation_parameters": directives.unchanged, "interpolation_precision": directives.unchanged, "inverse_y_axis": directives.unchanged, "js": directives.unchanged, "legend_at_bottom": directives.unchanged, "legend_at_bottom_columns": directives.unchanged, "legend_box_size": directives.unchanged, "logarithmic": directives.unchanged, "margin": directives.unchanged, "margin_bottom": directives.unchanged, "margin_left": directives.unchanged, "margin_right": directives.unchanged, "margin_top": directives.unchanged, "max_scale": directives.unchanged, "min_scale": directives.unchanged, "missing_value_fill_truncation": directives.unchanged, "no_data_text": directives.unchanged, "no_prefix": directives.unchanged, "order_min": directives.unchanged, "pretty_print": directives.unchanged, "print_labels": directives.unchanged, "print_values": directives.unchanged, "print_values_position": directives.unchanged, "print_zeroes": directives.unchanged, "range": directives.unchanged, "rounded_bars": directives.unchanged, "secondary_range": directives.unchanged, "show_dots": directives.unchanged, "show_legend": directives.unchanged, "show_minor_x_labels": directives.unchanged, "show_minor_y_labels": directives.unchanged, "show_only_major_dots": directives.unchanged, "show_x_guides": directives.unchanged, "show_x_labels": directives.unchanged, "show_y_guides": directives.unchanged, "show_y_labels": directives.unchanged, "spacing": directives.unchanged, "stack_from_top": directives.unchanged, "strict": directives.unchanged, "stroke": directives.unchanged, "stroke_style": directives.unchanged, "style": directives.unchanged, "title": directives.unchanged, "tooltip_border_radius": directives.unchanged, "truncate_label": directives.unchanged, "truncate_legend": directives.unchanged, "value_formatter": directives.unchanged, "width": directives.unchanged, "x_label_rotation": directives.unchanged, "x_labels": directives.unchanged, "x_labels_major": directives.unchanged, "x_labels_major_count": directives.unchanged, "x_labels_major_every": directives.unchanged, "x_title": directives.unchanged, "x_value_formatter": directives.unchanged, "xrange": directives.unchanged, "y_label_rotation": directives.unchanged, "y_labels": directives.unchanged, "y_labels_major": directives.unchanged, "y_labels_major_count": directives.unchanged, "y_labels_major_every": directives.unchanged, "y_title": directives.unchanged, "zero": directives.unchanged, } def run(self): """Run the directive.""" self.options['site'] = None html = _site.plugin_manager.getPluginByName( 'chart', 'ShortcodePlugin').plugin_object.handler( self.arguments[0], data='\n'.join(self.content), **self.options) return [nodes.raw('', html, format='html')]