alb-test 10.1.15

data/master_middleman/config.rb

@@ -0,0 +1,45 @@
+require 'bookbinder_helpers'
+require 'proof'
+require 'middleman-syntax'
+require 'middleman-livereload'
+require 'middleman-sprockets'
+require 'subdirectory_aware_assets'
+require 'middleman-compass'
+require 'font-awesome-sass'
+
+config = YAML.load_file('bookbinder_config.yml')
+config.each do |k, v|
+  set k, v
+end
+
+set :markdown_engine, :redcarpet
+set :markdown, :layout_engine => :erb,
+               :tables => true,
+               :autolink => true,
+               :smartypants => true,
+               :fenced_code_blocks => true,
+               :with_toc_data => true,
+               :no_intra_emphasis => true
+
+set :css_dir, 'stylesheets'
+
+set :js_dir, 'javascripts'
+
+set :images_dir, 'images'
+
+set :relative_links, false
+
+page '/owners.json', :layout => false
+
+activate :bookbinder
+
+activate :proof
+
+activate :syntax
+
+activate :livereload
+
+activate :sprockets
+import_path FontAwesome::Sass.fonts_path
+
+activate :subdirectory_aware_assets

data/master_middleman/proof.rb

@@ -0,0 +1,90 @@
+require 'nokogiri'
+
+module Bookbinder 
+  class Proof < ::Middleman::Extension
+    def initialize(*args)
+      super
+      @blacklist = [
+        %r{\Alayouts/},
+        %r{\Asubnavs/}
+      ]
+    end
+
+    def before_build(builder)
+      return unless proofing?
+      builder.instance_variable_set(:@parallel, false)
+      @partials = Hash.new { |h, k| h[k] = [] }
+      @pages = Hash.new { |h, k| h[k] = [] }
+    end
+
+    def after_build(builder)
+      return unless proofing?
+      @partials.values.each(&:uniq!)
+      @pages.values.each(&:uniq!)
+
+      @pages.each do |page_path, partials|
+        full_path = File.join(app.config.build_dir, page_path)
+        page = File.open(full_path) {|file| Nokogiri::HTML file}
+
+        page.css('.partial-notice').each do |node|
+          if node.text =~ /\ABEGIN PARTIAL (.+)\. Partial appears in these topics:\z/
+            partial_name = $1
+            all_files_using_partial = @partials[partial_name]
+
+            list = page.create_element('ul')
+            all_files_using_partial.each do |file_name|
+              li = list.add_child(page.create_element('li'))
+              link = li.add_child(page.create_element('a', file_name, href: "/#{file_name}"))
+            end
+
+            node.add_child(list)
+          end
+        end
+
+        File.open(full_path, 'w') { |file| file.puts page.to_html }
+      end
+    end
+
+    expose_to_template :proofing?
+    expose_to_template :track_partial
+
+    helpers do
+      def partial(template, *args)
+        contents = [super]
+
+        if proofing?
+          dir, name = File.split(template)
+          partial_template = File.join(dir, "_#{name}")
+          template_obj = locate_partial(partial_template, false) || locate_partial(partial_template, true)
+          template_path = template_obj.relative_path.to_s
+
+          if track_partial(template_path, current_resource.path)
+            contents.unshift %Q{<div class="partial-notice">BEGIN PARTIAL #{template_path}. Partial appears in these topics:</div>}
+            contents.push %Q{<div class="partial-notice">END PARTIAL #{template_path}</div>}
+          end
+        end
+
+        contents.join('')
+      end
+    end
+
+    def track_partial(template, page)
+      result = !blacklisted?(template)
+      if result
+        @partials[template] << page
+        @pages[page] << template
+      end
+      result
+    end
+
+    def proofing?
+      !!app.config[:proof]
+    end
+
+    def blacklisted?(template)
+      @blacklist.any? { |matcher| matcher.match template }
+    end
+  end
+end
+
+::Middleman::Extensions.register(:proof, Bookbinder::Proof)

data/master_middleman/quicklinks_renderer.rb

@@ -0,0 +1,80 @@
+require 'nokogiri'
+require 'redcarpet'
+
+class QuicklinksRenderer < Redcarpet::Render::Base
+  class BadHeadingLevelError < StandardError; end
+
+  attr_reader :vars
+
+  def initialize(template_variables)
+    super()
+    @vars = template_variables
+  end
+
+  def doc_header
+    @items = []
+    @items[1] = document.css('ul').first
+    nil
+  end
+
+  def doc_footer
+    document.css('.quick-links').to_html if any_headers?
+  end
+
+  def header(text, header_level)
+    return unless [2, 3].include?(header_level)
+    return unless anchor_for(text)
+
+    li = Nokogiri::XML::Node.new('li', document)
+    li.add_child anchor_for(text)
+    last_list_of_level(header_level-1).add_child(li)
+    @items[header_level] = li
+    nil
+  rescue BadHeadingLevelError => e
+    raise BadHeadingLevelError.new "The header \"#{text}\", which is at level #{e.message}, has no higher-level headers occurring before it."
+  end
+
+  private
+
+  def any_headers?
+    @items[2]
+  end
+
+  def anchor_for(text)
+    text = ERB.new(text).result(binding)
+    doc = Nokogiri::HTML(text)
+    target_anchor = doc.css('a').first
+    return unless target_anchor && target_anchor['id']
+    return if (target_anchor['class'] || '').match(/\bno-quick-link\b/)
+
+    anchor = Nokogiri::XML::Node.new('a', document)
+    anchor['href'] = "##{target_anchor['id']}"
+    anchor.content = doc.text.strip
+    anchor
+  end
+
+  def last_list_of_level(n)
+    item = @items[n]
+    raise BadHeadingLevelError.new("#{n+1}") unless item
+    return item if item.name == 'ul'
+
+    item.add_child('<ul>') unless item.css('ul').any?
+    @items[n] = item.css('ul').first
+  end
+
+  def document
+    builder.doc
+  end
+
+  def builder
+    @builder ||= Nokogiri::HTML::Builder.new(&base_quicklinks_doc)
+  end
+
+  def base_quicklinks_doc
+    Proc.new do |html|
+      html.div(class: 'quick-links') {
+        html.ul
+      }
+    end
+  end
+end

data/master_middleman/source/javascripts/all.js

@@ -0,0 +1,2 @@
+//= require bookbinder
+//= require book

data/master_middleman/source/javascripts/book.js

@@ -0,0 +1 @@
+// Declare your book-specific javascript overrides in this file.

data/master_middleman/source/javascripts/bookbinder.js

@@ -0,0 +1,130 @@
+(function() {
+  var MONTHS = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+
+  function toggleClass(el, className) {
+    var check = new RegExp("\\b" + className + "\\b");
+    if (check.test(el.className)) {
+      el.className = el.className.replace(check, '');
+    } else {
+      el.className += ' ' + className;
+    }
+  }
+
+  function openSubmenu(e) {
+    if (e.target.tagName !== 'A') {
+      var el = e.currentTarget;
+      toggleClass(el, 'expanded');
+      e.stopPropagation();
+    }
+  }
+
+  function registerOnClick(el, handler) {
+    if (el.addEventListener) {
+      el.addEventListener('click', handler);
+    } else {
+      el.onclick = handler;
+    }
+  }
+
+  function toggleMainMenu(e) {
+    var el = e.currentTarget;
+    toggleClass(el.parentNode, 'menu-active');
+  }
+
+  function toggleSubMenu(e) {
+    var el = e.currentTarget;
+    toggleClass(el.parentNode, 'active');
+  }
+
+  function displayDate(millis) {
+    millis = parseInt(millis, 10);
+    var date = new Date(millis);
+
+    return [MONTHS[date.getMonth()], ' ', date.getDate(), ', ', date.getFullYear()].join('');
+  }
+
+  function maybeOpenNewWindow(e) {
+    var el = e.currentTarget;
+    var href = el.href;
+
+    if (Bookbinder.needsNewWindow(e, href, window.location.host)) {
+      e.preventDefault();
+      e.stopPropagation();
+      window.open(href);
+    }
+  }
+
+  window.Bookbinder = {
+    startSidenav: function(rootEl, currentPath) {
+      if (!rootEl) { return; }
+
+      var submenus = rootEl.querySelectorAll('.has_submenu');
+
+      for (var i = 0; i < submenus.length; i++) {
+        registerOnClick(submenus[i], openSubmenu);
+      }
+
+      if (currentPath) {
+        var currentLink = rootEl.querySelector('a[href="' + currentPath + '"]');
+        if (currentLink) {
+          currentLink.className += ' active';
+
+          var hasSubmenu = /\bhas_submenu\b/;
+          var subnavLocation = currentLink.parentNode;
+
+          while(subnavLocation.parentNode !== rootEl) {
+            subnavLocation = subnavLocation.parentNode;
+            if (hasSubmenu.test(subnavLocation.className)) {
+              subnavLocation.className += ' expanded';
+            }
+          }
+
+          rootEl.scrollTop = currentLink.offsetTop - rootEl.offsetTop;
+        }
+      }
+    },
+    mobileMainMenu: function(root) {
+      var mainMenus = root.querySelectorAll('[data-behavior=MenuMobile]');
+
+      for (var i = 0; i < mainMenus.length; i++) {
+        registerOnClick(mainMenus[i], toggleMainMenu);
+      }
+    },
+    mobileSubMenu: function(root) {
+      var subMenus = root.querySelectorAll('[data-behavior=SubMenuMobile]');
+
+      for (var i = 0; i < subMenus.length; i++) {
+        registerOnClick(subMenus[i], toggleSubMenu);
+      }
+    },
+    modifiedDates: function(root) {
+      var datesElements = root.querySelectorAll('[data-behavior=DisplayModifiedDate]');
+
+      for (var i = 0; i < datesElements.length; i++) {
+        datesElements[i].innerText = displayDate(datesElements[i].getAttribute('data-modified-date'));
+      }
+    },
+    externalLinks: function(root) {
+      var links = root.querySelectorAll('a[href]');
+
+      for (var i = 0; i < links.length; i++) {
+        registerOnClick(links[i], maybeOpenNewWindow);
+      }
+    },
+    needsNewWindow: function(e, destinationUrl, currentDomain) {
+      if (e.button !== 0 || e.ctrlKey || e.altKey || e.shiftKey || e.metaKey) {
+        return false;
+      }
+
+      var destinationDomain = destinationUrl.replace(/^https?:\/\//, '').split('/')[0];
+      return destinationDomain !== currentDomain;
+    },
+    boot: function() {
+      Bookbinder.startSidenav(document.querySelector('#sub-nav'), document.location.pathname);
+      Bookbinder.mobileMainMenu(document);
+      Bookbinder.mobileSubMenu(document);
+      Bookbinder.modifiedDates(document);
+      Bookbinder.externalLinks(document);
+    }
+  };
+})();

data/master_middleman/source/layouts/_book-title.erb

@@ -0,0 +1,3 @@
+<!--Default title-->
+<!--If book needs something different, add a book-title partial to the book's layouts folder-->
+<%= vars.title %>

data/master_middleman/source/layouts/_header.erb

@@ -0,0 +1,34 @@
+<% if current_page.data.title %> <%# this is a proxy for if !homepage %>
+  <header class="header header-layout">
+    <h1 class="logo">
+      <a href="/"><%= vars.book_title || 'Default Book Title' %></a>
+    </h1>
+    <%= yield_for_archive_drop_down_menu %>
+    <div class="header-links js-bar-links">
+      <div class="btn-menu" data-behavior="MenuMobile"></div>
+      <%= vars.product_link %>
+      <div class="header-item">
+        <%= vars.support_link %>
+      </div>
+      <%= partial 'layouts/book-search' %>
+    </div>
+  </header>
+<% else %>
+  <header class="header-home">
+    <div class="home-links js-bar-links">
+      <div class="btn-menu" data-behavior="MenuMobile"></div>
+      <%= vars.product_link %>
+      <div class="header-item">
+        <%= vars.support_call_to_action %>
+      </div>
+      <%= partial 'layouts/book-search' %>
+    </div>
+    <h1 class="title-flashy">
+      <%= partial 'layouts/book-title' %>
+    </h1>
+
+    <h2 class="title-intro">
+      <%= vars.hero_text %>
+    </h2>
+  </header>
+<% end %>

data/master_middleman/source/layouts/_page-footer.erb

@@ -0,0 +1 @@
+<%= render_repo_link %>

data/master_middleman/source/layouts/_title.erb

@@ -0,0 +1,5 @@
+<% if current_page.data.title %>
+  <h1 class="title-container">
+    <%= current_page.data.title %>
+  </h1>
+<% end %>

data/master_middleman/source/layouts/layout.erb

@@ -0,0 +1,70 @@
+<!doctype html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <!-- Always force latest IE rendering engine or request Chrome Frame -->
+  <meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible">
+
+  <%= vars.html_head_meta %>
+  <link href='https://fonts.googleapis.com/css?family=Source+Sans+Pro:300,300italic,400italic,400,600' rel='stylesheet' type='text/css'>
+  <!-- Use title if it's in the page YAML frontmatter -->
+  <title>
+    <% if current_page.data.title %>
+      <%= current_page.data.title %> |
+    <% end %>
+    <%= vars.book_title_short %>
+  </title>
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <%= stylesheet_link_tag 'all', :media => 'screen, print' %>
+  <%= stylesheet_link_tag 'print', :media => 'print' %>
+  <link href='/images/favicon.ico' rel='shortcut icon'>
+
+  <%= javascript_include_tag "all" %>
+  <%= partial 'layouts/additional-scripts' %>
+</head>
+
+<body class="<%= body_classes %><%= yield_for_subnav.empty? ? '' : ' has-subnav' %>">
+
+<div class="viewport">
+  <div class='wrap'>
+    <script type="text/javascript">
+      document.domain = "<%= vars.domain_name %>";
+    </script>
+
+    <%= partial 'layouts/header' %>
+
+    <div class="container">
+
+      <!--googleoff: index-->
+      <%= yield_for_subnav %>
+      <!--googleon: index-->
+
+      <main class="content content-layout" id="js-content" role="main">
+        <a id="top"></a>
+        <%= partial 'layouts/local-header' %>
+        <%= partial 'layouts/title' %>
+        <% if quick_links %>
+          <div id="js-quick-links" <%= 'class="list-style-none"' if current_page.data.list_style_none %>>
+            <%= quick_links %>
+          </div>
+        <% end %>
+        <div class="to-top" id="js-to-top">
+          <a href="#top" title="back to top"></a>
+        </div>
+        <%= yield %>
+        <%= partial 'layouts/page-footer' %>
+      </main>
+    </div>
+  </div>
+</div>
+
+<div id="scrim"></div>
+
+<div class="container">
+  <footer class="site-footer-links">
+    <%= partial 'layouts/book-footer' %>
+  </footer>
+</div><!--end of container-->
+
+</body>
+</html>