mojombo-jekyll 0.5.1 → 0.5.2

data/.gitignore

@@ -0,0 +1,6 @@
+test/dest
+*.gem
+pkg/
+*.swp
+*~
+_site/

data/History.txt

@@ -1,4 +1,20 @@
-== 0.5.1
+== 0.5.2 / 2009-06-24
+  * Enhancements
+    * Added --paginate option to the executable along with a paginator object for the payload [github.com/calavera]
+    * Upgraded RedCloth to 4.2.1, which makes <notextile> tags work once again.
+    * Configuration options set in config.yml are now available through the site payload [github.com/vilcans]
+    * Posts can now have an empty YAML front matter or none at all [github.com/bahuvrihi]
+  * Bug Fixes
+    * Fixing Ruby 1.9 issue that requires to_s on the err object [github.com/Chrononaut]
+    * Fixes for pagination and ordering posts on the same day [github.com/ujh]
+    * Made pages respect permalinks style and permalinks in yml front matter [github.com/eugenebolshakov]
+    * Index.html file should always have index.html permalink [github.com/eugenebolshakov]
+    * Added trailing slash to pretty permalink style so Apache is happy [github.com/eugenebolshakov]
+    * Bad markdown processor in config fails sooner and with better message [github.com/gcnovus]
+    * Allow CRLFs in yaml frontmatter [github.com/juretta]
+    * Added Date#xmlschema for Ruby versions < 1.9
+
+== 0.5.1 / 2009-05-06
   * Major Enhancements
     * Next/previous posts in site payload [github.com/pantulis, github.com/tomo]
     * Permalink templating system

data/README.textile

@@ -10,6 +10,7 @@ h2. Getting Started
 * Read up about its "Usage":http://wiki.github.com/mojombo/jekyll/usage and "Configuration":http://wiki.github.com/mojombo/jekyll/configuration
 * Take a gander at some existing "Sites":http://wiki.github.com/mojombo/jekyll/sites
 * Fork and "Contribute":http://wiki.github.com/mojombo/jekyll/contribute your own modifications
+* Have questions? Post them on the "Mailing List":http://groups.google.com/group/jekyll-rb
 
 h2. Diving In
 
@@ -21,7 +22,7 @@ h2. Diving In
 
 h2. Dependencies
 
-* RedCloth 4.1.0: Textile support. This version obeys <notextile> tags. The latest version will still work, but tests will fail.
+* RedCloth: Textile support
 * Liquid: Templating system
 * Classifier: Generating related posts
 * Maruku: Default markdown engine

data/Rakefile

@@ -15,7 +15,7 @@ begin
     s.rubyforge_project = "jekyll"
     s.files.exclude 'test/dest'
     s.test_files.exclude 'test/dest'
-    s.add_dependency('RedCloth', '= 4.1.0')
+    s.add_dependency('RedCloth', '>= 4.2.1')
     s.add_dependency('liquid', '>= 1.9.0')
     s.add_dependency('classifier', '>= 1.3.1')
     s.add_dependency('maruku', '>= 0.5.9')
@@ -81,7 +81,7 @@ begin
   require 'cucumber/rake/task'
 
   Cucumber::Rake::Task.new(:features) do |t|
-    t.cucumber_opts = "--format pretty"
+    t.cucumber_opts = "--format progress"
   end
 rescue LoadError
   desc 'Cucumber rake task not available'

data/VERSION.yml

@@ -1,4 +1,4 @@
 --- 
 :major: 0
 :minor: 5
-:patch: 1
+:patch: 2

data/bin/jekyll

@@ -51,6 +51,16 @@ opts = OptionParser.new do |opts|
   opts.on("--permalink [TYPE]", "Use 'date' (default) for YYYY/MM/DD") do |style|
     options['permalink'] = style unless style.nil?
   end
