muwu 3.0.0.alpha → 3.0.0.beta

data/lib/muwu/project_builder/assets/config/css/base/mixin_text_section_heading.scss

@@ -1,7 +1,41 @@
+// @mixin text_section_heading($font-size, $margin-bottom) {
+//   >.section_number {
+//     font-size: $font-size;
+//     & + h1:first-of-type,
+//     & + h2:first-of-type,
+//     & + h3:first-of-type,
+//     & + h4:first-of-type,
+//     & + h5:first-of-type,
+//     & + h6:first-of-type {
+//       font-size: $font-size;
+//       margin-bottom: $margin-bottom;
+//     }
+//   }
+//   >h1:first-child,
+//   >h2:first-child,
+//   >h3:first-child,
+//   >h4:first-child,
+//   >h5:first-child,
+//   >h6:first-child {
+//     font-size: $font-size;
+//     margin-bottom: $margin-bottom;
+//   }
+// }
+
 @mixin text_section_heading($font-size, $margin-bottom) {
-  >.section_number {
+  >h1:first-child,
+  >h2:first-child,
+  >h3:first-child,
+  >h4:first-child,
+  >h5:first-child,
+  >h6:first-child {
+    font-size: $font-size;
+    margin-bottom: $margin-bottom;
+  }
+  >h1.section_number {
     font-size: $font-size;
-    & + h1:first-of-type,
+    margin-bottom: 0;
+    & + h1:nth-of-type(2),
     & + h2:first-of-type,
     & + h3:first-of-type,
     & + h4:first-of-type,
@@ -11,13 +45,4 @@
       margin-bottom: $margin-bottom;
     }
   }
-  >h1:first-child,
-  >h2:first-child,
-  >h3:first-child,
-  >h4:first-child,
-  >h5:first-child,
-  >h6:first-child { 
-    font-size: $font-size;
-    margin-bottom: $margin-bottom;
-  }
 }

data/lib/muwu/project_builder/project_reader.rb

@@ -77,6 +77,7 @@ module Muwu
 
 
     def phase_4_validate
+      @validator.validate_dir_compiled
       @validator.validate_file_css
       @validator.validate_option_remote_publish
       @validator.validate_option_remote_sync

data/lib/muwu/project_builder/project_reset_compiled.rb

@@ -0,0 +1,24 @@
+module Muwu
+  class ProjectResetCompiled
+
+
+    require 'fileutils'
+
+
+    include Muwu
+
+
+    def initialize(project)
+      @project = project
+    end
+
+
+    def reset_compiled
+      puts "- Resetting #{@project.path_compiled}"
+      FileUtils.remove_entry_secure(@project.path_compiled)
+      FileUtils.mkdir(@project.path_compiled)
+    end
+
+
+  end
+end

data/lib/muwu/project_builder/project_reset_css.rb

@@ -1,21 +1,21 @@
 module Muwu
   class ProjectResetCss
-    
-    
+
+
     include Muwu
-    
-    
+
+
     require 'fileutils'
-    
-    
+
+
     def initialize(project)
       @project = project
     end
-    
-    
+
+
     public
-    
-    
+
+
     def reset_css
       phase_1_verify_or_create_css_folder
       phase_2_clear_base_folder
@@ -25,8 +25,8 @@ module Muwu
       phase_6_copy_index
       phase_7_verify_or_create_extensions_folder
     end
-    
-    
+
+
     def phase_1_verify_or_create_css_folder
       if Dir.exists?(@project.path_config) == false
         puts "Creating folder #{@project.path_config}"
@@ -37,50 +37,50 @@ module Muwu
         FileUtils.mkdir(@project.path_css)
       end
     end
-    
-    
+
+
     def phase_2_clear_base_folder
       if Dir.exists?(@project.path_css_base) == true
         puts "Clearing folder #{@project.path_css_base}"
-        FileUtils.remove_dir(@project.path_css_base)
+        FileUtils.remove_entry_secure(@project.path_css_base)
       end
     end
