smallvictories 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 57b412c22c3ddab3b928e36a80fcd757bfedfa0c
-  data.tar.gz: 4860dd4466e9b09a7e7c9b39e1c3d9c7a30d25d1
+  metadata.gz: 7697d9131ed7aff89a85cfb9d647c54eddb738ef
+  data.tar.gz: 430eb38894186c232db4d6809442d4ea3f05ec4a
 SHA512:
-  metadata.gz: 90e8d86e01b61fb7ebbd515f676a776c2da4a6223c8015a35cb2d8ee4e0dcfc9d78146079b1897206d3a18b8cc83e2d94198a151a93bacd5084e6984fc7024e7
-  data.tar.gz: 9e51ce950e5513e3ad7bebefee87aa44ad659891b6cdc0677057e626efd3fd87c547c317d1f85d064fd168561d347a26b0c5733c370c0780fd3b4833e2267cd4
+  metadata.gz: 5f3c000d54497e043fa347ab8b5242902c97a859b2a63fb54e45eb4fa01179fce958064e4e27c0f1ee68d3cb00c8b6935fd1a3ccf40beb99b5055eca17e444b6
+  data.tar.gz: 8b029ccf6bdbdabcc74a8c4f10c3cccab1586162cb1ec6884aec9db80daf39dd1f0beb3eb65945d9a052dd412381bed5302a55d68ba4fb24160570a81f55b183

data/README.md

@@ -74,8 +74,8 @@ Dropbox
       │   ├── _includes
       │   │ └── _head.liquid
       │   ├── _layout.liquid
-      │   ├── _sv_custom.css
-      │   ├── _sv_custom.js
+      │   ├── application.css
+      │   ├── application.js
       │   └── index.liquid
       │
       ├── _sv_custom.css
@@ -137,8 +137,10 @@ You can set the following options:
 ```yaml
 source: '_'
 destination: ''
-stylesheet: '_sv_custom.css'
-javascript: '_sv_custom.js'
+source_stylesheet: 'application.css'
+source_javascript: 'application.js'
+destination_stylesheet: '_sv_custom.css'
+destination_javascript: '_sv_custom.js'
 layout: '_layout.liquid'
 includes: '_includes'
 ```

data/lib/sassc/compressor.rb

@@ -0,0 +1,21 @@
+require 'sprockets/sass_compressor'
+
+class Sprockets::SassCompressor
+  def call(*args)
+    input = if defined?(data)
+      data # sprockets 2.x
+    else
+      args[0][:data] #sprockets 3.x
+    end
+
+    SassC::Engine.new(
+      input,
+      {
+        style: :compressed
+      }
+    ).render
+  end
+
+  # sprockets 2.x
+  alias :evaluate :call
+end

data/lib/sassc/functions.rb

@@ -0,0 +1,12 @@
+require 'sprockets/sass_functions'
+require 'sassc'
+
+module Sprockets
+  module SassFunctions
+    def asset_data_url(path)
+      SassC::Script::String.new("url(" + sprockets_context.asset_data_uri(path.value) + ")")
+    end
+  end
+end
+
+::SassC::Script::Functions.send :include, Sprockets::SassFunctions

data/lib/sassc/importer.rb

