middleman-blog 3.0.0 → 3.1.0

data/CHANGELOG.md

@@ -0,0 +1,18 @@
+3.1.0
+====
+* Don't publish future-dated articles. #74
+* Create summary from source instead of output. #70
+* Deprecate instance variables in templates in favor of locals. #66
+* Allow articles to set "published: false" in frontmatter and show up in preview but not in build/production.
+* Allow articles to have their own layout set in the YAML front matter. #59
+* Per-article content subdirectories. #60
+* Allow article date to be in any order in permalink. #60
+* Use `link_to` in blog templates. #62
+* Pagination for index, tag, and calendar pages. #57
+
+3.0.0
+====
+* Middleman-3.0 compatible release. Complete overhaul.
+* Tag and calendar pages.
+* Sitemap integration.
+* Lots of bugfixes.

data/Gemfile

@@ -20,6 +20,7 @@ group :test do
   gem "fivemat"
   gem "aruba",    "~> 0.4.11"
   gem "rspec",    "~> 2.7"
+  gem "timecop",  "~> 0.4.0"
   
   platforms :ruby do
     gem "redcarpet", "~> 2.1.1"

data/features/article_dirs.feature

@@ -0,0 +1,7 @@
+Feature: Article-specific subdirectories
+  Scenario: Blog articles can have their own subdirectories for related files
+    Given the Server is running at "article-dirs-app"
+    When I go to "/blog/2011-01-01-new-article/example.txt"
+    Then I should see "Not Found"
+    When I go to "/2011/01/01/new-article/example.txt"
+    Then I should see "Example Text"

data/features/blog_sources.feature

@@ -7,3 +7,8 @@ Feature: Flexible article sources
     Then I should see "Not Found"
     When I go to "/"
     Then I should see "/2011/01/01/new-article.html"
+
+  Scenario: Blog articles can omit the day part
+    Given the Server is running at "no-day-app"
+    When I go to "/2012/08/01/testing.html"
+    Then I should see "Testing Article"

data/features/calendar-and-tag.feature

@@ -0,0 +1,56 @@
+Feature: Calendar and Tag pages
+  Scenario: Calendar pages are using the same template
+    Given the Server is running at "calendar-and-tag-app"
+    When I go to "/2011.html"
+    Then I should not see "Tag:"
+    Then I should see "Year: '2011'"
+    Then I should see "Month: ''"
+    Then I should see "Day: ''"
+
+    When I go to "/2011/01.html"
+    Then I should not see "Tag:"
+    Then I should see "Year: '2011'"
+    Then I should see "Month: '1'"
+    Then I should see "Day: ''"
+
+    When I go to "/2011/01/01.html"
+    Then I should not see "Tag:"
+    Then I should see "Year: '2011'"
+    Then I should see "Month: '1'"
+    Then I should see "Day: '1'"
+
+    When I go to "/tags/foo.html"
+    Then I should see "Tag: 'foo'"
+    Then I should not see "Year:"
+    Then I should not see "Month:"
+    Then I should not see "Day:"
+
+  Scenario: Calendar pages also get built
+    Given a successfully built app at "calendar-and-tag-app"
+    When I cd to "build"
+    Then the following files should exist:
+    | 2011.html       |
+    | 2011/01.html    |
+    | 2011/01/01.html |
+    | tags/foo.html   |
+
+    And the file "2011.html" should not contain "Tag:"
+    And the file "2011.html" should contain "Year: '2011'"
+    And the file "2011.html" should contain "Month: ''"
+    And the file "2011.html" should contain "Day: ''"
+
+    And the file "2011/01.html" should not contain "Tag:'"
+    And the file "2011/01.html" should contain "Year: '2011'"
+    And the file "2011/01.html" should contain "Month: '1'"
+    And the file "2011/01.html" should contain "Day: ''"
+
+    And the file "2011/01/01.html" should not contain "Tag:"
+    And the file "2011/01/01.html" should contain "Year: '2011'"
+    And the file "2011/01/01.html" should contain "Month: '1'"
+    And the file "2011/01/01.html" should contain "Day: '1'"
+
+    And the file "tags/foo.html" should contain "Tag: 'foo'"
+    And the file "tags/foo.html" should not contain "Year:"
+    And the file "tags/foo.html" should not contain "Month:"
+    And the file "tags/foo.html" should not contain "Day:"
+

