Metadata-Version: 2.1
Name: pelican-git
Version: 0.1.13
Summary: Easily embed Github files in your Pelican articles.
Home-page: https://github.com/minhhh/pelican_git
Author: Ha.Minh
Author-email: minhhh@minhhuyha.info
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Text Processing
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Requires-Dist: setuptools
Requires-Dist: requests (>=2.2.0)
Requires-Dist: beautifulsoup4
Requires-Dist: jinja2

Pelican Git
===========

Pelican Git is a library that makes it easy to embed GitHub files in your Pelican_ blogs using simple syntax.

Installation
------------

To install ``pelican-git``, simply use ``pip``:

.. code-block:: bash

    $ pip install pelican-git

Then add a bit of code to your ``pelican`` configuration file:

.. code-block:: python

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

Usage
-----

In your articles, add lines to your posts that look like:

.. code-block:: html

    [git:repo=yourname/yourrepo,file=somefile,branch=master,hash=xxxxxxx]

``branch`` and ``hash`` are optional. If you don't specify ``branch``, it will be ``master``. If you specify ``hash`` it will overwrite the ``branch`` setting.

The generated code will embed ``css`` and ``html`` content directly into a ``div`` and replace the original tag. This is faster and cleaner than using ``javascript`` to rewrite the page content like what gist_it_ does.

Settings
--------

``GIT_CACHE_ENABLED`` - Specifies whether to cache the git files on disk or not. Default is ``False``. (Optional)

Testing
---------

.. code-block:: bash

    $ make install
    $ make test


Authors
---------

Ha.Minh_

Inspired by pelican_gist_

Changelog
---------

0.1.13
~~~~~~
Fixed
^^^^^
- Fixed error when fetching github HTML

Changed
^^^^^^^
- Support Python 3.6


0.1.8
~~~~~~
Fixed
^^^^^^^
- Fix link to original repo


0.1.0
~~~~~~
dded
^^^^^^^
- Initial version


License
-------

Uses the `MIT`_ license.


.. _Pelican: http://blog.getpelican.com/
.. _MIT: http://opensource.org/licenses/MIT
.. _pelican_gist: https://github.com/streeter/pelican-gist
.. _gist_it: https://github.com/minhhh/gist-it
.. _Ha.Minh: http://minhhh.github.io


.. image:: https://d2weczhvl823v0.cloudfront.net/minhhh/pelican_git/trend.png
   :alt: Bitdeli badge
   :target: https://bitdeli.com/free



