evil-front 0.1.0

data/lib/assets/stylesheets/evil-front/sticky-footer.sass

@@ -0,0 +1,20 @@
+// Sticky footer, which show on bottom of screen if content height is less,
+// that screen content
+//
+//   +sticky-footer(100px)
+//
+// You can specify footer selector (`.footer-layout` by default):
+//
+//   +sticky-footer(100px, 'footer')
+@mixin sticky-footer($height, $footer: unquote(".footer-layout"))
+  html
+    position: relative
+    min-height: 100%
+  body
+    margin-bottom: $height
+  #{$footer}
+    position: absolute
+    left: 0
+    bottom: 0
+    height: $height
+    width: 100%

data/lib/assets/stylesheets/evil-front/stroke-text.sass

@@ -0,0 +1,8 @@
+// Stroke text by some shadow. Useful, when you white on transparent background.
+//
+//  .banner
+//    background: black(0.2)
+//    color: white
+//    +stroke-text(black)
+@mixin stroke-text($color)
+  text-shadow: 1px 1px 1px $color, 1px -1px 1px $color, 1px 1px 1px $color, -1px -1px 1px $color

data/lib/assets/stylesheets/evil-front/styled-taps.sass

@@ -0,0 +1,11 @@
+// Disable standard browser tap highlight and transitions for hover and tapped
+// states.
+//
+//   +styled-taps
+//
+// Must be used with `evil-front/tappable` JS and `no-hover` Sass mixin.
+@mixin styled-taps
+  .is-tapped, :active
+    transition: none !important
+  body
+    +no-tap-highlight

data/lib/assets/stylesheets/evil-front/to-px.sass

@@ -0,0 +1,6 @@
+// Add "px" if unit is unitless. Used in +media and +size.
+@function to-px($var)
+  @if unitless($var)
+    @return $var * 1px
+  @else
+    @return $var

data/lib/assets/stylesheets/evil-front.sass

@@ -0,0 +1,18 @@
+@import "rails-sass-images"
+
+@import "evil-front/to-px"
+
+@import "evil-front/size"
+@import "evil-front/reset"
+@import "evil-front/media"
+@import "evil-front/colors"
+@import "evil-front/height"
+@import "evil-front/easings"
+@import "evil-front/no-hover"
+@import "evil-front/clearfix"
+@import "evil-front/styled-taps"
+@import "evil-front/stroke-text"
+@import "evil-front/import-ruble"
+@import "evil-front/flying-quotes"
+@import "evil-front/sticky-footer"
+@import "evil-front/no-tap-highlight"

data/lib/evil-front/helpers/capitalize_first.rb

@@ -0,0 +1,8 @@
+module EvilFront::Helpers
+  # Capitalize only first letter (like titles in Russian).
+  #
+  #   = capitalize_first post.title
+  def capitalize_first(text)
+    EvilFront::Russian.capitalize_first(text)
+  end
+end

data/lib/evil-front/helpers/disable_mobile_zoom.rb

@@ -0,0 +1,13 @@
+module EvilFront::Helpers
+  # Disable user zoom in mobile browsers. You should use it only if your styles
+  # are special optimized for mobile screens.
+  #
+  #   html
+  #     head
+  #       = disable_mobile_zoom
+  def disable_mobile_zoom
+    html = '<meta name="viewport" content="width=device-width, ' +
+                 'initial-scale=1.0, maximum-scale=1.0, user-scalable=0" />'
+    EvilFront.html_safe(html)
+  end
+end

data/lib/evil-front/helpers/flying_quote.rb

@@ -0,0 +1,20 @@
+module EvilFront::Helpers
+  # Mark quotes to move first quote before the text line.
+  #
+  #   = flying_quotes feedback.text
+  #
+  # You can send block:
+  #
+  #   = flying_quotes do
+  #     a href=course.url
+  #       = course.name
+  def flying_quotes(text = nil, options = { }, &block)
+    text = if block_given?
+      capture(&block).strip
+    else
+      EvilFront.escape(text)
+    end
+    text = EvilFront::Russian.flying_quotes(text, options)
+    EvilFront.html_safe(text)
+  end
+end

data/lib/evil-front/helpers/head_content.rb