+  
+  opts.on("--paginate [POSTS_PER_PAGE]", "Paginate a blog's posts") do |per_page|
+    begin
+      options['paginate'] = per_page.to_i
+      raise ArgumentError if options['paginate'] == 0
+    rescue
+      puts 'you must specify a number of posts by page bigger than 0'
+      exit 0
+    end
+  end
 
   opts.on("--version", "Display current version") do
     puts "Jekyll " + Jekyll.version

data/features/create_sites.feature

@@ -0,0 +1,46 @@
+Feature: Create sites
+  As a hacker who likes to blog
+  I want to be able to make a static site
+  In order to share my awesome ideas with the interwebs
+
+  Scenario: Basic site
+    Given I have an "index.html" file that contains "Basic Site"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Basic Site" in "_site/index.html"
+
+  Scenario: Basic site with a post
+    Given I have a _posts directory
+    And I have the following post:
+      | title   | date      | content          |
+      | Hackers | 3/27/2009 | My First Exploit |
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "My First Exploit" in "_site/2009/03/27/hackers.html"
+
+  Scenario: Basic site with layout and a page
+    Given I have a _layouts directory
+    And I have an "index.html" page with layout "default" that contains "Basic Site with Layout"
+    And I have a default layout that contains "Page Layout: {{ content }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Page Layout: Basic Site with Layout" in "_site/index.html"
+
+  Scenario: Basic site with layout and a post
+    Given I have a _layouts directory
+    And I have a _posts directory
+    And I have the following post:
+      | title    | date      | layout  | content                               |
+      | Wargames | 3/27/2009 | default | The only winning move is not to play. |
+    And I have a default layout that contains "Post Layout: {{ content }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post Layout: <p>The only winning move is not to play.</p>" in "_site/2009/03/27/wargames.html"
+
+  Scenario: Basic site with include tag
+    Given I have a _includes directory
+    And I have an "index.html" page that contains "Basic Site with include tag: {% include about.textile %}"
+    And I have an "_includes/about.textile" file that contains "Generated by Jekyll"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Basic Site with include tag: Generated by Jekyll" in "_site/index.html"

data/features/embed_filters.feature

@@ -0,0 +1,60 @@
+Feature: Embed filters
+  As a hacker who likes to blog
+  I want to be able to transform text inside a post or page
+  In order to perform cool stuff in my posts
+
+  Scenario: Convert date to XML schema
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout  | content                                     |
+      | Star Wars | 3/27/2009 | default | These aren't the droids you're looking for. |
+    And I have a default layout that contains "{{ site.time | date_to_xmlschema }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see today's date in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Escape text for XML
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title       | date      | layout  | content                                     |
+      | Star & Wars | 3/27/2009 | default | These aren't the droids you're looking for. |
+    And I have a default layout that contains "{{ site.posts.first.title | xml_escape }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Star & Wars" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Calculate number of words
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout  | content                                     |
+      | Star Wars | 3/27/2009 | default | These aren't the droids you're looking for. |
+    And I have a default layout that contains "{{ site.posts.first.content | xml_escape }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "7" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Convert an array into a sentence
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout  | tags                   | content                                     |
+      | Star Wars | 3/27/2009 | default | [scifi, movies, force] | These aren't the droids you're looking for. |
+    And I have a default layout that contains "{{ site.posts.first.tags | array_to_sentence_string }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "scifi, movies, and force" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Textilize a given string
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout  | content                                      |
+      | Star Wars | 3/27/2009 | default | These aren't the droids you're looking for. |
+    And I have a default layout that contains "By {{ '_Obi-wan_' | textilize }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "By <p><em>Obi-wan</em></p>" in "_site/2009/03/27/star-wars.html"
+

data/features/pagination.feature

