textile_manual 0.0.2

data/features/path_mounting.feature

@@ -0,0 +1,28 @@
+Feature: Path mounting
+  Scenario: Extension mounted at /manual
+    Given the textile Server is running at "manual_at_path"
+    When I go to "/manual"
+    Then I should see "is a simple text markup language"
+    When I click on the getting started link
+    Then I should be on /manual/writing-paragraph-text
+    When I click "Phrase modifiers" in the TOC
+    Then I should be on /manual/phrase-modifiers
+    When I click "Writing Paragraph Text" in the TOC
+    Then I should be on /manual/writing-paragraph-text
+    When I click "Introduction" in the TOC
+    Then I should be on /manual
+    And I should see "is a simple text markup language"
+
+  Scenario: Extension mounted at root
+    Given the textile Server is running at "manual_at_root"
+    When I go to "/"
+    Then I should see "is a simple text markup language"
+    When I click on the getting started link
+    Then I should be on /writing-paragraph-text
+    When I click "Phrase modifiers" in the TOC
+    Then I should be on /phrase-modifiers
+    When I click "Writing Paragraph Text" in the TOC
+    Then I should be on /writing-paragraph-text
+    When I click "Introduction" in the TOC
+    Then I should be on /
+    And I should see "is a simple text markup language"

data/features/support/click_steps.rb

@@ -0,0 +1,20 @@
+When(/^I click on the getting started link$/) do
+  within(:css, ".content") do
+    click_link("Writing Paragraph Text")
+  end
+end
+
+When(/^I click "([^"]*)" in the TOC$/) do |text|
+  within(:css, ".table-of-contents") do
+    click_link text
+  end
+end
+
+Then /^(?:|I )should be on (.+)$/ do |page_path|
+  current_path = URI.parse(current_url).path
+  if current_path.respond_to? :should
+    current_path.should == page_path
+  else
+    assert_equal page_path, current_path
+  end
+end

data/features/support/env.rb

@@ -0,0 +1,4 @@
+PROJECT_ROOT_PATH = File.dirname(File.dirname(File.dirname(__FILE__)))
+require 'middleman-core'
+require 'middleman-core/step_definitions'
+require File.join(PROJECT_ROOT_PATH, 'lib', 'textile_manual')

data/features/support/server_steps.rb

@@ -0,0 +1,34 @@
+Given /^the textile Server is running$/ do
+  root_dir = File.expand_path(expand_path("."))
+
+  ENV['MM_SOURCE'] = '../../../source'
+  ENV['MM_DATA_DIR'] = '../../../data'
+
+  ENV['MM_ROOT'] = root_dir
+
+  initialize_commands = @initialize_commands || []
+  activation_commands = @activation_commands || []
+
+  @server_inst = ::Middleman::Application.new do
+    config[:watcher_disable] = true
+    config[:show_exceptions] = false
+
+    initialize_commands.each do |p|
+      instance_exec(&p)
+    end
+
+    app.after_configuration_eval do
+      activation_commands.each do |p|
+        config_context.instance_exec(&p)
+      end
+    end
+  end
+
+  Capybara.app = ::Middleman::Rack.new(@server_inst).to_app
+end
+
+Given /^the textile Server is running at "([^\"]*)"$/ do |app_path|
+  step %Q{a fixture app "#{app_path}"}
+  step %Q{the textile Server is running}
+end
+

data/fixtures/manual_at_path/config.rb

@@ -0,0 +1,10 @@
+config[:source] = '../../../source'
+config[:data_dir] = '../../../data'
+
+helpers do
+  def code(text)
+    text
+  end
+end
+
+activate :textile_manual, path: "/manual"

data/fixtures/manual_at_root/config.rb

@@ -0,0 +1,10 @@
+config[:source] = '../../../source'
+config[:data_dir] = '../../../data'
+
+helpers do
+  def code(text)
+    text
+  end
+end
+
+activate :textile_manual

data/lib/textile_manual.rb

@@ -0,0 +1,6 @@
+require "middleman-core"
+
+Middleman::Extensions.register :textile_manual do
+  require "textile_manual/extension"
+  TextileManual
+end

