guard-markdown 0.1.1 → 0.1.2

data/README.md

@@ -0,0 +1,64 @@
+# Guard::Markdown #
+Markdown guard will watch your markdown documents for changes and convert them to lovely, semantic html. Yay!
+
+## Install ##
+
+You're going to need [Guard](https://github.com/guard/guard) too.
+
+Install with
+	
+	$ gem install guard-markdown
+	
+Or add it to your Gemfile
+
+	gem 'guard-markdown'    
+	
+## Usage ##
+
+Go see the [Guard usage doc](https://github.com/guard/guard#readme) for general instructions
+
+## The Guardfile - where the magic happens
+	
+The Guardfile is where you define your desired input and output paths.
+Create it with:
+
+	$ guard init markdown
+	
+Then tweak the watch statements to your hearts content. It'll look a lot like this:
+
+	guard 'markdown', :convert_on_start => true, :dry_run => true do  
+		watch (/source_dir\/(.+\/)*(.+\.)(md|markdown)/i) { |m| "source_dir/#{m[1]}#{m[2]}#{m[3]}|output_dir/#{m[1]}#{m[2]}html"}
+	end
+
+The guard statement defines which guard your configuring and sets any optional parameters.
+
+*	:convert_on_start - if true will run all conversions when you start the guard. Defaults to true
+*	:dry_run - if true won't actually run the conversion process, but it will output the files being watched and the file it would write to. Use it to tweak your watch statements and when you're happy set it to false.
+
+The watch statement - ok, it may look a little intimidating. You'll need to know your regular expressions. But this is what it's doing.
+
+	watch (/source_dir\/(.+\/)*(.+\.)(md|markdown)/i) { |m| "source_dir/#{m[1]}#{m[2]}#{m[3]}|output_dir/#{m[1]}#{m[2]}html"}
+			 
+			^ ------ input file pattern -----------  ^        ^ ---- input file path -------- ^|^ ----- output file path ---^
+	
+The "input file pattern" is a regular expression that is used to determine which files are watched by the guard. It'll be applied recursively to all files and folders starting in the current working directory. 
+
+Any matches are passed into the block and used to construct the conversion command. The conversion command is a string containing the path to the source file and the desired path to the output file separated by a "|" 
+
+I hope that makes sense :)
+
+
+
+## Have Fun ##
+
+Go see the other [great guards available](https://github.com/guard/guard/wiki/List-of-available-Guards)
+
+Oh yeah, I'm using [Kramdown](http://kramdown.rubyforge.org/) for the conversion engine. So if you want to know what markdown syntax it supports, [go here](http://kramdown.rubyforge.org/syntax.html)
+
+# TODO #
+
+*	Simplify the required watch statement
+	* Seems a little wasteful to have to recreate the input path in the regexp. Must find a way around it.
+*	Allow the passing of Kramdown options into the guard
+*  Allow the conversion of more doc types using Kramdown
+

data/guard-markdown.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |s|
   s.version     = Guard::MarkdownVersion::VERSION
   s.authors     = ["Darren Wallace"]
   s.email       = ["wallace@midweekcrisis.com"]
-  s.homepage    = ""
+  s.homepage    = "https://github.com/darwalenator/guard-markdown"
 	s.summary     = %q{Markdown folder > html folder conversion}
   s.description = %q{Watches a source folder and converts markdown docs to html docs in a target folder}
 

data/lib/guard/markdown/version.rb

@@ -1,5 +1,5 @@
 module Guard
   module MarkdownVersion
-    VERSION = "0.1.1"
+    VERSION = "0.1.2"
   end
 end

metadata

@@ -2,7 +2,7 @@
 name: guard-markdown
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors: 
 - Darren Wallace
@@ -101,7 +101,7 @@ files:
 - lib/guard/markdown/version.rb
 - spec/lib/guard/markdown_spec.rb
 - spec/spec_helper.rb
-homepage: ""
+homepage: https://github.com/darwalenator/guard-markdown
 licenses: []
 
 post_install_message: