proscribe 0.0.1 → 0.0.3

data/HISTORY.md

@@ -1,3 +1,16 @@
+v0.0.2 - Jul 29, 2011
+---------------------
+
+### Added:
+  * Github link
+  * Literate programming style stuff
+
+### Removed:
+  * ghpages support
+
+### Misc:
+  * Cleaned up extension
+
 v0.0.1 - Jul 24, 2011
 ---------------------
 

data/data/default/Protonfile

@@ -7,8 +7,3 @@ tilt_options:
   haml:
     ugly: true
 
-# Custom stuff
-extractor:
-  files:
-    - source: ../lib/**/*.rb
-      target: api/

data/data/default/_extensions/{manual/lib/helpers.rb → helpers.rb}

@@ -1,4 +1,4 @@
-module Hyde::Helpers
+module Proton::Helpers
   def page_children(page)
     children = page.children
     of_type  = lambda { |str| children.select { |p| p.html? && p.meta.page_type == str } }
@@ -10,6 +10,15 @@ module Hyde::Helpers
         type.nil? ? nil : Inflector[type].pluralize.to_sym
       }
   end
+
+  # A link to the source file on GitHub
+  def github_source_link
+    if project.config.github && project.config.git
+      if page.meta.source_file
+        "https://github.com/#{project.config.github}/blob/#{project.config.git[0..6]}/#{page.source_file}#L#{page.source_line}".squeeze('/')
+      end
+    end
+  end
 end
 
 # Inflector['hello'].pluralize

data/data/default/_layouts/default.haml

@@ -18,6 +18,9 @@
 
     %link{:rel => 'stylesheet', :href => rel('/style.css')+"?#{File.mtime(Proton::Page['/style.css'].file).to_i}"}
 
+    %script{src: 'http://cachedcommons.org/cache/prettify/1.0.0/javascripts/prettify-min.js', type: 'text/javascript'}
+    %script{src: 'http://cdnjs.cloudflare.com/ajax/libs/jquery/1.6.2/jquery.min.js', type: 'text/javascript'}
+    %script{src: rel('/proscribe.js')+"?#{File.mtime(Proton::Page['/proscribe.js'].file).to_i}", type: 'text/javascript'}
   %body
     #top
       %a#logo{href: rel('/')}
@@ -54,6 +57,28 @@
                     - unless method.meta.brief.to_s.empty?
                       %span.brief= method.meta.brief
 
+            -# Source
+            %section.footer
+              .left
+                %strong
+                  - page.breadcrumbs[1...-1].each do |pp|
+                    %a{href: rel(page.path)}
+                      = pp.title
+                      -# if pp.meta.page_type
+                      -#  %span.type= pp.meta.page_type
+
+                    %span.arrow!= "›"
+
+                  = page.title
+                  - if page.meta.page_type
+                    %span.type= page.meta.page_type
+
+                - if github_source_link
+                  Defined in
+                  %a{href: github_source_link}
+                    %span= page.source_file
+                    %span.view-source!= "View source ›"
+
         %nav#nav
           - parent   = (page.children.any? ? page : (page.parent || page))
           - children = parent.children.select { |p| p.html? }
@@ -87,37 +112,3 @@
                       %a{href: rel(pp.path), class: classes.join(' ')}
                         = pp
 
-
-    %script{src: 'http://cachedcommons.org/cache/prettify/1.0.0/javascripts/prettify-min.js', type: 'text/javascript'}
-    %script{src: 'http://cdnjs.cloudflare.com/ajax/libs/jquery/1.6.2/jquery.min.js', type: 'text/javascript'}
-    :javascript
-      $(function () {
-        $("pre").each(function() {
-          var r = /\[(.*?)\s*\((.*?)\)\]\n*/;
-          var m = $(this).text().match(r);
-
-          $(this).addClass('prettyprint');
-
-          if (m) {
-            var file = m[1];
-            var type = m[2];
-            $(this).addClass('lang-'+type);
-
-            if (file.length) {
-              $(this).addClass('has-caption');
-              $(this).prepend($("<h5 class='caption'>").text(file));
-            }
-
-            $(this).html($(this).html().replace(r, ''));
-          }
-
-          if ($(this).text().match(/^\s*([a-zA-Z_~\/]*)\$ /)) {
-            $(this).addClass('terminal');
-            $(this).removeClass('prettyprint');
-            $(this).html($(this).html().replace(/([a-zA-Z_~\/]*\$ )(.*?)[\r\n$]/g, "<strong><em>$1</em>$2</strong>\n"));
-          }
-        });
-
-        prettyPrint();
-      });
-  