data/features/calendar.feature

@@ -1,12 +1,19 @@
 Feature: Calendar pages
   Scenario: Calendar pages are accessible from preview server
     Given the Server is running at "calendar-app"
-    When I go to "/2011.html"
+    When I go to "/2011/01/01.html"
     Then I should see "/2011-01-01-new-article.html"
+    Then I should not see "/2011-01-02-another-article.html"
+    Then I should see "Year: '2011'"
+    Then I should see "Month: '1'"
+    Then I should see "Day: '1'"
+
+    When I go to "/2011/01/02.html"
+    Then I should not see "/2011-01-01-new-article.html"
     Then I should see "/2011-01-02-another-article.html"
     Then I should see "Year: '2011'"
-    Then I should see "Month: ''"
-    Then I should see "Day: ''"
+    Then I should see "Month: '1'"
+    Then I should see "Day: '2'"
 
     When I go to "/2011/01.html"
     Then I should see "/2011-01-01-new-article.html"
@@ -15,16 +22,68 @@ Feature: Calendar pages
     Then I should see "Month: '1'"
     Then I should see "Day: ''"
 
-    When I go to "/2011/01/01.html"
+    When I go to "/2011.html"
     Then I should see "/2011-01-01-new-article.html"
-    Then I should not see "/2011-01-02-another-article.html"
+    Then I should see "/2011-01-02-another-article.html"
     Then I should see "Year: '2011'"
-    Then I should see "Month: '1'"
-    Then I should see "Day: '1'"
+    Then I should see "Month: ''"
+    Then I should see "Day: ''"
 
-    When I go to "/2011/01/02.html"
+    When I go to "/index.html"
+    Then I should see "Year Path: '/2011.html'"
+    Then I should see "Month Path: '/2011/01.html'"
+    Then I should see "Day Path: '/2011/01/01.html'"
+
+  Scenario: Calendar pages are accessible from preview server with directory_indexes
+    Given a fixture app "calendar-app"
+    And app "calendar-app" is using config "directory-indexes"
+    And the Server is running
+    When I go to "/2011.html"
+    Then I should see "File Not Found"
+
+    When I go to "/2011/"
     Then I should not see "/2011-01-01-new-article.html"
-    Then I should see "/2011-01-02-another-article.html"
-    Then I should see "Year: '2011'"
-    Then I should see "Month: '1'"
-    Then I should see "Day: '2'"
+    Then I should see "/2011-01-01-new-article/"
+
+    When I go to "/index.html"
+    Then I should see "Year Path: '/2011/'"
+    Then I should see "Month Path: '/2011/01/'"
+    Then I should see "Day Path: '/2011/01/01/'"
+
+  Scenario: Calendar pages also get built
+    Given a successfully built app at "calendar-app"
+    When I cd to "build"
+    Then the following files should exist:
+    | 2011.html       |
+    | 2011/01.html    |
+    | 2011/01/01.html |
+    | 2011/01/02.html |
+
+    And the file "2011.html" should contain "/2011-01-01-new-article.html"
+    And the file "2011.html" should contain "/2011-01-02-another-article.html"
+    And the file "2011.html" should contain "Year: '2011'"
+    And the file "2011.html" should contain "Month: ''"
+    And the file "2011.html" should contain "Day: ''"
+
+    And the file "2011/01.html" should contain "/2011-01-01-new-article.html"
+    And the file "2011/01.html" should contain "/2011-01-02-another-article.html"
+    And the file "2011/01.html" should contain "Year: '2011'"
+    And the file "2011/01.html" should contain "Month: '1'"
+    And the file "2011/01.html" should contain "Day: ''"
+
+    And the file "2011/01/01.html" should contain "/2011-01-01-new-article.html"
+    And the file "2011/01/01.html" should not contain "/2011-01-02-another-article.html"
+    And the file "2011/01/01.html" should contain "Year: '2011'"
+    And the file "2011/01/01.html" should contain "Month: '1'"
+    And the file "2011/01/01.html" should contain "Day: '1'"
+
+    And the file "2011/01/02.html" should not contain "/2011-01-01-new-article.html"
+    And the file "2011/01/02.html" should contain "/2011-01-02-another-article.html"
+    And the file "2011/01/02.html" should contain "Year: '2011'"
+    And the file "2011/01/02.html" should contain "Month: '1'"
+    And the file "2011/01/02.html" should contain "Day: '2'"
+
+    And the file "index.html" should contain "Year Path: '/2011.html'"
+    And the file "index.html" should contain "Month Path: '/2011/01.html'"
+    And the file "index.html" should contain "Day Path: '/2011/01/01.html'"
+