@@ -0,0 +1,40 @@
+Feature: Site pagination
+  In order to paginate my blog
+  As a blog's user
+  I want divide the posts in several pages
+  
+  Scenario Outline: Paginate with N posts per page
+    Given I have a configuration file with "paginate" set to "<num>"
+    And I have a _layouts directory
+    And I have an "index.html" file that contains "Basic Site"
+    And I have a _posts directory
+    And I have the following post:
+      | title     | date      | layout  | content                                |
+      | Wargames  | 3/27/2009 | default | The only winning move is not to play.  |
+      | Wargames2 | 4/27/2009 | default | The only winning move is not to play2. |
+      | Wargames3 | 5/27/2009 | default | The only winning move is not to play2. |
+    When I run jekyll
+    Then the _site/page2 directory should exist
+    And the _site/page2/index.html file should exist
+
+    Examples:
+      | num |
+      | 1   |
+      | 2   |
+
+  Scenario: Correct liquid paginator replacements
+    Given I have a configuration file with "paginate" set to "1"
+    And I have a _layouts directory
+    And I have an "index.html" file that contains "{{ paginator.page }}"
+    And I have a _posts directory
+    And I have the following post:
+      | title     | date      | layout  | content                                |
+      | Wargames  | 3/27/2009 | default | The only winning move is not to play.  |
+      | Wargames2 | 4/27/2009 | default | The only winning move is not to play2. |
+    When I run jekyll
+    Then the _site/index.html file should exist
+    And I should see "1" in "_site/index.html"
+    Then the _site/page2 directory should exist
+    And the _site/page2/index.html file should exist
+    And I should see "2" in "_site/page2/index.html"
+    

data/features/permalinks.feature

@@ -0,0 +1,63 @@
+Feature: Fancy permalinks
+  As a hacker who likes to blog
+  I want to be able to set permalinks
+  In order to make my blog URLs awesome
+
+  Scenario: Use none permalink schema
+    Given I have a _posts directory
+    And I have the following post:
+      | title                 | date      | content          |
+      | None Permalink Schema | 3/27/2009 | Totally nothing. |
+    And I have a configuration file with "permalink" set to "none"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Totally nothing." in "_site/none-permalink-schema.html"
+
+  Scenario: Use pretty permalink schema
+    Given I have a _posts directory
+    And I have the following post:
+      | title                   | date      | content            |
+      | Pretty Permalink Schema | 3/27/2009 | Totally wordpress. |
+    And I have a configuration file with "permalink" set to "pretty"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Totally wordpress." in "_site/2009/03/27/pretty-permalink-schema/index.html"
+
+  Scenario: Use pretty permalink schema for pages
+    Given I have an "index.html" page that contains "Totally index"
+    And I have an "awesome.html" page that contains "Totally awesome"
+    And I have a configuration file with "permalink" set to "pretty"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Totally index" in "_site/index.html"
+    And I should see "Totally awesome" in "_site/awesome/index.html"
+
+  Scenario: Use custom permalink schema with prefix
+    Given I have a _posts directory
+    And I have the following post:
+      | title                   | category | date      | content         |
+      | Custom Permalink Schema | stuff    | 3/27/2009 | Totally custom. |
+    And I have a configuration file with "permalink" set to "/blog/:year/:month/:day/:title"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Totally custom." in "_site/blog/2009/03/27/custom-permalink-schema/index.html"
+
+  Scenario: Use custom permalink schema with category
+    Given I have a _posts directory
+    And I have the following post:
+      | title                   | category | date      | content         |
+      | Custom Permalink Schema | stuff    | 3/27/2009 | Totally custom. |
+    And I have a configuration file with "permalink" set to "/:categories/:title.html"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Totally custom." in "_site/stuff/custom-permalink-schema.html"
+
+  Scenario: Use custom permalink schema with squished date
+    Given I have a _posts directory
+    And I have the following post:
+      | title                   | category | date      | content         |
+      | Custom Permalink Schema | stuff    | 3/27/2009 | Totally custom. |
+    And I have a configuration file with "permalink" set to "/:month-:day-:year/:title.html"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Totally custom." in "_site/03-27-2009/custom-permalink-schema.html"

data/features/post_data.feature