data/data/default/proscribe.js

@@ -0,0 +1,52 @@
+$(function () {
+  $("h4").each(function() {
+    var $this = $(this);
+
+    // Find the next p
+    var $p    = $this.find('+ p');
+    if (!$p.length) { $p = $this; }
+
+    var $pre = $p.find('+ pre');
+    if (!$pre.length) { return; }
+
+    // Build it
+    var $el   = $("<section class='literate'>");
+    $this.before($el);
+
+    // Move them
+    $el.append($pre);
+    $el.append($this);
+    $el.append($p);
+  });
+
+  $("pre").each(function() {
+    var $this = $(this);
+    $this.addClass('prettyprint');
+
+    // Filename
+    var r = /\[(.*?)\s*\((.*?)\)\]\n*/;
+    var m = $this.text().match(r);
+    if (m) {
+      var file = m[1];
+      var type = m[2];
+      $this.addClass('lang-'+type);
+
+      if (file.length) {
+        $this.addClass('has-caption');
+        $this.prepend($("<h5 class='caption'>").text(file));
+      }
+
+      $this.html($this.html().replace(r, ''));
+    }
+
+    // Terminal
+    if ($this.text().match(/^\s*([a-zA-Z_~\/]*)\$ /)) {
+      $this.addClass('terminal');
+      $this.removeClass('prettyprint');
+      $this.html($this.html().replace(/([a-zA-Z_~\/]*\$ )(.*?)[\r\n$]/g, "<strong><em>$1</em>$2</strong>\n"));
+    }
+  });
+
+  prettyPrint();
+});
+

data/data/default/style.scss

@@ -135,6 +135,7 @@ $pad: 40px;
 #content {
   @include border-top-radius(2px);
   background: white; padding: 40px;
+  padding-bottom: 140px;
   position: relative;
   @include box-sizing(border-box);
   @include clearfix;
