projectlist

A tag plug-in for Jekyll

This plug-in introduces the new tag projectlist to Jekyll. It loads all files in the _projects directory and renders the entries into a single tag response, thus avoiding the creation of separate posts.

As of version 1.3.0, Jekyll has a feature called "data files" which makes this plug-in obsolete and is also more flexibe. You can still find the original version in the old master branch, which will no longer be maintained.

Using Jekyll's data files to create a list of projects

_data/projects.yml

- title: "Dummy project"
  link: http://www.example.com
  categories:
  - Jekyll
  - Dummy
  - Project
  content: Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt …

- title: "Jekyll projectlist plug-in"
  link:
  download: https://github.com/fhemberger/jekyll-projectlist/zipball/master
  github: http://github.com/fhemberger/jekyll-projectlist
  categories:
  - Jekyll
  - Ruby
  content: This plug-in introduces the new tag `projectlist` to Jekyll. It loads all files in the `_projects` directory and renders the entries into a single tag response, thus avoiding the creation of separate posts.

This data can be accessed via site.data.projects (notice that the filename determines the variable name).

You can now render the list of projects in a template:

<ul>
{% for project in site.data.projects %}
  <li>
    <h3>{% if project.link %}<a href="{{ project.link }}">{{ project.title }}</a>{% else %}{{ project.title }}{% endif %}</h3>
    {{ project.content }}
    {% if project.github or project.categories %}
    <ul class="metadata">
      {% if project.github %}<li><a href="{{ project.github }}">GitHub</a></li>{% endif %}
      <li>{{ project.categories | join:', ' }}</li>
    </ul>
    {% endif %}
  </li>
{% endfor %}
</ul>