hoe-manualgen 0.2.0 → 0.3.0

data/data/hoe-manualgen/resources/css/reset.css

@@ -0,0 +1,112 @@
+/* @group Reset */
+
+html,body,div,span,a,img,h1,h2,h3,h4,h5,h6,hgroup,p,dl,dialog,dt,dd,ol,ul,li,abbr,
+acronym,address,b,big,blockquote,cite,code,del,dfn,em,i,ins,kbd,pre,q,samp,tt,var,
+small,strong,sub,sup,object,iframe,form,fieldset,label,legend,table,caption,tbody,
+tfoot,thead,tr,th,td,article,aside,footer,header,nav,section,figure,menu,time,mark,
+audio,video {
+	font-family: inherit;
+	font-size: 100%;
+	font-weight: inherit;
+	font-style: inherit;
+	vertical-align: baseline;
+	white-space: normal;
+	text-align: left;
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0;
+	background: transparent
+}
+
+textarea {
+	font-family: inherit;
+	font-size: 100%;
+	font-weight: normal;
+	font-style: normal;
+	white-space: normal;
+	text-align: left;
+	margin: 0;
+	padding: 0
+}
+
+article,aside,footer,header,nav,section,dialog,figure,hgroup,menu {
+	display: block
+}
+
+h1,h2,h3,h4,h5,h6 {
+	font-size: 100%;
+	font-weight: normal
+}
+
+del,ins {
+	text-decoration: none
+}
+
+ol,ul {
+	list-style: none
+}
+
+nav ul {
+	list-style-type: none
+}
+
+table {
+	border-collapse: separate;
+	border-spacing: 0;
+	background-color: transparent;
+	width: auto;
+	height: auto
+}
+
+:focus {
+	outline: 0
+}
+
+blockquote:before,blockquote:after,q:before,q:after {
+	content: ""
+}
+
+blockquote,q {
+	quotes: "" ""
+}
+
+input {
+	margin: 0
+}
+
+applet,basefont,dir,font,isindex,menu,s,strike,u {
+	font-family: inherit;
+	font-size: 100%;
+	font-weight: normal;
+	font-style: normal;
+	white-space: normal;
+	vertical-align: baseline;
+	text-decoration: inherit;
+	text-align: left;
+	color: inherit;
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0
+}
+
+dir,menu {
+	list-style: none
+}
+
+nobr {
+	white-space: normal
+}
+
+blink {
+	text-decoration: none
+}
+
+marquee {
+	overflow: visible
+}
+
+/* @end */
+
+

data/lib/hoe/manualgen.rb

@@ -31,10 +31,10 @@ module Hoe::ManualGen
 	include FileUtils::DryRun if Rake.application.options.dryrun
 
 	# Library version constant
-	VERSION = '0.2.0'
+	VERSION = '0.3.0'
 
 	# Version-control revision constant
-	REVISION = %q$Revision: b775fc3856f5 $
+	REVISION = %q$Revision: cbd7dd95d043 $
 
 	# Configuration defaults
 	DEFAULT_BASE_DIR     = Pathname( 'manual' )
@@ -60,21 +60,23 @@ module Hoe::ManualGen
 		DEFAULT_LIB_DIR,
 	]
 
-	### A collection of output methods for Rake tasks
-	module TraceFunctions
+	module Logging
 
-		### Output a message if Rake -t is enabled
+		### Output a logging message
+		def log( message )
+			$stderr.puts( message )
+		end
+
+		### Output a message if tracing or running in verbose mode
 		def trace( *messages )
-			return unless Rake.application.options.trace
-			$stderr.puts( messages )
+			$stderr.puts( messages.join ) if $VERBOSE || Rake.application.options.trace
 		end
 
-	end # module TraceFunctions
+	end
 
 
 	### Manual page-generation class
 	class Page