@@ -0,0 +1,10 @@
+module EvilFront::Helpers
+  # Add content to head tag. Will be useful in page views.
+  #
+  #   - head_content do
+  #     meta name="description" content=page.seo.description
+  #     meta name="keywords"    content=page.seo.keywords
+  def head_content(&block)
+    content_for(:evil_front_head, &block)
+  end
+end

data/lib/evil-front/helpers/head_tag.rb

@@ -0,0 +1,26 @@
+module EvilFront::Helpers
+  # Add content from `head_content` and statistics counter in production,
+  # if you set `:stats` option.
+  #
+  #   html
+  #     head
+  #       = head_tag do
+  #         = title_tag(t.title)
+  #         = standard_assets
+  #
+  # You can disable statistics counter by options:
+  #
+  #   = head_tag(statistics: false) do
+  def head_tag(options = { }, &block)
+    head  = tag(:meta, charset: 'UTF-8')
+    head += capture(&block) if block_given?
+    head += content_for(:evil_front_head)
+
+    options[:statistics] = true unless options.has_key? :statistics
+    if options[:statistics] and Rails.env.production?
+      head += render('layouts/statistics') rescue ''
+    end
+
+    content_tag(:head, head)
+  end
+end

data/lib/evil-front/helpers/ruble.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+module EvilFront::Helpers
+  # Insert symbol of Russian currency.
+  #
+  #   = order.price
+  #   = ruble
+  #
+  # Don’t forget to import ruble’s fonts and class in you Sass:
+  #
+  #   +import-ruble("PT Sane, sans-serif", $regular: inline)
+  def ruble
+    EvilFront.html_safe('<span class="ruble">Р</span>')
+  end
+end

data/lib/evil-front/helpers/russian_typograph.rb

@@ -0,0 +1,21 @@
+module EvilFront::Helpers
+  # Insert non-break spaces and mark quotes to have nice text. Work only with
+  # Russian language.
+  #
+  #   = typograph user.description
+  #
+  # You can send block:
+  #
+  #   = typograph do
+  #     = user.name
+  #     = user.profession
+  def russian_typograph(text = nil, &block)
+    text = if block_given?
+      capture(&block)
+    else
+      EvilFront.escape(text)
+    end
+    text = EvilFront::Russian.typograph_html(text)
+    EvilFront.html_safe(text)
+  end
+end

data/lib/evil-front/helpers/standard_assets.rb

@@ -0,0 +1,13 @@
+module EvilFront::Helpers
+  # Add `application.css`, jQuery from Google CDN and `application.js`.
+  #
+  #   html
+  #     = head_tag do
+  #       = standard_assets
+  def standard_assets(attributes = { })
+    stylesheet_link_tag('application', media: 'all') +
+      include_jquery(attributes.dup) +
+      content_for(:evil_libraries) +
+      javascript_include_tag('application', attributes)
+  end
+end

data/lib/evil-front/helpers/tel.rb

@@ -0,0 +1,12 @@
+module EvilFront::Helpers
+  # Render link with phone number. It will remove all non-digits symbols from
+  # phone number and format `tel:` protocol URI.
+  #
+  #   label Contact us:
+  #   = tel('+7 (495) 660−83−79')
+  def tel(number, args = { })
+    args[:href]  = "tel:" + number.gsub(/[^\d\+]/, '')
+    args[:class] = (['tel', args[:class]]).compact.join(' ')
+    content_tag(:a, number, args)
+  end
+end

data/lib/evil-front/helpers/title.rb

@@ -0,0 +1,14 @@
+module EvilFront::Helpers
+  # Add page title. Will be used with site title in document title tag by
+  # `title_tag`.
+  #
+  #   - title 'FAQ'
+  #
+  # You can set subtitles (order will be reversed):
+  #
+  #   - title 'FAQ', 'Ask'
+  def title(*titles)
+    @evil_front_titles ||= []
+    @evil_front_titles  += titles
+  end
+end