data/lib/textile_manual/extension.rb

@@ -0,0 +1,89 @@
+# Require core library
+require 'middleman-core'
+
+# Extension namespace
+class TextileManual < ::Middleman::Extension
+  option :path, '/', 'Path where you want to mount the textile reference manual'
+
+  def initialize(app, options_hash={}, &block)
+    # Call super to build options from the options_hash
+    super
+    add_extension_dirs
+
+    @sitemap = app.sitemap
+
+    @base_path = options.path
+  end
+
+  def textile_data
+    app.data.textile
+  end
+
+  # A Sitemap Manipulator
+  def manipulate_resource_list(resources)
+    new_resources = textile_data.map do |slug, contents|
+      build_proxy_resource(link(slug), contents)
+    end
+
+    new_resources << root_resource
+
+    new_resources.reduce(resources) do |sum, r|
+      r.execute_descriptor(app, sum)
+    end
+  end
+
+  def add_extension_dirs
+    app.files.watch :source, path: File.join(File.dirname(__FILE__), '../../source'), priority: 1
+    app.files.watch :data, path: File.join(File.dirname(__FILE__), '../../data'), priority: 1
+  end
+
+  helpers do
+    def textile_manual_link(path)
+      base = app.extensions[:textile_manual].options.path
+      File.join([base, path].compact)
+    end
+  end
+
+  private
+
+  def link(slug=nil)
+    File.join([@base_path, slug, 'index.html'].compact)
+  end
+
+  def root_resource
+    build_proxy_resource(link, {}, 'textile_manual/index.html')
+  end
+
+  def build_proxy_resource(path, locals, template='textile_manual/chapter')
+    ProxyDescriptor.new(
+      ::Middleman::Util.normalize_path(path),
+      template,
+      { locals: locals,
+        ignore: true }
+    )
+  end
+
+   ProxyDescriptor = Struct.new(:path, :target, :metadata) do
+     def execute_descriptor(app, resources)
+       md = metadata.dup
+       should_ignore = md.delete(:ignore)
+
+       page_data = md.delete(:data) || {}
+       page_data[:id] = md.delete(:id) if md.key?(:id)
+
+       r = ::Middleman::Sitemap::ProxyResource.new(app.sitemap, path, target)
+       r.add_metadata(
+         locals: md.delete(:locals) || {},
+         page: page_data || {},
+         options: md
+       )
+
+       if should_ignore
+         d = ::Middleman::Sitemap::Extensions::Ignores::StringIgnoreDescriptor.new(target)
+         d.execute_descriptor(app, resources)
+       end
+
+       resources + [r]
+     end
+   end
+end

data/source/javascripts/all.js

@@ -0,0 +1,5 @@
+//= require jquery/dist/jquery
+//= require what-input/what-input.min
+//= require foundation-sites/dist/foundation.min
+
+//= require app

data/source/javascripts/modernizr.js

@@ -0,0 +1 @@
+//= require modernizr/modernizr

data/source/layouts/layout.html.slim

@@ -0,0 +1,23 @@
+doctype html
+html
+  head
+    meta content="IE=edge,chrome=1" http-equiv="X-UA-Compatible"
+    meta charset="utf-8"
+    meta content="width=device-width,initial-scale=1.0,minimum-scale=1.0,maximum-scale=1.0,user-scalable=no" name="viewport"
+
+    title = strip_tags(current_page.data.title || title)
+
+    == stylesheet_link_tag :style
+    == javascript_include_tag  "modernizr"
+
+  body class="#{page_classes}"
+    article.textile-manual
+      .row
+        .small-12.medium-9.columns
+          header.page-header
+            h1= current_page.data.title || title
+          .content
+            == yield
+        .hide-for-small-only.medium-3.columns
+          = partial 'partials/textile_toc', locals: {contents: data.textile}
+    = javascript_include_tag  "all"

data/source/partials/_textile_toc.html.slim

