jekyll-paginate-v2 1.4.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d2151298586fb30e325abf19b2f4f2feb050581d
-  data.tar.gz: d01e27f2e65eaa820a194e4a261f1668839d75be
+  metadata.gz: 5815a5929c866dd11ae6f027f4f3d58bbd584f3f
+  data.tar.gz: 7d261bcb4d2089d8f196f0ddc71a7961992bbc5d
 SHA512:
-  metadata.gz: 15b28be37affd98b4b18709747afaf3d7e4ab85cc22541b5549c6b34bedd1e3f531c7e52fc3b20937643371e99fcaa0f15f056a37295d778925342045fc5aef7
-  data.tar.gz: 422190d1e73563def30150c4a4173e4cbbc267b9e123c3bd93cc74da93f99c8b98e2f3c5f22b4be492d3f27169143c0568e5749690e7bf81786efa9eaead52a7
+  metadata.gz: c18ad4a94390fd030c278ca84beceffe32643926775ca7596679278658ab7665a19f55fffe76662261f88f1e4d725ab6482f5d2e86ddd0d681ec939f9e1f8c1c
+  data.tar.gz: 823ab882ae1fa5342fd8eca1554b6b921c29abecd585967224c77717edd5e2ab6162b254a6d72fbe791893c3d879cade61d3d611690346285122f48240edd52d

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at [jekyll@sverrirs.com](mailto:jekyll@sverrirs.com). All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/README.md

@@ -76,6 +76,9 @@ pagination:
   # Site-wide kill switch, disabled here it doesn't run at all 
   enabled: true
 
+  # The default document collection to paginate if nothing is specified ('posts' is default)
+  collection: 'posts'
+
   # How many objects per paginated page, used to be `paginate` (default: 0, means all)
   per_page: 10
 