data/lib/evil-front/helpers/title_tag.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+require 'i18n'
+
+module EvilFront::Helpers
+  # Return title tag with current page title. It will just join page titles
+  # from `title` helper and `site` name.
+  #
+  # By default, separator will be m-dash for Russian and n-dash for others.
+  #
+  #   html
+  #     head
+  #       = title_tag('Foo Company')
+  #
+  # Separator will be taken by current locale. But, you can change it by
+  # `separator` option:
+  #
+  #   = title_tag('Foo Company', separator: ' * ')
+  def title_tag(*site)
+    @evil_front_titles ||= []
+    options   = site.extract_options!
+    separator = options[:separator] || (I18n.locale == :ru ? ' — ' : ' - ')
+    titles    = (@evil_front_titles + site).compact
+    titles    = titles.join(separator)
+    EvilFront.html_safe("<title>#{ EvilFront.escape(titles) }</title>")
+  end
+end

data/lib/evil-front/helpers.rb

@@ -0,0 +1,25 @@
+module EvilFront
+  HTML_ESCAPE = { '&' => '&amp;',  '>' => '&gt;', '<' => '&lt;' }
+
+  # Call `html_safe` if String has this methods.
+  def self.html_safe(string)
+    if string.respond_to?(:html_safe)
+      string.html_safe
+    else
+      string.to_s
+    end
+  end
+
+  # Escape unsafe strings
+  def self.escape(string)
+    string = string.to_s
+    if not string.respond_to?(:html_safe?) or string.html_safe?
+      string
+    else
+      string.gsub(/[&><]/, HTML_ESCAPE).html_safe
+    end
+  end
+end
+
+dir = Pathname(__FILE__).dirname.join('helpers')
+Dir.glob(dir.join('*.rb').to_s) { |helper| require helper }

data/lib/evil-front/russian.rb

@@ -0,0 +1,84 @@
+# encoding: utf-8
+
+require 'unicode_utils'
+require 'nokogiri'
+require 'standalone_typograf'
+
+module EvilFront
+  # Helpers to work with Russian text.
+  module Russian
+    # Capitalize only first letter (like titles in Russian).
+    #
+    #   = EvilFront::Russian.capitalize_first(title)
+    def self.capitalize_first(text)
+      UnicodeUtils.upcase(text[0]) + text[1..-1]
+    end
+
+    # Insert non-break spaces and mark quotes to have nice text. Work only with
+    # Russian language.
+    #
+    #   EvilFront::Russian.typograph(article)
+    def self.typograph(text)
+      return text if text.nil? or text.empty?
+
+      text = StandaloneTypograf::Typograf.new(text).prepare
+
+      tiny = %w(ни не и но а или да как из-за про по за для
+                на до при меж о у в во с со от ото из без
+                безо к ко об обо под подо над перед передо)
+      tiny += tiny.map { |i| capitalize_first(i) }
+      tiny.each do |word|
+        regexp = Regexp.new(" #{Regexp.quote word} ") # fix JRuby issue
+        text.gsub! regexp, " #{word} " # non-break space
+      end
+
+      text.gsub!(/([^\s" ]+)-([^\s" ]+)/, '\1‑\2')
+
+      text
+    end
+
+    # Like `typograph`, but process only text nodes in HTML.
+    #
+    #   EvilFront::Russian.typograph_html(article.html)
+    def self.typograph_html(html)
+      return html if html.nil? or html.empty?
+
+      if html.include? '<'
+        nodes = Nokogiri::HTML::DocumentFragment.parse(html)
+        typograph_node! nodes
+        nodes.to_html
+      else
+        auto_flying_quotes(typograph(html))
+      end
+    end
+
+    # Find quotes in text and make them flying
+    def self.auto_flying_quotes(text)
+      text.gsub(/\s«[^»]+»/) { |i| flying_quotes i[2..-2], space: i[0] }.
+           gsub(/^«[^»]+»/)  { |i| flying_quotes i[1..-2], space: '' }
+    end
+
+    # Mark quotes to move first quote before the text line.
+    def self.flying_quotes(text, options = { })
+      sp = options[:space] || ' '
+      sp = "<span class=\"space-before-quote\">#{sp}</span>" if sp != ''
+      "#{ sp }<span class=\"quotes\">«#{ text }»</span>"
+    end
+
+    private
+
+    # Recursively apply typography to Nokogiri nodes
+    def self.typograph_node!(node)
+      return if node.name == 'code'
+
+      node.children.each do |child|
+        if child.is_a? Nokogiri::XML::Text
+          text = EvilFront.escape(child.content)
+          child.replace( auto_flying_quotes(typograph(text)) )
+        else
+          typograph_node! child
+        end
+      end
+    end
+  end
+end

