hologram 0.5.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9e4adec839d8a6a2ae3bdb51fad49eae23e42cf6
+  data.tar.gz: c49899ab9a578374192073286465bdba4a23f340
+SHA512:
+  metadata.gz: 80c5363bd1fef75a8547075b37a933bacf209f65e77896898ebb2d7105dcbe22f3c229a094879c4857fa14d9a69e7fbf6f19ee9145abd26a1b47d73dea6cda20
+  data.tar.gz: 9ba3a7facb16ba43a823fcc4d797e8ce95ad824c9a860470b5e065fd8b5a7e57240a8e16ba4d66925724610f70ea6fdad2a2901acc769a83dd8596154c3e6e58

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.sass-cache
+build
+bin
+!bin/hologram

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hologram.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,23 @@
+Copyright (c) 2013, Trulia, Inc.
+All rights reserved.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,154 @@
+# Hologram
+
+Hologram is a Ruby gem that parses comments in your CSS and turns them into a beautiful style guide.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'hologram'
+
+And then execute:
+
+    $ bundle
+    
+If you don't use bundler you can run `gem install hologram`.
+
+## Usage
+
+There are two things you need to do to start using hologram:
+
+1. Create a YAML config file for your project
+
+2. Document yourself some code
+ 
+### Creating a YAML config file
+
+Hologram needs a few configuration settings before it can begin to build
+your documentation for you. Once this is set up you can execute hologram by 
+simply running:
+
+`hologram path/to/your/config.yml` or (using bundler) `bundle exec hologram path/to/your/config.yml`
+
+Your config file needs to contain the following key/value pairs
+
+* **source**: relative path to your source files
+
+* **destination**: relative path to where you want the documentation to be
+  built to
+
+* **documentation_assets**: The path that contains supporting assets for
+  the documentaiton page. This typically includes html fragments (header/footer, etc),
+  styleguide specific CSS, javascript and any images.
+
+* **custom_markdown**: (optional) this is the filename of a class that extends 
+  RedCarpet::Render::HTML class. Use this for when you need
+  additional classes or html tags for different parts of the page.
+
+* **dependencies**: a **list** of relative pathes to a folderes containing any dependencies your style guide has.
+These folders will be copied over into the documentation output directory. 
+PUT THE CSS/JS THAT IS ACTUALLY BEING DOCUMENTED HERE
+
+##### Example config file
+
+    # The directory containing the source files to parse
+    source: ../components
+
+    # The directory that hologram will build to
+    destination: ../docs
+
+    # The assets needed to build/style the docs (includes header.html, footer.html, etc)
+    documentation_assets: ../hologram_assets
+    
+    # A custom markdown renderer that extends `RedCarpet::Render::HTML class`
+    custom_markdown: trulia_markdown_renderer.rb
+
+    # Any other asset folders that need to be copied to the destination folder
+    # This is where the CSS/JS you are actually documenting should go
+    dependencies:
+        - ../build
+
+
+
+###Documenting your styles
+
+Hologram will scan any css/scss/less files within your **source** directory. 
+It will look for comments that match the following:
+
+    /*doc
+    --- 
+    title: Buttons 
+    name: button 
+    category: Base CSS 
+    ---
+
+    Button styles can be applied to any element. Typically you'll want
+    to use either a `<button>` or an `<a>` element:
+
+    ```html_example 
+      <button class="btn btnDefault">Click</button>
+      <a class="btn btnDefault" href="trulia.com">Trulia!</a> 
+    ```
+    
+    If your button is actually a link to another page, please use the
+    `<a>` element, while if your button performs an action, such as
+    submitting a form or triggering some javascript event, then use a
+    `<button>` element.
+
+    */
+
+The first section of the comment is a yaml block that defines certain
+aspects of the this documentation block. The second part is simply
+markdown as defined by Redcarpet. 
+
+####Document YAML section
+The yaml in the doc block can have any key value pair you deem important
+but it specifically looks for the following keys:
+
+* **title**: The title to display in the documents
+* **category**: This is the broad category for the component, all
+  components in the same category will be written to the same page.
+  (Usually named the same as the category but with spaces replaced with
+  underscores and lower cased).
+* **name**: This is used for grouping components, by assigning
+  a name a component can be referenced in another component as a parent.
+* **parent**: Optional. If this is set the current component will be
+  displayed as a section within the parent's documentation.
+
+
+###Documentation Assets
+
+The documentation assets folder contains the html, css, js and images
+you'll need for making your style guide look beautiful. 
+
+Hologram doesn't care too much about to what is in here as it is intended 
+to be custom for your style guide. 
+
+However, it does look for two files called header.html and footer.html. 
+These are html fragments that will be used when creating a new category page. 
+`header.html` will be copied to the beginning to the page and `footer.html`
+will be copied to the bottom of the page. This gives you control of how you 
+will navigate your docs and lets you include any css, disclaimer text, and 
+whatever else you need on each page.
+
+#####Styling Your Code Examples
+
+Hologram uses [pygments.rb](https://github.com/tmm1/pygments.rb) gem to provide 
+syntax highlighting for code examples. One of the assets that you probably want
+to include in your documentation assets folder is a css file that styles the
+"pygmentized" code examples. We use `github.css` which can be found along with the
+css we use to style code blocks [here](https://github.com/trulia/hologram-example/tree/gh-pages/hologram_assets/doc_assets/css).
+
+## Contributing
+
+1. Fork it
+2. Create your feature/bug fix branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+## License
+[Hologram is licensed under the MIT License](https://github.com/trulia/hologram/blob/master/LICENSE.txt)
+
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/hologram.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hologram/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hologram"
+  spec.version       = Hologram::VERSION
+  spec.authors       = ["JD Cantrell", "August Flanagan"]
+  spec.email         = ["jcantrell@trulia.com"]
+  spec.description   = %q{Build doc type things}
+  spec.summary       = %q{Build document type things.}
+  spec.homepage      = "http://trulia.github.io/hologram"
+  spec.license       = "MIT"
+
+  spec.add_dependency "redcarpet", "~> 2.2.2"
+  spec.add_dependency "sass", "~> 3.2.7"
+  spec.add_dependency "pygments.rb", "~> 0.4.2"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = ['hologram']
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+end

data/lib/hologram.rb

@@ -0,0 +1,319 @@
+# Copyright (c) 2013, Trulia, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#    * Redistributions of source code must retain the above copyright
+#      notice, this list of conditions and the following disclaimer.
+#    * Redistributions in binary form must reproduce the above copyright
+#      notice, this list of conditions and the following disclaimer in the
+#      documentation and/or other materials provided with the distribution.
+#    * Neither the name of the Trulia, Inc. nor the
+#      names of its contributors may be used to endorse or promote products
+#      derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TRULIA, INC. BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require "hologram/version"
+
+require 'redcarpet'
+require 'yaml'
+require 'pygments'
+require 'fileutils'
+require 'pathname'
+
+require 'hologram_markdown_renderer'
+
+module Hologram
+
+
+  class DocumentBlock
+    attr_accessor :name, :parent, :children, :title, :category, :markdown, :output_file, :config
+
+    def initialize(config = nil, markdown = nil)
+      @children = {}
+      set_members(config, markdown) if config and markdown
+    end
+
+    def set_members(config, markdown)
+      @name     = config['name']
+      @parent   = config['parent']
+      @category = config['category']
+      @title    = config['title']
+      @markdown = markdown
+    end
+
+    def is_valid?
+      @name && @markdown
+    end
+  end
+
+
+  class Builder
+    attr_accessor :doc_blocks, :config, :pages
+
+    def init(args)
+      @doc_blocks, @pages = {}, {}
+      begin
+        @config = args ? YAML::load_file(args[0]) : YAML::load_file('hologram_config.yml')
+        validate_config
+
+        #TODO: maybe this should move into build_docs
+        current_path = Dir.pwd
+        base_path = Pathname.new(args[0])
+        Dir.chdir(base_path.dirname)
+
+        build_docs
+
+        Dir.chdir(current_path)
+        puts "Build successful. (-: ".green
+      rescue Errno::ENOENT
+        display_error("Could not load config file.")
+      rescue RuntimeError => e
+        display_error("#{e}")
+      end
+    end
+
+
+    private
+    def build_docs
+      # Create the output directory if it doesn't exist
+      FileUtils.mkdir_p(config['destination']) unless File.directory?(config['destination'])
+
+      input_directory  = Pathname.new(config['source']).realpath
+      output_directory = Pathname.new(config['destination']).realpath
+      doc_assets       = Pathname.new(config['documentation_assets']).realpath
+
+      process_dir(input_directory)
+
+      build_pages_from_doc_blocks(@doc_blocks)
+      write_docs(output_directory, doc_assets)
+
+      # Copy over dependencies
+      if config['dependencies']
+        config['dependencies'].each do |dir|
+          dirpath  = Pathname.new(dir).realpath
+          if Dir.exists?("#{dir}")
+            `rm -rf #{output_directory}/#{dirpath.basename}`
+            `cp -R #{dirpath} #{output_directory}/#{dirpath.basename}`
+          end
+        end
+      end
+
+      Dir.foreach(doc_assets) do |item|
+       # ignore . and .. directories
+       next if item == '.' or item == '..'
+       `rm -rf #{output_directory}/#{item}`
+       `cp -R #{doc_assets}/#{item} #{output_directory}/#{item}`
+      end
+    end
+
+
+    def process_dir(base_directory)
+      #get all directories in our library folder
+      directories = Dir.glob("#{base_directory}/**/*/")
+      directories.unshift(base_directory)
+
+      directories.each do |directory|
+        # filter and sort the files in our directory
+        files = []
+        Dir.foreach(directory).select{ |file| is_supported_file_type?(file) }.each do |file|
+          files << file
+        end
+        files.sort!
+        process_files(files, directory)
+      end
+    end
+
+
+    def process_files(files, directory)
+      files.each do |input_file|
+        if input_file.end_with?('md')
+          @pages[File.basename(input_file, '.md') + '.html'] = File.read("#{directory}/#{input_file}")
+        else
+          process_file("#{directory}/#{input_file}")
+        end
+      end
+    end
+
+
+    def process_file(file)
+      file_str = File.read(file)
+      # get any comment blocks that match the pattern /*doc ... */
+      hologram_comments = file_str.scan(/^\s*\/\*doc(.*?)\*\//m)
+      return unless hologram_comments
+
+      hologram_comments.each do |comment_block|
+        doc_block = build_doc_block(comment_block[0])
+        add_doc_block_to_collection(doc_block) if doc_block
+      end
+    end
+
+
+    # this should throw an error if we have a match, but now yaml_match
+    def build_doc_block(comment_block)
+      yaml_match = /^\s*---\s(.*?)\s---$/m.match(comment_block)
+      return unless yaml_match
+      markdown = comment_block.sub(yaml_match[0], '')
+      config = YAML::load(yaml_match[0])
+      if config['name'].nil?
+        puts "Missing required name config value. This hologram comment will be skipped. \n #{config.inspect}"
+      else
+        doc_block = DocumentBlock.new(config, markdown)
+      end
+    end
+
+
+    def add_doc_block_to_collection(doc_block)
+      return unless doc_block.is_valid?
+      if doc_block.parent.nil?
+        #parent file
+        begin
+          doc_block.output_file = get_file_name(doc_block.category)
+        rescue NoMethodError => e
+          display_error("No output file specified. Missing category? \n #{doc_block.inspect}")
+        end
+
+        @doc_blocks[doc_block.name] = doc_block;
+        doc_block.markdown = "\n\n# #{doc_block.title}" + doc_block.markdown
+      else
+        # child file
+        parent_doc_block = @doc_blocks[doc_block.parent]
+        if parent_doc_block
+          doc_block.markdown = "\n\n## #{doc_block.title}" + doc_block.markdown
+          parent_doc_block.children[doc_block.name] = doc_block
+        else
+          @doc_blocks[doc_block.parent] = DocumentBlock.new()
+        end
+      end
+    end
+
+
+    def build_pages_from_doc_blocks(doc_blocks, output_file = nil)
+      doc_blocks.sort.map do |key, doc_block|
+        output_file = doc_block.output_file || output_file
+        @pages[output_file] ||= ""
+        @pages[output_file] << doc_block.markdown
+        if doc_block.children
+          build_pages_from_doc_blocks(doc_block.children, output_file)
+        end
+      end
+    end
+
+
+    def write_docs(output_directory, doc_assets)
+      # load the markdown renderer we are going to use
+      renderer = get_markdown_renderer
+
+      #generate html from markdown
+      @pages.each do |file_name, markdown|
+        fh = get_fh(output_directory, file_name)
+
+        # generate doc nav html
+        if File.exists?("#{doc_assets}/header.html")
+          fh.write(File.read("#{doc_assets}/header.html"))
+        end
+
+        # write the docs
+        fh.write(renderer.render(markdown))
+
+        # write the footer
+        if File.exists?("#{doc_assets}/footer.html")
+          fh.write(File.read("#{doc_assets}/footer.html"))
+        end
+        fh.close()
+      end
+    end
+
+
+    def get_markdown_renderer
+      if config['custom_markdown'].nil?
+        renderer = Redcarpet::Markdown.new(HologramMarkdownRenderer, { :fenced_code_blocks => true, :tables => true })
+      else
+        begin
+          load config['custom_markdown']
+          renderer_class = File.basename(config['custom_markdown'], '.rb').split(/_/).map(&:capitalize).join
+          puts "Custom markdown renderer #{renderer_class} loaded."
+          renderer = Redcarpet::Markdown.new(Module.const_get(renderer_class), { :fenced_code_blocks => true, :tables => true })
+        rescue LoadError => e
+          display_error("Could not load #{config['custom_markdown']}.")
+        rescue NameError => e
+          display_error("Class #{renderer_class} not found in #{config['custom_markdown']}.")
+        end
+      end
+      renderer
+    end
+
+
+    def validate_config
+      unless @config.key?('source')
+        raise "No source directory specified in the config file"
+      end
+
+      unless @config.key?('destination')
+        raise "No destination directory specified in the config"
+      end
+
+      unless @config.key?('documentation_assets')
+        raise "No documentation assets directory specified"
+      end
+    end
+
+
+    def is_supported_file_type?(file)
+      supported_extensions = ['.css', '.scss', '.less', '.sass', '.js', '.md', '.markdown' ]
+      supported_extensions.include?(File.extname(file))
+    end
+
+    def display_error(message)
+        puts "(\u{256F}\u{00B0}\u{25A1}\u{00B0}\u{FF09}\u{256F}".green + "\u{FE35} \u{253B}\u{2501}\u{253B} ".yellow + " Build not complete.".red
+        puts " #{message}"
+        exit 1
+    end
+
+
+    def get_file_name(str)
+      str = str.gsub(' ', '_').downcase + '.html'
+    end
+
+
+    def get_fh(output_directory, output_file)
+      File.open("#{output_directory}/#{output_file}", 'w')
+    end
+  end
+
+end
+
+
+class String
+  # colorization
+  def colorize(color_code)
+    "\e[#{color_code}m#{self}\e[0m"
+  end
+
+  def red
+    colorize(31)
+  end
+
+  def green
+    colorize(32)
+  end
+
+  def yellow
+    colorize(33)
+  end
+
+  def pink
+    colorize(35)
+  end
+end

data/lib/hologram/version.rb

@@ -0,0 +1,29 @@
+# Copyright (c) 2013, Trulia, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#    * Redistributions of source code must retain the above copyright
+#      notice, this list of conditions and the following disclaimer.
+#    * Redistributions in binary form must reproduce the above copyright
+#      notice, this list of conditions and the following disclaimer in the
+#      documentation and/or other materials provided with the distribution.
+#    * Neither the name of the Trulia, Inc. nor the
+#      names of its contributors may be used to endorse or promote products
+#      derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TRULIA, INC. BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module Hologram
+  VERSION = "0.5.2"
+end

data/lib/hologram_markdown_renderer.rb

@@ -0,0 +1,41 @@
+# Copyright (c) 2013, Trulia, Inc.
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#    * Redistributions of source code must retain the above copyright
+#      notice, this list of conditions and the following disclaimer.
+#    * Redistributions in binary form must reproduce the above copyright
+#      notice, this list of conditions and the following disclaimer in the
+#      documentation and/or other materials provided with the distribution.
+#    * Neither the name of the Trulia, Inc. nor the
+#      names of its contributors may be used to endorse or promote products
+#      derived from this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+# TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+# PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL TRULIA, INC. BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+# BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+# WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
+# OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+# ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+class HologramMarkdownRenderer < Redcarpet::Render::HTML
+  def block_code(code, language)
+    if language and language.include?('example')
+      if language.include?('js')
+        # first actually insert the code in the docs so that it will run and make our example work.
+        '<script>' + code + '</script>
+        <div class="codeBlock jsExample">' + Pygments.highlight(code) + '</div>'
+      else
+        '<div class="codeExample">' + '<div class="exampleOutput">' + code + '</div>' + '<div class="codeBlock">' + Pygments.highlight(code) + '</div>' + '</div>'
+      end
+    else
+      '<div class="codeBlock">' + Pygments.highlight(code) + '</div>'
+    end      
+  end
+end

metadata

@@ -0,0 +1,126 @@
+--- !ruby/object:Gem::Specification
+name: hologram
+version: !ruby/object:Gem::Version
+  version: 0.5.2
+platform: ruby
+authors:
+- JD Cantrell
+- August Flanagan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.2
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.2.7
+- !ruby/object:Gem::Dependency
+  name: pygments.rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Build doc type things
+email:
+- jcantrell@trulia.com
+executables:
+- hologram
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/hologram
+- hologram.gemspec
+- lib/hologram.rb
+- lib/hologram/version.rb
+- lib/hologram_markdown_renderer.rb
+homepage: http://trulia.github.io/hologram
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 4
+summary: Build document type things.
+test_files: []