@@ -176,6 +179,59 @@ See more about the old style of pagination at the [jekyll-paginate](https://gith
 
 > :bangbang: **Warning** Backwards compatibility with the old jekyll-paginate gem is currently scheduled to be removed after **1st January 2018**. Users will start receiving warning log messages when running jekyll two months before this date.
 
+## Paginating collections
+By default the pagination system only paginates `posts`. If you only have `posts` and `pages` in your site you don't need to worry about a thing, everything will work as intended without you configuring anything. 
+
+However if you use document collections, or would like to, then this pagination gem offers extensive support for paginating documents in one or more collections at the same time. 
+
+> Collections are groups of documents that belong together but should not be grouped by date. 
+> See more about ['collections'](http://ben.balter.com/2015/02/20/jekyll-collections/) on Ben Balters blog.
+
+### Paginating a single collection
+
+Lets expand on Ben's collection discussion (linked above). Let's say that you have hundreds of cupcake pages in your cupcake collection. To create a pagination page for only documents from the cupcake collection you would do this
+
+``` yml
+---
+layout: page
+title: All Cupcakes
+pagination: 
+  enabled: true
+  collection: cupcakes
+---
+```
+
+### Paginating multiple collections
+
+Lets say that you want to create a single pagination page for only small cakes on your page (you have both cupcakes and cookies to sell). You could do that like this
+
+``` yml
+---
+layout: page
+title: Lil'bits
+pagination: 
+  enabled: true
+  collection: cupcakes, cookies
+---
+```
+
+### The special 'all' collection
+
+Now your site has grown and you have multiple cake collections on it and you want to have a single page that paginates all of your collections at the same time. 
+You can use the special `all` collection name for this.
+
+``` yml
+---
+layout: page
+title: All the Cakes!
+pagination: 
+  enabled: true
+  collection: all
+---
+```
+
+> Note: Due to the `all` keyword being reserved for this feature, you cannot have a collection called `all` in your site configuration. Sorry. 
+
 
 ## Paginate categories, tags, locales
 
@@ -394,10 +450,10 @@ Make absolutely sure that your pagination permalink paths do not clash with any
 
 ## Issues / to-be-completed
 * Incomplete unit-tests 
-* Missing integration tests [#2](https://github.com/jekyll/jekyll-paginate/pull/2)
-* Missing more detailed examples
-* Unable to auto-generate category/tag/language pagination pages. Still requires programmer to specify the pages him/herself.
+* No integration tests [#2](https://github.com/jekyll/jekyll-paginate/pull/2)
 * _Exclude_ filter not implemented [#6](https://github.com/jekyll/jekyll-paginate/issues/6)
+* Pagination for [Collections](http://ben.balter.com/2015/02/20/jekyll-collections/) not implemented yet
+* Feature being considered is to auto-generate category/tag/language pagination pages. Project still requires programmer to specify the pages him/herself.
 
 ## Contributing
 

data/examples/03-tags/README.md

@@ -1,6 +1,8 @@
-# Example 03::Tag pagination
+# Example 03::Tag and Collection pagination
 
-This example bookshop website expands on the category example and adds pagination by both category and tags. The site uses the pretty permalink structure. It also demonstrates advanced sorting features such as nested fields. 
+This example bookshop website uses collections to organize its books^*. The site relies on pagination of its books by both collections and tags. The site shows how to paginate by single, multiple or all collections at the same time. 
+
+The site uses the pretty permalink structure. It also demonstrates advanced sorting features such as nested fields. 
 
 <p align="center">
   <img src="https://raw.githubusercontent.com/sverrirs/jekyll-paginate-v2/master/examples/img/03-example-screenshot-main.png" />
@@ -13,11 +15,13 @@ After generating the pagination gem was installed using
 gem install jekyll-paginate-v2
 ```
 
+^* _It could be argued that the bookstore should have just used categories here and collections were better suited to separate things into 'books', 'DVDs', 'Games' etc..._
+
 ## Structure
 
-The site has four types of post categories `biography/_posts`, `blog/_posts`, `fantasy/_posts`, `romance/_posts`. 
+The site has three types of document collections `_biography/`, `_fantasy/`, `_romance/`. In addition to that the bookstore also has a blog and those posts are stored under `blog/_posts`. 
 
-All book posts have assigned multiple tags to them.
+All books have multiple tags assigned to them.
 
 Permalinks are configured to the `pretty` format site-wide. The pagination logic handles this configuration without problems and constructs the correct sub url structure.
 
@@ -34,9 +38,12 @@ Pagination pages are:
 
 Most pages are self explanatory and most sort books by the nested attribute `rank`.
 
-### byisbn.md 
+### Page: byisbn.md 
 Demonstrates how to have multiple pagination pages defined in the root of the site without their pagination pages clashing. Uses permalinks to achieve this.
 
+### Page: Under tags/
+Demonstrate how to paginate across multiple collections by using the `collections: all` front matter configuration
+
 ## Setup Configuration
 The gem is added to the `_config.yml` file under
 ``` yml

data/examples/03-tags/{biography/_posts/2016-10-27-princess-diarist-the.md → _biography/all/princess-diarist-the.md}

@@ -14,7 +14,7 @@ book:
 price: 
   usd: 22.19
   eur: 20.97
-tags: Memoirs,Films,Autobiography,Actors
+tags: Memoirs,Films,Autobiography,Actors,Science Fiction
 ---
 
 The Princess Diarist is Carrie Fisher's intimate, hilarious and revealing recollection of what happened behind the scenes on one of the most famous film sets of all time, the first Star Wars movie. 

data/examples/03-tags/{biography → _biography}/biography-musicians.md

@@ -3,7 +3,7 @@ layout: home
 title: Biographies by Musicians
 pagination: 
   enabled: true
-  category: biography
+  collection: biography
   tag: Musicians
   permalink: /:num/
   sort_field: 'book:rank'

data/examples/03-tags/{biography/biography.md → _biography/index.md}

@@ -3,7 +3,7 @@ layout: home
 title: Biographies by Rank
 pagination: 
   enabled: true
-  category: biography
+  collection: biography
   permalink: /:num/
   sort_field: 'book:rank'
   sort_reverse: false

data/examples/03-tags/_config.yml

@@ -30,6 +30,18 @@ exclude:
   - Gemfile
   - Gemfile.lock
   
+# Collection configurations
+collections:
+  biography:
+    output: true
+    permalink: /biography/:path/
+  fantasy:
+    output: true
+    permalink: /fantasy/:path/
+  romance: 
+    output: true
+    permalink: /romance/:path/
+  
 # This site uses the pretty permalink structure, this renders all urls with a slash / at the end and 
 # no file endings, I guess that is considered pretty :)
 permalink: pretty

data/examples/03-tags/_layouts/home.html

@@ -20,7 +20,7 @@ layout: default
     -->
     {% for post in paginator.posts %}
       <li>
-        <span class="post-meta">{{ post.date | date: "%b %-d, %Y" }}{% if post.book.rank %} | Rank: {{ post.book.rank }}{% endif %}{% if post.categories %} | {{ post.categories }}{% endif %}{% if post.tags %}<br>Tags: {{ post.tags }}{% endif %}</span>
+        <span class="post-meta">{{ post.date | date: "%b %-d, %Y" }}{% if post.book.rank %} | Rank: {{ post.book.rank }}{% endif %}{% if post.collection %} | {{ post.collection }}{% endif %}{% if post.tags %}<br>Tags: {{ post.tags }}{% endif %}</span>
         <h2>
           <a class="post-link" href="{{ post.url | relative_url }}">{{ post.title | escape }}</a>
         </h2>

data/examples/03-tags/_layouts/post.html

@@ -6,7 +6,7 @@ layout: default
   <header class="post-header">
     <h1 class="post-title" itemprop="name headline">{{ page.title | escape }}</h1>
     <p class="post-meta"><time datetime="{{ page.date | date_to_xmlschema }}" itemprop="datePublished">{{ page.date | date: "%b %-d, %Y" }}</time>{% if page.author %} • <span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">{{ page.author }}</span></span>{% endif %}
-    {% if page.book.rank %} • Rank: {{ page.book.rank }}{% endif %}{% if page.categories %}<br>Category: {{ page.categories }}{% endif %}{% if page.tags %}<br>Tags: {{ page.tags }}{% endif %}</p>
+    {% if page.book.rank %} • Rank: {{ page.book.rank }}{% endif %}{% if page.collection %}<br>Collection: {{ page.collection }}{% endif %}{% if page.tags %}<br>Tags: {{ page.tags }}{% endif %}</p>
   </header>
 
   <div class="post-content" itemprop="articleBody">

data/examples/03-tags/{romance → _romance}/romance-historical.md

@@ -3,7 +3,7 @@ layout: home
 title: Historical Romance
 pagination: 
   enabled: true
-  category: romance
+  collection: romance
   tag: historical, fiction
   per_page: 2
   permalink: /:num/

data/examples/03-tags/byisbn.md

@@ -4,6 +4,7 @@ title: By ISBN
 permalink: /isbn/
 pagination: 
   enabled: true
+  collection: all
   permalink: '/:num/'
   sort_field: 'book:ISBN13'
   sort_reverse: false

data/examples/03-tags/index.md

@@ -6,6 +6,7 @@ layout: home
 title: Home
 pagination: 
   enabled: true
+  collection: biography, fantasy, romance
   sort_field: 'title'
   sort_reverse: false
 ---

data/examples/03-tags/tags/contemporary.md

@@ -3,6 +3,7 @@ layout: home
 title: Contemporary
 pagination: 
   enabled: true
+  collection: all
   tag: contemporary
   permalink: /:num/
 ---

data/examples/03-tags/tags/fantasy.md

@@ -3,6 +3,7 @@ layout: home
 title: Fantasy
 pagination: 
   enabled: true
+  collection: all
   tag: fantasy
   permalink: /:num/
   sort_field: 'book:rank'

data/examples/03-tags/tags/sci-fi.md

@@ -3,6 +3,7 @@ layout: home
 title: Sci-Fi
 pagination: 
   enabled: true
+  collection: fantasy,romance
   tag: Science, Fiction
   per_page: 2
   permalink: /:num/
@@ -10,4 +11,6 @@ pagination:
   sort_reverse: false
 ---
 
-All books tagged with _science_ and _fiction_
+All books in the _fantasy_ and _romance_ collections that are tagged with _science_ and _fiction_
+
+This should exclude the Biography "The Princess Diarist"

data/examples/README.md

@@ -14,8 +14,10 @@ This example also demonstrates how the page can operate as a zero-config replace
 ## Example 2: Category Pagination
 Car site that has multiple paginated pages and multiple post categories.
 
-## Example 3: Tag Pagination
-Book review site that organizes its content by tags and categories. Uses the `pretty` permalink structure for the site.
+## Example 3: Tag and Collection Pagination
+Book review site that organizes its content into collections and by tags. Uses the `pretty` permalink structure for the site.
+
+This site demonstrates how the pagination logic handles paginating across one or more collections at the same time. The pagination can also paginate over all collections. 
 
 This site also demonstrates how to sort posts by nested front-matter attributes.
 

data/lib/jekyll-paginate-v2/paginationGenerator.rb

@@ -51,18 +51,39 @@ module Jekyll
         
         Jekyll.logger.debug "Pagination:","Starting"
 
-        ################# 1 ###################
-        # Extract the necessary information out of the site object and then instantiate the model
-
-        # Get all posts that will be generated (excluding hidden posts that have hidden:true in the front matter)
-        all_posts = site.site_payload['site']['posts'].reject { |post| post['hidden'] }
-
+        ################ 0 #################### 
         # Get all pages in the site (this will be used to find the pagination templates)
         all_pages = site.pages
 
         # Get the default title of the site (used as backup when there is no title available for pagination)
         site_title = site.config['title']
 
+        ################ 1 #################### 
+        # Specify the callback function that returns the correct docs/posts based on the collection name
+        # "posts" are just another collection in Jekyll but a specialized version that require timestamps
+        # This collection is the default and if the user doesn't specify a collection in their front-matter then that is the one we load
+        # If the collection is not found then empty array is returned
+        collection_by_name_lambda = lambda do |collection_name|
+          coll = []
+          if collection_name == "all"
+            # the 'all' collection_name is a special case and includes all collections in the site (except posts!!)
+            # this is useful when you want to list items across multiple collections
+            for coll_name, coll_data in site.collections
+              if( !coll_data.nil? && coll_name != 'posts')
+                coll += coll_data.docs.select { |doc| !doc.data.has_key?('pagination') } # Exclude all pagination pages
+              end
+            end
+          else
+            # Just the one collection requested
+            if !site.collections.has_key?(collection_name)
+              return []
+            end
+
+            coll = site.collections[collection_name].docs.select { |doc| !doc.data.has_key?('pagination') } # Exclude all pagination pages
+          end
+          return coll
+        end
+
         ################ 2 ####################
         # Create the proc that constructs the real-life site page
         # This is necessary to decouple the code from the Jekyll site object
@@ -101,9 +122,10 @@ module Jekyll
         # Now create and call the model with the real-life page creation proc and site data
         model = PaginationModel.new()
         if( default_config['legacy'] ) #(REMOVE AFTER 2018-01-01)
+          all_posts = site.site_payload['site']['posts'].reject { |post| post['hidden'] }
           model.run_compatability(default_config, all_pages, site_title, all_posts, page_create_lambda, logging_lambda) #(REMOVE AFTER 2018-01-01)
         else
-          model.run(default_config, all_pages, site_title, all_posts, page_create_lambda, logging_lambda, page_remove_lambda)
+          model.run(default_config, all_pages, site_title, page_create_lambda, logging_lambda, page_remove_lambda, collection_by_name_lambda)
         end
 
       end

data/lib/jekyll-paginate-v2/paginationModel.rb

@@ -3,7 +3,7 @@ module Jekyll
 
     class PaginationModel
 
-      def run(default_config, site_pages, site_title, all_posts, page_create_lambda, logging_lambda, page_remove_lambda)
+      def run(default_config, site_pages, site_title, page_create_lambda, logging_lambda, page_remove_lambda, collection_by_name_lambda)
         # By default if pagination is enabled we attempt to find all index.html pages in the site
         templates = self.discover_paginate_templates(site_pages)
         if( templates.size.to_i <= 0 )
@@ -12,13 +12,6 @@ module Jekyll
           return
         end
 
-        # Create the necessary indexes for the posts
-        all_categories = self.index_posts_by(all_posts, 'categories')
-        all_categories['posts'] = all_posts; # Populate a category for all posts 
-                                             # (this is a default and must not be used in the category system)
-        all_tags = self.index_posts_by(all_posts, 'tags')
-        all_locales = self.index_posts_by(all_posts, 'locale')
-
         # Now for each template page generate the paginator for it
         for template in templates
           # All pages that should be paginated need to include the pagination config element
@@ -30,6 +23,19 @@ module Jekyll
             # were generated automatically and which weren't
             if( template_config['enabled'] )
               logging_lambda.call "found page: "+template.path
+
+              # Request all documents in all collections that the user has requested 
+              all_posts = self.get_docs_in_collections(template_config['collection'], collection_by_name_lambda)
+
+              # Create the necessary indexes for the posts
+              all_categories = self.index_posts_by(all_posts, 'categories')
+              all_categories['posts'] = all_posts; # Populate a category for all posts (this is here for backward compatibility, do not use this as it will be decommissioned 2018-01-01) 
+                                                  # (this is a default and must not be used in the category system)
+              all_tags = self.index_posts_by(all_posts, 'tags')
+              all_locales = self.index_posts_by(all_posts, 'locale')
+
+              # TODO: NOTE!!! This whole request for posts and indexing results could be cached to improve performance, leaving like this for now during testing
+
               # Now construct the pagination data for this template page
               #self.paginate(site, template, template_config, all_posts, all_tags, all_categories, all_locales)
               self.paginate(template, template_config, site_title, all_posts, all_tags, all_categories, all_locales, page_create_lambda, logging_lambda, page_remove_lambda)
@@ -66,6 +72,25 @@ module Jekyll
           "an index.html page to use as the pagination page. Skipping pagination.", "warn"
         end
       end # function run_compatability (REMOVE AFTER 2018-01-01)
+
+      # Returns the combination of all documents in the collections that are specified
+      # raw_collection_names can either be a list of collections separated by a ',' or ' ' or a single string
+      def get_docs_in_collections(raw_collection_names, collection_by_name_lambda)
+        if raw_collection_names.is_a?(String)
+          collection_names = raw_collection_names.split(/;|,|\s/)
+        else
+          collection_names = raw_collection_names
+        end
+
+        docs = []
+        # Now for each of the collections get the docs
+        for coll_name in collection_names
+          # Request all the documents for the collection in question, and join it with the total collection 
+          docs += collection_by_name_lambda.call(coll_name.downcase.strip)
+        end
+
+        return docs
+      end
       
       #
       # Rolls through all the pages passed in and finds all pages that have pagination enabled on them.

data/lib/jekyll-paginate-v2/version.rb

@@ -1,8 +1,8 @@
 module Jekyll
   module PaginateV2
-    VERSION = "1.4.0"
+    VERSION = "1.5.0"
     # When modifying remember to issue a new tag command in git before committing, then push the new tag
-    # git tag -a v1.4.0 -m "Gem v1.4.0"
+    # git tag -a v1.5.0 -m "Gem v1.5.0"
     # git push origin --tags
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-paginate-v2
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Sverrir Sigmundarson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-30 00:00:00.000000000 Z
+date: 2016-12-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -63,6 +63,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE
 - README.md
@@ -103,34 +104,34 @@ files:
 - examples/02-category/toyota/index.md
 - examples/03-tags/Gemfile
 - examples/03-tags/README.md
+- examples/03-tags/_biography/all/born-to-run.md
+- examples/03-tags/_biography/all/forty-autumns.md
+- examples/03-tags/_biography/all/life-in-questions-a.md
+- examples/03-tags/_biography/all/not-dead-yet.md
+- examples/03-tags/_biography/all/princess-diarist-the.md
+- examples/03-tags/_biography/all/when-breath-becomes-air.md
+- examples/03-tags/_biography/biography-musicians.md
+- examples/03-tags/_biography/index.md
 - examples/03-tags/_config.yml
+- examples/03-tags/_fantasy/all/harry-potter-deathly-hallows.md
+- examples/03-tags/_fantasy/all/harry-potter-philosophers-stone.md
+- examples/03-tags/_fantasy/all/mistborn-trilogy.md
+- examples/03-tags/_fantasy/all/ready-player-one.md
+- examples/03-tags/_fantasy/all/sword-of-destiny.md
+- examples/03-tags/_fantasy/all/terry-pratchet-diary-2017.md
 - examples/03-tags/_includes/header.html
 - examples/03-tags/_layouts/home.html
 - examples/03-tags/_layouts/post.html
-- examples/03-tags/biography/_posts/2016-10-27-born-to-run.md
-- examples/03-tags/biography/_posts/2016-10-27-forty-autumns.md
-- examples/03-tags/biography/_posts/2016-10-27-life-in-questions-a.md
-- examples/03-tags/biography/_posts/2016-10-27-not-dead-yet.md
-- examples/03-tags/biography/_posts/2016-10-27-princess-diarist-the.md
-- examples/03-tags/biography/_posts/2016-10-27-when-breath-becomes-air.md
-- examples/03-tags/biography/biography-musicians.md
-- examples/03-tags/biography/biography.md
+- examples/03-tags/_romance/all/breath-of-snow-and-ashes-a.md
+- examples/03-tags/_romance/all/dressmaker-the.md
+- examples/03-tags/_romance/all/fiery-cross-the.md
+- examples/03-tags/_romance/all/it-ends-with-us.md
+- examples/03-tags/_romance/all/outlander-novel.md
+- examples/03-tags/_romance/all/virgins-outlander-short-story.md
+- examples/03-tags/_romance/romance-historical.md
 - examples/03-tags/blog/_posts/2016-09-30-welcome-to-jekyll-paginate-v2.md
 - examples/03-tags/byisbn.md
-- examples/03-tags/fantasy/_posts/2016-10-27-harry-potter-deathly-hallows.md
-- examples/03-tags/fantasy/_posts/2016-10-27-harry-potter-philosophers-stone.md
-- examples/03-tags/fantasy/_posts/2016-10-27-mistborn-trilogy.md
-- examples/03-tags/fantasy/_posts/2016-10-27-ready-player-one.md
-- examples/03-tags/fantasy/_posts/2016-10-27-sword-of-destiny.md
-- examples/03-tags/fantasy/_posts/2016-10-27-terry-pratchet-diary-2017.md
 - examples/03-tags/index.md
-- examples/03-tags/romance/_posts/2016-10-27-breath-of-snow-and-ashes-a.md
-- examples/03-tags/romance/_posts/2016-10-27-dressmaker-the.md
-- examples/03-tags/romance/_posts/2016-10-27-fiery-cross-the.md
-- examples/03-tags/romance/_posts/2016-10-27-it-ends-with-us.md
-- examples/03-tags/romance/_posts/2016-10-27-outlander-novel.md
-- examples/03-tags/romance/_posts/2016-10-27-virgins-outlander-short-story.md
-- examples/03-tags/romance/romance-historical.md
 - examples/03-tags/tags/contemporary.md
 - examples/03-tags/tags/fantasy.md
 - examples/03-tags/tags/sci-fi.md