@@ -0,0 +1,127 @@
+require 'tilt'
+
+module SassC
+  module Rails
+    class Importer < SassC::Importer
+      class Extension
+        attr_reader :postfix
+
+        def initialize(postfix=nil)
+          @postfix = postfix
+        end
+
+        def import_for(full_path, parent_dir, options)
+          SassC::Importer::Import.new(full_path)
+        end
+      end
+
+      class CSSExtension
+        def postfix
+          ".css"
+        end
+
+        def import_for(full_path, parent_dir, options)
+          import_path = full_path.gsub(/\.css$/,"")
+          SassC::Importer::Import.new(import_path)
+        end
+      end
+
+      EXTENSIONS = [
+        Extension.new(".scss"),
+        Extension.new(".sass"),
+        CSSExtension.new
+      ]
+
+      PREFIXS = [ "", "_" ]
+      GLOB = /(\A|\/)(\*|\*\*\/\*)\z/
+
+      def imports(path, parent_path)
+        parent_dir, _ = File.split(parent_path)
+        specified_dir, specified_file = File.split(path)
+
+        if m = path.match(GLOB)
+          path = path.sub(m[0], "")
+          base = File.expand_path(path, File.dirname(parent_path))
+          return glob_imports(base, m[2], parent_path)
+        end
+
+        search_paths = ([parent_dir] + load_paths).uniq
+
+        if specified_dir != "."
+          search_paths.map! do |path|
+            File.join(path, specified_dir)
+          end
+        end
+
+        search_paths.each do |search_path|
+          PREFIXS.each do |prefix|
+            file_name = prefix + specified_file
+
+            EXTENSIONS.each do |extension|
+              try_path = File.join(search_path, file_name + extension.postfix)
+              if File.exists?(try_path)
+                record_import_as_dependency try_path
+                return extension.import_for(try_path, parent_dir, options)
+              end
+            end
+          end
+        end
+
+        SassC::Importer::Import.new(path)
+      end
+
+      private
+
+      def extension_for_file(file)
+        EXTENSIONS.detect do |extension|
+          file.include? extension.postfix
+        end
+      end
+
+      def record_import_as_dependency(path)
+        context.depend_on path
+      end
+
+      def context
+        options[:sprockets][:context]
+      end
+
+      def load_paths
+        options[:load_paths]
+      end
+
+      def glob_imports(base, glob, current_file)
+        files = globbed_files(base, glob)
+        files = files.reject { |f| f == current_file }
+
+        files.map do |filename|
+          record_import_as_dependency(filename)
+          extension = extension_for_file(filename)
+          extension.import_for(filename, base, options)
+        end
+      end
+
+      def globbed_files(base, glob)
+        # TODO: Raise an error from SassC here
+        raise ArgumentError unless glob == "*" || glob == "**/*"
+
+        extensions = EXTENSIONS.map(&:postfix)
+        exts = extensions.map { |ext| Regexp.escape("#{ext}") }.join("|")
+        sass_re = Regexp.compile("(#{exts})$")
+
+        record_import_as_dependency(base)
+
+        files = Dir["#{base}/#{glob}"].sort.map do |path|
+          if File.directory?(path)
+            record_import_as_dependency(path)
+            nil
+          elsif sass_re =~ path
+            path
+          end
+        end
+
+        files.compact
+      end
+    end
+  end
+end

data/lib/sassc/template.rb

@@ -0,0 +1,103 @@
+require "sprockets/version"
+require "sprockets/sass_template"
+require "sprockets/utils"
+
+module SassC::Rails
+  class SassTemplate < Sprockets::SassTemplate
+    module Sprockets3
+      def call(input)
+        context = input[:environment].context_class.new(input)
+
+        options = {
+          filename: input[:filename],
+          line_comments: line_comments?,
+          syntax: self.class.syntax,
+          load_paths: input[:environment].paths,
+          importer: SassC::Rails::Importer,
+          sprockets: {
+            context: context,
+            environment: input[:environment],
+            dependencies: context.metadata[:dependency_paths]
+          }
+        }.merge(config_options)
+
+        engine = ::SassC::Engine.new(input[:data], options)
+
+        css = Sprockets::Utils.module_include(::SassC::Script::Functions, @functions) do
+          engine.render
+        end
+
+        context.metadata.merge(data: css)
+      end
+    end
+
+    module Sprockets2
+      def self.included(base)
+        base.class_eval do
+          self.default_mime_type = "text/css"
+        end
+      end
+
+      def evaluate(context, locals, &block)
+        options = {
+          filename: eval_file,
+          line_comments: line_comments?,
+          syntax: syntax,
+          load_paths: context.environment.paths,
+          importer: SassC::Rails::Importer,
+          sprockets: {
+            context: context,
+            environment: context.environment
+          }
+        }.merge(config_options)
+
+        ::SassC::Engine.new(data, options).render
+      end
+    end
+
+    if Sprockets::VERSION > "3.0.0"
+      include Sprockets3
+    else
+      include Sprockets2
+    end
+
+    def config_options
+      opts = { style: sass_style }
+
+
+      if Rails.application.config.sass.inline_source_maps
+        opts.merge!({
+          source_map_file: ".",
+          source_map_embed: true,
+          source_map_contents: true,
+        })
+      end
+
+      opts
+    end
+
+    def sass_style
+      (Rails.application.config.sass.style || :expanded).to_sym
+    end
+
+    def line_comments?
+      Rails.application.config.sass.line_comments
+    end
+  end
+
+  class ScssTemplate < SassTemplate
+    unless Sprockets::VERSION > "3.0.0"
+      self.default_mime_type = 'text/css'
+    end
+
+    # Sprockets 3
+    def self.syntax
+      :scss
+    end
+
+    # Sprockets 2
+    def syntax
+      :scss
+    end
+  end
+end

data/lib/smallvictories/builder.rb

@@ -54,8 +54,10 @@ module SmallVictories
       d = YAML::load_file(File.join(src_directory, 'config.yml'))
       d['source'] = DEFAULT_SOURCE
       d['destination'] = DEFAULT_DESTINATION
-      d['stylesheet'] = DEFAULT_STYLESHEET
-      d['javascript'] = DEFAULT_JAVASCRIPT
+      d['source_stylesheet'] = DEFAULT_SOURCE_STYLESHEET
+      d['source_javascript'] = DEFAULT_SOURCE_JAVASCRIPT
+      d['destination_stylesheet'] = DEFAULT_DESTINATION_STYLESHEET
+      d['destination_javascript'] = DEFAULT_DESTINATION_JAVASCRIPT
       d['layout'] = DEFAULT_LAYOUT
       d['includes'] = DEFAULT_INCLUDES
       File.open(File.join(folder_path, CONFIG_FILE), 'w') {|f| f.write d.to_yaml }
@@ -66,11 +68,11 @@ module SmallVictories
     end
 
     def setup_stylesheet
-      create_src_file('stylesheet.css', File.join(folder_source_path, config.stylesheet))
+      create_src_file('stylesheet.css', File.join(folder_source_path, config.stylesheets.first))
     end
 
     def setup_javascript
-      create_src_file('javascript.js', File.join(folder_source_path, config.javascript))
+      create_src_file('javascript.js', File.join(folder_source_path, config.javascripts.first))
     end
 
     def setup_html

data/lib/smallvictories/compiler.rb

@@ -11,11 +11,11 @@ module SmallVictories
     end
 
     def compile_css
-      package  [config.stylesheet]
+      package  [config.stylesheets]
     end
 
     def compile_js
-      package  [config.javascript]
+      package  [config.javascripts]
     end
 
     def compile_html
@@ -42,13 +42,14 @@ module SmallVictories
 
           file = File.open(path).read
           liquid = Liquid::Template.parse(file)
-          content = liquid.render('config' => { 'stylesheet' => config.stylesheet, 'javascript' => config.javascript })
+          data = { 'config' => { 'stylesheet' => config.stylesheets.last, 'javascript' => config.javascripts.last } }
+          content = liquid.render(data)
           output_file_name = file_name.concat('.html')
           output_path = File.join(config.full_destination_path, output_file_name)
           if layout
-            html = layout.render('content_for_layout' => liquid.render, 'config' => { 'stylesheet' => config.stylesheet, 'javascript' => config.javascript })
+            html = layout.render(data.merge('content_for_layout' => liquid.render))
           else
-            html = liquid.render('config' => { 'stylesheet' => config.stylesheet, 'javascript' => config.javascript })
+            html = liquid.render(data)
           end
           Dir.mkdir(config.full_destination_path) unless File.exists?(config.full_destination_path)
           File.open(File.join(config.full_destination_path, output_file_name), 'w') { |file| file.write(html) }
@@ -59,22 +60,21 @@ module SmallVictories
       end
     end
 
-    def package bundles=[config.stylesheet, config.javascript], options={}
-      sprockets = Sprockets::Environment.new(ROOT) do |environment|
+    def package bundles=[config.stylesheets, config.javascripts], options={}
+      sprockets = Sprockets::Environment.new(config.full_source_path) do |environment|
         environment.gzip = true
         environment.logger = SmallVictories.logger
         environment.js_compressor  = options[:js_compressor] || :uglify
         environment.css_compressor = options[:css_compressor] || :sass
       end
 