-		include Hoe::ManualGen::TraceFunctions
 
 		### The default page configuration if none is specified.
 		DEFAULT_CONFIG = {
@@ -215,7 +217,6 @@ module Hoe::ManualGen
 		def cleanup( source )
 			require 'tidy'
 
-			Tidy.path = '/usr/lib/libtidy.dylib'
 			Tidy.open( TIDY_OPTIONS ) do |tidy|
 				tidy.options.output_xhtml = true
 
@@ -234,7 +235,7 @@ module Hoe::ManualGen
 		### Get (singleton) instances of the filters named in +filterlist+ and return them.
 		def load_filters( filterlist )
 			filterlist.flatten.collect do |key|
-				raise ArgumentError, "filter '#{key}' could not be loaded" unless
+				raise ArgumentError, "filter '#{key}' didn't load correctly" unless
 					Hoe::ManualGen::PageFilter.derivatives.key?( key )
 				Hoe::ManualGen::PageFilter.derivatives[ key ].instance
 			end
@@ -282,7 +283,7 @@ module Hoe::ManualGen
 
 	### A catalog of Page objects that can be referenced by filters.
 	class PageCatalog
-		include Hoe::ManualGen::TraceFunctions
+		include Hoe::ManualGen::Logging
 
 		### Create a new PageCatalog that will load Page objects for .page files
 		### in the specified +sourcedir+.
@@ -478,7 +479,7 @@ module Hoe::ManualGen
 	### An abstract filter class for manual content transformation.
 	class PageFilter
 		include Singleton,
-		        Hoe::ManualGen::TraceFunctions
+		        Hoe::ManualGen::Logging
 
 		# A list of inheriting classes, keyed by normalized name
 		@derivatives = {}
@@ -574,8 +575,6 @@ module Hoe::ManualGen
 		@manual_metadata     = DEFAULT_METADATA
 		@manual_paths = {}
 
-		$trace = Rake.application.options.trace
-
 		self.extra_dev_deps << ['hoe-manualgen', "~> #{VERSION}"] unless
 			self.name == 'hoe-manualgen'
 	end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hoe-manualgen
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,61 +9,49 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain:
-- ! '-----BEGIN CERTIFICATE-----
-
-  MIIDLDCCAhSgAwIBAgIBADANBgkqhkiG9w0BAQUFADA8MQwwCgYDVQQDDANnZWQx
-
-  FzAVBgoJkiaJk/IsZAEZFgdfYWVyaWVfMRMwEQYKCZImiZPyLGQBGRYDb3JnMB4X
-
-  DTEwMDkxNjE0NDg1MVoXDTExMDkxNjE0NDg1MVowPDEMMAoGA1UEAwwDZ2VkMRcw
-
-  FQYKCZImiZPyLGQBGRYHX2FlcmllXzETMBEGCgmSJomT8ixkARkWA29yZzCCASIw
-
-  DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALy//BFxC1f/cPSnwtJBWoFiFrir
-
-  h7RicI+joq/ocVXQqI4TDWPyF/8tqkvt+rD99X9qs2YeR8CU/YiIpLWrQOYST70J
-
-  vDn7Uvhb2muFVqq6+vobeTkILBEO6pionWDG8jSbo3qKm1RjKJDwg9p4wNKhPuu8
-
-  KGue/BFb67KflqyApPmPeb3Vdd9clspzqeFqp7cUBMEpFS6LWxy4Gk+qvFFJBJLB
-
-  BUHE/LZVJMVzfpC5Uq+QmY7B+FH/QqNndn3tOHgsPadLTNimuB1sCuL1a4z3Pepd
-
-  TeLBEFmEao5Dk3K/Q8o8vlbIB/jBDTUx6Djbgxw77909x6gI9doU4LD5XMcCAwEA
-
-  AaM5MDcwCQYDVR0TBAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFJeoGkOr9l4B
-
-  +saMkW/ZXT4UeSvVMA0GCSqGSIb3DQEBBQUAA4IBAQBG2KObvYI2eHyyBUJSJ3jN
-
-  vEnU3d60znAXbrSd2qb3r1lY1EPDD3bcy0MggCfGdg3Xu54z21oqyIdk8uGtWBPL
-
-  HIa9EgfFGSUEgvcIvaYqiN4jTUtidfEFw+Ltjs8AP9gWgSIYS6Gr38V0WGFFNzIH
-
-  aOD2wmu9oo/RffW4hS/8GuvfMzcw7CQ355wFR4KB/nyze+EsZ1Y5DerCAagMVuDQ
-
-  U0BLmWDFzPGGWlPeQCrYHCr+AcJz+NRnaHCKLZdSKj/RHuTOt+gblRex8FAh8NeA
-
-  cmlhXe46pZNJgWKbxZah85jIjx95hR8vOI+NAM5iH9kOqK13DrxacTKPhqj5PjwF
-
-  -----END CERTIFICATE-----
-
-'
-date: 2011-08-15 00:00:00.000000000Z
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURMRENDQWhTZ0F3SUJB
+  Z0lCQURBTkJna3Foa2lHOXcwQkFRVUZBREE4TVF3d0NnWURWUVFEREFOblpX
+  UXgKRnpBVkJnb0praWFKay9Jc1pBRVpGZ2RmWVdWeWFXVmZNUk13RVFZS0Na
+  SW1pWlB5TEdRQkdSWURiM0puTUI0WApEVEV3TURreE5qRTBORGcxTVZvWERU
+  RXhNRGt4TmpFME5EZzFNVm93UERFTU1Bb0dBMVVFQXd3RFoyVmtNUmN3CkZR
+  WUtDWkltaVpQeUxHUUJHUllIWDJGbGNtbGxYekVUTUJFR0NnbVNKb21UOGl4
+  a0FSa1dBMjl5WnpDQ0FTSXcKRFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURD
+  Q0FRb0NnZ0VCQUx5Ly9CRnhDMWYvY1BTbnd0SkJXb0ZpRnJpcgpoN1JpY0kr
+  am9xL29jVlhRcUk0VERXUHlGLzh0cWt2dCtyRDk5WDlxczJZZVI4Q1UvWWlJ
+  cExXclFPWVNUNzBKCnZEbjdVdmhiMm11RlZxcTYrdm9iZVRrSUxCRU82cGlv
+  bldERzhqU2JvM3FLbTFSaktKRHdnOXA0d05LaFB1dTgKS0d1ZS9CRmI2N0tm
+  bHF5QXBQbVBlYjNWZGQ5Y2xzcHpxZUZxcDdjVUJNRXBGUzZMV3h5NEdrK3F2
+  RkZKQkpMQgpCVUhFL0xaVkpNVnpmcEM1VXErUW1ZN0IrRkgvUXFObmRuM3RP
+  SGdzUGFkTFROaW11QjFzQ3VMMWE0ejNQZXBkClRlTEJFRm1FYW81RGszSy9R
+  OG84dmxiSUIvakJEVFV4NkRqYmd4dzc3OTA5eDZnSTlkb1U0TEQ1WE1jQ0F3
+  RUEKQWFNNU1EY3dDUVlEVlIwVEJBSXdBREFMQmdOVkhROEVCQU1DQkxBd0hR
+  WURWUjBPQkJZRUZKZW9Ha09yOWw0Qgorc2FNa1cvWlhUNFVlU3ZWTUEwR0NT
+  cUdTSWIzRFFFQkJRVUFBNElCQVFCRzJLT2J2WUkyZUh5eUJVSlNKM2pOCnZF
+  blUzZDYwem5BWGJyU2QycWIzcjFsWTFFUEREM2JjeTBNZ2dDZkdkZzNYdTU0
+  ejIxb3F5SWRrOHVHdFdCUEwKSElhOUVnZkZHU1VFZ3ZjSXZhWXFpTjRqVFV0
+  aWRmRUZ3K0x0anM4QVA5Z1dnU0lZUzZHcjM4VjBXR0ZGTnpJSAphT0Qyd211
+  OW9vL1JmZlc0aFMvOEd1dmZNemN3N0NRMzU1d0ZSNEtCL255emUrRXNaMVk1
+  RGVyQ0FhZ01WdURRClUwQkxtV0RGelBHR1dsUGVRQ3JZSENyK0FjSnorTlJu
+  YUhDS0xaZFNLai9SSHVUT3QrZ2JsUmV4OEZBaDhOZUEKY21saFhlNDZwWk5K
+  Z1dLYnhaYWg4NWpJang5NWhSOHZPSStOQU01aUg5a09xSzEzRHJ4YWNUS1Bo
+  cWo1UGp3RgotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
+date: 2012-03-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hoe
-  requirement: &70213889262460 !ruby/object:Gem::Requirement
+  requirement: &70209483374240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.10'
+        version: '3.0'
   type: :runtime
   prerelease: false
-  version_requirements: *70213889262460
+  version_requirements: *70209483374240
 - !ruby/object:Gem::Dependency
   name: RedCloth
-  requirement: &70213889261920 !ruby/object:Gem::Requirement
+  requirement: &70209483373440 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -71,10 +59,10 @@ dependencies:
         version: '4.2'
   type: :runtime
   prerelease: false
-  version_requirements: *70213889261920
+  version_requirements: *70209483373440
 - !ruby/object:Gem::Dependency
   name: rcodetools
-  requirement: &70213889261500 !ruby/object:Gem::Requirement
+  requirement: &70209483372600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -82,21 +70,21 @@ dependencies:
         version: '0.8'
   type: :runtime
   prerelease: false
-  version_requirements: *70213889261500
+  version_requirements: *70209483372600
 - !ruby/object:Gem::Dependency
   name: hoe-mercurial
-  requirement: &70213889260960 !ruby/object:Gem::Requirement
+  requirement: &70209483371900 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.2.1
+        version: 1.4.0
   type: :development
   prerelease: false
-  version_requirements: *70213889260960
+  version_requirements: *70209483371900
 - !ruby/object:Gem::Dependency
   name: hoe-highline
-  requirement: &70213889260380 !ruby/object:Gem::Requirement
+  requirement: &70209483387260 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -104,21 +92,21 @@ dependencies:
         version: 0.0.1
   type: :development
   prerelease: false
-  version_requirements: *70213889260380
+  version_requirements: *70209483387260
 - !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &70213889259920 !ruby/object:Gem::Requirement
+  name: rdoc
+  requirement: &70209483386360 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '3.10'
   type: :development
   prerelease: false
-  version_requirements: *70213889259920
+  version_requirements: *70209483386360
 - !ruby/object:Gem::Dependency
   name: tidy-ext
-  requirement: &70213889259400 !ruby/object:Gem::Requirement
+  requirement: &70209483385520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -126,40 +114,28 @@ dependencies:
         version: '0.1'
   type: :development
   prerelease: false
-  version_requirements: *70213889259400
-- !ruby/object:Gem::Dependency
-  name: hoe
-  requirement: &70213889258840 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.10'
-  type: :development
-  prerelease: false
-  version_requirements: *70213889258840
-description: ! 'A manual-generation plugin for Hoe.
-
-
-  This is a plugin for [Hoe][hoe] that adds tasks and resources for
-
-  generating a manual or cookbook.
-
-
-  It''s self-documenting, so for more, see [the latest manual for hoe-manualgen itself][hoe-manualgen-manual].'
+  version_requirements: *70209483385520
+description: ! "A manual-generation plugin for Hoe.\n\nThis is a plugin for Hoe[http://seattlerb.rubyforge.org/hoe/]
+  that \nadds tasks and resources for generating a manual or cookbook.\n\nIt's self-documenting,
+  so for more, see\n{the latest manual for hoe-manualgen itself}[http://deveiate.org/code/hoe-manualgen/]."
 email:
 - ged@FaerieMUD.org
 executables: []
 extensions: []
 extra_rdoc_files:
+- History.rdoc
+- Manifest.txt
+- README.rdoc
 - data/hoe-manualgen/lib/api-filter.rb
 - data/hoe-manualgen/lib/editorial-filter.rb
 - data/hoe-manualgen/lib/examples-filter.rb
 - data/hoe-manualgen/lib/links-filter.rb
 files:
 - .autotest
-- History.md
-- README.md
+- ChangeLog
+- History.rdoc
+- Manifest.txt
+- README.rdoc
 - Rakefile
 - data/hoe-manualgen/layouts/default.erb.erb
 - data/hoe-manualgen/lib/api-filter.rb
@@ -167,6 +143,7 @@ files:
 - data/hoe-manualgen/lib/examples-filter.rb
 - data/hoe-manualgen/lib/links-filter.rb
 - data/hoe-manualgen/resources/css/manual.css.erb
+- data/hoe-manualgen/resources/css/reset.css
 - data/hoe-manualgen/resources/fonts/GraublauWeb.otf
 - data/hoe-manualgen/resources/fonts/GraublauWebBold.otf
 - data/hoe-manualgen/resources/fonts/Inconsolata.otf
@@ -201,7 +178,7 @@ licenses:
 post_install_message: 
 rdoc_options:
 - --main
-- README.md
+- README.rdoc
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -218,7 +195,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: hoe-manualgen
-rubygems_version: 1.8.6
+rubygems_version: 1.8.16
 signing_key: 
 specification_version: 3
 summary: A manual-generation plugin for Hoe

data/History.md

@@ -1,16 +0,0 @@
-## v0.1.1 [2011-06-29] Michael Granger <ged@FaerieMUD.org>
-
-* Bugfix: add trace function in a mixin for outputting based on rake -t.
-
-## v0.1.0 [2011-03-16] Michael Granger <ged@FaerieMUD.org>
-
-* Put page filters under the same namespace as the rest
-* More work on the meta-manual.
-* Add page filters to the API docs
-* Reorganized page filter plugins to be a bit more consistently-
-  named/located
-
-## 0.0.1 [2011-01-31] Michael Granger <ged@FaerieMUD.org>
-
-Initial release.
-