data/features/future_date.feature

@@ -0,0 +1,36 @@
+Feature: Future-dated blog articles
+  Scenario: Future-dated articles show up in the preview server
+    Given the date is 2012-06-18
+    And the Server is running at "future-date-app"
+    When I go to "/2011/01/01/new-article.html"
+    Then I should see "Newer Article Content"
+    When I go to "/2012/06/19/future-article.html"
+    Then I should see "This is a future-dated article"
+    When I go to "/2012/06/19/future-article/example.txt"
+    Then I should see "Example Text"
+
+  Scenario: Future-dated articles don't show up when the environment is not :development
+    Given a fixture app "future-date-app"
+    And a file named "config.rb" with:
+      """
+      set :environment, :production
+      Time.zone = "Pacific Time (US & Canada)"
+      activate :blog do |blog|
+        blog.sources = "blog/:year-:month-:day-:title.html"
+      end
+      """
+    Given the date is 2012-06-18
+    And the Server is running at "future-date-app"
+    When I go to "/2011/01/01/new-article.html"
+    Then I should see "Newer Article Content"
+    When I go to "/2012/06/19/future-article.html"
+    Then I should see "Not Found"
+    When I go to "/2012/06/19/future-article/example.txt"
+    Then I should see "Not Found"
+
+    Given the date is 2012-06-20
+    And the Server is running at "future-date-app"
+    When I go to "/2012/06/19/future-article.html"
+    Then I should see "This is a future-dated article"
+    When I go to "/2012/06/19/future-article/example.txt"
+    Then I should see "Example Text"

data/features/layouts.feature

@@ -0,0 +1,21 @@
+Feature: Layouts
+  Background:
+    Given the Server is running at "layouts-app"
+  Scenario: The layout of a blog entry can be set in its front matter.
+    When I go to "/2011/01/01/first-article.html"
+    Then I should see "First Alternative Layout"
+    And I should see "First Article"
+    When I go to "/2011/01/01/second-article.html"
+    Then I should see "Second Alternative Layout"
+    And I should see "Second Article"
+    When I go to "/2011/01/01/third-article.html"
+    Then I should see "Third Alternative Layout"
+    And I should see "Third Article"
+  Scenario: The default blog layout is used if none is set in front matter.
+    When I go to "/2011/01/02/article-in-normal-layout.html"
+    Then I should see "Default Layout"
+    And I should see "New Article"
+  Scenario: Do not use a layout for the article if set to false in front matter.
+    When I go to "/2011/01/03/article-without-layout.html"
+    Then I should not see "Default Layout"
+    And I should see "Article Content"

data/features/no_date.feature

@@ -0,0 +1,9 @@
+Feature: Flexible article sources
+  Scenario: Blog sources may not include the date in the filename
+    Given the Server is running at "no-date-app"
+    When I go to "/2011/01/01/new-article.html"
+    Then I should see "/2011/01/01/new-article.html"
+    When I go to "/blog/new-article.html"
+    Then I should see "Not Found"
+    When I go to "/"
+    Then I should see "/2011/01/01/new-article.html"

data/features/paginate.feature