-    
-    
+
+
     def phase_3_copy_base_css_files
       folder_source_gem = File.absolute_path(File.join(Muwu::GEM_HOME_LIB, 'muwu','project_builder','assets','config','css','base'))
       folder_destination_project = @project.path_css_base
       puts "Resetting folder #{@project.path_css_base}"
       FileUtils.cp_r(folder_source_gem, folder_destination_project)
     end
-        
-    
+
+
     def phase_4_verify_or_create_colors_folder
       if Dir.exists?(@project.path_css_colors) == false
         puts "Creating folder #{@project.path_css_colors}"
         FileUtils.mkdir(@project.path_css_colors)
       end
     end
-    
-    
+
+
     def phase_5_copy_colors_css_files
       colors_source_gem = File.absolute_path(File.join(Muwu::GEM_HOME_LIB, 'muwu','project_builder','assets','config','css','colors','.'))
       colors_destination_project = @project.path_css
       puts "Resetting file #{File.join(@project.path_css_colors,'dark.scss')}"
-      puts "Resetting file #{File.join(@project.path_css_colors,'dark.scss')}"
-      puts "Resetting file #{File.join(@project.path_css_colors,'dark.scss')}"
+      puts "Resetting file #{File.join(@project.path_css_colors,'index.scss')}"
+      puts "Resetting file #{File.join(@project.path_css_colors,'light.scss')}"
       FileUtils.cp_r(colors_source_gem, colors_destination_project)
     end
-    
-    
+
+
     def phase_6_copy_index
       index_source_gem = File.absolute_path(File.join(Muwu::GEM_HOME_LIB, 'muwu','project_builder','assets','config','css','index.scss'))
       index_destination_project = @project.path_css
       puts "Resetting file #{File.join(@project.path_css, 'index.scss')}"
       FileUtils.cp_r(index_source_gem, index_destination_project)
     end
-    
-    
+
+
     def phase_7_verify_or_create_extensions_folder
       if Dir.exists?(@project.path_css_extensions) == false
         folder_source_gem = File.absolute_path(File.join(Muwu::GEM_HOME_LIB, 'muwu','project_builder','assets','config','css','extensions'))
@@ -89,7 +89,7 @@ module Muwu
         FileUtils.cp_r(folder_source_gem, folder_destination_project)
       end
     end
-   
-    
+
+
   end
-end
+end

data/lib/muwu/project_builder/project_validator.rb

@@ -14,6 +14,16 @@ module Muwu
     public
 
 
+    def validate_dir_compiled
+      if @project.path_compiled_does_exist
+        return true
+      else
+        @project.exceptions_add ProjectException::CompiledFolderNotFound.new(@project)
+        return false
+      end
+    end
+
+
     def validate_file_css
       if @project.css_manifest_file_does_exist
         return true
@@ -52,8 +62,8 @@ module Muwu
         return false
       end
     end
-    
-    
+
+
     def validate_option_remote_publish
       if @project.options.remote_publish.to_s == ''
         @project.exceptions_add ProjectException::OptionRemotePublishValueNil.new
@@ -106,8 +116,8 @@ module Muwu
         @project.exceptions_add ProjectException::MultipleFormatsRequestedWithStdout.new
       end
     end
-    
-    
+
+
     def validate_scenario_if_more_than_one_document
       if @project.outline_has_more_than_one_document && @project.output_destination_requests_stdout
         @project.exceptions_add ProjectException::MultipleDocumentsOutlinedWithStdout.new

data/lib/muwu/project_builder/project_writer.rb

@@ -8,8 +8,8 @@ module Muwu
 
     require 'fileutils'
     require 'yaml'
-    
-    
+
+
     attr_accessor(
       :project
     )
@@ -40,19 +40,20 @@ module Muwu
 
       end
     end
-    
-    
+
+
     def phase_1_make_project_folder
       announce_and_execute_dir_mkdir(@project.working_directory)
     end
-    
-    
+
+
     def phase_2_make_project_subfolders
+      announce_and_execute_dir_mkdir(@project.path_compiled)
       announce_and_execute_dir_mkdir(@project.path_config)
       announce_and_execute_dir_mkdir(@project.path_images)
       announce_and_execute_dir_mkdir(@project.path_text)
     end