@@ -0,0 +1,12 @@
+.table-of-contents
+  - if current_page.data.title.blank?
+    .strong-text Textile Reference Manual
+  ul.no-bullet
+    li= link_to 'Introduction', textile_manual_link(nil)
+    - contents.each do |slug, chapter|
+      li
+        = link_to chapter.title, textile_manual_link(slug)
+        ul
+          - chapter.sections.each do |anchor, section|
+            li= link_to section.keys.first, textile_manual_link("#{slug}##{anchor}")
+

data/source/stylesheets/_highlighting.scss

@@ -0,0 +1,209 @@
+.highlight table td { padding: 5px; }
+.highlight table pre { margin: 0; }
+.highlight .cm {
+  color: #999988;
+  font-style: italic;
+}
+.highlight .cp {
+  color: #999999;
+  font-weight: bold;
+}
+.highlight .c1 {
+  color: #999988;
+  font-style: italic;
+}
+.highlight .cs {
+  color: #999999;
+  font-weight: bold;
+  font-style: italic;
+}
+.highlight .c, .highlight .cd {
+  color: #999988;
+  font-style: italic;
+}
+.highlight .err {
+  color: #a61717;
+  background-color: #e3d2d2;
+}
+.highlight .gd {
+  color: #000000;
+  background-color: #ffdddd;
+}
+.highlight .ge {
+  color: #000000;
+  font-style: italic;
+}
+.highlight .gr {
+  color: #aa0000;
+}
+.highlight .gh {
+  color: #999999;
+}
+.highlight .gi {
+  color: #000000;
+  background-color: #ddffdd;
+}
+.highlight .go {
+  color: #888888;
+}
+.highlight .gp {
+  color: #555555;
+}
+.highlight .gs {
+  font-weight: bold;
+}
+.highlight .gu {
+  color: #aaaaaa;
+}
+.highlight .gt {
+  color: #aa0000;
+}
+.highlight .kc {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .kd {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .kn {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .kp {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .kr {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .kt {
+  color: #445588;
+  font-weight: bold;
+}
+.highlight .k, .highlight .kv {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .mf {
+  color: #009999;
+}
+.highlight .mh {
+  color: #009999;
+}
+.highlight .il {
+  color: #009999;
+}
+.highlight .mi {
+  color: #009999;
+}
+.highlight .mo {
+  color: #009999;
+}
+.highlight .m, .highlight .mb, .highlight .mx {
+  color: #009999;
+}
+.highlight .sb {
+  color: #d14;
+}
+.highlight .sc {
+  color: #d14;
+}
+.highlight .sd {
+  color: #d14;
+}
+.highlight .s2 {
+  color: #d14;
+}
+.highlight .se {
+  color: #d14;
+}
+.highlight .sh {
+  color: #d14;
+}
+.highlight .si {
+  color: #d14;
+}
+.highlight .sx {
+  color: #d14;
+}
+.highlight .sr {
+  color: #009926;
+}
+.highlight .s1 {
+  color: #d14;
+}
+.highlight .ss {
+  color: #990073;
+}
+.highlight .s {
+  color: #d14;
+}
+.highlight .na {
+  color: #008080;
+}
+.highlight .bp {
+  color: #999999;
+}
+.highlight .nb {
+  color: #0086B3;
+}
+.highlight .nc {
+  color: #445588;
+  font-weight: bold;
+}
+.highlight .no {
+  color: #008080;
+}
+.highlight .nd {
+  color: #3c5d5d;
+  font-weight: bold;
+}
+.highlight .ni {
+  color: #800080;
+}
+.highlight .ne {
+  color: #990000;
+  font-weight: bold;
+}
+.highlight .nf {
+  color: #990000;
+  font-weight: bold;
+}
+.highlight .nl {
+  color: #990000;
+  font-weight: bold;
+}
+.highlight .nn {
+  color: #555555;
+}
+.highlight .nt {
+  color: #000080;
+}
+.highlight .vc {
+  color: #008080;
+}
+.highlight .vg {
+  color: #008080;
+}
+.highlight .vi {
+  color: #008080;
+}
+.highlight .nv {
+  color: #008080;
+}
+.highlight .ow {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .o {
+  color: #000000;
+  font-weight: bold;
+}
+.highlight .w {
+  color: #bbbbbb;
+}
+.highlight {
+  background-color: #f8f8f8;
+}