dyi 1.1.1 → 1.1.2

data/CHANGES

@@ -1,10 +1,16 @@
 = DYI Changelog
 
+== Version 1.1.2 / 2012-03-01
+* Bug Fixes
+  * Calls data_label_format property instead of baloon_format when it draws the baloon of PieChart.
+  * Changes the order of overlapping charts of LineChart.
+  * Calcuration of second-axis settings of LineChart.
+
 == Version 1.1.1 / 2012-02-02
 * Minor Enhancements
   * Adds a String parsing to CsvReader.
   * Spports metadata.
-  * Adds `title' and `description' attribute to DYI::Element.
+  * Adds 'title' and 'description' attribute to DYI::Element.
 
 == Version 1.1.0 / 2012-01-06
 * Major Enhancements

data/lib/dyi.rb

@@ -20,12 +20,14 @@
 # along with DYI.  If not, see <http://www.gnu.org/licenses/>.
 
 # Root namespace of DYI.
+# @since 0.0.0
 module DYI
 
   # DYI program version
-  VERSION = '1.1.1'
+  VERSION = '1.1.2'
 
   # URL of DYI Project
+  # @since 0.0.2
   URL = 'http://sourceforge.net/projects/dyi/'
 end
 

data/lib/dyi/animation.rb

@@ -1,6 +1,6 @@
 # -*- encoding: UTF-8 -*-
 
-# Copyright (c) 2009-2011 Sound-F Co., Ltd. All rights reserved.
+# Copyright (c) 2009-2012 Sound-F Co., Ltd. All rights reserved.
 #
 # Author:: Mamoru Yuo
 #
@@ -23,11 +23,12 @@
 #
 # This file provides the classes of animation.  The event becomes effective
 # only when it is output by SVG format.
+
 #
-# @since 1.0.0
+module DYI
 
-module DYI #:nodoc:
-  module Animation #:nodoc:
+  # @since 1.0.0
+  module Animation
 
     # Base class for animation classes.
     # @abstract

data/lib/dyi/canvas.rb

@@ -19,6 +19,7 @@
 # You should have received a copy of the GNU General Public License
 # along with DYI.  If not, see <http://www.gnu.org/licenses/>.
 
+#
 module DYI
 
   # The body of Vector-Image. This class is a container for all graphical
@@ -30,21 +31,17 @@ module DYI
     IMPLEMENT_ATTRIBUTES = [:view_box, :preserve_aspect_ratio]
 
     # Returns width of the vector-image on user unit.
-    # @attribute width
-    # @return [Length] width of vector-image on user unit
     attr_length :width
 
     # Returns heigth of the vector-image on user unit.
-    # @attribute height
-    # @return [Length] heigth of vector-image on user unit
     attr_length :height
 
-    # Returns the value of the view_box.
     # @attribute view_box
+    # Returns the value of the view_box.
     # @return [String]
-
-    # Returns the value of the preserve_aspect_ratio.
+    #+++
     # @attribute preserve_aspect_ratio
+    # Returns the value of the preserve_aspect_ratio.
     # @return [String] the value of preserve_aspect_ratio
     attr_reader *IMPLEMENT_ATTRIBUTES
 
@@ -220,7 +217,7 @@ module DYI
     # @param [String, Script::SimpleScript] script_body a string that is a
     #   script body or a script object that is registered
     # @param [String] content_type a content-type of the script. If parameter
-    #   `script_body' is {Script::SimpleScript} object, this parameter is ignored
+    #   'script_body' is {Script::SimpleScript} object, this parameter is ignored
     # @since 1.0.0
     def add_script(script_body, content_type = 'application/ecmascript')
       if script_body.respond_to?(:include_external_file?)

data/lib/dyi/chart.rb

@@ -1,6 +1,6 @@
 # -*- encoding: UTF-8 -*-
 
-# Copyright (c) 2009-2011 Sound-F Co., Ltd. All rights reserved.
+# Copyright (c) 2009-2012 Sound-F Co., Ltd. All rights reserved.
 #
 # Author:: Mamoru Yuo
 #

data/lib/dyi/chart/array_reader.rb

@@ -1,6 +1,6 @@
 # -*- encoding: UTF-8 -*-
 
