Metadata-Version: 2.0
Name: pelican-githubprojects
Version: 0.1.0
Summary: Embed a list of your public GitHub projects in your pages
Home-page: https://github.com/kura/pelican-githubprojects
Author: Kura
Author-email: kura@kura.io
License: MIT
Download-URL: https://github.com/kura/pelican-githubprojects/archive/0.1.0.zip
Platform: linux
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing

=======================
Pelican Github Projects
=======================

Embed a list of your public GitHub projects in your pages.

Installation
============

To install pelican-githubprojects, simply install it from PyPI:

.. code-block:: bash

    $ pip install pelican-githubprojects

Configuration
=============

Enable the plugin in your pelicanconf.py

.. code-block:: python

    PLUGINS = [
        # ...
        'pelican_githubprojects',
        # ...
    ]

Add a setting with your GitHub username.

.. code-block:: python

    GITHUB_USER = 'kura'

Available data
==============

:name:
    The name of your project.
:language:
    The language your project is written in, information on how GitHub detects
    languages is `available here
    <https://help.github.com/articles/my-repository-is-marked-as-the-wrong-language>`_.
    It is GitHub that detects the language, not this plugin. So please, no
    issues about that.
:description:
    The description of your project (as set on GitHub.)
:homepage:
    The homepage of your project (as set on GitHub.)
:github_url:
    The web page URL of your project on GitHub (not the GIT or API URL.)

Usage
=====

In your templates you will be able to iterate over the `github_projects`
variable, as below.

.. code-block:: html

    {% if GITHUB_USER %}
        <h1>Projects</h1>
        {% for project in github_projects %}
            <h2>{{ project.name }} <sup>({{ project.language }})</sup></h2>
            <p>{{ project.description }}</p>
            <p>
                <a href="{{ project.homepage }}">Homepage</a>
                <a href="{{ project.github_url }}">GitHub</a>
            </p>
        {% endfor %}
    {% endif %}


License
=======

`MIT`_ license.

.. _MIT: http://opensource.org/licenses/MIT