-    
+
 
     def phase_2_make_folder_css_and_copy_files
       folder_source_gem = File.absolute_path(File.join(Muwu::GEM_HOME_LIB, 'muwu','project_builder','assets','config','css'))
@@ -79,8 +80,8 @@ module Muwu
         phase_3_write_file_outline_yml_blank
       end
     end
-    
-    
+
+
     def phase_3_write_file_outline_yml_dump
       announce_and_execute_yaml_dump(@project.outline, @project.outline_filename)
     end
@@ -124,4 +125,4 @@ module Muwu
 
 
   end
-end
+end

data/lib/muwu/project_exception/compiled_folder_not_found.rb

@@ -0,0 +1,23 @@
+module Muwu
+  module ProjectException
+    class CompiledFolderNotFound
+
+
+      def initialize(project)
+        @compiled_folder = project.path_compiled
+      end
+
+
+      def report
+        "The folder for compiled documents `#{@compiled_folder}` could not be found."
+      end
+
+
+      def type
+        :fatal
+      end
+
+
+    end
+  end
+end

data/lib/muwu/project_exception/lynx_not_available.rb

@@ -0,0 +1,23 @@
+module Muwu
+  module ProjectException
+    class LynxNotAvailable
+
+
+      def initialize
+        $stderr.puts "#{self.class}"
+      end
+
+
+      def report
+        "lynx is not available"
+      end
+
+
+      def type
+        :view
+      end
+
+
+    end
+  end
+end

data/lib/muwu/project_options/project_options.rb

@@ -3,6 +3,7 @@ module Muwu
 
 
     attr_accessor(
+      :expunge_when_compiling_all,
       :generate_navigators_automatically,
       :generate_subcontents_automatically,
       :html_head_includes_metadata_tags,
@@ -25,15 +26,15 @@ module Muwu
       :render_title_section_metadata,
       :warning_if_parent_heading_lacks_source
     )
-    
-    
+
+
     def initialize
       Default::PROJECT_OPTIONS.each_pair do |key, value|
         set_option(key, value)
       end
     end
-    
-    
+
+
     def inspect
       ["#{self.to_s}", "{", inspect_instance_variables, "}"].join(' ')
     end
@@ -42,15 +43,15 @@ module Muwu
     def inspect_instance_variables
       instance_variables.map { |v| "#{v}=#{instance_variable_get(v).inspect}" }.join(", ")
     end
-    
-    
+
+
     def set_option(key, value)
       if Default::PROJECT_OPTIONS.has_key?(key)
         key_ivsym = "@#{key.to_s}"
         instance_variable_set(key_ivsym, value)
       end
     end
-      
-  
+
+
   end
 end

data/lib/muwu/project_options_builder/project_option_validator_value.rb

@@ -3,32 +3,32 @@ module Muwu
 
 
     require 'iso-639'
-    
-   
+
+
     include Muwu
     include Helper
 
-    
+
     attr_accessor(
       :key_validated,
       :project,
       :validation_method_name,
       :value_provided
     )
-   
- 
+
+
     def initialize(key_validated, value_provided, project)
       @key_validated = key_validated.to_s.gsub(/\W/,'_')
       @project = project
       @validation_method_name = "validate_option_#{@key_validated}"
       @value_provided = value_provided
     end
-    
-    
-    
+
+
+
     public
-    
-        
+
+
     def validated_value
       if private_methods.include?(@validation_method_name.to_sym)
         return method(@validation_method_name).call
@@ -37,20 +37,6 @@ module Muwu
         return nil
       end
     end
-    
-    
-    # def value_as_array(value)
-    #   result = []
-    #   if String === value
-    #     result = value.split(/,\s*/).map{ |v| value_as_string(v) }.sort
-    #   elsif Array === value
-    #     result = value.map{ |v| value_as_string(v) }.sort
-    #   elsif Boolean === @value_provided
-    #     result << value
-    #   end
-    #   result.reject!{ |r| r == '' }
-    #   result
-    # end
 
 
     def value_as_array(value)
@@ -66,13 +52,13 @@ module Muwu
       result.reject!{ |r| r == '' }
       result
     end
