proton 0.3.0.rc1

data/AUTHORS

@@ -0,0 +1,6 @@
+Credits
+=======
+
+Hyde was created and being developed and maintained by Rico Sta. Cruz of Sinefunc, Inc.
+
+A hat tip goes to Tom Preston-Werner (mojombo) for Jekyll, the very project that inspired Hyde.

data/HISTORY.md

@@ -0,0 +1,200 @@
+Proton v0.3.0 - Jun 22, 2011
+----------------------------
+
+**The project has been renamed to Proton** (previously called *Hyde*).
+
+### Changed:
+  * The main class is now called `Proton` instead of `Hyde`. However, `Hyde` 
+  still works as an alias.
+  * The main executable is now called `proton` (and not `hyde`).
+  * The configuration file is now called `Protonfile`. The legacy `hyde.conf` 
+  and `.hyderc` still works for backward-compatibility.
+
+Hyde v0.2.3 - Jun 20, 2011
+--------------------------
+
+### Changed:
+  * Use a bundler Gemfile for Hyde sites if a Gemfile is found.
+
+### Fixed:
+  * **Fixed `hyde create`.**
+  * Fixed overriding of Hyde::CLI via commands not working.
+  * Fixed the rel() helper.
+
+Hyde v0.2.2 - Jun 16, 2011
+--------------------------
+
+### Added:
+  * **Built-in Compass support.**
+  * **Enable Sass, SCSS, Haml, Textile and Markdown by default.**
+  * Extensions from `_extensions/*rb` will now be loaded.
+
+### Changed:
+  * The default `hyde.conf` now comments out the default stuff you don't need to set.
+  * Update dependencies to Cuba 2.0, and Hashie 1.0.
+
+Hyde v0.1.14 - Jun 04, 2011
+---------------------------
+
+### Fixed:
+  * Fixed a syntax error in page.rb.
+  * Don't impose gem versions explicitly, and don't load Rubygems if used as a 
+  library.
+
+### Misc:
+  * Added some doc comments to the main classes.
+
+Hyde v0.1.13
+------------
+
+ - Try to fix an edge case where the path '/' gives you an arbitrary dotfile.
+
+Hyde v0.1.11
+------------
+
+ - Deprecate in-app caching for rack-cache.
+ - The Hyde server now sends the Last-Modified HTTP header.
+ - New Hyde sites will now use rack-cache (optionally) when used as a Rack site.
+
+Hyde v0.1.10
+-------
+
+ - New Hyde sites will now have a gems manifest. This means you can
+   push your Hyde sites to Heroku instantly.
+ - Add cuba to dependencies.
+ - The server now serves the right MIME types.
+ - When used as a Rack app, Hyde sends cache headers.
+
+Hyde v0.1.9
+-----------
+
+ - Hotfix: tilt_build_options should work even if there was no tilt_options specified.
+
+Hyde v0.1.8
+-----------
+
+ - Fix: 404 pages in 'hyde start' no longer throws an exception log to the viewer.
+ - Implemented the `content_for` and `yield_content` helpers.
+ - Fix partial locals not working.
+ - Allow having the same layouts/partials path as the site.
+ - Implement `Hyde.project` which returns the latest project. (deprecates $project)
+ - Support tilt_build_options in the config.
+
+Hyde v0.1.7
+-----------
+
+ - Show friendlier error messages.
+ - Show steps on how to install missing gems when any are encountered.
+ - Change 'hyde build' display format to look better.
+
+Hyde v0.1.6
+-----------
+
+ - Fix an edge case where files containing '---' somewhere is treated wrong.
+ - Ruby 1.8 compatibility.
+
+Hyde v0.1.4
+-----------
+
+ - Fix: `hyde start` was giving errors.
+
+Hyde v0.1.3
+-----------
+
+ - .html files are now being treated as .erb.
+ - Implement `page.children.find`.
+ - Implement `page.children.except`.
+ - Fix #children and sorting giving errors.
+ - Fix #siblings.
+ - Revise the 'no config file found' error message.
+ - Allow `.hyderc` as a filename.
+ - Add help for `hyde help start`.
+ - Support `hyde start -D` which is a very hackish solution to have
+   Hyde start as a daemon.
+
+Hyde v0.1.2
+-----------
+
+ - Allow `hyde create .` to add a hyde.conf in the current folder.
+ - Revamp the help screen.
+ - Fix: change the default load path for Sass/SCSS to 'css'.
+ - Add Page#depth.
+ - Fix Page#breadcrumbs.
+ - Fix Page#parent.
+ - Add the `rel` helper.
+ - Generated Hyde projects are now Rack-compatible.
+
+Hyde v0.1.1
+-----------
+
+ - Default project is now simpler. The site_path is `.`.
+ - Implement `Project#build`.
+ - If YAML parsing of page metadata fails, treat it as content.
+ - All options in `hyde.conf` are now optional (even `hyde_requirement`).
+ - Page metadata can now only be a hash.
+ - Fix `hyde start`.
+ - Minimum Ruby version is now at 1.8.6.
+
+Hyde v0.1.0
+-----------
+
+**Complete rewrite.** Many thing have been deprecated.
+
+ - Now uses Tilt (for templates), Shake (for CLI) and Cuba (for the server).
+ - Now supports everything Tilt supports: CoffeeScript, Liquid, etc.
+ - Allow `tilt_options` in hyde.conf.
+ - Old extensions will be broken (but who made any yet, anyway?)
+ - Update the `hyde create` template's gitignore file to account for _public.
+
+Hyde v0.0.8
+-----------
+
+ - Add support for subclassing. (just add a 'type' meta)
+ - Implement Project#all.
+ - Implement Page#all and Page#all(type).
+ - Fix binary files losing extensions on 'hyde build'.
+ - Allow "layout: false" to ensure that a page doesn't have a layout.
+ - Fix bug where "index.html.haml" and "index.rss.haml" clash.
+ - Implement Page#content.
+
+Hyde v0.0.7
+-----------
+
+ - Add support for Sass and SCSS.
+ - Add support for ignored files.
+
+Hyde v0.0.6
+-----------
+
+ - Added support for blocks for `yield_content` (as default text).
+ - `Page#referrer` now is a page (instead of a string of the name).
+ - Partials path is now not ignored by default.
+ - Add support for page ordering (by the `position` key in metadata).
+ - You can now start an IRB session with the `hyde console` command.
+ - Implement traversion methods for page: #next, #previous, #siblings,
+   and #parent.
+ - Implement the 'page' variable to be available in pages.
+ - Add Page#title.
+ - Add Page#path.
+ - Add Page#breadcrumbs.
+ - Implement Utils#escape_html.
+ - Hyde now always tries 'layouts/default.*' as the default layout, if none's
+   specified. (TODO: layout: false)
+ - Implement Renderer.layoutable?, which dictates if a renderer is capable of
+   having a layout.
+
+Hyde v0.0.5 - 2010-05-30
+------------------------
+
+ - Implemented `content_for` and `yield_content` helpers
+ - Added `partials_path` config variable
+ - Changed helper method `partial`s syntax (from `partial X, :locals => { ... }` to `partial X, ...`)
+ - Line numbers for errors are shown now
+ - Added rudimentary 404 page
+ - Added `hyde_requirement` config variable -- Hyde will now not proceed if the project needs a later version of Hyde
+ - Extensions are now auto-guessed (for example, 'foo.less' will be accessible as 'foo.css')
+
+Hyde v0.0.4 - 2010-05-25
+------------------------
+
+ - First public release