data/lib/evil-front/slim.rb

@@ -0,0 +1,6 @@
+module EvilFront
+  # Set default options to Slim
+  def self.set_slim_options!
+    Slim::Engine.set_default_options(pretty: true, format: :html5)
+  end
+end

data/lib/evil-front/version.rb

@@ -0,0 +1,3 @@
+module EvilFront
+  VERSION = '0.1.0' unless defined? EvilFront::VERSION
+end

data/lib/evil-front.rb

@@ -0,0 +1,30 @@
+require 'pathname'
+
+require 'slim'
+require 'sass'
+require 'sprockets'
+require 'rails-sass-images'
+
+module EvilFront
+  autoload :Russian, 'evil-front/russian'
+
+  if defined?(::Rails)
+    # Enable `lib/assets/` and `vendor/assets/` in Rails app.
+    class Engine < ::Rails::Engine
+    end
+  end
+
+  # Install Evil Front to standalone Sprockets environment.
+  def self.install(sprockets)
+    RailsSassImages.install(sprockets)
+
+    root = Pathname(__FILE__).dirname.join('..')
+    sprockets.append_path(root.join('lib/assets/javascripts'))
+    sprockets.append_path(root.join('lib/assets/stylesheets'))
+    sprockets.append_path(root.join('vendor/assets/fonts'))
+  end
+end
+
+require_relative 'evil-front/version'
+require_relative 'evil-front/helpers'
+require_relative 'evil-front/slim'

data/spec/helpers_spec.rb

@@ -0,0 +1,98 @@
+# encoding: utf-8
+
+require_relative 'spec_helper'
+require 'slim'
+
+describe EvilFront::Helpers do
+  include EvilFront::Helpers
+
+  describe 'capitalize_first' do
+
+    it 'capitalizes Russian' do
+      capitalize_first('тест').should == 'Тест'
+    end
+
+  end
+
+  describe 'disable_mobile_zoom' do
+
+    it 'returns viewport meta tag' do
+      disable_mobile_zoom.should =~ /^<meta name="viewport" /
+    end
+
+  end
+
+  describe 'flying_quotes' do
+
+    it 'set quotes to text' do
+      flying_quotes('a').should == '<span class="space-before-quote"> </span>' +
+                                   '<span class="quotes">«a»</span>'
+    end
+
+    it 'escapes HTML' do
+      flying_quotes('<br>').should ==
+        '<span class="space-before-quote"> </span>' +
+        '<span class="quotes">«&lt;br&gt;»</span>'
+    end
+
+  end
+
+  describe 'ruble' do
+
+    it 'returns span' do
+      ruble.should be_a(String)
+    end
+
+  end
+
+  describe 'russian_typograph' do
+
+    it 'typograps text inside tags' do
+      tag = '<a title="а - б">а - б</a>'.html_safe
+      russian_typograph(tag).should == '<a title="а - б">а — б</a>'
+    end
+
+    it 'escapes HTML' do
+      russian_typograph('<a>').should == '&lt;a&gt;'
+    end
+
+  end
+
+  describe 'title' do
+    after do
+      I18n.locale = :en
+      @evil_front_titles = nil
+    end
+
+    it 'shows site name' do
+      title_tag('Site').should == '<title>Site</title>'
+    end
+
+    it 'shows site names' do
+      title_tag('One', 'Two').should == '<title>One - Two</title>'
+    end
+
+    it 'shows page name' do
+      title 'Page', 'Section'
+      title_tag('Site').should == '<title>Page - Section - Site</title>'
+    end
+
+    it 'shows Russian separator' do
+      I18n.locale = :ru
+      title 'Страница', 'Раздел'
+      title_tag('Сайт').should == '<title>Страница — Раздел — Сайт</title>'
+    end
+
+    it 'shows custom separator' do
+      title 'One', 'Two'
+      title_tag(separator: ' | ').should == '<title>One | Two</title>'
+    end
+
+    it 'escapes HTML' do
+      title '<B>'
+      title_tag.should == '<title>&lt;B&gt;</title>'
+    end
+
+  end
+
+end