-      sprockets.append_path(config.full_source_path)
+      sprockets.append_path('.')
       bundles.each do |bundle|
         begin
-          if assets = sprockets.find_asset(bundle)
-            prefix, basename = assets.pathname.to_s.split('/')[-2..-1]
+          if assets = sprockets.find_asset(bundle.first)
             FileUtils.mkpath config.full_destination_path
-            assets.write_to File.join(config.full_destination_path,  basename)
-            SmallVictories.logger.info "compiled #{config.destination}/#{basename}"
+            assets.write_to File.join(config.full_destination_path,  bundle.last)
+            SmallVictories.logger.info "compiled #{File.join(config.destination, bundle.last)}"
           end
         rescue => e
           SmallVictories.logger.error "#{bundle}\n#{e}"
@@ -84,18 +84,18 @@ module SmallVictories
 
     def prefix_css
       begin
-        path = File.join(config.full_destination_path, config.stylesheet)
+        path = File.join(config.full_destination_path, config.stylesheets.last)
         css = File.open(path).read
         prefixed = AutoprefixerRails.process(css, browsers: ['last 2 version', 'safari 5', 'ie 8', 'ie 9', 'opera 12.1'], cascade: false)
         File.open(path, 'w') { |file| file.write(prefixed.css) }
 
-        sprockets = Sprockets::Environment.new(ROOT) do |environment|
+        sprockets = Sprockets::Environment.new(config.full_source_path) do |environment|
           environment.css_compressor = :yui
         end
         sprockets.append_path(config.full_destination_path)
-        if assets = sprockets.find_asset(config.stylesheet)
-          assets.write_to File.join(config.full_destination_path, config.stylesheet)
-          SmallVictories.logger.info "prefixed #{config.destination}/#{config.stylesheet}"
+        if assets = sprockets.find_asset(config.stylesheets.last)
+          assets.write_to File.join(config.full_destination_path, config.stylesheets.last)
+          SmallVictories.logger.info "prefixed #{config.destination}/#{config.stylesheets.last}"
         end
       rescue => e
         SmallVictories.logger.error "#{path}\n#{e}"
@@ -103,12 +103,12 @@ module SmallVictories
     end
 
     def minify_css
-      package  [config.stylesheet]
+      package  [config.stylesheets]
       prefix_css
     end
 
     def minify_js
-      package [config.javascript], { js_compressor: :closure }
+      package [config.javascripts], { js_compressor: :closure }
     end
   end
 end

data/lib/smallvictories/configuration.rb

@@ -32,12 +32,28 @@ module SmallVictories
       File.join(ROOT, destination)
     end
 
-    def javascript
-      config_file(:javascript) || DEFAULT_JAVASCRIPT
+    def source_javascript
+      config_file(:source_javascript) || DEFAULT_SOURCE_JAVASCRIPT
     end
 
-    def stylesheet
-      config_file(:stylesheet) || DEFAULT_STYLESHEET
+    def destination_javascript
+      config_file(:destination_javascript) || DEFAULT_DESTINATION_JAVASCRIPT
+    end
+
+    def javascripts
+      [source_javascript, destination_javascript]
+    end
+
+    def source_stylesheet
+      config_file(:source_stylesheet) || DEFAULT_SOURCE_STYLESHEET
+    end
+
+    def destination_stylesheet
+      config_file(:destination_stylesheet) || DEFAULT_DESTINATION_STYLESHEET
+    end
+
+    def stylesheets
+      [source_stylesheet, destination_stylesheet]
     end
 
     def layout

data/lib/smallvictories/constants.rb

@@ -2,8 +2,10 @@ module SmallVictories
   CONFIG_FILE = '_sv_config.yml'
   DEFAULT_SOURCE = '_'
   DEFAULT_DESTINATION = ''
-  DEFAULT_STYLESHEET = '_sv_custom.css'
-  DEFAULT_JAVASCRIPT = '_sv_custom.js'
+  DEFAULT_SOURCE_STYLESHEET = 'application.css'
+  DEFAULT_SOURCE_JAVASCRIPT = 'application.js'
+  DEFAULT_DESTINATION_STYLESHEET = '_sv_custom.css'
+  DEFAULT_DESTINATION_JAVASCRIPT = '_sv_custom.js'
   DEFAULT_LAYOUT = '_layout.liquid'
   DEFAULT_INCLUDES = '_includes'
   ROOT = Dir.pwd