@@ -195,7 +196,7 @@ $pad: 40px;
     }
 
   >h2, >h3 {
-    & + pre {
+    & + pre, & + section {
       margin-top: 20px !important; }
 
     font-size: 2em;
@@ -360,11 +361,14 @@ pre.has-caption {
 }
 
 pre.terminal {
-  background: #222;
+  background: #444;
+  @include box-shadow(inset 2px 2px 8px rgba(black, 0.4));
 
-  code {
+  &, code {
     color: #ccc;
-    text-shadow: 1px 1px 0 rgba(black, 0.3);
+    text-shadow: 1px 1px 0 rgba(black, 0.3); }
+
+  code {
     background: transparent; }
 
   strong {
@@ -376,6 +380,118 @@ pre.terminal {
     color: #8d8 * 0.5; }
 }
 
+section.literate {
+    overflow: hidden;
+    padding: 20px 40px;
+    border-top: solid 1px #eee;
+    margin: 0 -40px;
+
+    font-size: 9pt;
+
+    pre + * { margin-top: 0; }
+    &:first-of-type { margin-top: 30px; }
+    &:last-of-type  { margin-bottom: 30px; }
+    
+    p { width: 33%; }
+    pre { float: right; width: 60%; }
+    pre + pre { margin-top: 20px; }
+    pre::after { clear: both; }
+
+    h4 { font-size: 1.2em; margin-bottom: 10px; color: #456 * 1.7; }
+    h4 + * { margin-top: 0; }
+}
+
+a.github-link, a[title="Source code"] {
+  position: absolute;
+  top: 0;
+  right: 0;
+  display: block;
+  background: url('https://d3nwyuy0nl342s.cloudfront.net/img/e6bef7a091f5f3138b8cd40bc3e114258dd68ddf/687474703a2f2f73332e616d617a6f6e6177732e636f6d2f6769746875622f726962626f6e732f666f726b6d655f72696768745f7265645f6161303030302e706e67') top right no-repeat;
+  text-indent: -9999px;
+  width: 149px; height: 149px;
+  z-index: 1;
+}
+
+section.aux-links {
+  position: absolute;
+  top: 40px;
+  right: 0px;
+
+  ul, li { list-style-type: none; margin: 0; padding: 0; }
+
+  a {
+    overflow: hidden;
+    display: block;
+    margin-bottom: 5px;
+    font-size: 8pt;
+    padding: 5px 10px;
+    width: 140px; 
+    font-size: 8pt;
+    line-height: 12pt;
+    font-weight: bold;
+    @include border-left-radius(4px);
+    background: #eee; }
+
+  a::after {
+    content: '›'; color: #aaa;
+    font-size: 1.5em;
+    float: right; }
+
+  a:hover {
+    background: #888; color: #ddd;
+    text-shadow: 1px 1px 0 rgba(black, 0.1); }
+}
+
+section.footer {
+  background: #eee;
+  border-top: solid 1px #eee;
+
+  position: absolute;
+  @include box-sizing(border-box);
+  bottom: 0; left: 0; width: 100%;
+  padding: 20px;
+
+
+  font-size: 0.75em;
+
+  color: #aaa;
+  text-shadow: 1px 1px 0 rgba(white, 0.5);
+
+  @include box-shadow(inset 0 3px 3px rgba(black, 0.1));
+  text-align: left;
+
+  a, strong {
+    color: #888; }
+
+  strong {
+    font-size: 1.1em; }
+
+  span.type {
+    opacity: 0.7;
+    font-weight: normal; font-size: 0.9em;
+    &::before { content: '['; }
+    &::after { content: ']'; } }
+
+  span.arrow {
+    margin: 0 5px; }
+
+  .left {
+    strong { display: block; } }
+
+  .line {
+    font-style: normal; }
+
+  .view-source {
+    background: rgba(black, 0.1);
+    color: #888;
+    padding: 1px 8px;
+    font-size: 0.9em;
+    font-weight: normal;
+    margin-left: 5px;
+    @include border-radius(7px);
+    font-style: normal; }
+}
+
 //
 // Prettify
 //

data/data/rack/config.ru

@@ -1,8 +1,4 @@
-begin
-  require 'bundler'
-  Bundler.setup
-rescue LoadError => e
-end
-
+gem 'proscribe', '~> 0.0.1'
 require 'proscribe'
+
 run ProScribe.rack_app

data/lib/proscribe/cli.rb

@@ -41,5 +41,17 @@ class ProScribe::CLI < Shake
     copy_files ProScribe.root('data/rack'), dir
   end
   task.description = "Makes a project Rack-compatible"
+
+  invalid do
+    if task(command)
+      usage = task(command).usage || command
+
+      err "Invalid usage."
+      err "Usage: #{executable} #{usage}"
+      err "See `#{executable} help` for more info."
+    else
+      err "Unknown command: #{command}"
+      err "See `#{executable} help` for a list of commands."
+    end
+  end
 end
-  

data/lib/proscribe/extractor.rb

@@ -17,8 +17,9 @@ module ProScribe
   #   ex.write!('manual/')       # Writes to manual/
   #
   class Extractor
-    def initialize(files, options={})
+    def initialize(files, root, options={})
       @files = files
+      @root  = File.realpath(root)
     end
 
     def write!(output_path = '.', &blk)
@@ -36,17 +37,22 @@ module ProScribe
         @files.map { |file|
           if File.file?(file)
             input = File.read(file)
-            get_blocks input
+            get_blocks(input, unroot(file))
           end
         }.compact.flatten
       end
     end
 
   private
+    def unroot(fn)
+      (File.realpath(fn))[@root.size..-1]
+    end
+
     # Returns blocks that match a blah.
-    def get_blocks(str)
+    def get_blocks(str, filename)
       arr = get_comment_blocks(str)
-      arr.map { |block|
+      arr.map { |hash|
+        block = hash[:block]
         re = /^([A-Za-z ]*?): (.*?)(?: \((.*?)\))?$/
 
         if block.last =~ re
@@ -54,32 +60,37 @@ module ProScribe
             :type => $1,
             :title => $2,
             :parent => $3,
+            :line => hash[:line] + block.size + 1,
+            :source => filename,
             :body => (block[0..-2].join("\n") + "\n")
         elsif block.first =~ re
           Extractor::Block.new \
             :type => $1,
             :title => $2,
             :parent => $3,
+            :line => hash[:line] + block.size + 1,
+            :source => filename,
             :body => (block[1..-1].join("\n") + "\n")
         end
       }.compact
     end
 
     # Returns contiguous comment blocks.
+    # Returns an array of hashes (:block => [line1,line2...], :line => n)
     def get_comment_blocks(str)
       chunks = Array.new
       i = 0
 
-      str.split("\n").each { |s|
+      str.split("\n").each_with_index { |s, line|
         if s =~ /^\s*(?:\/\/\/?|##?) ?(.*)$/
-          chunks[i] ||= Array.new
-          chunks[i] << $1
+          chunks[i] ||= { :block => Array.new, :line => line }
+          chunks[i][:block] << $1
         else
           i += 1  if chunks[i]
         end
       }
 
-      chunks
+      chunks.compact
     end
   end
 
@@ -93,11 +104,14 @@ module ProScribe
       body   = options[:body]
       type   = options[:type].downcase
 
+      source = options[:source]
+      line   = options[:line]
+
       file = to_filename(title, parent)
       brief, *body = body.split("\n\n")
       body = "#{body.join("\n\n")}"
 
-      heading = "title: #{title}\npage_type: #{type}\nbrief: #{brief}\n"
+      heading = "title: #{title}\npage_type: #{type}\nsource_file: #{source}\nsource_line: #{line}\nbrief: #{brief}\n"
       heading += "--\n"
 
       @file = file

data/lib/proscribe/project.rb

@@ -52,19 +52,39 @@ module ProScribe
       # Copy manual files over
       copy_files manual_path, dir, :except => ['Gemfile', 'Gemfile.lock', 'config.ru']
 
+      # Merge Scribefile into Protonfile
+      File.open(File.join(dir, 'Protonfile'), 'w') { |f| f.write protonfile }
+
       # Extract block comments
       config.files.each do |group|
-        ex = ProScribe::Extractor.new Dir[root(group.source)]
-        ex.write! File.join(dir, group.target)
+        ex = ProScribe::Extractor.new(Dir[root(group.source)], root)
+        ex.write! File.join(dir, group.prefix || '')
       end
     end
 
+    def protonfile
+      yaml = YAML::load_file(ProScribe.root('data/default/Protonfile'))
+
+      # Copy from Scribefile
+      c = config.to_hash.dup
+      c.delete 'manual'
+      c.delete 'output'
+      c.delete 'files'
+
+      # Add some things
+      c['git'] = `git rev-parse HEAD`.strip
+
+      yaml.merge! c
+
+      YAML::dump yaml
+    end
+
     # Attribute: dir (ProScribe::Project)
     # Returns the path to the temporary Proton project.
     #
     def dir(*a)
       @dir ||= begin
-        dir = File.join(Dir.tmpdir, File.basename(root))
+        dir = File.join(Dir.tmpdir, File.basename(root) + Time.now.to_i.to_s)
         FileUtils.rm_rf dir
         FileUtils.mkdir_p dir
         dir

data/lib/proscribe/rack_app.rb

@@ -2,7 +2,7 @@ require 'proton'
 require 'proton/server'
 require 'shake'
 
-# Module: RackApp
+# Module: RackApp (ProScribe)
 # Provides a Rack app.
 #
 # ## Usage

data/lib/proscribe/version.rb

@@ -3,9 +3,9 @@ module ProScribe
   # Returns the version of the ProScribe gem.
   #
   # ##  Example
-  #     ProScribe.version     #=> "0.0.1"
+  #     ProScribe.version     #=> "0.0.2"
   #
   def self.version
-    "0.0.1"
+    "0.0.3"
   end
 end

data/lib/proscribe.rb

@@ -8,6 +8,17 @@ require 'tilt'
 # Module: ProScribe
 # The main module.
 #
+# #### Hello s1
+#
+# yes s1
+#
+#     foo s1
+#     foo s1
+#
+# #### Creating something
+#
+#     s2
+#
 module ProScribe
   def self.root(*a)
     File.join(File.expand_path('../../', __FILE__), *a)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: proscribe
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,12 +9,12 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-07-24 00:00:00.000000000 +08:00
+date: 2011-07-29 00:00:00.000000000 +08:00
 default_executable: 
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hashie
-  requirement: &2153048280 !ruby/object:Gem::Requirement
+  requirement: &2158295020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -22,10 +22,10 @@ dependencies:
         version: 1.0.0
   type: :runtime
   prerelease: false
-  version_requirements: *2153048280
+  version_requirements: *2158295020
 - !ruby/object:Gem::Dependency
   name: shake
-  requirement: &2153047780 !ruby/object:Gem::Requirement
+  requirement: &2158294520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -33,10 +33,10 @@ dependencies:
         version: 0.1.2
   type: :runtime
   prerelease: false
-  version_requirements: *2153047780
+  version_requirements: *2158294520
 - !ruby/object:Gem::Dependency
   name: tilt
-  requirement: &2153047320 !ruby/object:Gem::Requirement
+  requirement: &2158294060 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -44,10 +44,10 @@ dependencies:
         version: 1.2.2
   type: :runtime
   prerelease: false
-  version_requirements: *2153047320
+  version_requirements: *2158294060
 - !ruby/object:Gem::Dependency
   name: proton
-  requirement: &2153046860 !ruby/object:Gem::Requirement
+  requirement: &2158293600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -55,10 +55,10 @@ dependencies:
         version: 0.3.3
   type: :runtime
   prerelease: false
-  version_requirements: *2153046860
+  version_requirements: *2158293600
 - !ruby/object:Gem::Dependency
   name: fssm
-  requirement: &2153046400 !ruby/object:Gem::Requirement
+  requirement: &2158293140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -66,10 +66,10 @@ dependencies:
         version: 0.2.7
   type: :runtime
   prerelease: false
-  version_requirements: *2153046400
+  version_requirements: *2158293140
 - !ruby/object:Gem::Dependency
   name: rdiscount
-  requirement: &2153045940 !ruby/object:Gem::Requirement
+  requirement: &2158292680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -77,7 +77,7 @@ dependencies:
         version: 1.6.8
   type: :runtime
   prerelease: false
-  version_requirements: *2153045940
+  version_requirements: *2158292680
 description: Build some documentation for your projects of any language.
 email:
 - rico@sinefunc.com
@@ -86,18 +86,15 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- data/default/_extensions/manual/lib/cli.rb
-- data/default/_extensions/manual/lib/extractor.rb
-- data/default/_extensions/manual/lib/helpers.rb
-- data/default/_extensions/manual/manual.rb
+- data/default/_extensions/helpers.rb
 - data/default/_layouts/_nav.haml
 - data/default/_layouts/default.haml
 - data/default/Gemfile
 - data/default/Gemfile.lock
+- data/default/proscribe.js
 - data/default/Protonfile
 - data/default/style.scss
 - data/rack/config.ru
-- data/rack/Gemfile
 - bin/proscribe
 - lib/proscribe/cli.rb
 - lib/proscribe/extractor.rb

data/data/default/_extensions/manual/lib/cli.rb

@@ -1,18 +0,0 @@
-class Proton::CLI
-  task :update do
-    require File.expand_path('../extractor', __FILE__)
-
-    Dir.chdir(Hyde.project.root) {
-      Proton.project.config.extractor.files.each { |group|
-        FileUtils.rm_rf group.target
-
-        ex = Extractor.new Dir[group.source]
-
-        ex.write!(group.target) { |b| puts "   update  *  #{File.join(group.target, b.file)}" }
-      }
-    }
-  end
-
-  task.description = "Extracts inline documentation."
-end
-

data/data/default/_extensions/manual/lib/extractor.rb

@@ -1,206 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'ostruct'
-require 'fileutils'
-
-# Extracts comments from list of files.
-# Gets the ones with comment blocks starting with `[...]`
-#
-# == Common usage
-#
-#   ex = Extractor.new('.')
-#   ex.blocks
-#
-#   ex.blocks.map! { |b| b.file = "file: #{b.file}" }
-#
-#   ex.write!('manual/')       # Writes to manual/
-#
-class Extractor
-  def initialize(files, options={})
-    @files = files
-  end
-
-  def write!(output_path = '.', &blk)
-    blocks.each { |block|
-      path = File.join(output_path, block.file)
-      FileUtils.mkdir_p File.dirname(path)
-      File.open(path, 'w') { |f| f.write block.body }
-      yield block  if block_given?
-    }
-  end
-
-  # Returns an array of Extractor::Blocks.
-  def blocks
-    @blocks ||= begin
-      @files.map { |file|
-        if File.file?(file)
-          input = File.read(file)
-          get_blocks input
-        end
-      }.compact.flatten
-    end
-  end
-
-private
-  # Returns blocks that match a blah.
-  def get_blocks(str)
-    arr = get_comment_blocks(str)
-    arr.map { |block|
-      re = /^([A-Za-z ]*?): (.*?)(?: \((.*?)\))?$/
-
-      if block.last =~ re
-        Extractor::Block.new \
-          :type => $1,
-          :title => $2,
-          :parent => $3,
-          :body => (block[0..-2].join("\n") + "\n")
-      elsif block.first =~ re
-        Extractor::Block.new \
-          :type => $1,
-          :title => $2,
-          :parent => $3,
-          :body => (block[1..-1].join("\n") + "\n")
-      end
-    }.compact
-  end
-
-  # Returns contiguous comment blocks.
-  def get_comment_blocks(str)
-    chunks = Array.new
-    i = 0
-
-    str.split("\n").each { |s|
-      if s =~ /^\s*(?:\/\/\/?|##?) ?(.*)$/
-        chunks[i] ||= Array.new
-        chunks[i] << $1
-      else
-        i += 1  if chunks[i]
-      end
-    }
-
-    chunks
-  end
-end
-
-class Extractor::Block
-  attr_accessor :body
-  attr_accessor :file
-
-  def initialize(options)
-    title  = options[:title]
-    parent = options[:parent]
-    body   = options[:body]
-    type   = options[:type].downcase
-
-    file = to_filename(title, parent)
-    brief, *body = body.split("\n\n")
-    body = "#{body.join("\n\n")}"
-
-    heading = "title: #{title}\npage_type: #{type}\nbrief: #{brief}\n"
-    heading += "--\n"
-
-    @file = file
-    body  = Tilt.new(".md") { body }.render
-    body  = fix_links(body, from: file)
-    @body = heading + body
-  end
-
-private
-  def fix_links(str, options={})
-    from = ("/" + options[:from].to_s).squeeze('/')
-    depth = from.to_s.count('/')
-    indent = (depth > 1 ? '../'*(depth-1) : './')[0..-2]
-
-    # First pass: {Helpers::content_for} to become links
-    str = str.gsub(/{([^}]*?)}/) { |s|
-      s = s.gsub(/{|}/, '')
-
-      m = s.match(/^(.*?)[:\.]+([A-Za-z_\(\)\!\?]+)$/)
-      if m
-        name, context = $2, $1
-      else
-        name, context = s, nil
-      end
-
-      s = "<a href='/#{to_filename(s, '', :ext => '.html')}'>#{name}</a>"
-      s += " <span class='context'>(#{context})</span>"  if context
-      s
-    }
-
-    # Second pass: relativize
-    re = /href=['"](\/(?:.*?))['"]/
-    str.gsub(re) { |s|
-      url = s.match(re) && $1
-      url = "#{indent}/#{url}".squeeze('/')
-      "href=#{url.inspect}"
-    }
-  end
-
-  def to_filename(title, parent='', options={})
-    extension = options[:ext] || '.erb'
-    pathify = lambda { |s|
-      s.to_s.scan(/[A-Za-z0-9_\!\?]+/).map { |chunk|
-        chunk = chunk.gsub('?', '_question')
-        chunk = chunk.gsub('!', '_bang')
-
-        if chunk[0].upcase == chunk[0]
-          chunk
-        else
-          "#{chunk}_"
-        end
-      }.join("/")
-    }
-
-    pathify["#{parent}/#{title}"] + extension
-  end
-end
-
-module Extractor::Command
-  module Params
-    def extract(what)
-      i = index(what) and slice!(i, 2)[1]
-    end
-
-    def extract_all(what)
-      re = Array.new
-      while true
-        x = extract(what) or return re
-        re << x
-      end
-    end
-  end
-
-  def self.show_usage
-    puts "Usage: #{$0} <path> [-o <output_path>] [-i <ignore_spec>]"
-    puts "  Extracts documentation comments from files in <path>, and places"
-    puts "  them in <output_path>."
-    puts ""
-    puts "Example:"
-    puts "  #{$0} **/*.rb -o manual/"
-    puts ""
-  end
-
-  def self.run!
-    return show_usage  if ARGV.empty?
-
-    ARGV.extend Params
-
-    glob = lambda { |s| Dir["#{s}/**/*"] + Dir[s] }
-
-    output = ARGV.extract('--output') || ARGV.extract('-o') || '.'
-    ignore = ARGV.extract_all('-i') + ARGV.extract_all('--ignore')
-
-    files  = ARGV.map { |s| glob[s] }.flatten
-    files  = Dir["**/*"]  if ARGV.empty?
-
-    files -= ignore.map { |s| glob[s] }.flatten
-
-    ex = Extractor.new(files)
-    ex.blocks.map { |b| b.file }
-    ex.write!(output) { |blk|
-      puts "* #{blk.file}"
-    }
-  end
-end
-
-Extractor::Command.run!  if $0 == __FILE__

data/data/default/_extensions/manual/manual.rb

@@ -1,2 +0,0 @@
-require File.expand_path('../lib/cli', __FILE__)
-require File.expand_path('../lib/helpers', __FILE__)

data/data/rack/Gemfile

@@ -1,2 +0,0 @@
-source :rubygems
-gem 'proscribe', '~> 0.0.1'