-# Copyright (c) 2009-2011 Sound-F Co., Ltd. All rights reserved.
+# Copyright (c) 2009-2012 Sound-F Co., Ltd. All rights reserved.
 #
 # Author:: Mamoru Yuo
 #
@@ -19,38 +19,102 @@
 # You should have received a copy of the GNU General Public License
 # along with DYI.  If not, see <http://www.gnu.org/licenses/>.
 
-module DYI #:nodoc:
-  module Chart #:nodoc:
+#
+module DYI
+  module Chart
 
+    # +ArrayReader+ converts the ruby array into a readable format for the
+    # chart object of DYI.
+    #
+    # If any ruby object or something (file, database, etc...) is used as the
+    # data source of DYI's chart, the object of the inheritance class of
+    # +ArrayReader+ avails. For example, using a CSV data, {CsvReader} class
+    # avails.
+    #
+    #= Basic Usage
+    #
+    # Using +PieChart+ and ArrayReader (or sub class of ArrayReader), you can
+    # create the pie chart as the following:
+    #   require 'rubygems'
+    #   require 'dyi'
+    #   
+    #   # Nominal GDP of Asian Countries (2010)
+    #   chart_data = [['China', 5878],
+    #                 ['Japan', 5459],
+    #                 ['India', 1538],
+    #                 ['South Koria', 1007],
+    #                 ['Other Countries', 2863]]
+    #   reader = DYI::Chart::ArrayReader.read(chart_data, :schema => [:name, :value])
+    #
+    #   # Creates the Pie Chart
+    #   chart = DYI::Chart::PieChart.new(450,250)
+    #   chart.load_data(reader)
+    #   chart.save('asian_gdp.svg')
+    # Creating the instance, you should not call +new+ method but {.read} method.
+    #
+    # The optional argument +:schema+ means a field name. The field name +:value+
+    # is the particular name, that is to say, the chart object generate a chart
+    # using a value of the field named +:value+. If +:schema+ option is not
+    # specified, the +ArrayReader+ object looks upon all feilds as +:vlaue+
+    # field. The field names other than +:name+ are used in the format string
+    # and so on, as following:
+    #   # Nominal GDP of Asian Countries (2010)
+    #   chart_data = [['China',       'People\'s Republic of China', 5878, 'red'],
+    #                 ['Japan',       'Japan',                       5459, 'blue'],
+    #                 ['India',       'Republic of India',           1538, 'yellow'],
+    #                 ['South Koria', 'Republic of Korea',           1007, 'green'],
+    #                 ['Others',      'Other Asian Countries',       2863, 'gray']]
+    #   reader = DYI::Chart::ArrayReader.read(chart_data,
+    #                                         :schema => [:name, :long, :value, :color])
+    #
+    #   # Creates the Pie Chart
+    #   chart = DYI::Chart::PieChart.new(450,250,
+    #                                    :legend_format => '{?long}')
+    #   chart.load_data(reader)
+    #   chart.save('asian_gdp.svg')
+    # See {ArrayReader.read ArrayReader.read} for other optional arguments.
+    # @since 0.0.0
     class ArrayReader
       include Enumerable
 
+      # Returns the value at index.
+      # @param [Integer] i the index of records
+      # @param [Integer] j the index of series
+      # @return [Numeric] the value at index
       def [](i, j)
         @records[i].values[j]
       end
 
-      # @return [Array] array of a struct
+      # Returns the array of the records.
+      # @return [Array<Struct>] the array of the records
       # @since 1.0.0
       def records
         @records.clone
       end
 
+      # Returns number of the records.
       # @return [Integer] number of the records
       # @since 1.0.0
       def records_size
         @records.size
       end
 
+      # Returns number of the values in the record
       # @return [Integer] number of the values
       # @since 1.0.0
       def values_size
         @records.first.values.size rescue 0
       end
 
+      # Clears all records
       def clear_data
         @records.clear
       end
 
+      # Calls block once for each record, passing the values that records as a
+      # parameter.
+      # @yield [values] iteration block
+      # @yieldparam [Array<Numeric>] values the values that the record has
       # @since 1.0.0
       def values_each(&block)
         @records.each do |record|
@@ -58,8 +122,9 @@ module DYI #:nodoc:
         end
       end
 
-      # @param [Integer] index index of series
-      # @return [Array]
+      # Returns an array of values of the specified series.
+      # @param [Integer] index an index of the series
+      # @return [Array<Numeric>] an array of values
       # @since 1.0.0
       def series(index)
         @records.map do |record|