data/lib/smallvictories/version.rb

@@ -1,3 +1,3 @@
 module SmallVictories
-  VERSION = "0.0.6"
+  VERSION = "0.0.7"
 end

data/lib/smallvictories.rb

@@ -8,3 +8,7 @@ require "smallvictories/configuration"
 require "smallvictories/builder"
 require "smallvictories/compiler"
 require "smallvictories/watcher"
+require "sassc/compressor"
+require "sassc/functions"
+require "sassc/importer"
+require "sassc/template"

data/spec/builder_spec.rb

@@ -11,12 +11,12 @@ describe SmallVictories do
       expect(File.exists?('fixtures/new/_/_layout.liquid')).to eq true
       expect(File.exists?('fixtures/new/_/index.liquid')).to eq true
       expect(File.exists?('fixtures/new/_/_includes/_head.liquid')).to eq true
-      expect(File.exists?('fixtures/new/_/_sv_custom.js')).to eq true
-      expect(File.exists?('fixtures/new/_/_sv_custom.css')).to eq true
+      expect(File.exists?('fixtures/new/_/application.js')).to eq true
+      expect(File.exists?('fixtures/new/_/application.css')).to eq true
     end
 
     after do
-      %w(fixtures/new/_sv_config.yml fixtures/new/.sv_guardfile fixtures/new/_/index.liquid fixtures/new/_/_sv_custom.css fixtures/new/_/_sv_custom.js fixtures/new/_/_includes/_head.liquid fixtures/new/_/_layout.liquid).each { |path| clean_file(path) }
+      %w(fixtures/new/_sv_config.yml fixtures/new/.sv_guardfile fixtures/new/_/index.liquid fixtures/new/_/application.css fixtures/new/_/application.js fixtures/new/_/_includes/_head.liquid fixtures/new/_/_layout.liquid).each { |path| clean_file(path) }
     end
   end
 end

data/spec/configuration_spec.rb

@@ -12,12 +12,20 @@ describe SmallVictories do
       expect(configuration.destination).to eq ''
     end
 
-    it 'defaults stylesheet file' do
-      expect(configuration.stylesheet).to eq '_sv_custom.css'
+    it 'defaults source stylesheet file' do
+      expect(configuration.source_stylesheet).to eq 'application.css'
     end
 
-    it 'defaults javascript file' do
-      expect(configuration.javascript).to eq '_sv_custom.js'
+    it 'defaults destination stylesheet file' do
+      expect(configuration.destination_stylesheet).to eq '_sv_custom.css'
+    end
+
+    it 'defaults source javascript file' do
+      expect(configuration.source_javascript).to eq 'application.js'
+    end
+
+    it 'defaults destination javascript file' do
+      expect(configuration.destination_javascript).to eq '_sv_custom.js'
     end
 
     it 'defaults layout file' do
@@ -43,11 +51,11 @@ describe SmallVictories do
     end
 
     it 'reads the output css file' do
-      expect(configuration.stylesheet).to eq 'my-stylesheet.css'
+      expect(configuration.source_stylesheet).to eq 'my-stylesheet.css'
     end
 
     it 'reads the output js file' do
-      expect(configuration.javascript).to eq 'my-javascript.js'
+      expect(configuration.source_javascript).to eq 'my-javascript.js'
     end
 
     it 'reads layout file' do

data/spec/fixtures/source/_sv_config.yml

@@ -1,6 +1,8 @@
 source: '/my-source-folder/'
 destination: 'my-site-folder/'
-stylesheet: 'my-stylesheet.css'
-javascript: 'my-javascript.js'
+source_stylesheet: 'my-stylesheet.css'
+source_javascript: 'my-javascript.js'
+destination_stylesheet: 'stylesheet.css'
+destination_javascript: 'javascript.js'
 layout: '_my-template.liquid'
 includes: 'snippets'

data/src/Guardfile

@@ -1,37 +1,8 @@
 # A Small Victories Guardfile
 # More info at https://github.com/guard/guard#readme
 
