pith 0.2.2 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. data/README.markdown +17 -1
  2. data/lib/pith/version.rb +1 -1
  3. metadata +21 -20
data/README.markdown CHANGED
@@ -48,7 +48,7 @@ Templates
48
48
 
49
49
  Files in the input directory are considered to be "templates" if the file name ends with a template format extension recognised as such by [Tilt][tilt], e.g. "`.haml`", or "`.textile`". These will be evaluated dynamically. Pith strips the format extension off the file name when generating output.
50
50
 
51
- Formats supported by Tilt include:
51
+ Tilt supports a wide variety of formats, including:
52
52
 
53
53
  - [Markdown](http://daringfireball.net/projects/markdown/) (`markdown`, `md`)
54
54
  - [Textile](http://redcloth.org/hobix.com/textile/) (`textile`)
@@ -57,6 +57,22 @@ Formats supported by Tilt include:
57
57
  - [Sass][sass] (`sass`)
58
58
  - [CoffeeScript](http://jashkenas.github.com/coffee-script/) (`coffee`)
59
59
 
60
+ At one end of the spectrum are the "template engines", like ERB/Erubis and Liquid, which allow insertion of dynamic content into a template. These aren't really HTML-specific; they can be used to generate any output format ... really, they're just string interpolation on steroids.
61
+
62
+ At the other end of the spectrum are "markup formats" like Markdown, Textile, Creole, which are targeted specifically at HTML output ... but don't support insertion of dynamic content.
63
+
64
+ In the middle are hybrids like Haml, and Markaby, which are both HTML-focused, but support dynamic content.
65
+
66
+ Pipelining
67
+ ----------
68
+
69
+ If you want both dynamic content, and simplified markup, in the same template, one option is to use Haml.
70
+
71
+ The alternative to Haml, if you want both dynamic content, and less angle-bracket, is to combine a template format with a markup format. For example, you can create a "page.md.liquid" template, which would undergo first Liquid template expansion (for dynamic content), and then Markdown processing (for generation of HTML).
72
+
73
+ Resources
74
+ ---------
75
+
60
76
  Any non-template input files (we call them "resources") are just copied verbatim into the output directory.
61
77
 
62
78
  Ignored files
data/lib/pith/version.rb CHANGED
@@ -1,3 +1,3 @@
1
1
  module Pith
2
- VERSION = "0.2.2".freeze
2
+ VERSION = "0.2.3".freeze
3
3
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: pith
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.2
4
+ version: 0.2.3
5
5
  prerelease:
6
6
  platform: ruby
7
7
  authors:
@@ -9,11 +9,11 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2012-01-24 00:00:00.000000000 Z
12
+ date: 2012-03-15 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: tilt
16
- requirement: &70328100528500 !ruby/object:Gem::Requirement
16
+ requirement: &70245266534120 !ruby/object:Gem::Requirement
17
17
  none: false
18
18
  requirements:
19
19
  - - ! '>='
@@ -21,51 +21,51 @@ dependencies:
21
21
  version: '1.3'
22
22
  type: :runtime
23
23
  prerelease: false
24
- version_requirements: *70328100528500
24
+ version_requirements: *70245266534120
25
25
  - !ruby/object:Gem::Dependency
26
26
  name: adsf
27
- requirement: &70328100527980 !ruby/object:Gem::Requirement
27
+ requirement: &70245266533620 !ruby/object:Gem::Requirement
28
28
  none: false
29
29
  requirements:
30
- - - ~>
30
+ - - ! '>='
31
31
  - !ruby/object:Gem::Version
32
32
  version: 1.0.1
33
33
  type: :runtime
34
34
  prerelease: false
35
- version_requirements: *70328100527980
35
+ version_requirements: *70245266533620
36
36
  - !ruby/object:Gem::Dependency
37
37
  name: rack
38
- requirement: &70328100527460 !ruby/object:Gem::Requirement
38
+ requirement: &70245266533160 !ruby/object:Gem::Requirement
39
39
  none: false
40
40
  requirements:
41
- - - ~>
41
+ - - ! '>='
42
42
  - !ruby/object:Gem::Version
43
43
  version: 1.2.1
44
44
  type: :runtime
45
45
  prerelease: false
46
- version_requirements: *70328100527460
46
+ version_requirements: *70245266533160
47
47
  - !ruby/object:Gem::Dependency
48
48
  name: thin
49
- requirement: &70328100527000 !ruby/object:Gem::Requirement
49
+ requirement: &70245266532700 !ruby/object:Gem::Requirement
50
50
  none: false
51
51
  requirements:
52
- - - ~>
52
+ - - ! '>='
53
53
  - !ruby/object:Gem::Version
54
54
  version: 1.2.7
55
55
  type: :runtime
56
56
  prerelease: false
57
- version_requirements: *70328100527000
57
+ version_requirements: *70245266532700
58
58
  - !ruby/object:Gem::Dependency
59
59
  name: clamp
60
- requirement: &70328100526520 !ruby/object:Gem::Requirement
60
+ requirement: &70245266532240 !ruby/object:Gem::Requirement
61
61
  none: false
62
62
  requirements:
63
- - - ~>
63
+ - - ! '>='
64
64
  - !ruby/object:Gem::Version
65
65
  version: 0.3.0
66
66
  type: :runtime
67
67
  prerelease: false
68
- version_requirements: *70328100526520
68
+ version_requirements: *70245266532240
69
69
  description: ! 'Pith builds static websites, using markup/template languages including
70
70
  Haml, Sass, ERb, Liquid, Markdown and Textile.
71
71
 
@@ -153,7 +153,8 @@ files:
153
153
  - features/textile.feature~
154
154
  - features/verbatim.feature~
155
155
  - cucumber.yml
156
- - bin/pith
156
+ - !binary |-
157
+ YmluL3BpdGg=
157
158
  homepage: http://github.com/mdub/pith
158
159
  licenses: []
159
160
  post_install_message:
@@ -168,7 +169,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
168
169
  version: '0'
169
170
  segments:
170
171
  - 0
171
- hash: 1318173105558920173
172
+ hash: 1675155199732218344
172
173
  required_rubygems_version: !ruby/object:Gem::Requirement
173
174
  none: false
174
175
  requirements:
@@ -177,10 +178,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
177
178
  version: '0'
178
179
  segments:
179
180
  - 0
180
- hash: 1318173105558920173
181
+ hash: 1675155199732218344
181
182
  requirements: []
182
183
  rubyforge_project:
183
- rubygems_version: 1.8.10
184
+ rubygems_version: 1.8.17
184
185
  signing_key:
185
186
  specification_version: 3
186
187
  summary: A static website generator