@@ -0,0 +1,153 @@
+Feature: Post data
+  As a hacker who likes to blog
+  I want to be able to embed data into my posts
+  In order to make the posts slightly dynamic
+
+  Scenario: Use post.title variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post title: {{ site.posts.first.title }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post title: Star Wars" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Use post.url variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post url: {{ site.posts.first.url }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post url: /2009/03/27/star-wars.html" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Use post.date variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post date: {{ site.posts.first.date }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post date: Fri Mar 27" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Use post.id variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post id: {{ site.posts.first.id }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post id: /2009/03/27/star-wars" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Use post.content variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post content: {{ site.posts.first.content }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post content: <p>Luke, I am your father.</p>" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Use post.categories variable when category is in a folder
+    Given I have a movies directory
+    And I have a movies/_posts directory
+    And I have a _layouts directory
+    And I have the following post in "movies":
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post category: {{ site.posts.first.categories }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post category: movies" in "_site/movies/2009/03/27/star-wars.html"
+
+  Scenario: Use post.tags variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | tag   | content                 |
+      | Star Wars | 5/18/2009 | simple | twist | Luke, I am your father. |
+    And I have a simple layout that contains "Post tags: {{ site.posts.first.tags }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post tags: twist" in "_site/2009/05/18/star-wars.html"
+
+  Scenario: Use post.categories variable when categories are in folders
+    Given I have a movies directory
+    And I have a movies/scifi directory
+    And I have a movies/scifi/_posts directory
+    And I have a _layouts directory
+    And I have the following post in "movies/scifi":
+      | title     | date      | layout | content                 |
+      | Star Wars | 3/27/2009 | simple | Luke, I am your father. |
+    And I have a simple layout that contains "Post categories: {{ site.posts.first.categories | array_to_sentence_string }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post categories: movies and scifi" in "_site/movies/scifi/2009/03/27/star-wars.html"
+
+  Scenario: Use post.categories variable when category is in YAML
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | category | content                 |
+      | Star Wars | 3/27/2009 | simple | movies   | Luke, I am your father. |
+    And I have a simple layout that contains "Post category: {{ site.posts.first.categories }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post category: movies" in "_site/movies/2009/03/27/star-wars.html"
+
+  Scenario: Use post.categories variable when categories are in YAML
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | categories          | content                 |
+      | Star Wars | 3/27/2009 | simple | ['movies', 'scifi'] | Luke, I am your father. |
+    And I have a simple layout that contains "Post categories: {{ site.posts.first.categories | array_to_sentence_string }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post categories: movies and scifi" in "_site/movies/scifi/2009/03/27/star-wars.html"
+
+  Scenario: Disable a post from being published
+    Given I have a _posts directory
+    And I have an "index.html" file that contains "Published!"
+    And I have the following post:
+      | title     | date      | layout | published | content                 |
+      | Star Wars | 3/27/2009 | simple | false     | Luke, I am your father. |
+    When I run jekyll
+    Then the _site directory should exist
+    And the "_site/2009/03/27/star-wars.html" file should not exist
+    And I should see "Published!" in "_site/index.html"
+
+  Scenario: Use a custom variable
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following post:
+      | title     | date      | layout | author      | content                 |
+      | Star Wars | 3/27/2009 | simple | Darth Vader | Luke, I am your father. |
+    And I have a simple layout that contains "Post author: {{ site.posts.first.author }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "Post author: Darth Vader" in "_site/2009/03/27/star-wars.html"
+
+  Scenario: Previous and next posts title
+    Given I have a _posts directory
+    And I have a _layouts directory
+    And I have the following posts:
+      | title            | date      | layout  | author      | content                 |
+      | Star Wars        | 3/27/2009 | ordered | Darth Vader | Luke, I am your father. |
+      | Some like it hot | 4/27/2009 | ordered | Osgood      | Nobody is perfect.      |
+      | Terminator       | 5/27/2009 | ordered | Arnold      | Sayonara, baby          |
+    And I have a ordered layout that contains "Previous post: {{ page.previous.title }} and next post: {{ page.next.title }}"
+    When I run jekyll
+    Then the _site directory should exist
+    And I should see "next post: Some like it hot" in "_site/2009/03/27/star-wars.html"
+    And I should see "Previous post: Some like it hot" in "_site/2009/05/27/terminator.html"