@@ -67,16 +132,23 @@ module DYI #:nodoc:
         end
       end
 
+      # Returns whether the record has the field.
+      # @param [Symbol, String] field_name field name
+      # @return [Bolean] true if the record has the field, false otherwise
       # @since 1.0.0
       def has_field?(field_name)
         @schema.members.include?(RUBY_VERSION >= '1.9' ? field_name.to_sym : field_name.to_s)
       end
 
+      # Calls block once for each record, passing that records as a parameter.
+      # @yield [record] iteration block
+      # @yieldparam [Struct] record the record in self
       # @since 1.0.0
       def each(&block)
         @records.each(&block)
       end
 
+      # @private
       def initialize
         @records = []
       end
@@ -85,8 +157,8 @@ module DYI #:nodoc:
       # @param [Array<Array>] array_of_array two dimensional array
       # @option options [Range] :row_range a range of rows
       # @option options [Range] :column_range a range of columns
-      # @option options [Array<Symbol>] :schema array of field names
-      # @option options [Array<Symbol>] :data_types array of field data types
+      # @option options [Array<Symbol>] :schema array of field names. see
+      #   Overview of {ArrayReader}.
       # @option options [Boolean] :transposed whether the array-of-array is
       #   transposed
       def read(array_of_array, options={})
@@ -121,7 +193,8 @@ module DYI #:nodoc:
         self
       end
 
-      # @return [Array] a array of a field's name (as Symbol)
+      # Returns an array of the field's name
+      # @return [Array<Symbol>] an array of the field's name
       # @since 1.1.0
       def members
         @schema.members.map{|name| name.to_sym}
@@ -152,6 +225,7 @@ module DYI #:nodoc:
 
       # @param [Array] schema of the record
       # @return [Class] subclass of Struct class
+      # @raise [ArgumentError]
       # @since 1.0.0
       def record_schema(schema)
         struct_schema =
@@ -172,7 +246,7 @@ module DYI #:nodoc:
         Struct.new(*struct_schema)
       end
 
-      # Makes the instance respond to xxx_values method.
+      # Makes the instance respond to +xxx_values+ method.
       # @example
       #   data = ArrayReader.read([['Smith', 20, 3432], ['Thomas', 25, 9721]],
       #                           :schema => [:name, :age, :value])
@@ -193,6 +267,26 @@ module DYI #:nodoc:
         # @param (see #read)
         # @option (see #read)
         # @return [ArrayReader] a new instance of ArrayReader
+        # @example
+        #   # example of using :row_range option
+        #   chart_data = [['Country', 'Nominal GDP'],
+        #                 ['China', 5878],
+        #                 ['Japan', 5459],
+        #                 ['India', 1538],
+        #                 ['South Koria', 1007],
+        #                 ['Other Countries', 2863]]
+        #   # skips the first row
+        #   reader = DYI::Chart::ArrayReader.read(chart_data,
+        #                                         :schema => [:name, :value],
+        #                                         :row_range => (1..-1))
+        # @example
+        #   # example of using :transposed option
+        #   chart_data = [['China', 'Japan', 'India', 'South Koria', 'Other Countries'],
+        #                 [5878, 5459, 1538, 1007, 2863]]
+        #   # transposes the rows and the columns
+        #   reader = DYI::Chart::ArrayReader.read(chart_data,
+        #                                           :schema => [:name, :value],
+        #                                           :transposed => true)
         def read(array_of_array, options={})
           new.read(array_of_array, options)
         end

data/lib/dyi/chart/axis_util.rb

@@ -1,6 +1,6 @@
 # -*- encoding: UTF-8 -*-
 
-# Copyright (c) 2009-2011 Sound-F Co., Ltd. All rights reserved.
+# Copyright (c) 2009-2012 Sound-F Co., Ltd. All rights reserved.
 #
 # Author:: Mamoru Yuo
 #
@@ -21,9 +21,10 @@
 
 require 'csv'
 
-module DYI #:nodoc:
-  module Chart #:nodoc:
+module DYI
+  module Chart
 
+    # @since 0.0.0
     module AxisUtil
 
       private
@@ -56,11 +57,11 @@ module DYI #:nodoc:
         }
       end
 