data/spec/russian_spec.rb

@@ -0,0 +1,100 @@
+# encoding: utf-8
+
+require_relative 'spec_helper'
+
+describe EvilFront::Russian do
+
+  describe 'capitalize_first' do
+
+    it 'capitalizes first letter in russian text' do
+      EvilFront::Russian.capitalize_first('тест тест').should == 'Тест тест'
+    end
+
+  end
+
+  describe 'flying_quotes' do
+
+    it 'inserts tags and quotes with space by default' do
+      EvilFront::Russian.flying_quotes('тест').should ==
+        '<span class="space-before-quote"> </span>' +
+        '<span class="quotes">«тест»</span>'
+    end
+
+    it 'inserts specified space' do
+      EvilFront::Russian.flying_quotes('тест', space: '-').should ==
+        '<span class="space-before-quote">-</span>' +
+        '<span class="quotes">«тест»</span>'
+    end
+
+    it 'ignores space on request' do
+      EvilFront::Russian.flying_quotes('тест', space: '').should ==
+        '<span class="quotes">«тест»</span>'
+    end
+
+  end
+
+  describe 'auto_flying_quotes' do
+
+    it 'replaces quotes on start' do
+      EvilFront::Russian.auto_flying_quotes('«тест»').should ==
+        '<span class="quotes">«тест»</span>'
+    end
+
+    it 'replaces quotes in middle' do
+      EvilFront::Russian.auto_flying_quotes('на «тесте».').should ==
+        'на<span class="space-before-quote"> </span>' +
+        '<span class="quotes">«тесте»</span>.'
+    end
+
+  end
+
+  describe 'typograph' do
+
+    it 'changes quotes' do
+      EvilFront::Russian.typograph('сказал "смотри "зорко"".').should ==
+        'сказал «смотри „зорко“».'
+    end
+
+    it 'changes dashes' do
+      EvilFront::Russian.typograph('а - это б').should == 'а — это б'
+    end
+
+    it 'changes ellipsis' do
+      EvilFront::Russian.typograph('а...').should == 'а…'
+    end
+
+    it 'inserts non-break spaces' do
+      EvilFront::Russian.typograph('оно не надо').should == 'оно не надо'
+    end
+
+  end
+
+  describe 'typograph_html' do
+
+    it 'typographs plain text' do
+      EvilFront::Russian.typograph_html('а - б').should == 'а — б'
+    end
+
+    it 'typographs only in text nodes' do
+      EvilFront::Russian.typograph_html('<a title="а - б">а - б</a>').should ==
+        '<a title="а - б">а — б</a>'
+    end
+
+    it 'ignores code tags' do
+      EvilFront::Russian.typograph_html('<code>а - б</code>').should ==
+        '<code>а - б</code>'
+    end
+
+    it 'keeps escaping' do
+      EvilFront::Russian.typograph_html('<b>&lt;a&gt;</b>').should ==
+        '<b>&lt;a&gt;</b>'
+    end
+
+    it 'inserts flying quotes' do
+      EvilFront::Russian.typograph_html('<a>"ссылка"</a>').should ==
+        '<a><span class="quotes">«ссылка»</span></a>'
+    end
+
+  end
+
+end

data/spec/sass/inline-ruble.sass

@@ -0,0 +1,3 @@
+@import "evil-front"
+
++import-ruble("PT Sans, sans-serif", $italic: "inline")

data/spec/sass/load.sass

@@ -0,0 +1,7 @@
+@import "evil-front"
+
+a
+  content: inline("empty.txt")
+  background: black(0.5)
+  transition: all 1s $easeInSine
+  +clearfix

data/spec/sass/media.sass

@@ -0,0 +1,9 @@
+@import "evil-front"
+
+.one
+  +max-width(100)
+    color: black
+
+.two
+  +min-width(200px)
+    color: white

data/spec/sass/ruble.sass

@@ -0,0 +1,3 @@
+@import "evil-front"
+
++import-ruble("PT Sans, sans-serif")

data/spec/sass/size.sass

@@ -0,0 +1,10 @@
+@import "evil-front"
+
+.all
+  +size(10px, 20px)
+
+.one
+  +size(30px)
+
+.no-unit
+  +size(15)