-    
-    
+
+
     def value_as_integer(value)
       value.to_i
     end
-    
-    
+
+
     def value_as_string(value)
       value.to_s.strip.downcase
     end
@@ -81,8 +67,8 @@ module Muwu
     def value_as_string_preserving_case(value)
       value.to_s.strip
     end
-    
-        
+
+
     def value_provided_as_array
       value_as_array(@value_provided)
     end
@@ -91,22 +77,22 @@ module Muwu
     def value_provided_as_integer
       value_as_integer(@value_provided)
     end
-    
-    
+
+
     def value_provided_as_string
       value_as_string(@value_provided)
     end
-    
-    
+
+
     def value_provided_as_string_preserving_case
       value_as_string_preserving_case(@value_provided)
     end
-      
+
 
 
     private
-    
-    
+
+
     def validate_option_boolean
       case @value_provided
       when false, true
@@ -118,23 +104,28 @@ module Muwu
         return nil
       end
     end
-    
-    
+
+
+    def validate_option_expunge_when_compiling_all
+      return validate_option_boolean
+    end
+
+
     def validate_option_generate_navigators_automatically
       return validate_option_boolean
     end
-    
-    
+
+
     def validate_option_generate_subcontents_automatically
       return validate_option_boolean
     end
-    
-    
+
+
     def validate_option_html_head_includes_metadata_tags
       return validate_option_boolean
     end
-    
-    
+
+
     def validate_option_html_lang
       case @value_provided
       when nil, 'nil'
@@ -149,18 +140,18 @@ module Muwu
         end
       end
     end
-    
-    
+
+
     def validate_option_html_uses_javascript_navigation
       return validate_option_boolean
     end
-    
-    
+
+
     def validate_option_markdown_allows_raw_html
       return validate_option_boolean
     end
-      
-    
+
+
     def validate_option_markdown_renderer
       value = value_provided_as_string
       case value
@@ -173,8 +164,8 @@ module Muwu
         return nil
       end
     end
-    
-    
+
+
     def validate_option_outline_text_pathnames
       value = value_provided_as_string
       case value
@@ -185,8 +176,8 @@ module Muwu
         return nil
       end
     end
-    
-    
+
+
     def validate_option_output_destination
       value = value_provided_as_string
       case value
@@ -210,22 +201,22 @@ module Muwu
         return nil
       end
     end
-    
-    
+
+
     def validate_option_output_file_css_basename
       return validate_option_output_file_basename
     end
-    
-    
+
+
     def validate_option_output_file_html_basename
       return validate_option_output_file_basename
     end
-    
-    
+
+
     def validate_option_output_file_js_basename
       return validate_option_output_file_basename
     end
-    
+
 
     def validate_option_output_formats
       result = []
@@ -239,23 +230,23 @@ module Muwu
       end
       return result
     end
-    
-    
+
+
     def validate_option_remote_publish
       return value_provided_as_string_preserving_case
     end
-  
-  
+
+
     def validate_option_remote_sync
       return value_provided_as_string_preserving_case
     end
-  
-  
+
+
     def validate_option_render_punctuation_smart
       return validate_option_boolean
     end
-  
-  
+
+
     def validate_option_render_section_end_links
       result = []
       value_provided_as_array.each do |value|
@@ -272,12 +263,12 @@ module Muwu
       end
       return result
     end
-    
-    
+
+
     def validate_option_render_section_numbers
       return validate_option_boolean
     end
-  
+
 
     def validate_option_render_sections_distinctly_depth_max
       case @value_provided
@@ -290,8 +281,8 @@ module Muwu
         return nil
       end
     end
-    
-    
+
+
     def validate_option_render_title_section_metadata
       case @value_provided
       when nil, '', 'nil'
@@ -304,17 +295,17 @@ module Muwu
         return [@value_provided.to_s].flatten
       end
     end
-    
-    
+
+
     def validate_option_render_punctuation_smart
       return validate_option_boolean
     end
-    
-    
+
+
     def validate_option_warning_if_parent_heading_lacks_source
       return validate_option_boolean
     end
-    
-    
+
+
   end
-end
+end