-      def top_digit(num, n=1) #:nodoc:
+      def top_digit(num, n=1)
         num.div(10 ** (figures_count(num) - n + 1))
       end
 
-      def suitable_1digit_value(a, b) #:nodoc:
+      def suitable_1digit_value(a, b)
         return a if a == b
         a, b = b, a if a > b
         return 0 if a == 0
@@ -71,11 +72,11 @@ module DYI #:nodoc:
         8
       end
 
-      def figures_count(num) #:nodoc:
+      def figures_count(num)
         Math.log10(num).floor
       end
 
-      def base_value(a, b, allow_under=true, allow_over=true) #:nodoc:
+      def base_value(a, b, allow_under=true, allow_over=true)
         return 0 if a * b <= 0 || a == b
         a, b = -a, -b if negative = (a < 0)
         a, b = b, a if a > b
@@ -83,7 +84,7 @@ module DYI #:nodoc:
         suitable_value_positive(a, b) * (negative ? -1 : 1)
       end
 
-      def suitable_value_positive(a, b) #:nodoc:
+      def suitable_value_positive(a, b)
         if figures_count(a) != (dig = figures_count(b))
           return 10 ** dig
         end
@@ -92,7 +93,7 @@ module DYI #:nodoc:
         (suitable_1digit_value(dig_a - dig_a.div(10) * 10 + (dig_a == dig_a.div(10) * 10 ? 0 : 1), dig_b - dig_b.div(10) * 10) + dig_a.div(10) * 10) * (10 ** (dig - figures_count(dig_a)))
       end
 
-      def scale_interval(base_value, data_min, data_max, scale_count_limit) #:nodoc:
+      def scale_interval(base_value, data_min, data_max, scale_count_limit)
         if base_value - data_min < data_max - base_value
           allocate_scale_count = (data_max - base_value).div((data_max - data_min).quo(scale_count_limit))
           scale_interval_base2edge(base_value, data_max, allocate_scale_count)
@@ -102,7 +103,7 @@ module DYI #:nodoc:
         end
       end
 
-      def scale_interval_base2edge(base_value, edge_value, scale_count_limit) #:nodoc:
+      def scale_interval_base2edge(base_value, edge_value, scale_count_limit)
         raise ArgumentError, 'base_value should not equal edge_value' if edge_value == base_value
         range = (base_value - edge_value).abs
 
@@ -217,11 +218,24 @@ module DYI #:nodoc:
         base_value = base_value(data_min, data_max, min.nil?, max.nil?)
 
         scale_interval = scale_interval(base_value, data_min, data_max, scale_count)