@@ -0,0 +1,157 @@
+Feature: Pagination
+  Scenario: Index pages are accessible from preview server
+    Given the Server is running at "paginate-app"
+    When I go to "/2011.html"
+    Then I should see "Paginate: true"
+    Then I should see "Article Count: 5"
+    Then I should see "Page Num: 1"
+    Then I should see "Num Pages: 2"
+    Then I should see "Per Page: 5"
+    Then I should see "Page Start: 1"
+    Then I should see "Page End: 5"
+    Then I should see "Next Page: '/2011/page/2.html'"
+    Then I should see "Prev Page: ''"
+    Then I should not see "/2011-01-01-test-article.html"
+    Then I should not see "/2011-01-02-test-article.html"
+    Then I should see "/2011-01-03-test-article.html"
+    Then I should see "/2011-01-04-test-article.html"
+    Then I should see "/2011-01-05-test-article.html"
+    Then I should see "/2011-02-01-test-article.html"
+    Then I should see "/2011-02-02-test-article.html"
+
+    When I go to "/2011/page/2.html"
+    Then I should see "Article Count: 2"
+    Then I should see "Page Num: 2"
+    Then I should see "Page Start: 6"
+    Then I should see "Page End: 7"
+    Then I should see "Next Page: ''"
+    Then I should see "Prev Page: '/2011.html'"
+    Then I should see "/2011-01-01-test-article.html"
+    Then I should see "/2011-01-02-test-article.html"
+    Then I should not see "/2011-01-03-test-article.html"
+    Then I should not see "/2011-01-04-test-article.html"
+    Then I should not see "/2011-01-05-test-article.html"
+    Then I should not see "/2011-02-01-test-article.html"
+    Then I should not see "/2011-02-02-test-article.html"
+
+    When I go to "/tags/bar.html"
+    Then I should see "Paginate: true"
+    Then I should see "Article Count: 2"
+    Then I should see "Page Num: 1"
+    Then I should see "Num Pages: 3"
+    Then I should see "Per Page: 2"
+    Then I should see "Page Start: 1"
+    Then I should see "Page End: 2"
+    Then I should see "Next Page: '/tags/bar/page/2.html'"
+    Then I should see "Prev Page: ''"
+    Then I should see "/2011-02-02-test-article.html"
+    Then I should see "/2011-02-01-test-article.html"
+    Then I should not see "/2011-02-05-test-article.html"
+    Then I should not see "/2011-01-04-test-article.html"
+    Then I should not see "/2011-01-03-test-article.html"
+
+  Scenario: Index pages are accessible from preview server, with pagination off
+    Given a fixture app "paginate-app"
+    And app "paginate-app" is using config "paginate-off"
+    And the Server is running
+    When I go to "/2011.html"
+    Then I should see "Paginate: false"
+    Then I should see "Article Count: 7"
+    Then I should see "/2011-01-01-test-article.html"
+    Then I should see "/2011-01-02-test-article.html"
+    Then I should see "/2011-01-03-test-article.html"
+    Then I should see "/2011-01-04-test-article.html"
+    Then I should see "/2011-01-05-test-article.html"
+    Then I should see "/2011-02-01-test-article.html"
+    Then I should see "/2011-02-02-test-article.html"
+
+    When I go to "/2011/page/2.html"
+    Then I should see "File Not Found"
+
+    When I go to "/tags/bar.html"
+    Then I should see "Paginate: false"
+    Then I should see "Article Count: 2"
+    Then I should see "/2011-02-02-test-article.html"
+    Then I should see "/2011-02-01-test-article.html"
+    Then I should not see "/2011-01-05-test-article.html"
+    Then I should not see "/2011-01-04-test-article.html"
+    Then I should not see "/2011-01-03-test-article.html"
+
+  Scenario: Index pages are accessible from preview server, with directory_indexes on
+    Given a fixture app "paginate-app"
+    And app "paginate-app" is using config "directory-indexes"
+    And the Server is running
+    When I go to "/2011.html"
+    Then I should see "File Not Found"
+
+    When I go to "/2011/"
+    Then I should see "Next Page: '/2011/page/2/'"
+    Then I should not see "/2011-01-03-test-article.html"
+    Then I should see "/2011-01-03-test-article/"
+
+    When I go to "/2011/page/2/"
+    Then I should see "Prev Page: '/2011/'"
+
+    When I go to "/tags/bar/"
+    Then I should see "Next Page: '/tags/bar/page/2/'"
+
+  Scenario: Index pages also get built
+    Given a successfully built app at "paginate-app"
+    When I cd to "build"
+    Then the following files should exist:
+    | tags/foo.html        |
+    | tags/bar.html        |
+    | tags/bar/page/2.html |
+    | tags/bar/page/3.html |
+    | 2011.html            |
+    | 2011/page/2.html     |
+    Then the following files should not exist:
+    | tags.html     |
+    | calendar.html |
+
+    And the file "2011/page/2.html" should contain "Year: '2011'"
+    And the file "2011/page/2.html" should contain "Month: ''"
+    And the file "2011/page/2.html" should contain "Day: ''"
+    And the file "2011/page/2.html" should contain "Article Count: 2"
+    And the file "2011/page/2.html" should contain "/2011-01-02-test-article.html"
+    And the file "2011/page/2.html" should contain "/2011-01-01-test-article.html"
+
+    And the file "tags/bar/page/2.html" should contain "Tag: bar"
+    And the file "tags/bar/page/2.html" should contain "Article Count: 2"
+    And the file "tags/bar/page/2.html" should contain "Prev Page: '/tags/bar.html'"
+    And the file "tags/bar/page/2.html" should contain "Next Page: '/tags/bar/page/3.html'"
+    And the file "tags/bar/page/2.html" should contain "/2011-01-05-test-article.html"
+    And the file "tags/bar/page/2.html" should contain "/2011-01-04-test-article.html"
+
+    And the file "tags/bar/page/3.html" should contain "Tag: bar"
+    And the file "tags/bar/page/3.html" should contain "Article Count: 1"
+    And the file "tags/bar/page/3.html" should contain "Prev Page: '/tags/bar/page/2.html'"
+    And the file "tags/bar/page/3.html" should contain "Next Page: ''"
+    And the file "tags/bar/page/3.html" should contain "/2011-01-03-test-article.html"
+
+  Scenario: Adding a tag to a post in preview adds a new index page
+    Given the Server is running at "paginate-app"
+    When I go to "/tags/foo.html"
+    Then I should see "/2011-01-01-test-article.html"
+    Then I should see "Next Page: ''"
+
+    When I go to "/tags/foo/page/2.html"
+    Then I should see "Not Found"
+
+    And the file "source/blog/2011-02-03-new-article.html.markdown" has the contents
+      """
+      ---
+      title: "Newest Article"
+      date: 2011-02-03
+      tags: foo
+      ---
+
+      Newer Article Content
+      """
+    When I go to "/tags/foo.html"
+    Then I should see "Next Page: '/tags/foo/page/2.html'"
+    Then I should see "/2011-02-03-new-article.html"
+    Then I should not see "/2011-01-01-test-article.html"
+
+    When I go to "/tags/foo/page/2.html"
+    Then I should see "/2011-01-01-test-article.html"