-## Uncomment and set this to only include directories you want to watch
-directories %w(.).select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
-
 guard 'livereload' do
-  extensions = {
-    css: :css,
-    js: :js,
-    html: :html,
-    png: :png,
-    gif: :gif,
-    jpg: :jpg,
-    jpeg: :jpeg,
-  }
-
-  # file types LiveReload may optimize refresh for
-  compiled_exts = extensions.values.uniq
-  watch(%r{./.+\.(#{compiled_exts * '|'})})
-
-  extensions.each do |ext, type|
-    watch(%r{
-          (?:app|vendor)
-          (?:/assets/\w+/(?<path>[^.]+) # path+base without extension
-           (?<ext>\.#{ext})) # matching extension (must be first encountered)
-          (?:\.\w+|$) # other extensions
-          }x) do |m|
-      path = m[1]
-      "/_/#{path}.#{type}"
-    end
-  end
-
-  watch(%r{_/.+\.liquid})
+  watch(%r{.+\.(css|js|html)})
 end
 
 logger level: :warn

data/src/config.yml

@@ -1,6 +1 @@
-source: ''
-destination: '_site'
-stylesheet: '_sv_custom.css'
-javascript: '_sv_custom.js'
-layout: '_layout.liquid'
-includes: '_includes'
+source: '_'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smallvictories
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - Michael Dijkstra
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-01-23 00:00:00.000000000 Z
+date: 2016-01-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: autoprefixer-rails
@@ -220,6 +220,10 @@ files:
 - README.md
 - Rakefile
 - bin/sv
+- lib/sassc/compressor.rb
+- lib/sassc/functions.rb
+- lib/sassc/importer.rb
+- lib/sassc/template.rb
 - lib/smallvictories.rb
 - lib/smallvictories/builder.rb
 - lib/smallvictories/compiler.rb
@@ -234,9 +238,8 @@ files:
 - spec/configuration_spec.rb
 - spec/fixtures/_sv_custom.css
 - spec/fixtures/destination/.gitkeep
-- spec/fixtures/destination_sv_custom.css
-- spec/fixtures/destination_sv_custom.js
-- spec/fixtures/destinationindex.html
+- spec/fixtures/destination/application.css
+- spec/fixtures/destination/application.js
 - spec/fixtures/invalid/_layout.liquid
 - spec/fixtures/invalid/_sass/stylesheet.scss
 - spec/fixtures/invalid/index.html
@@ -248,8 +251,8 @@ files:
 - spec/fixtures/source/_stylesheets/extra.scss
 - spec/fixtures/source/_stylesheets/stylesheet.scss
 - spec/fixtures/source/_sv_config.yml
-- spec/fixtures/source/_sv_custom.css
-- spec/fixtures/source/_sv_custom.js
+- spec/fixtures/source/application.css
+- spec/fixtures/source/application.js
 - spec/fixtures/source/index.html
 - spec/spec_helper.rb
 - src/Guardfile
@@ -289,9 +292,8 @@ test_files:
 - spec/configuration_spec.rb
 - spec/fixtures/_sv_custom.css
 - spec/fixtures/destination/.gitkeep
-- spec/fixtures/destination_sv_custom.css
-- spec/fixtures/destination_sv_custom.js
-- spec/fixtures/destinationindex.html
+- spec/fixtures/destination/application.css
+- spec/fixtures/destination/application.js
 - spec/fixtures/invalid/_layout.liquid
 - spec/fixtures/invalid/_sass/stylesheet.scss
 - spec/fixtures/invalid/index.html
@@ -303,7 +305,7 @@ test_files:
 - spec/fixtures/source/_stylesheets/extra.scss
 - spec/fixtures/source/_stylesheets/stylesheet.scss
 - spec/fixtures/source/_sv_config.yml
-- spec/fixtures/source/_sv_custom.css
-- spec/fixtures/source/_sv_custom.js
+- spec/fixtures/source/application.css
+- spec/fixtures/source/application.js
 - spec/fixtures/source/index.html
 - spec/spec_helper.rb

data/spec/fixtures/destinationindex.html

@@ -1,5 +0,0 @@
-<html>
-<h1>Index</h1>
-Liquid error: No such template 'snippet'
-
-</html>