-        min_scale_value = nil
-        (base_value + scale_interval).step(data_min, -scale_interval) {|n| min_scale_value = n}
-        min ||= (min_scale_value.nil? ? base_value : min_scale_value - scale_interval)
-        min_scale_value ||= min + scale_interval
-        max = scale_interval * scale_count + min
+        scale_ratio = scale_interval.quo(main_axis_settings[:scale_interval])
+        if min
+          min_scale_value = scale_ratio * (main_axis_settings[:min_scale_value] - main_axis_settings[:min]) + min
+          max = scale_ratio * (main_axis_settings[:max] - main_axis_settings[:min_scale_value]) + min_scale_value
+        elsif max
+          min_scale_value = max - scale_ratio * (main_axis_settings[:max] - main_axis_settings[:min_scale_value])
+          min = min_scale_value - scale_ratio * (main_axis_settings[:min_scale_value] - main_axis_settings[:min])
+        else
+          min_scale_value = nil
+          (base_value + scale_interval).step(data_min, -scale_interval) {|n| min_scale_value = n}
+          min_scale_value ||= base_value + scale_interval
+          min = min_scale_value - scale_ratio * (main_axis_settings[:min_scale_value] - main_axis_settings[:min])
+          if data_min < min
+            min_scale_value -= scale_interval
+            min -= scale_interval
+          end
+          max = scale_ratio * (main_axis_settings[:max] - main_axis_settings[:min_scale_value]) + min_scale_value
+        end
 
         {
           :min => min || min_scale_value - scale_interval,
@@ -276,12 +290,12 @@ module DYI #:nodoc:
         axis_length * pos + chart_margin
       end
 
-      def round_top_2_digit(max, min) #:nodoc:
+      def round_top_2_digit(max, min)
         digit = Math.log10([max.abs, min.abs].max).floor - 1
         [max.quo(10 ** digit).ceil * (10 ** digit), min.quo(10 ** digit).floor * (10 ** digit)]
       end
 
-      def min_scale_value(max, min, scale_interval) #:nodoc:
+      def min_scale_value(max, min, scale_interval)
         return scale_interval if min == 0
         if (max_digit = Math.log10(max).to_i) != Math.log10(min).to_i
           base_value = 10 ** max_digit

data/lib/dyi/chart/base.rb

@@ -1,6 +1,6 @@
 # -*- encoding: UTF-8 -*-
 
-# Copyright (c) 2009-2011 Sound-F Co., Ltd. All rights reserved.
+# Copyright (c) 2009-2012 Sound-F Co., Ltd. All rights reserved.
 #
 # Author:: Mamoru Yuo
 #
@@ -21,9 +21,11 @@
 
 require 'csv'
 
-module DYI #:nodoc:
-  module Chart #:nodoc:
+module DYI
+  module Chart
 
+    # @private
+    # @since 1.0.0
     module OptionCreator
 
       # Difines a read property.
@@ -188,22 +190,64 @@ module DYI #:nodoc:
       end
     end
 
+    # Base class of all the chart classes.
+    # @abstract
+    # @since 0.0.0
     class Base
       extend OptionCreator
 
       DEFAULT_CHART_COLOR = ['#ff0f00', '#ff6600', '#ff9e01', '#fcd202', '#f8ff01', '#b0de09', '#04d215', '#0d8ecf', '#0d52d1', '#2a0cd0', '#8a0ccf', '#cd0d74']
-      attr_reader :options, :data, :canvas
 
+      # @private
+      attr_reader :options
+
+      # Returns the data for the chart.
+      # @return [Chart::ArrayReader] the data for the chart
+      attr_reader :data
+
+      # Returns the canvas of the image body.
+      # @return [Canvas] the canvas of the image body
+      attr_reader :canvas
+
+      # Returns or sets the URI of the background image of the chart. The URL is
+      # included the chart image.
       opt_accessor :background_image_url, :type => :string
+
+      # Returns or sets the background image of the chart. The image files is
+      # read and included when the chart image is created. The hash includes the
+      # following key:
+      # [+:path+] (+String+) the file path of the background image file
+      # [+:content_type+] (+String+) the content-type of the background image
+      #                   file
       opt_accessor :background_image_file, :type => :hash, :default => {}, :keys => [:path, :content_type], :item_type => :string
+
+      # Returns or sets the opacity of the background image of the chart.
+      # Default to 1.0.
       opt_accessor :background_image_opacity, :type => :float, :default => 1.0
+
+      # Returns or sets the script string of the chart.
       opt_accessor :script_body, :type => :string
+
+      # Returns or sets the CSS styles of the image body of the chart.
       opt_accessor :css_body, :type => :string
+
+      # Returns or sets the URIs of the script files that the chart includes.
       opt_accessor :script_files, :type => :array, :item_type => :string
+
+      # Returns or sets the URIs of the CSS files that the chart includes.
       opt_accessor :css_files, :type => :array, :item_type => :string
+
+      # Returns or sets the URIs of the XSL files that the chart includes.
       opt_accessor :xsl_files, :type => :array, :item_type => :string
+
+      # Returns or sets the CSS class of the image body of the chart.
       opt_accessor :canvas_css_class, :type => :string
 
+      # @param [Length] width width of the chart image
+      # @param [Length] height height of the chart image
+      # @param [Hash{Symbol => Object}] options the options to creat the chart
+      #   image. See <em>Instance Attribute</em> of the each chart class
+      #   ({Base}, {PieChart}, {LineChart}, etc...).
       def initialize(width, height, options={})
         @canvas = Canvas.new(width, height)
         @options = {}
@@ -212,56 +256,109 @@ module DYI #:nodoc:
         end
       end
 
+      # Returns width of the chart image on user unit.
+      # @return [Length] width of the chart image on user unit
       def width
         @canvas.width
       end
 
+      # Sets width of the chart image on user unit.
+      # @param [Length] width width of the chart image on user unit
       def width=(width)
         @canvas.width = width
       end
 
+      # Returns height of the chart image on user unit.
+      # @return [Length] height of the chart image on user unit
       def height
         @canvas.height
       end
 
+      # Sets height of the chart image on user unit.
+      # @param [Length] height height of the chart image on user unit
       def height=(height)
         @canvas.height = height
       end
 
+      # Sets size of the chart image.
+      # @param [Length] width width of the chart image
+      # @param [Length] height height of the chart image
       def set_real_size(width, height)
         @canvas.real_width = Length.new(width)
         @canvas.real_height = Length.new(height)
       end
 
+      # Clears <em>real size</em> of the chart image, and sets chart size as
+      # values of +width+ and +height+ properties. See {#set_real_size},
+      # {#width}, {#height}, {Canvas#real_width} and {Canvas#real_height}.
       def clear_real_size
         @canvas.real_width = nil
         @canvas.real_height = nil
       end
 
+      # Loads the data, and creates chart image.
+      # @param [ArrayReader] reader the +ArrayReader+ or its sub class that has
+      #   the data of the chart
       def load_data(reader)
         @data = reader
         create_vector_image
       end
 
+      # Save the chart image as a file.
+      # @param [String] file_name the file name which is saved the chart image
+      #   as
+      # @param [Symbol] format the file format. Supports the following formats:
+      #   [+:svg+] SVG (Scalable Vector Graphics). If +format+ equals nil,
+      #            output SVG format.
+      #   [+:eps+] EPS (Encapsulated Post Script).
+      #   [+:xaml+] XAML (Extensible Application Markup Language).
+      #   [+:emf+] EMF (Enhanced Metafile). Using _IronRuby_ only.
+      #   [+:png+] PNG (Portable Network Graphics). _librsvg_ must have been
+      #            installed on the system.
+      # @option options [Boolean] :inline_mode true if outputs the inlime-mode, false
+      #   otherwise. _SVG_ format only.
       def save(file_name, format=nil, options={})
         @canvas.save(file_name, format, options)
       end
 
+      # Outputs the chart image to IO stream.
+      # @param [Symbol] format the file format. Supports the following formats:
+      #   [+:svg+] SVG (Scalable Vector Graphics). If +format+ equals nil,
+      #            output SVG format.
+      #   [+:eps+] EPS (Encapsulated Post Script).
+      #   [+:xaml+] XAML (Extensible Application Markup Language).
+      #   [+:emf+] EMF (Enhanced Metafile). Using _IronRuby_ only.
+      #   [+:png+] PNG (Portable Network Graphics). _librsvg_ must have been
+      #            installed on the system.
+      # @param [IO] io the io which the chart image is outputed to
+      # @option options [Boolean] :inline_mode true if outputs the inlime-mode, false
+      #   otherwise. _SVG_ format only.
       def puts_in_io(format=nil, io=$>, options={})
         @canvas.puts_in_io(format, io, options)
       end
 
+      # Outputs the chart image as a +String+ (binary).
+      # @param [Symbol] format the file format. Supports the following formats:
+      #   [+:svg+] SVG (Scalable Vector Graphics). If +format+ equals nil,
+      #            output SVG format.
+      #   [+:eps+] EPS (Encapsulated Post Script).
+      #   [+:xaml+] XAML (Extensible Application Markup Language).
+      #   [+:emf+] EMF (Enhanced Metafile). Using _IronRuby_ only.
+      #   [+:png+] PNG (Portable Network Graphics). _librsvg_ must have been
+      #            installed on the system.
+      # @option options [Boolean] :inline_mode true if outputs the inlime-mode, false
+      #   otherwise. _SVG_ format only.
       def string(format=nil, options={})
         @canvas.string(format, options)
       end
 
       private
 
-      def options #:nodoc:
+      def options
         @options
       end
 
-      def chart_color(index) #:nodoc:
+      def chart_color(index)
         if data.has_field?(:color)
           color = Color.new_or_nil(data.records[index].color)
         end
@@ -272,7 +369,7 @@ module DYI #:nodoc:
       end
 
       # @since 1.0.0
-      def create_vector_image #:nodoc:
+      def create_vector_image
         @canvas.add_css_class(canvas_css_class) if canvas_css_class && !canvas_css_class.empty?
         @canvas.add_script(script_body) if script_body && !script_body.empty?
         @canvas.add_stylesheet(css_body) if css_body && !css_body.empty?