Skip to content

Latest commit

 

History

History

neighbors

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
test_data
test_data
 
 
Readme.rst
Readme.rst
 
 
__init__.py
__init__.py
 
 
neighbors.py
neighbors.py
 
 
test_neighbors.py
test_neighbors.py
 
 

Readme.rst

Neighbor Articles Plugin for Pelican

NOTE: This plugin has been moved to its own repository. Please file any issues/PRs there. Once all plugins have been migrated to the new Pelican Plugins organization, this monolithic repository will be archived.

This plugin adds next_article (newer) and prev_article (older) variables to the article's context.

Also adds next_article_in_category and prev_article_in_category.

Usage

 <ul>
 {% if article.prev_article %}
     <li>
         <a href="{{ SITEURL }}/{{ article.prev_article.url}}">
             {{ article.prev_article.title }}
         </a>
     </li>
 {% endif %}
 {% if article.next_article %}
     <li>
         <a href="{{ SITEURL }}/{{ article.next_article.url}}">
             {{ article.next_article.title }}
         </a>
     </li>
 {% endif %}
</ul>
<ul>
 {% if article.prev_article_in_category %}
     <li>
         <a href="{{ SITEURL }}/{{ article.prev_article_in_category.url}}">
             {{ article.prev_article_in_category.title }}
         </a>
     </li>
 {% endif %}
 {% if article.next_article_in_category %}
     <li>
         <a href="{{ SITEURL }}/{{ article.next_article_in_category.url}}">
             {{ article.next_article_in_category.title }}
         </a>
     </li>
 {% endif %}
 </ul>

Usage with the Subcategory plugin

If you want to get the neigbors within a subcategory it's a little different. Since an article can belong to more than one subcategory, subcategories are stored in a list. If you have an article with subcategories like

Category/Foo/Bar

it will belong to both subcategory Foo, and Foo/Bar. Subcategory neighbors are added to an article as next_article_in_subcategory# and prev_article_in_subcategory# where # is the level of subcategory. So using the example from above, subcategory1 will be Foo, and subcategory2 Foo/Bar. Therefor the usage with subcategories is:

 <ul>
 {% if article.prev_article_in_subcategory1 %}
     <li>
         <a href="{{ SITEURL }}/{{ article.prev_article_in_subcategory1.url}}">
             {{ article.prev_article_in_subcategory1.title }}
         </a>
     </li>
 {% endif %}
 {% if article.next_article_in_subcategory1 %}
     <li>
         <a href="{{ SITEURL }}/{{ article.next_article_in_subcategory1.url}}">
             {{ article.next_article_in_subcategory1.title }}
         </a>
     </li>
 {% endif %}
</ul>
<ul>
 {% if article.prev_article_in_subcategory2 %}
     <li>
         <a href="{{ SITEURL }}/{{ article.prev_article_in_subcategory2.url}}">
             {{ article.prev_article_in_subcategory2.title }}
         </a>
     </li>
 {% endif %}
 {% if article.next_article_in_subcategory2 %}
     <li>
         <a href="{{ SITEURL }}/{{ article.next_article_in_subcategory2.url}}">
             {{ article.next_article_in_subcategory2.title }}
         </a>
     </li>
 {% endif %}
 </ul>