data/features/published.feature

@@ -0,0 +1,33 @@
+Feature: Unpublished blog articles
+  Scenario: Unpublished articles show up in the preview server
+    Given the Server is running at "published-app"
+    When I go to "/2011/01/01/new-article.html"
+    Then I should see "Newer Article Content"
+    When I go to "/2012/06/19/draft-article.html"
+    Then I should see "This is a draft"
+    When I go to "/2012/06/19/draft-article/example.txt"
+    Then I should see "Example Text"
+
+  Scenario: Unpublished articles don't show up when the environment is not :development
+    Given a fixture app "published-app"
+    And a file named "config.rb" with:
+      """
+      set :environment, :production
+      activate :blog do |blog|
+        blog.sources = "blog/:year-:month-:day-:title.html"
+      end
+      """
+    Given the Server is running at "published-app"
+    When I go to "/2012/06/19/draft-article.html"
+    Then I should see "Not Found"
+    When I go to "/2012/06/19/draft-article/example.txt"
+    Then I should see "Not Found"
+
+  Scenario: Unpublished articles don't get built
+    Given a successfully built app at "published-app"
+    When I cd to "build"
+    Then the following files should not exist:
+      | 2012/06/19/draft-article.html        |
+      | 2012/06/19/draft-article/example.txt |
+    Then the following files should exist:
+      | 2011/01/01/new-article.html          |