data/README.md

@@ -0,0 +1,75 @@
+# [Proton](http://sinefunc.com/proton?)
+#### Proton is a website preprocessor.
+
+http://sinefunc.com/proton/
+
+ - __HAML, Sass, Compass and more:__ Proton will let you write in HAML, SCSS,
+   Sass, and more by default. It also comes preloaded with 
+   [Compass](http://compass-style.org).
+
+ - __Layouts and Partials:__ Proton lets you define your site's header and footer
+   layouts in a separate file, and even separate snippets of your site
+   into reuseable components (partials). Your code will be much cleaner and
+   DRYer!
+
+ - __Template languages:__ Proton lets you write your site in any template
+   language you need -- the translation will be taken care of for you.
+   Proton supports HAML, LessCSS, Markdown, SASS and Textile by default, and
+   more can be added through extensions.
+
+ - __Extendable:__ Proton is easily customizable with extensions. You can add
+   new helpers, new commands, support for new languages and many more by
+   simply adding the extensions to your project folder. Some are even
+   available as simple Ruby gems!
+
+ - __Design fast:__ Proton comes with a web server that lets you serve up
+   your site locally. Any changes to your files will be seen on your next
+   browser refresh!
+
+ - __Build your site as static HTMLs:__ You can export your site as plain
+   HTML files with one simple command.
+
+Why use Proton?
+---------------
+
+It's like building a static site, but better! You can use Proton for:
+
+ - Building HTML prototypes
+ - Building sites with no dynamic logic
+ - Creating a blog where the entries are stored in a source repository
+
+Installation
+------------
+
+    gem install protonweb
+
+Usage
+-----
+
+Here's how you can get started:
+
+    proton create <project_name>
+    cd <project_name>
+    proton build                       # <= Build the HTML files, or
+    proton start                       # <= Serve via a local web server
+
+
+Testing
+-------
+
+Run tests:
+
+    rake test
+
+To try it in a different Ruby version, you can use RVM + Bundler to make 
+things easier. For instance:
+
+    rvm use 1.8.7@proton --create     # Create a gemset
+    bundle install                    # Install the needed gems on that set
+    rake test
+
+Authors
+-------
+
+Authored and maintained by Rico Sta. Cruz and Sinefunc, Inc.  
+See [sinefunc.com](http://sinefunc.com) for more about our work!

data/Rakefile

@@ -0,0 +1,5 @@
+task :test do
+  Dir['test/**/*_test.rb'].each { |f| load f }
+end
+
+task :default => :test

data/TODO.md

@@ -0,0 +1,6 @@
+- Caching
+- MIME types
+
+- Post build hooks?
+- tilt_build_options
+- deprecate $project, implement Hyde.project

data/bin/proton

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+$:.push File.expand_path('../../lib', __FILE__)
+
+require 'rubygems'  unless defined?(::Gem)
+require 'proton'
+
+Proton::CLI.run!

data/data/new_site/Protonfile

@@ -0,0 +1,12 @@
+# This is a Proton site.
+# Install Proton (`gem install proton`) and type `proton` for help.
+requirement: 0.2
+
+# The folder where the site's source files are kept.
+site_path:       .
+output_path:     _output
+
+# Other paths:
+layouts_path:    _layouts
+extensions_path: _extensions
+partials_path:   .

data/data/new_site/README.md

@@ -0,0 +1,10 @@
+Instructions
+------------
+
+ 1. Make sure Ruby (>= v1.8) is installed.
+ 2. Install the proton gem: `gem install proton`
+ 3. Build the site HTML files by typing: `proton build`
+
+(If #2 fails, you may need to type `sudo gem install proton` instead.)
+
+

data/data/new_site/_layouts/default.haml

@@ -0,0 +1,28 @@
+!!!
+%html
+  %head
+    %title= page.title
+
+    %meta(charset='UTF-8')
+    -# Use the latest IE engine, or Chrome frame.
+    %meta(http-equiv='X-UA-Compatible' content='IE=edge,chrome=1')
+
+    -# Mobile viewport optimization. j.mp/bplateviewport
+    %meta(name='viewport' content='width=device-width, initial-scale=1.0')
+
+    -# Standard SEO meta
+    - if page.meta.keywords
+      %meta{:name => 'keywords', :content => page.meta.keywords}
+    - if page.meta.description
+      %meta{:name => 'description', :content => page.meta.description}
+
+    %link{:rel => 'stylesheet', :href => '/css/style.css'}
+
+  %body
+    #content
+      != yield
+
+    %div#footer
+      %hr
+      %p Generated by Hyde
+

data/data/new_site/index.haml

@@ -0,0 +1,5 @@
+layout: default
+title: Your new Hyde site
+--
+%h1 It works!
+%p This is your new site. Feel free to take a look around!

data/data/rack/Gemfile

@@ -0,0 +1,2 @@
+gem "proton", "0.3.0.rc1"
+gem "rack-cache", "~> 1.0.0"

data/data/rack/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  specs:
+    RedCloth (4.2.3)
+    chunky_png (1.2.0)
+    compass (0.11.3)
+      chunky_png (~> 1.2)
+      fssm (>= 0.2.7)
+      sass (~> 3.1)
+    cuba (2.0.0)
+      rack (~> 1.2)
+      tilt (~> 1.2)
+    fssm (0.2.7)
+    haml (3.1.1)
+    hashie (1.0.0)
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    proton (0.3.0.rc1)
+      RedCloth (~> 4.2.3)
+      compass (~> 0.11.1)
+      cuba (~> 2.0.0)
+      haml (~> 3.1.1)
+      hashie (~> 1.0.0)
+      maruku (~> 0.6.0)
+      sass (~> 3.1.1)
+      shake (~> 0.1)
+      tilt (~> 1.2.2)
+    rack (1.3.0)
+    rack-cache (1.0.2)
+      rack (>= 0.4)
+    sass (3.1.1)
+    shake (0.1.2)
+    syntax (1.0.0)
+    tilt (1.2.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  proton (= 0.3.0.rc1)
+  rack-cache (~> 1.0.0)

data/data/rack/config.ru

@@ -0,0 +1,24 @@
+# This file exists to make this project Rack-compatible.
+# You may delete it if you're not concerned about this.
+
+require 'rubygems'  unless defined?(::Gem)
+
+# Use Bundler if possible.
+begin
+  require 'bundler'
+  Bundler.setup
+rescue LoadError
+  gem 'proton', '0.3.0.rc1'
+end
+
+# Add the 'rack-cache' gem if you want to enable caching.
+begin
+  require 'rack/cache'
+  use Rack::Cache
+rescue LoadError
+end
+
+# Load Proton.
+require 'proton/server'
+Proton::Project.new File.dirname(__FILE__)
+run Proton::Server

data/lib/proton.rb

@@ -0,0 +1,78 @@
+$:.push *Dir[File.expand_path('../../vendor/*/lib', __FILE__)]
+
+require 'fileutils'
+require 'ostruct'
+require 'hashie'
+require 'yaml'
+require 'tilt'
+require 'shake'
+
+# For Compass and such
+Encoding.default_external = 'utf-8' if defined?(::Encoding)
+
+# HTML files as ERB
+Tilt.mappings['html'] = Tilt.mappings['erb']
+
+# Class: Proton
+# The Proton class.
+#
+# ## Description
+#    This is the main class.
+#
+#    This class is also aliased as `Hyde` for backward-compatibility with
+#    versions <= 0.2.x, when the project was still called Hyde.
+
+class Proton
+  PREFIX  = File.expand_path('../', __FILE__)
+
+  # Class: Proton::Error 
+  # An error.
+  #
+  # ## Description
+  #    The class Error describes any error thrown by the application.
+  #
+  # ##  Example
+  #
+  #     begin
+  #       Proton::Project.new './my_project/'
+  #     rescue Proton::LegacyError => e
+  #       puts "Old version."
+  #     rescue Proton::VersionError => e
+  #       puts "The project requires a newer version of Proton."
+  #     rescue Proton::Error => e
+  #       puts e
+  #     end
+
+  Error        = Class.new(StandardError)
+  LegacyError  = Class.new(Error)
+  VersionError = Class.new(Error)
+
+  # Constant: CONFIG_FILES (Proton)
+  # An array of the allowed config filenames.
+  CONFIG_FILES = ['Protonfile', 'proton.conf', '.protonrc', 'hyde.conf', '.hyderc']
+
+  autoload :Project, "#{PREFIX}/proton/project"
+  autoload :Page,    "#{PREFIX}/proton/page"
+  autoload :Meta,    "#{PREFIX}/proton/meta"
+  autoload :Config,  "#{PREFIX}/proton/config"
+  autoload :CLI,     "#{PREFIX}/proton/cli"
+  autoload :Set,     "#{PREFIX}/proton/set"
+  autoload :Layout,  "#{PREFIX}/proton/layout"
+  autoload :Partial, "#{PREFIX}/proton/partial"
+  autoload :Helpers, "#{PREFIX}/proton/helpers"
+
+  require "#{PREFIX}/proton/version"
+
+  class << self
+    # Attribute: project (Proton)
+    # Returns the latest project.
+    #
+    # ##  Example
+    #     Proton.project.path(:site)
+
+    attr_accessor :project
+  end
+end
+
+# For backward compatibility reasons, Hyde is an alias for Proton.
+Hyde = Proton